Biometrische Authentifizierung: Warnungen & Codes

Die biometrische Authentifizierung kombiniert eine Liveness-Prüfung mit einem optionalen 1:1-Gesichtsabgleich mit dem bei der Sitzungserstellung ermittelten Referenzgesicht (das bereitgestellte portrait_image oder das über vendor_data nachgeschlagene, gespeicherte Gesicht des Benutzers). Jeder Schritt gibt in der V3-Entscheidungs-Payload eigene Warnungen aus. Diese Seite listet jeden Code auf, zeigt, wo er erscheint und wie Schwellenwerte in einen endgültigen Sitzungsstatus überführt werden.

Übersicht

Wenn eine Sitzung zur biometrischen Authentifizierung ausgeführt wird, führt Didit folgende Schritte aus:

Erfasst ein Live-Selfie mithilfe von 3D Action, Flash oder passiver Liveness (method: ACTIVE_3D, FLASHING oder PASSIVE).
Extrahiert das größte Gesicht aus der Aufnahme und bewertet dessen Liveness.
Vergleicht das erfasste Gesicht mit dem Referenzgesicht der Sitzung (bereitgestelltes portrait_image oder gespeichertes Gesicht des Benutzers), sofern der Workflow Gesichtsabgleich beinhaltet.
Schreibt das Ergebnis jedes Schritts sowie etwaige Warnungen in die Sitzungsentscheidung.

Warnungen folgen der plattformweit einheitlichen Struktur des Warnungsobjekts: feature, risk, additional_data, log_type, short_description, long_description und node_id.

Wo Warnungen angezeigt werden

Schlüssel der Entscheidungsantwort	Funktions-Tag der Warnung	Wann sie ausgelöst wird
`liveness_checks[].warnings[]`	`LIVENESS`	Liveness-Scoring, Gesichtsqualität, Helligkeit, mehrere Gesichter sowie Prüfungen auf Sperrlisten, Allowlisten und doppelte Gesichter.
`face_matches[].warnings[]`	`FACEMATCH`	Gesichtsabgleich mit dem Referenzgesicht der Sitzung (bereitgestelltes `portrait_image` oder das gespeicherte Gesicht des Benutzers).

In einer typischen Sitzung zur biometrischen Authentifizierung enthält jedes Array ein Element. Bei Workflows mit mehreren Instanzen gibt die node_id bei jeder Warnung eindeutig an, welcher Schritt sie erzeugt hat.

Bedingungen für eine automatische Ablehnung

Die folgenden Warnungen führen unabhängig von Ihrer Workflow-Konfiguration stets zur Ablehnung des jeweiligen Schritts (log_type: "error"):

Risiko	Funktion	Grund für die automatische Ablehnung
`FACE_IN_BLOCKLIST`	`LIVENESS`	Das Gesicht stimmt mit einem Eintrag in Ihrer Gesichts-Sperrliste überein.
`NO_FACE_DETECTED`	`LIVENESS`	Bei der Liveness-Aufnahme wurde kein Gesicht erkannt oder der Benutzer hat alle Wiederholungsversuche aufgebraucht.
`LIVENESS_FACE_ATTACK`	`LIVENESS`	Ein Präsentationsangriff wurde erkannt (Maske, Bildschirmwiedergabe, Deepfake-basiertes Spoofing).
`NO_REFERENCE_IMAGE`	`FACEMATCH`	Es war kein Referenzbild für den Vergleich verfügbar. Wenn dies ausgelöst wird, wird `LOW_FACE_MATCH_SIMILARITY` unterdrückt.

Wenn NO_FACE_DETECTED ausgelöst wird, wird LOW_LIVENESS_SCORE unterdrückt (da kein Gesicht zur Bewertung vorhanden ist).

Konfigurierbare Schwellenwerte und Aktionen

Diese Warnungen werden bewertet und anschließend anhand der von Ihnen pro Workflow festgelegten Schwellenwerte und Aktionen einem Status zugeordnet:

Risiko	Funktion	Konfigurierbares Verhalten
`LOW_LIVENESS_SCORE`	`LIVENESS`	Wert bei oder unter dem Prüfschwellenwert → `In Review`; bei oder unter dem Ablehnungsschwellenwert → `Declined`.
`LOW_FACE_MATCH_SIMILARITY`	`FACEMATCH`	Wert bei oder unter dem Prüfschwellenwert (Standard: 70) → `In Review`; bei oder unter dem Ablehnungsschwellenwert (Standard: 50) → `Declined`.
`LOW_FACE_QUALITY`	`LIVENESS`	Prüfschwellenwert (Standard: 15) → `In Review`; Ablehnungsschwellenwert (Standard: 0, d. h. Ablehnung deaktiviert) → `Declined`. Nur bei passiver Liveness.
`LOW_FACE_LUMINANCE`	`LIVENESS`	Unter dem Mindesthelligkeits-Schwellenwert (Standard: 20): Keine Aktion / Prüfung (Standard) / Ablehnung. Nur bei passiver Liveness.
`HIGH_FACE_LUMINANCE`	`LIVENESS`	Über dem Maximalhelligkeits-Schwellenwert (Standard: 80): Keine Aktion / Prüfung (Standard) / Ablehnung. Nur bei passiver Liveness.
`MULTIPLE_FACES_DETECTED`	`LIVENESS`	Keine Aktion (Standard) / Prüfung / Ablehnung, wenn mehr als ein Gesicht erfasst wird. Nur bei passiver Liveness.
`DUPLICATED_FACE` / `POSSIBLE_DUPLICATED_FACE`	`LIVENESS`	Eine gemeinsame Aktion für doppelte Gesichter: Keine Aktion (Standard) / Prüfung / Ablehnung bei Übereinstimmungen mit genehmigten oder importierten Gesichtern anderer Benutzer.
`DUPLICATED_FACE_NAME_MISMATCH`	`LIVENESS`	Eigene Aktion (`face_liveness_duplicated_face_name_mismatch_action`): Keine Aktion / Prüfung (Standard) / Ablehnung. Wird zusammen mit `DUPLICATED_FACE` ausgegeben, wenn die Identität der Sitzung, mit der der Abgleich erfolgt ist, nicht mit dem ermittelten Namen dieser Sitzung übereinstimmt – siehe Liveness-Warnungen.

POSSIBLE_FACE_IN_BLOCKLIST (LIVENESS) ist nicht konfigurierbar – ein Treffer in der Sperrliste mit geringerer Konfidenz wird immer zur Prüfung (log_type: "warning") weitergeleitet.

Wiederholungsversuche bei der Erfassung

Fehler, die ausschließlich auf behebbare Qualitätsrisiken bei der Erfassung zurückzuführen sind (niedriger Score, kein Gesicht, Qualität, Helligkeit, mehrere Gesichter – und geringe Ähnlichkeit beim Gesichtsabgleich), durchlaufen eine Wiederholungsschleife, bevor der Status endgültig feststeht: Der Benutzer erhält insgesamt bis zu face_liveness_max_attempts / face_match_max_attempts Versuche (Standard: 3, konfigurierbar von 2 bis 5 pro Workflow-Knoten). Wenn das Kontingent erschöpft ist, gilt der berechnete Status des letzten Versuchs, und LIVENESS_MAX_ATTEMPTS_EXCEEDED oder FACE_MATCH_MAX_ATTEMPTS_EXCEEDED wird als information protokolliert, um dies festzuhalten.

Liveness-Warnungen

Die API gibt exakt diese short_description- und long_description-Zeichenfolgen zurück:

`risk`	`short_description`	`long_description`
`LOW_LIVENESS_SCORE`	Niedriger Liveness-Wert	Die Liveness-Prüfung ergab einen niedrigen Wert, was auf die potenzielle Verwendung nicht-lebendiger Gesichtsdarstellungen oder minderwertige biometrische Daten hinweist.
`NO_FACE_DETECTED`	Kein Gesicht bei Liveness erkannt	Das System konnte bei der Liveness-Prüfung kein Gesicht erkennen, was an schlechter Bildqualität, falscher Positionierung oder technischen Problemen liegen kann.
`LIVENESS_FACE_ATTACK`	Liveness-Gesichtsangriff	Das System hat einen potenziellen Versuch erkannt, die Liveness-Prüfung zu umgehen.
`FACE_IN_BLOCKLIST`	Gesicht auf der Sperrliste	Das System hat ein Gesicht auf der Sperrliste identifiziert, was bedeutet, dass das Gesicht nicht verifiziert werden darf.
`POSSIBLE_FACE_IN_BLOCKLIST`	Mögliches Gesicht auf der Sperrliste	Das System hat ein mögliches Gesicht auf der Sperrliste identifiziert, was bedeutet, dass das Gesicht nicht verifiziert werden darf.
`FACE_IN_ALLOWLIST`	Gesicht auf Positivliste	Das Gesicht stimmte mit der Gesichts-Positivliste der Anwendung überein, daher wurden Aktionen für doppelte Gesichter für dieses Signal übersprungen.
`POSSIBLE_FACE_IN_ALLOWLIST`	Mögliches Gesicht auf Positivliste	Das Gesicht stimmte möglicherweise mit der Gesichts-Positivliste der Anwendung überein, daher wurden Aktionen für mögliche doppelte Gesichter für dieses Signal übersprungen.
`DUPLICATED_FACE`	Doppeltes Gesicht aus anderer genehmigter Sitzung	Das System hat ein doppeltes Gesicht aus einer anderen genehmigten Sitzung identifiziert, was eine weitere Untersuchung erfordert.
`POSSIBLE_DUPLICATED_FACE`	Mögliches doppeltes Gesicht aus anderer genehmigter Sitzung	Das System hat ein mögliches doppeltes Gesicht aus einer anderen genehmigten Sitzung identifiziert, was eine weitere Untersuchung erfordert.
`DUPLICATED_FACE_NAME_MISMATCH`	Doppeltes Gesicht unter anderem Namen	Dasselbe Gesicht wurde bereits in einer anderen Sitzung genehmigt, jedoch unter einem anderen Namen. Die Identität hinter dem Duplikat stimmt nicht mit der für diese Sitzung angegebenen Identität überein, was ein starker Hinweis auf Identitätsbetrug ist.
`MULTIPLE_FACES_DETECTED` (nur passiv)	Mehrere Gesichter erkannt	Im Liveness-Bild wurden mehrere Gesichter erkannt. Das System verwendet das größte Gesicht für die Liveness-Verifizierung und den Gesichtsvergleich, das Vorhandensein mehrerer Gesichter erfordert jedoch möglicherweise eine zusätzliche Prüfung.
`LOW_FACE_QUALITY` (nur passiv)	Geringe Gesichtsqualität	Die Qualität des Gesichtsbildes liegt unter dem akzeptablen Schwellenwert, was die Zuverlässigkeit der Liveness-Erkennung beeinträchtigen kann. Dies kann an der Kameraauflösung, dem Fokus oder Kompressionsartefakten liegen.
`LOW_FACE_LUMINANCE` (nur passiv)	Geringe Gesichtshelligkeit	Das Gesichtsbild ist zu dunkel, was die Genauigkeit der Liveness-Erkennung beeinträchtigen kann. Bessere Lichtverhältnisse werden empfohlen.
`HIGH_FACE_LUMINANCE` (nur passiv)	Hohe Gesichtshelligkeit	Das Gesichtsbild ist zu hell oder überbelichtet, was die Genauigkeit der Liveness-Erkennung beeinträchtigen kann. Eine reduzierte Beleuchtung oder das Vermeiden von direktem Licht wird empfohlen.
`LIVENESS_MAX_ATTEMPTS_EXCEEDED`	Maximale Liveness-Versuche überschritten	Die maximale Anzahl von Liveness-Erfassungsversuchen wurde erreicht. Der berechnete Status des letzten Versuchs (Ablehnung oder Prüfung) wurde angewendet.

Übereinstimmungen mit Sperrlisten, Positivlisten und Duplikaten enthalten additional_data mit der übereinstimmenden Sitzung (blocklisted_session_id / allowlisted_session_id / duplicated_session_id, der entsprechenden *_session_number und api_service). Nur einer dieser sechs Codes erscheint pro Bericht. DUPLICATED_FACE_NAME_MISMATCH ist die Ausnahme: Er wird zusätzlich zu DUPLICATED_FACE ausgegeben, niemals stattdessen, wenn die Identität der übereinstimmenden Sitzung nicht mit dem aufgelösten Namen dieser Sitzung übereinstimmt. Seine additional_data ergänzen dieselben Felder der Duplikatsitzung um name_match_score. Ein Name, der auf beiden Seiten in einem unterschiedlichen Schriftsystem geschrieben ist, wird nicht als Abweichung gewertet, wenn die Ausweisdokumente beider Sitzungen denselben ausstellenden Staat, eine exakt übereinstimmende Dokumenten- oder persönliche Nummer und ein nicht widersprüchliches Geburtsdatum aufweisen. Siehe Liveness-Warnungen.

Warnungen zum Gesichtsabgleich

`risk`	`short_description`	`long_description`
`LOW_FACE_MATCH_SIMILARITY`	Geringe Ähnlichkeit beim Gesichtsabgleich	Die Gesichtszüge des bereitgestellten Bildes stimmen nicht ausreichend mit dem Referenzbild überein, was auf eine potenzielle Nichtübereinstimmung der Identität hindeutet.
`NO_REFERENCE_IMAGE`	Kein Quellbild zur Durchführung des Gesichtsabgleichs gefunden	Ein Referenzbild für den Gesichtsvergleich fehlt, sodass das System den Prozess des Gesichtsabgleichs nicht abschließen kann.
`FACE_MATCH_MAX_ATTEMPTS_EXCEEDED`	Maximale Anzahl von Gesichtsabgleichversuchen überschritten	Die maximale Anzahl von Erfassungsversuchen für den Gesichtsabgleich wurde erreicht. Der berechnete Status des letzten Versuchs (Ablehnung oder Prüfung) wurde angewendet.

Beispiel – abgelehnt wegen Gesichtsangriff

{
  "liveness_checks": [
    {
      "node_id": "feature_liveness",
      "status": "Declined",
      "method": "ACTIVE_3D",
      "score": 12.40,
      "reference_image": "https://<media-host>/.../reference.jpg",
      "video_url": "https://<media-host>/.../video.mp4",
      "age_estimation": null,
      "matches": [],
      "face_quality": null,
      "face_luminance": null,
      "warnings": [
        {
          "feature": "LIVENESS",
          "risk": "LIVENESS_FACE_ATTACK",
          "additional_data": null,
          "log_type": "error",
          "short_description": "Liveness Face Attack",
          "long_description": "The system detected a potential attempt to bypass the liveness check.",
          "node_id": "feature_liveness"
        }
      ]
    }
  ],
  "face_matches": null
}

Beispiel – in Prüfung wegen geringer Ähnlichkeit

{
  "face_matches": [
    {
      "node_id": "feature_face_match",
      "status": "In Review",
      "score": 58.70,
      "source_image_session_id": "11111111-2222-3333-4444-555555555555",
      "source_image": "https://<media-host>/.../source.jpg",
      "target_image": "https://<media-host>/.../target.jpg",
      "warnings": [
        {
          "feature": "FACEMATCH",
          "risk": "LOW_FACE_MATCH_SIMILARITY",
          "additional_data": null,
          "log_type": "warning",
          "short_description": "Low face match similarity",
          "long_description": "The facial features of the provided image don't closely match the reference image, suggesting a potential identity mismatch.",
          "node_id": "feature_face_match"
        }
      ]
    }
  ]
}

Der Wert (58.70) liegt zwischen dem Schwellenwert für eine Ablehnung (Standard: 50) und dem Schwellenwert für eine Prüfung (Standard: 70), weshalb die Warnung log_type: "warning" enthält und der Status des Gesichtsabgleichs In Review lautet. In diesem Beispiel wurde die Warnung bei einer Sitzung ausgelöst, deren session_id 11111111-2222-3333-4444-555555555555 lautet – source_image_session_id enthält die ID der Sitzung selbst, da die Referenz aus dem bei der Sitzungserstellung gespeicherten Porträt stammte.

Warnungstypen

Jedem Risiko wird basierend auf der Konfiguration Ihrer Anwendung ein Warnungstyp zugewiesen. Warnungen unterteilen sich in drei Schweregradkategorien:

Bericht zur biometrischen Authentifizierung

Wo liveness_checks[] und face_matches[] in der V3-Entscheidung erscheinen.

Liveness-Warnungen

Vollständige Referenz zu Liveness-Warnungen einschließlich des Abgleichs doppelter Gesichter.

Warnungen zum Gesichtsabgleich

Vollständige Warnungsreferenz zum Gesichtsabgleich für 1:1-Vergleiche.

Authentifizierung

Verifizierung

Überwachung

Plattform

Biometrische Authentifizierung: Warnungen & Codes

Übersicht

Wo Warnungen angezeigt werden

Bedingungen für eine automatische Ablehnung

Konfigurierbare Schwellenwerte und Aktionen

Wiederholungsversuche bei der Erfassung

Liveness-Warnungen

Warnungen zum Gesichtsabgleich

Beispiel – abgelehnt wegen Gesichtsangriff

Beispiel – in Prüfung wegen geringer Ähnlichkeit

Warnungstypen

Verwandte Themen

Bericht zur biometrischen Authentifizierung

Liveness-Warnungen

Warnungen zum Gesichtsabgleich

​Übersicht

​Wo Warnungen angezeigt werden

​Bedingungen für eine automatische Ablehnung

​Konfigurierbare Schwellenwerte und Aktionen

​Wiederholungsversuche bei der Erfassung

​Liveness-Warnungen

​Warnungen zum Gesichtsabgleich

​Beispiel – abgelehnt wegen Gesichtsangriff

​Beispiel – in Prüfung wegen geringer Ähnlichkeit

​Warnungstypen

​Verwandte Themen

Bericht zur biometrischen Authentifizierung

Liveness-Warnungen

Warnungen zum Gesichtsabgleich

Übersicht

Wo Warnungen angezeigt werden

Bedingungen für eine automatische Ablehnung

Konfigurierbare Schwellenwerte und Aktionen

Wiederholungsversuche bei der Erfassung

Liveness-Warnungen

Warnungen zum Gesichtsabgleich

Beispiel – abgelehnt wegen Gesichtsangriff

Beispiel – in Prüfung wegen geringer Ähnlichkeit

Warnungstypen

Verwandte Themen