Pourquoi la génération des jetons côté serveur est nécessaire
Le SDK Youverify utilise deux jetons distincts pour authentifier une session :- Identifiant de session : un identifiant à courte durée de vie qui délimite la session et la relie à un utilisateur ou à un enregistrement d’entité spécifique de votre compte.
- Jeton de vivacité : un jeton d’authentification qui autorise le SDK à soumettre les données de vivacité à l’infrastructure de vérification de Youverify.
Endpoint 1 — Générer un SDK Session ID
Utilisez cet endpoint pour démarrer des sessions de détection de vivacité anti-deepfake.POST /v2/api/identity/sdk/session/generate
Requête
Paramètres de la requête
Durée de validité de l’identifiant de session, en secondes. Doit être comprise entre
30 et 600. Par défaut, 120.Métadonnées clé-valeur facultatives à associer à la session, par exemple votre identifiant utilisateur interne.
Réponse
Endpoint 2 — Générer un SDK Liveness Token
Utilisez cet endpoint pour les parcours de détection de vivacité sur toutes les plateformes (Web, Android, iOS).POST /v2/api/identity/sdk/liveness/token
Requête
Paramètres de la requête
Un identifiant unique pour cet appareil ou cette session utilisateur. Utilisez un UUID généré par session. Il aide Youverify à détecter et à empêcher la réutilisation de jetons entre appareils.
Un identifiant d’appareil alternatif à partir duquel Youverify peut déduire
deviceCorrelationId. Utilisez soit deviceCorrelationId, soit deviceId, mais pas les deux.Réponse
Expiration et mise en cache des jetons
Les jetons ont une durée de vie courte par conception. Générez une nouvelle paire de jetons juste avant chaque initialisation du SDK. Ne stockez pas les jetons dans une base de données ni dans un cache pour les réutiliser d’une session à l’autre.
onFailure du SDK est déclenché avec error.key = "invalid_or_expired_session". Votre application doit générer de nouveaux jetons et réinitialiser le SDK.