Authentification

Ce qui passe sur le fil

• Où elle se situe

  Devant chaque appel. L’identifiant détermine le compte visé, l’environnement atteint et ce qui est permis, avant même la lecture du corps.

• Ce que vous envoyez

  L’identifiant sur la requête, en TLS. Les appels serveur portent la clé secrète; les composants navigateur sont initialisés avec la clé publiable; une plateforme qui agit pour une entreprise connectée présente une autorisation OAuth plutôt que la clé de cette entreprise.

• Ce qui revient en cas de refus

  Un échec d’authentification se distingue d’un échec d’autorisation : le premier signifie un identifiant absent ou erroné, le second un identifiant valide mais non habilité. La référence donne le code de chacun.

Quand l’utiliser

• Intégrations serveur

  Les clés secrètes autorisent la création, la capture et le remboursement d’un paiement. N’en livrez jamais une dans un navigateur ou un binaire mobile.

• Navigateur et mobile

  Les clés publiables alimentent les champs intégrés et renvoient des jetons que votre serveur facture ensuite, ce qui garde les données de carte hors de votre périmètre PCI.

• Plateformes et places de marché

  OAuth permet à une plateforme d’agir au nom d’entreprises connectées sans détenir leurs identifiants, et permet à ces entreprises de révoquer l’accès sans rien faire tourner de leur côté.

Mettre en œuvre Authentification

Ce qui échoue, et comment vous l’apprenez

• Une clé secrète dans un paquet client

  Elle est lisible par quiconque ouvre l’onglet réseau, et elle peut rembourser. Toute apparition dans un paquet navigateur, un binaire mobile ou un dépôt public vaut compromission : faites la rotation avant d’enquêter.

• La clé du mauvais environnement

  Une clé de production en préproduction débite de vraies cartes; une clé sandbox en production fait échouer chaque appel. Refuser de démarrer quand le préfixe de clé ne correspond pas à l’environnement attendu élimine les deux cas.

• Une rotation sans recouvrement

  Révoquer l’ancienne clé au moment d’émettre la nouvelle fait échouer les requêtes en vol. Gardez les deux, basculez le trafic, puis révoquez, en confirmant par vos journaux que l’ancienne clé ne sert plus.

• Une autorisation OAuth révoquée prise pour une panne

  Quand une entreprise connectée se déconnecte, les appels faits pour elle échouent alors que vos propres identifiants restent valides. Traitez cela comme un changement d’état, pas comme un incident global.

Sandbox par rapport à la production

• Les identifiants ne s’interchangent pas

  Les clés sandbox et production sont émises séparément et aucune ne fonctionne dans l’autre environnement. C’est voulu : une confusion échoue immédiatement au lieu de réussir discrètement au mauvais endroit.

• La rotation mérite une répétition

  Faire tourner une clé sandbox et voir votre déploiement la reprendre prouve le mécanisme avant le jour où il faudra le faire sous pression en production.

• OAuth en sandbox relie des comptes test

  Le parcours d’autorisation se comporte de la même façon, mais les entreprises reliées sont des ID de marchand test : une plateforme peut établir et révoquer des connexions sans impliquer un vrai client.