Live ID Validation

Ajoutez l'ouverture de session biométrique à votre application — confirmez un utilisateur récurrent en comparant un selfie en direct avec le visage de sa vérification KYC Certivant déjà validée, et contrôlez l'accès à partir d'un simple résultat matched vrai/faux.

Live ID Validation transforme l'identité KYC déjà vérifiée d'un client en facteur d'ouverture de session biométrique. Au moment de la connexion, l'utilisateur prend un selfie en direct ; Certivant le compare à son visage KYC vérifié (le même pipeline de correspondance faciale et de vivacité que pendant l'intégration) et renvoie un simple matched: true | false sur lequel vous contrôlez l'accès.

Validation Live ID (cette fonctionnalité) réauthentifie un utilisateur récurrent. Elle est différente de la vérification en direct par visioconférence (un appel d'intégration assisté par un humain). Fonctionnalité différente, nom différent.

Fonctionnement

graph LR
  A[User starts login] --> B[Your backend mints a session]
  B -->|holds the Identification Key| C[Certivant verifies key, returns sessionToken + captureUrl]
  C --> D[Device opens captureUrl in a WebView]
  D --> E[Selfie -> face match + liveness]
  E --> F[Your backend reads matched]
  F -->|matched true| G[Grant login]
  F -->|matched false| H[Deny / fall back]

La clé d'identification chiffrée est votre identifiant de longue durée, propre à chaque profil. Elle reste sur votre backend : l'appareil ne détient jamais qu'un jeton de session à usage unique et de courte durée (durée de vie par défaut de 120 s). La clé est scellée avec AES-256-GCM et une signature Ed25519, de sorte que toute altération, même d'un seul bit, est rejetée côté serveur ; le jeton de session ne peut rien faire d'autre que soumettre un selfie pour un seul profil.

Prérequis

Un profil vérifié et inscrit. Un demandeur KYC devient admissible à Live ID dès que sa demande est APPROUVÉE et que Live ID est activé pour votre locataire. L'inscription est automatique à l'approbation : elle capture le selfie vérifié comme visage de référence.

Live ID activé + seuils. Activez-le dans KYC → Paramètres → Live ID (liveIdEnabled), où vous définissez aussi le score minimal de correspondance faciale, l'exigence ou non de la vivacité, et la durée de vie de la session.

Un forfait avec capacité Live ID. Le quota Validations Live ID par mois incluses de votre forfait couvre les validations gratuites ; au-delà, chacune est facturée au Prix par validation Live ID (paiement à l'utilisation) sur votre portefeuille. Voir Facturation.

Une clé d'identification par profil. Émettez-en une dans KYC → Live ID → Clés (ou via l'API des clés) pour un profil inscrit. Conservez-la sur votre backend, associée à votre utilisateur.

Intégrer en quatre étapes

Créer une session, côté serveur. Lorsqu'un utilisateur commence sa connexion, votre backend envoie la clé d'identification de l'utilisateur à Certivant et reçoit en retour un sessionToken et un captureUrl.

curl -X POST https://app.certivant.com/api/kyc/public/live-id/sessions \
  -H "Content-Type: application/json" \
  -d '{"key":"livid_…"}'
# → { "sessionToken": "…", "captureUrl": "https://…/live-id/…", "expiresAt": "…" }

Ouvrir la page de capture. Envoyez l'appareil vers captureUrl : une page hébergée, conçue d'abord pour le mobile, qui gère la caméra, le selfie et l'affichage du résultat. Sur le web, ouvrez-la dans une fenêtre contextuelle ou par redirection ; dans une application mobile, chargez-la dans une WebView (voir Intégration mobile).

Lire le résultat. Abonnez-vous au webhook live_id.validation.completed (recommandé), ou interrogez GET /api/kyc/public/live-id/sessions/:sessionToken jusqu'à ce que status vaille completed, puis lisez matched.

Contrôler la connexion. matched === true → accorder l'accès. false → refuser ou basculer vers un autre facteur. Chaque validation terminée est mesurée (et facturée si le quota est dépassé).

Pour la structure complète des requêtes et des réponses, voir la référence de l'API.

Pourquoi la clé ne touche jamais l'appareil

Placer la clé d'identification dans le code client permettrait à quiconque l'extrait de créer des sessions pour n'importe lequel de vos utilisateurs. Ainsi :

La clé reste sur votre backend et n'est utilisée que dans l'appel serveur à serveur POST /sessions.
Le jeton de session reçu par l'appareil est à usage unique, de courte durée, et lié à un seul profil inscrit. Soumettre un selfie est tout ce qu'il permet de faire.
Une clé altérée est rejetée avant tout traitement (deux contrôles d'intégrité indépendants : le tag d'authentification GCM et la signature Ed25519).

Facturation

Live ID tient compte du quota :

Les validations dans le quota inclus mensuel de votre forfait sont gratuites (mais mesurées).
Au-delà du quota, chaque validation est facturée au Prix par validation Live ID sur votre portefeuille en dollars.
Si la prochaine validation serait facturée à l'utilisation et que votre portefeuille ne peut pas la couvrir, POST /sessions renvoie 402 verification_unavailable : le parcours échoue immédiatement, avant que l'utilisateur n'ouvre la caméra, afin que vous puissiez recharger le portefeuille ou basculer vers une autre solution.

Les organisations en période d'essai utilisent le quota Validations Live ID d'essai par mois de leur forfait. L'utilisation apparaît dans votre relevé mensuel d'utilisation KYC.

Suite

Référence de l'API : création de session, capture, interrogation, validation et charge utile du webhook.
Intégration mobile : intégration en WebView et applications exemples pour iOS, Android et .NET MAUI.