Live ID Validation

Fügen Sie Ihrer App eine biometrische Anmeldung hinzu — bestätigen Sie einen wiederkehrenden Nutzer, indem Sie ein Live-Selfie mit seinem bereits verifizierten KYC-Gesicht bei Certivant abgleichen, und steuern Sie den Zugang anhand eines einfachen Ergebnisses matched true/false.

Live ID Validation macht die bereits verifizierte KYC-Identität eines Kunden zu einem biometrischen Anmeldefaktor. Bei der Anmeldung nimmt der Nutzer ein Live-Selfie auf; Certivant gleicht es mit dem verifizierten KYC-Gesicht ab (dieselbe Pipeline aus Gesichtsabgleich und Lebenderkennung wie beim Onboarding) und liefert ein einfaches matched: true | false, mit dem Sie den Zugang steuern.

Live ID Validation (diese Funktion) authentifiziert einen wiederkehrenden Nutzer erneut. Sie unterscheidet sich von der Live-Verifizierung per Videokonferenz (ein von einer Person begleiteter Onboarding-Anruf). Andere Funktion, anderer Name.

So funktioniert es

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]

Der verschlüsselte Identifikationsschlüssel ist Ihre langlebige Anmeldedaten pro Profil. Er bleibt auf Ihrem Backend — das Gerät hält nur ein einmal verwendbares, kurzlebiges Sitzungstoken (Standardlaufzeit 120 s). Der Schlüssel ist mit AES-256-GCM und einer Ed25519-Signatur versiegelt, sodass jede auch nur einzelbitgenaue Manipulation serverseitig abgelehnt wird. Das Sitzungstoken kann nur eines: genau ein Selfie für genau ein Profil übermitteln.

Voraussetzungen

Ein verifiziertes, registriertes Profil. Ein KYC-Antragsteller wird für Live ID berechtigt, sobald seine Anfrage APPROVED ist und Live ID für Ihren Mandanten aktiviert ist. Die Registrierung erfolgt bei der Genehmigung automatisch — dabei wird das verifizierte Selfie als Referenzgesicht übernommen.

Live ID aktiviert und Schwellenwerte gesetzt. Aktivieren Sie die Funktion unter KYC → Einstellungen → Live ID (liveIdEnabled). Dort legen Sie außerdem den minimalen Score für den Gesichtsabgleich, ob die Lebenderkennung erforderlich ist, und die Laufzeit der Sitzung fest.

Ein Tarif mit Live-ID-Kapazität. Das Kontingent Live-ID-Validierungen pro Monat inklusive Ihres Tarifs deckt kostenlose Validierungen ab; darüber hinaus wird jede Validierung zum Preis pro Live-ID-Validierung (PAYG) von Ihrem Guthaben abgerechnet. Siehe Abrechnung.

Ein Identifikationsschlüssel pro Profil. Stellen Sie einen unter KYC → Live ID → Schlüssel aus (oder über die Schlüssel-API) für ein registriertes Profil. Speichern Sie ihn auf Ihrem Backend, zugeordnet zu Ihrem Nutzer.

In vier Schritten integrieren

Sitzung erzeugen — serverseitig. Sobald ein Nutzer die Anmeldung beginnt, sendet Ihr Backend den Identifikationsschlüssel des Nutzers an Certivant und erhält ein sessionToken sowie eine captureUrl zurück.

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": "…" }

Die Aufnahmeseite öffnen. Leiten Sie das Gerät zur captureUrl — einer gehosteten, für Mobilgeräte optimierten Seite, die Kamera, Selfie und die Ergebnisanzeige übernimmt. Im Web öffnen Sie sie in einem Popup oder per Weiterleitung; in einer mobilen App laden Sie sie in einer WebView (siehe Mobiles Onboarding).

Das Ergebnis auslesen. Abonnieren Sie entweder den Webhook live_id.validation.completed (empfohlen) oder fragen Sie GET /api/kyc/public/live-id/sessions/:sessionToken ab, bis status den Wert completed hat, und lesen Sie matched aus.

Anmeldung steuern. matched === true → Zugang gewähren. false → ablehnen oder auf einen anderen Faktor zurückgreifen. Jede abgeschlossene Validierung wird erfasst (und bei Überschreitung des Kontingents abgerechnet).

Die vollständigen Anfrage- und Antwortstrukturen finden Sie in der API-Referenz.

Warum der Schlüssel das Gerät nie erreicht

Würde der Identifikationsschlüssel im Client-Code liegen, könnte jeder, der ihn extrahiert, Sitzungen für beliebige Ihrer Nutzer erzeugen. Stattdessen gilt:

Der Schlüssel liegt auf Ihrem Backend und wird nur beim serverseitigen Aufruf POST /sessions verwendet.
Das Sitzungstoken, das das Gerät erhält, ist einmal verwendbar, kurzlebig und an genau ein registriertes Profil gebunden. Damit lässt sich nur ein Selfie übermitteln.
Ein manipulierter Schlüssel wird abgelehnt, bevor irgendeine Arbeit beginnt (zwei unabhängige Integritätsprüfungen: GCM-Authentifizierungs-Tag und Ed25519-Signatur).

Abrechnung

Live ID berücksichtigt das Kontingent:

Validierungen innerhalb des monatlich inklusiven Kontingents Ihres Tarifs sind kostenlos (werden aber erfasst).
Darüber hinaus wird jede Validierung zum Preis pro Live-ID-Validierung von Ihrem Dollar-Guthaben abgerechnet.
Wenn die nächste Validierung PAYG wäre und Ihr Guthaben sie nicht deckt, liefert POST /sessions 402 verification_unavailable — der Ablauf schlägt sofort fehl, noch bevor der Nutzer die Kamera öffnet, sodass Sie aufladen oder auf einen Alternativfaktor ausweichen können.

Testphasen-Organisationen nutzen das Kontingent Live-ID-Validierungen in der Testphase pro Monat des Tarifs. Die Nutzung erscheint in Ihrem monatlichen KYC-Nutzungsbericht.

Weiter

API-Referenz — erzeugen, aufnehmen, abfragen, validieren und die Webhook-Nutzlast.
Mobiles Onboarding — WebView-Einbettung und Beispiel-Apps für iOS, Android und .NET MAUI.