Live ID Validation

Aggiunga l'accesso biometrico alla Sua app — confermi un utente di ritorno confrontando un selfie dal vivo con il volto della sua verifica KYC già approvata, e subordini l'accesso a un semplice esito matched true/false.

Live ID Validation trasforma l'identità KYC già verificata di un cliente in un fattore di accesso biometrico. Al momento dell'accesso l'utente scatta un selfie dal vivo; Certivant lo confronta con il volto KYC verificato (la stessa pipeline di confronto del volto e di controllo di vivacità usata durante l'onboarding) e restituisce un semplice matched: true | false su cui Lei subordina l'accesso.

Validation di Live ID (questa funzione) ri-autentica un utente di ritorno. È diversa dalla verifica dal vivo in videoconferenza (una chiamata di onboarding assistita da un operatore). Funzione diversa, nome diverso.

Come funziona

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 chiave di identificazione cifrata è la Sua credenziale a lunga durata, per profilo. Resta sul Suo backend — il dispositivo possiede solo un token di sessione monouso e a breve durata (TTL predefinito 120 secondi). La chiave è protetta con AES-256-GCM e con una firma Ed25519, quindi qualsiasi alterazione anche di un solo bit viene respinta lato server; il token di sessione non può fare altro che inviare un selfie per un profilo.

Prerequisiti

Un profilo verificato e registrato. Un richiedente KYC diventa idoneo a Live ID quando la sua richiesta è APPROVED e Live ID è attivo per il Suo tenant. La registrazione avviene automaticamente all'approvazione — acquisisce il selfie verificato come volto di riferimento.

Live ID attivo + soglie. Lo attivi in KYC → Impostazioni → Live ID (liveIdEnabled), dove imposta anche il punteggio minimo del confronto del volto, se la vivacità è obbligatoria e la durata della sessione (TTL).

Un piano con capacità Live ID. La quota Live ID Validations / mese incluse del piano copre le validazioni gratuite; oltre, ciascuna viene addebitata con il Prezzo per Live ID Validation (a consumo) sul wallet. Vedi Fatturazione.

Una chiave di identificazione per profilo. Ne emetta una in KYC → Live ID → Chiavi (oppure tramite l'API delle chiavi) per un profilo registrato. La conservi sul Suo backend, associata al Suo utente.

Integrazione in quattro passaggi

Crei una sessione — lato server. Quando un utente inizia l'accesso, il Suo backend invia la chiave di identificazione dell'utente a Certivant e riceve un sessionToken e 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": "…" }

Apra la pagina di acquisizione. Mandi il dispositivo a captureUrl — una pagina ospitata, pensata per il mobile, che gestisce fotocamera, selfie e interfaccia dell'esito. Sul web, la apra in un popup o con un reindirizzamento; in un'app mobile, la carichi in una WebView (vedi Onboarding mobile).

Legga l'esito. Si iscriva al webhook live_id.validation.completed (consigliato), oppure interroghi GET /api/kyc/public/live-id/sessions/:sessionToken finché status è completed e legga matched.

Subordini l'accesso. matched === true → conceda l'accesso. false → lo neghi oppure ripieghi su un altro fattore. Ogni validazione completata viene misurata (e fatturata se oltre la quota).

Per la forma completa di richieste e risposte, vedi il riferimento API.

Perché la chiave non tocca mai il dispositivo

Inserire la chiave di identificazione nel codice client permetterebbe a chiunque la estragga di creare sessioni per qualsiasi Suo utente. Per questo:

La chiave resta sul Suo backend e viene usata solo nella chiamata server-to-server POST /sessions.
Il token di sessione che riceve il dispositivo è monouso, a breve durata e legato a esattamente un profilo registrato. Può fare una sola cosa: inviare un selfie.
Una chiave alterata viene respinta prima di qualsiasi elaborazione (due controlli di integrità indipendenti: tag di autenticazione GCM e firma Ed25519).

Fatturazione

Live ID tiene conto della quota:

Le validazioni entro la quota inclusa mensile del piano sono gratuite (ma vengono comunque misurate).
Oltre la quota, ogni validazione addebita il Prezzo per Live ID Validation sul Suo wallet in dollari.
Se la validazione successiva sarebbe a consumo e il wallet non riesce a coprirla, POST /sessions restituisce 402 verification_unavailable — il flusso fallisce subito, prima che l'utente apra la fotocamera, così può ricaricare o ripiegare su un'alternativa.

Le organizzazioni in prova usano la quota Live ID Validations di prova / mese del piano. L'utilizzo compare nel Suo record mensile di utilizzo KYC.

Avanti

Riferimento API — creazione, acquisizione, interrogazione, validazione e payload del webhook.
Onboarding mobile — integrazione con WebView ed esempi di app per iOS, Android e .NET MAUI.