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ètresign_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é.- Vérifiez le token d’accès à chaque requête. Contrôlez la signature ES256 avec le JWKS de votre émetteur, puis
iss,aud,expettyp: at+jwt, et rejetez un token dontactn’est pasnull, sauf si la route accepte les agents IA. Voir vérifier un token sur votre serveur. - 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. - 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
approvedque votre backend a lui-même lu. Voir step-up avant les actions sensibles. - Prenez
vendor_datadepuis 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.

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
webcredentialsdans votreapple-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.
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 valeurvendor_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.loginpour 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.
Recevoir les événements de connexion
Abonnez une destination de webhook aux typesauth.* 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 formeexternal_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
- L’authentification est activée pour votre application Live sur la page Products.
- Vos URL de redirection
https://et origines autorisées de production sont enregistrées sur l’application Live. Une application Live n’accepte aucune adressehttp://. - 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.
- Votre configuration de production contient la clé publique Live (
pk_live_) et votre émetteur Live. - 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.
- La protection contre les bots est activée, ainsi que le contrôle des mots de passe compromis.
- Votre backend vérifie chaque token d’accès et appelle
GET /session/avant les actions sensibles. - 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.
- Votre destination de webhook est abonnée aux types
auth.*que vous gérez. - 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.