> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Biometrische Authentifizierung: Warnungen & Codes > Behandeln Sie Warnungen der biometrischen Authentifizierung in Didit: LOW_LIVENESS_SCORE, Angriffe, Sperrlisten und Schwellenwerte. 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](https://docs.didit.me/de/reference/data-models.md#warnungsobjekt): `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](https://docs.didit.me/de/core-technology/liveness/warnings-liveness.md#sitzungsübergreifender-gesichtsabgleich). | `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](https://docs.didit.me/de/core-technology/liveness/warnings-liveness.md#sitzungsübergreifender-gesichtsabgleich). ## 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 ```json theme={null} { "liveness_checks": [ { "node_id": "feature_liveness", "status": "Declined", "method": "ACTIVE_3D", "score": 12.40, "reference_image": "https:///.../reference.jpg", "video_url": "https:///.../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 ```json theme={null} { "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:///.../source.jpg", "target_image": "https:///.../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: ## Verwandte Themen > [card] [Bericht zur biometrischen Authentifizierung](https://docs.didit.me/de/core-technology/biometric-auth/report-biometric-authentication.md) > > Wo `liveness_checks[]` und `face_matches[]` in der V3-Entscheidung erscheinen. > [card] [Liveness-Warnungen](https://docs.didit.me/de/core-technology/liveness/warnings-liveness.md) > > Vollständige Referenz zu Liveness-Warnungen einschließlich des Abgleichs doppelter Gesichter. > [card] [Warnungen zum Gesichtsabgleich](https://docs.didit.me/de/core-technology/face-match/warnings-face-match.md) > > Vollständige Warnungsreferenz zum Gesichtsabgleich für 1:1-Vergleiche. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.