Passer au contenu principal
Ce guide explique comment s’articule une intégration Didit Authentication en production, de la première redirection jusqu’à la liste de contrôle avant mise en production. Commencez par le démarrage rapide si vous n’avez pas encore connecté un utilisateur, et utilisez les guides de démarrage rapide des plateformes pour le code de chaque SDK.

Architecture

Quatre éléments interviennent : Aucune clé API Didit ni aucun secret ne doit figurer dans votre application : la clé publiable est publique, et l’échange de code est protégé par PKCE au lieu d’un secret client.

Pages hébergées ou vos propres écrans

Choisissez où les utilisateurs saisissent leur e-mail, leur mot de passe ou leur code. Le paramètre sign_in_ui (hosted par défaut, ou own) peut être modifié à tout moment. Les passkeys sont liés à l’origine de connexion de votre application. Les méthodes passkey des SDK ne fonctionnent que sur les pages servies depuis cette origine. Ainsi, sur vos propres écrans situés sur un autre domaine, orientez les utilisateurs vers la page hébergée pour les passkeys.

Choisir votre SDK

Sans SDK, implémentez vous-même le flux d’autorisation par code avec PKCE : le démarrage rapide JavaScript présente l’ensemble du contrat.

Protégez votre backend

Une vérification de session côté frontend ne contrôle que ce que vous affichez. Votre backend prend chaque décision à partir d’un token vérifié.
  1. Vérifiez le token d’accès à chaque requête. Contrôlez la signature ES256 avec le JWKS de votre émetteur, puis iss, aud, exp et typ: at+jwt, et rejetez un token dont act n’est pas null, sauf si la route accepte les agents IA. Voir vérifier un token sur votre serveur.
  2. Contrôlez la session active avant une action sensible. Un token d’accès reste valide jusqu’à son expiration, dans un délai maximal de 5 minutes. GET /session/ échoue immédiatement lorsque la session a été révoquée, est restée inactive ou a expiré, lorsque la personne a été bloquée, ou lorsque la session ne respecte plus votre politique MFA. Voir contrôler la session.
  3. Demandez un step-up lorsque l’action est risquée. Avant un versement, un nouveau compte bancaire ou une modification de l’e-mail ou du téléphone, demandez à Didit si la personne doit se vérifier à nouveau, et n’agissez que sur un step-up approved que votre backend a lui-même lu. Voir step-up avant les actions sensibles.
  4. Prenez vendor_data depuis le token vérifié, jamais depuis un champ envoyé par le navigateur, et utilisez-le pour les vérifications et les transactions de la personne.

Sessions

Modifiez les durées dans Authentication > Security and sessions, ou par API dans les paramètres de l’application.
La vue Active sessions de la Business Console de Didit, listant les sessions ouvertes avec l'appareil, la localisation, la date de début, la date de dernière activité, la date de fin et un bouton Revoke

Authentication > Sign-ins > Active sessions, avec Revoke sur chaque session.

Applications natives

Didit renvoie les utilisateurs vers une application native uniquement par une redirection HTTPS : il n’accepte aucun schéma d’URL personnalisé.
  • iOS : faites de la redirection un domaine associé, avec webcredentials dans votre apple-app-site-association.
  • Android : faites de la redirection un App Link, avec votre assetlinks.json.
  • Enregistrez chaque URL de redirection sous Authentication > Security and sessions, comme une URL de rappel web.
Pour les clés d’accès de votre application, enregistrez les applications qui partagent les clés d’accès de votre application avec PUT native-apps/ sur l’API de gestion de l’authentification. Didit les liste ensuite dans les fichiers apple-app-site-association et assetlinks.json qu’il sert sur l’origine de connexion de votre application. MANAGEMENT_BASE est l’adresse de l’API de gestion de votre application, et une clé API avec le périmètre authentication en écriture peut effectuer l’appel. L’appel remplace les deux listes : envoyez donc les deux :
Les guides de démarrage rapide iOS et Android montrent le côté application.

Connecter la vérification d’identité et la Surveillance des transactions

Chaque personne dispose d’une seule valeur vendor_data, présente dans ses tokens et dans sa session. Utilisez-la comme vendor_data lorsque vous créez une session de vérification ou soumettez une transaction. La console affiche alors les connexions, les vérifications et les transactions d’une même personne.
  • Pour vérifier les personnes lors de l’inscription, ou à nouveau avant un versement, sans créer de parcours de vérification, utilisez identité vérifiée.
  • Les événements de connexion sont transmis automatiquement aux règles d’événements et aux vues antifraude. N’envoyez pas vos propres événements auth.login pour les mêmes connexions.
  • Une connexion réussie n’approuve jamais une vérification ni une transaction : traitez séparément la décision propre à chaque produit.
Consultez garder une même personne à travers les produits.

Recevoir les événements de connexion

Abonnez une destination de webhook aux types auth.* dont vous avez besoin, par exemple auth.new_device ou auth.account_locked. Effectuez la déduplication à partir de auth_event.event_id, et vérifiez la signature comme pour tout webhook Didit. Consultez les événements et les webhooks pour chaque type et son payload.

Migrer les utilisateurs existants

Si vos utilisateurs disposent déjà de comptes sur une autre plateforme d’identité ou dans votre propre base de données, importez-les avant de modifier le mode de connexion. Importez leurs hachages de mot de passe lorsque la source les fournit, conservez leurs liens de connexion sociale, et conservez vos propres identifiants utilisateur sous la forme external_id, qui devient leur vendor_data. Rien ne change pour eux tant que vous n’avez pas basculé votre application vers Didit.

Liste de contrôle avant la mise en production

  1. L’authentification est activée pour votre application Live sur la page Products.
  2. Vos URL de redirection https:// et origines autorisées de production sont enregistrées sur l’application Live. Une application Live n’accepte aucune adresse http://.
  3. Chaque méthode de connexion sociale utilise l’identifiant client et le secret de votre propre application : les identifiants de test de Didit ne fonctionnent qu’en Sandbox.
  4. Votre configuration de production contient la clé publique Live (pk_live_) et votre émetteur Live.
  5. Votre politique MFA, la durée de vie de la session, le délai d’inactivité, la longueur des mots de passe et la politique d’inscription correspondent à vos besoins. Consultez les paramètres de l’application.
  6. La protection contre les bots est activée, ainsi que le contrôle des mots de passe compromis.
  7. Votre backend vérifie chaque token d’accès et appelle GET /session/ avant les actions sensibles.
  8. Votre identité visuelle, les textes des pages ainsi que les liens vers les conditions d’utilisation et la politique de confidentialité sont configurés. Si vous prévoyez un domaine personnalisé, activez-le avant que les utilisateurs n’ajoutent des clés d’accès.
  9. Votre destination de webhook est abonnée aux types auth.* que vous gérez.
  10. Vous avez testé sur l’application Live l’inscription, la connexion des utilisateurs existants, l’annulation, le mot de passe oublié, la MFA, l’expiration de la session, la déconnexion et une session révoquée.

Dépannage

Dernière modification le 22 novembre 2026