Testez l’intégration complète dans l’environnement de test de Parkour Design avant l’émission des identifiants de production. Les contrôles automatisés prouvent le comportement du protocole et du contrat ; la recette manuelle prouve le parcours utilisateur et la reprise en cas d’incident.
Règle de mise en production : un rappel d’autorisation réussi ne suffit pas à la recette. La mise en production exige la validation de l’identité, l’isolation des utilisateurs, la rotation des jetons, des tests du contrat de ressources, la reprise après défaillance et l’accord des deux équipes.
Prérequis des tests
Parkour Design et le partenaire doivent préparer :
- un client de test enregistré et un secret remis de façon sécurisée ;
- une URI de redirection de test exacte ;
- l’ensemble de scopes validé ;
- au moins deux utilisateurs de test Parkour Design ;
- des événements et des projets appartenant séparément à chaque utilisateur ;
- un compte ou un événement vide, le cas échéant ;
- des contacts techniques et d’incident ;
- les résultats attendus pour chaque cas de recette.
Utilisez l’émetteur de test :
https://parkour-test.web.app
Ne réutilisez pas en production les identifiants, URL de rappel, jetons ou données utilisateur de test.
Contrôles préalables
Découverte
curl --fail-with-body \
"https://parkour-test.web.app/.well-known/openid-configuration"
Vérifiez que :
issuerest exactement égal à l’émetteur de test configuré ;- les points de terminaison d’autorisation, de jetons, UserInfo et JWKS utilisent HTTPS ;
code,authorization_code,refresh_token,RS256etS256sont présents ;- aucun secret client ni valeur privée propre à l’environnement n’apparaît dans la découverte.
Clés de signature
Récupérez le jwks_uri depuis la découverte et vérifiez que chaque clé utilisable a un kid, un kty, un usage de signature et un algorithme validé. Face à un kid inconnu, le client doit actualiser le JWKS une fois avant de rejeter le jeton.
Requête de ressource non authentifiée
curl --include "https://parkour-test.web.app/api/events"
Résultat attendu :
HTTP/2 401
Content-Type: application/json
{"error":"invalid_token"}
Tests OAuth automatisés
Automatisez ces cas à la frontière du partenaire. Utilisez des jeux de données contrôlés et ne simulez que l’étape externe du navigateur quand un test complet en navigateur n’est pas réaliste.
Demande d’autorisation
- contient exactement l’identifiant client, l’URI de redirection et les scopes validés ;
- génère des valeurs
state,nonceet vérificateur PKCE uniques et à forte entropie ; - envoie
code_challenge_method=S256; - ne met ni le secret client ni le vérificateur dans l’URL ;
- rejette une URI de redirection non enregistrée ou légèrement différente lors d’un test négatif sur l’environnement.
Rappel
- accepte une seule fois le bon
state; - rejette un
stateabsent, différent, expiré ou réutilisé ; - traite
access_deniedsans échanger de code ; - rejette l’absence de code sur un rappel par ailleurs réussi ;
- ne conserve qu’un chemin de retour local validé ;
- n’expose au navigateur ni diagnostics du protocole ni données personnelles.
Échange du code
- s’authentifie avec
client_secret_basic; - utilise la même URI de redirection que la demande d’autorisation ;
- envoie le vérificateur PKCE d’origine ;
- rejette les codes expirés, réutilisés, destinés à un autre client ou associés à un autre vérificateur ;
- considère les réponses de jetons comme non mises en cache et les garde côté serveur.
Validation du jeton d’identité
Rejetez les jetons :
- à la signature invalide ;
- dont la clé de signature reste inconnue après une actualisation du JWKS ;
- au mauvais émetteur ;
- à la mauvaise audience ;
- signés avec un autre algorithme que
RS256; - au nonce absent ou incorrect ;
- aux attributs de temps expirés ou invraisemblables ;
- sans sujet.
Vérifiez que la liaison des comptes utilise la paire iss et sub, et pas seulement l’e-mail.
Rotation des jetons de rafraîchissement
- un jeton de rafraîchissement valide renvoie un nouveau jeton d’accès et un jeton de rafraîchissement de remplacement ;
- le remplacement est enregistré de façon atomique ;
- les rafraîchissements sont sérialisés pour chaque session utilisateur et client ;
- la réutilisation de l’ancien jeton de rafraîchissement est rejetée ;
- un jeton émis pour un autre client est rejeté ;
- un jeton expiré exige un nouveau flux d’autorisation ;
- un délai dépassé ou une réponse de rafraîchissement perdue au résultat incertain efface l’état local des jetons et relance un flux d’autorisation au lieu de réessayer avec l’ancien jeton ;
- des tentatives de rafraîchissement simultanées ne peuvent pas entrer en concurrence avec le même jeton ;
- la déconnexion locale supprime le jeton de rafraîchissement actif et les données de session.
Parkour Design n’a pas actuellement de point de terminaison public de révocation. Les tests ne doivent pas présenter une suppression locale comme une révocation côté serveur.
Tests automatisés des ressources
Authentification et isolation
- sans jeton, la réponse est
401 invalid_token; - un jeton expiré ou mal formé renvoie
401 invalid_token; - un jeton d’identité utilisé comme jeton porteur d’API est rejeté ;
- l’utilisateur A ne voit que ses propres événements et projets ;
- l’utilisateur B ne peut pas récupérer un événement de l’utilisateur A en copiant son identifiant ;
- un événement inaccessible et un événement inexistant renvoient tous deux
404 not_found.
Contrat de schéma
Validez chaque réponse par rapport à un schéma de référence détenu par le partenaire :
- les propriétés obligatoires sont présentes ;
- les propriétés nullables acceptent
null; - les dates s’analysent comme des valeurs ISO 8601 ;
- des propriétés supplémentaires inconnues ne cassent pas le client ;
- une collection vide renvoie un tableau
itemsvide ; - les identifiants sont traités comme des chaînes opaques ;
- le texte prend en charge Unicode et s’affiche de façon sûre.
Ne déduisez pas un plan de parcours complet du schéma de résumé.
Limites et défaillances
- le client gère la plus grande liste d’événements validée ;
- la limite actuelle de 500 projets par événement figure dans l’analyse des risques de lancement ;
- les réponses
401,404,405,429et5xxsuivent la politique de nouvelle tentative convenue ; - les délais dépassés ne déclenchent pas de nouvelles tentatives illimitées ;
- un JSON mal formé échoue proprement et enregistre un diagnostic expurgé ;
- des requêtes
GETidempotentes répétées ne modifient pas l’état du partenaire.
Tests des exports de Parkour Design vers le partenaire
Quand Parkour Design envoie des données à un partenaire, ajoutez des tests de contrat bilatéraux pour :
- la liste des destinations et la validation des identifiants ;
- l’envoi du fichier seul ;
- l’envoi des données structurées seules ;
- l’envoi réussi de toutes les parties ;
- chaque combinaison possible de réussite partielle ;
- des données structurées mal formées ;
- des fichiers vides et trop volumineux ;
- les réponses
401,403,404,409,413,429et5xxdu partenaire ; - le délai de connexion et le délai de réponse dépassés ;
- l’envoi en double et le comportement d’idempotence ;
- la déconnexion, la reconnexion et l’expiration des jetons.
Recette manuelle
Réalisez les cas suivants dans un vrai navigateur, sur l’environnement de test hébergé.
| Scénario | Résultat attendu |
|---|---|
| Bon compte | Le consentement aboutit et seules les ressources de cet utilisateur sont renvoyées |
| Consentement refusé | Le partenaire affiche une annulation récupérable et ne conserve aucun jeton |
| Mauvais compte Parkour Design | Le partenaire affiche l’identité connectée et permet de recommencer en toute sécurité |
| Session partenaire existante pour un autre compte | Le changement de compte suit les instructions de support validées |
| Retour arrière et actualisation | Aucun code d’autorisation ni state n’est accepté deux fois |
| Double clic sur la connexion | Une seule transaction de navigateur fait foi |
| Onglets simultanés | Un rappel ne peut pas se rattacher à la mauvaise transaction locale |
| Rappel expiré | L’utilisateur peut recommencer sans état de connexion périmé |
| Jeton d’accès expiré | Le partenaire rafraîchit une fois ou redemande l’autorisation |
| Panne du partenaire ou de Parkour Design | L’utilisateur reçoit un message récupérable sans diagnostic sensible |
| Déconnexion et reconnexion | Les jetons locaux sont supprimés et une nouvelle identité peut être établie |
Répétez le flux principal dans chaque langue d’interface prise en charge. Les valeurs du protocole restent inchangées, seuls les messages destinés à l’utilisateur sont traduits.
Éléments pour la revue de sécurité
Fournissez aux relecteurs :
- un schéma des flux de données montrant le navigateur, les deux serveurs, le fournisseur d’identité, les API et le stockage des jetons ;
- les listes autorisées d’URI de redirection et d’origines ;
- les scopes demandés et leur correspondance avec les ressources ;
- la configuration du chiffrement et de la conservation des jetons ;
- la configuration de la validation des jetons d’identité ;
- des exemples expurgés de journaux et d’alertes ;
- les résultats d’analyse des dépendances et de détection des secrets ;
- les résultats des tests automatisés ;
- le compte rendu complet de la recette manuelle ;
- les procédures de rotation des identifiants et de gestion des incidents.
N’ajoutez jamais comme preuves des codes, jetons, secrets client, clés privées, réponses UserInfo brutes ou données clients réels.
Observabilité
Enregistrez assez d’informations pour diagnostiquer les défaillances, sans enregistrer d’identifiants ni de données personnelles :
- un identifiant de corrélation généré par le partenaire ;
- l’environnement et le sens de l’intégration ;
- le nom de l’opération ;
- la catégorie du point de terminaison appelé, pas les paramètres de requête ;
- le statut HTTP et un code d’erreur OAuth sans risque ;
- la durée et le nombre de nouvelles tentatives ;
- un nombre de ressources expurgé quand c’est utile à l’exploitation.
Ne journalisez pas les codes d’autorisation, jetons d’accès, jetons de rafraîchissement, jetons d’identité, secrets client, state, nonce, vérificateur PKCE, URL de redirection complètes, adresses e-mail ou contenus de plans de parcours.
Les alertes doivent distinguer les échecs d’authentification, les échecs d’autorisation, les pannes du partenaire, la latence, les erreurs de schéma et les limitations de débit prolongées.
Préparation à la mise en production
Avant l’émission des identifiants de production, les deux équipes doivent valider :
- l’émetteur et l’URI de redirection de production exacts ;
- l’authentification du client et le responsable des identifiants ;
- les scopes et les ressources accessibles ;
- le volume attendu et les limites actuelles de l’API ;
- le comportement en matière de confidentialité, de conservation, de dissociation et de suppression ;
- les règles de délai, de nouvelle tentative, d’idempotence et de réussite partielle ;
- la supervision et l’escalade des incidents ;
- les instructions de support destinées aux utilisateurs ;
- la procédure de retour arrière ou de désactivation de l’intégration ;
- le créneau et le responsable du test de fumée en production.
Utilisez des identifiants client différents pour le test et la production. Transmettez-les par le canal de secrets validé et vérifiez leur rotation avant le lancement.
Test de fumée en production
Gardez le premier test en production restreint :
- autorisez un compte interne validé ;
- validez le jeton d’identité et récupérez UserInfo ;
- demandez la liste des événements ;
- demandez les résumés de projets d’un événement connu ;
- vérifiez l’isolation des utilisateurs et les champs attendus ;
- rafraîchissez une fois et enregistrez le jeton de remplacement ;
- déconnectez-vous et supprimez les identifiants conservés localement ;
- examinez les journaux et alertes expurgés ;
- consignez le résultat et décidez d’ouvrir ou non un accès plus large.
Ne testez pas en production de comportements destructeurs ou à fort volume, sauf s’ils font explicitement partie de la procédure de lancement validée.
Compte rendu de recette
Pour chaque scénario, consignez :
- l’environnement et la version du build ;
- le responsable du test et la date ;
- l’identité anonymisée du jeu de données ;
- le résultat attendu ;
- le résultat obtenu ;
- l’emplacement des preuves ;
- l’anomalie ou la limite acceptée ;
- le responsable de la validation.
Une limite non documentée n’est pas une limite acceptée. Ajoutez les problèmes de contrat ou de sécurité non résolus à la décision de lancement avant d’ouvrir l’accès en production.