Passer au contenu principal
L’authentification est nouvelle : la disponibilité de @didit-protocol/auth-react-native dépend de la version publiée. Les coordonnées de distribution, les versions et les signatures d’appel ne sont pas confirmées ici. N’installez pas un package deviné et n’utilisez pas le SDK de vérification d’identité comme SDK d’authentification.

​
Préparer l’application

  1. Vérifiez que l’authentification est activée pour votre application Didit et copiez son origine de connexion (https://<slug>.auth.didit.me, ou <slug>.sandbox.auth.didit.me pour le sandbox) depuis la console.
  2. Enregistrez une URL de rappel exacte prise en charge par votre application et par l’environnement d’exécution. Validez la propriété des liens d’application ; ne supposez pas que des schémas d’URL personnalisés arbitraires sont acceptés.
  3. Gardez séparées les configurations sandbox et environnement de production, y compris la gestion des rappels et les identifiants stockés.
  4. Choisissez votre méthode stable d’identification de la personne avant de connecter la vérification ou la surveillance.
Configurez et testez les liens de rappel séparément sur iOS et Android. Le wrapper d’authentification est distinct de @didit-protocol/sdk-react-native, qui gère la vérification.

​
Implémenter le flux hébergé

Ouvrez le navigateur d’authentification système natif avec l’URL {origin}/sign-in. Fournissez un state aléatoire et récent, un challenge PKCE S256 et votre redirect_uri enregistré. Conservez le vérificateur dans votre application pour cette tentative uniquement. Le guide de démarrage JavaScript présente le protocole sous-jacent ; utilisez la cryptographie et la gestion des URL propres à la plateforme plutôt que les objets globaux du navigateur dans le code natif. Au retour du rappel, vérifiez le state, la durée de vie de la transaction et la destination du rappel avant d’échanger le code à usage unique auprès de l’endpoint token/. Utilisez le vérificateur d’origine et l’URI de redirection exacte. Annuler ou fermer le navigateur n’est pas une connexion réussie. Stockez les tokens de rafraîchissement dans un stockage natif protégé par la plateforme ; jamais dans un fichier de préférences en clair, ni dans les analytics ou les journaux de plantage. Validez la session courante avec GET session/ et le Bearer token de l’utilisateur final. Sérialisez les opérations de rafraîchissement, remplacez les deux tokens ensemble, et effacez l’état propre à l’utilisateur après la déconnexion. Voir tokens et JWKS pour le contrat des requêtes et le comportement en cas de réutilisation d’un token de rafraîchissement.

​
Aperçu de la version SDK native

Les modules d’authentification natifs sont prévus pour fournir la connexion, l’accès à la session courante, la récupération des tokens, la déconnexion et l’authentification renforcée, avec des signaux d’appareil automatiques. Les clés d’accès natives et le stockage protégé des tokens font partie de cette version. Les API du wrapper suivront leurs contrats de plateforme publiés ; ne copiez pas des arguments de constructeur ou des signatures de méthodes devinés à partir d’un exemple de conception. Tant que le module n’est pas publié, gardez son adaptateur désactivé ou utilisez une implémentation examinée du protocole hébergé pour votre application sur laquelle l’authentification est activée. Ne présentez pas un guide de démarrage natif d’authentification comme fonctionnel en vous basant uniquement sur l’installation du package.

​
Connecter la vérification et la surveillance

Votre backend dérive vendor_data à partir de la personne authentifiée. Il crée des sessions de vérification ou génère des tokens de surveillance limités à cette personne. Ne renvoyez à votre application que l’identifiant d’accès à la session ou le token limité ; la clé API reste sur le serveur. Utilisez le SDK React Native de vérification d’identité lorsque vous avez besoin de la vérification d’identité. Suivez la soumission de transactions avec le SDK pour la prise en charge de la surveillance sur votre plateforme. Traitez séparément la connexion, la vérification et les décisions relatives aux transactions.

​
Vérifier l’intégration

Testez le retour dans une application arrêtée puis relancée, les passages en arrière-plan et au premier plan, l’annulation du navigateur, un rappel non concordant, le rejeu d’un code, l’expiration des tokens, le rafraîchissement concurrent, l’authentification multifacteur (MFA), la déconnexion et la connexion avec un autre utilisateur. Testez l’enregistrement et la connexion avec une clé d’accès sur les appareils pris en charge, une fois cette version disponible. Une vérification uniquement sur appareil reste non vérifiée tant qu’elle n’a pas été exécutée sur la plateforme cible.
Dernière modification le 7 novembre 2026