Zum Hauptinhalt springen

Übersicht

Warnungen im Bericht zur Ausweisverifizierung kennzeichnen jeden Zustand, den Didit beim Lesen und Validieren des Dokuments festgestellt hat. Sie werden im Array warnings[] jedes Eintrags von id_verifications[] aufgeführt (siehe Bericht zur Ausweisverifizierung), mit der in Datenmodelle — Warnungsobjekt beschriebenen Struktur: feature, risk, additional_data, log_type, short_description, long_description, node_id. Jede Warnung besteht aus drei Ebenen:
  1. Der risk-Code – eine stabile Kennung, die Sie in Ihrem Code abgleichen können.
  2. Der log_type – abgeleitet von der Aktion, die Ihre Konfiguration dem Risiko zum Auswertungszeitpunkt zuweist: Ablehnen → error, Überprüfung → warning, alles andere → information.
  3. Die Auswirkung auf die Entscheidung – festgelegt durch die konfigurierbaren Risikogruppen des Workflows. Derselbe risk-Code kann abhängig von der Konfiguration Ihrer Anwendung zu Genehmigen, Überprüfung oder Ablehnen führen.

Bedingungen für die automatische Ablehnung

In Workflows führen die folgenden Risiken immer dazu, dass der Ausweisbericht (und die Sitzung) auf Declined gesetzt wird. Sie können nicht konfiguriert werden: Für die eigenständige OCR-API umfasst die Gruppe der bedingungslosen Ablehnungen DOCUMENT_EXPIRED, MINIMUM_AGE_NOT_MET, PORTRAIT_IMAGE_NOT_DETECTED, SCREEN_CAPTURE_DETECTED, PRINTED_COPY_DETECTED, PORTRAIT_MANIPULATION_DETECTED und PUBLIC_DOCUMENT_IMAGE_DETECTED. In Workflows ist das Mindestalter konfigurierbar (Standard: Ablehnen) und die drei Risiken der Dokument-Liveness sind schwellenwertbasiert (siehe unten). Die konfigurierbaren Risiken dieser API akzeptieren als Anfrageparameter DECLINE oder NO_ACTION anstelle eines Überprüfungsergebnisses. Das einzige Überprüfungsergebnis, das sie zurückgeben kann, ist nicht konfigurierbar: Wenn eine angeforderte Dokument-Liveness-Prüfung keinen verwertbaren Wert liefert, lautet die Antwort In Review mit einer DOCUMENT_LIVENESS_NOT_COMPUTED-Warnung (siehe Dokument-Liveness).

Konfigurierbare Verifizierungseinstellungen

In der Didit-Konsole sind die verbleibenden Ausweisrisiken in Einstellungen gruppiert, die Sie auf Genehmigen, Überprüfung oder Ablehnen leiten können (pro Workflow und pro Knoten in Graph-Workflows): Die Risiken bezüglich Duplikaten und Sperrlisten bei stiller Aufnahme stammen aus der Gesichtssuche auf dem während der Dokumentenerfassung aufgenommenen Selfie. Die Suche wird ausgeführt, solange Gesichtssuche bei stiller Aufnahme (document_selfie_face_search_enabled) aktiviert ist (was der Standard ist) und die Gesichtssuche im Liveness-Schritt nicht deaktiviert ist; andernfalls wird keines dieser sechs Risiken ausgelöst. Zwei Familien von Ausweisrisiken werden über Schwellenwerte statt über Auswahlschalter für Genehmigen/Überprüfung/Ablehnen gesteuert:
  • Dokument-Liveness-Erkennung – SCREEN_CAPTURE_DETECTED, PRINTED_COPY_DETECTED, PORTRAIT_MANIPULATION_DETECTED. Jede Betrugsart hat ihre eigenen Ablehnungs- und Überprüfungsschwellenwerte: Wert unter dem Ablehnungsschwellenwert → error + Abgelehnt; unter dem Überprüfungsschwellenwert → warning + In Prüfung; andernfalls information.
  • Kameraübergreifender Gesichtsabgleich – LOW_FRONT_CAMERA_FACE_MATCH_SIMILARITY, gesteuert über document_selfie_portrait_match_decline_threshold / document_selfie_portrait_match_review_threshold.

Schwellenwerte für die Dokument-Liveness-Erkennung konfigurieren

Im Workflow-Editor befinden sich diese Schwellenwerte auf dem Tab Fälschung des Ausweisverifizierungsschritts, mit einer Karte pro Betrugsart: Porträt-Ersetzung, Ausgedruckte Kopie und Bildschirmaufnahme. Jede Prüfung vergibt für das Dokument einen Wert von 0 bis 100 dafür, wie echt es wirkt. Ein höherer Wert bedeutet, dass das Dokument mit höherer Wahrscheinlichkeit echt ist. Die beiden Werte auf einer Karte unterteilen diese Skala in drei Bereiche: Das Erhöhen eines der beiden Werte macht die Prüfung strenger: Mehr Sitzungen landen im Bereich darüber. Das Senken eines Werts lässt mehr Sitzungen passieren. Im Editor kann der Wert für Ablehnen nicht über den Wert für Überprüfung hinaus verschoben werden. Über die API entfernt ein Wert für Ablehnen über dem Wert für Überprüfung den Bereich „In Prüfung“. Plattformstandards, die verwendet werden, wenn ein Workflow keinen Wert festlegt: Gehen Sie von den Standardwerten aus und ändern Sie immer nur einen Wert. Jede Karte zeigt ihren Standardwert und eine Schaltfläche Auf Standard zurücksetzen, sodass Sie jederzeit dorthin zurückkehren können. Der Editor warnt Sie außerdem vor folgenden Konfigurationen:
  • Überprüfung bei 100. Nur ein perfekter Wert besteht die Prüfung, sodass fast jede Sitzung in Prüfung geht oder abgelehnt wird.
  • Ablehnen bei 100. Nur ein perfekter Wert verhindert eine Ablehnung, sodass fast jede Sitzung abgelehnt wird.
  • Beide Werte bei 0. Kein Wert wird jemals markiert, sodass die Prüfung praktisch deaktiviert ist.
Das Setzen beider Werte auf dieselbe Zahl entfernt den Bereich „In Prüfung“: Ein Wert darunter wird abgelehnt und jeder andere Wert besteht die Prüfung. Wenn sowohl Ausgedruckte Kopie als auch Bildschirmaufnahme dasselbe Dokument markieren würden, wird nur SCREEN_CAPTURE_DETECTED gemeldet. Der kameraübergreifende Gesichtsabgleich folgt demselben Prinzip mit einem Unterschied an der Grenze: Ein Wert, der genau dem Überprüfungsschwellenwert entspricht, geht weiterhin in die Prüfung. Vier Ausweisrisiken sind weder konfigurierbar noch schwellenwertbasiert. POSSIBLE_FRONT_CAMERA_FACE_IN_BLOCKLIST leitet immer zur Überprüfung weiter: Ein Selfie, das einem Gesicht auf der Sperrliste ähnelt, ohne eine bestätigte Übereinstimmung zu sein, muss von einer Person beurteilt werden – es wird niemals automatisch abgelehnt und niemals ignoriert. BARCODE_SIGNATURE_INVALID leitet immer zur Überprüfung weiter. Dies wird nur ausgelöst, wenn ein Barcode eine Signatur der Ausstellungsbehörde enthält, die die kryptografische Prüfung nicht besteht, sodass es keine Konfiguration gibt, bei der eine nachgewiesene Fälschung ignoriert wird. DOCUMENT_BACK_SIDE_NOT_AVAILABLE ist immer Information und beeinflusst niemals die Entscheidung: Es meldet eine Einschränkung des Dokumentenkatalogs von Didit, keine Eigenschaft des vorgelegten Dokuments, sodass es keine Konfiguration gibt, in der ein rechtmäßiger Inhaber abgelehnt oder zur Überprüfung weitergeleitet werden kann. FRONT_CAMERA_CAPTURED_DOCUMENT leitet immer zur Überprüfung weiter. Dies wird nur ausgelöst, wenn das Frontkamera-Einzelbild, das während des Scannens des Dokuments aufgenommen wurde, ein Ausweisdokument und keine Person zeigt, sodass eine Erfassung, die nichts darüber aussagt, wer das Dokument gehalten hat, immer von einem Menschen geprüft wird. Dies wird immer dann geprüft, wenn der Selfie-Abgleich bei der Dokumentenerfassung (is_document_selfie_portrait_match_enabled) aktiviert ist.

Erzeugte Warnungen

Verifiziert anhand von collect_ocr_logs, dem Dokumentenerfassungs-Flow und process_ocr_logs_and_get_status. Die kurzen Beschreibungen unten sind die exakten short_description-Strings, die von der API zurückgegeben werden.

Dokumenterkennung und -qualität

Der Erfassungs-Flow kann einen Upload auch mit den Feedback-Codes IMAGE_RESOLUTION_TOO_LOW, DOCUMENT_NOT_FULLY_VISIBLE, IMAGE_QUALITY_TOO_LOW und DOCUMENT_OCCLUSION_DETECTED (ein Finger oder Objekt verdeckt nach Beurteilung physisch gedruckten Text) ablehnen. Jeder dieser Codes fordert im SDK zu einer erneuten Aufnahme auf und wird im Bericht als eigenes Risiko erfasst, gesteuert über die Image-Quality-Einstellungen — DOCUMENT_OCCLUSION_DETECTED und IMAGE_QUALITY_TOO_LOW teilen sich dieselbe Aktion. Sie beschreiben die Erfassung: Eine erfolgreiche erneute Aufnahme löscht die Warnung. Ob ein verdecktes Feld die Entscheidung beeinflussen soll, regelt das separate, integritätsbezogene CRITICAL_FIELD_OCCLUSION_DETECTED weiter unten, das zum Entscheidungszeitpunkt ausgelöst wird und standardmäßig auf Review gesetzt ist.
Wenn Ihr Workflow die Identität über den Gesichtsabgleich statt über das Dokumentenporträt absichert, sollten Sie erwägen, Document Without Portrait auf Decline zu leiten — andernfalls erreicht eine porträtlose Dokumentenfamilie den Gesichtsabgleich ohne Vergleichsmöglichkeit.

Feldextraktion

MRZ, QR, Barcode

Alle drei MRZ-Risiken werden bei Dokumenttypen mit bekanntermaßen unzuverlässiger MRZ übersprungen.
Die Barcode-Signaturprüfung umfasst derzeit französische Personalausweise, deren ANTS-2D-Doc-Barcode von der Ausstellungsbehörde signiert ist. BARCODE_SIGNATURE_INVALID wird nur ausgelöst, wenn die Signaturprüfung selbst die Payload zurückweist. Ein Barcode ohne Signatur, ein Barcode, der von einer noch nicht im Vertrauensspeicher von Didit enthaltenen Behörde signiert wurde, oder ein Barcode, dessen Signatur nicht decodiert werden kann, wird als nicht authentifizierte Daten behandelt und wie bisher mit der MRZ und dem gedruckten Text abgeglichen, ohne dass dieses Risiko ausgelöst wird.Barcodes auf US-amerikanischen und kanadischen Führerscheinen (AAMVA) werden nicht kryptografisch verifiziert: Die digitale Signierung ist dort optional und je nach Bundesstaat bzw. Rechtsordnung unterschiedlich, und keine Rechtsordnung veröffentlicht Verifizierungsschlüssel. Didit erkennt und protokolliert daher lediglich, ob eine Payload eine Signatur enthält; die Signatur selbst wird nie geprüft. Fehlgeschlagene AAMVA-Signaturen stellen derzeit kein Risikosignal dar. Eine manipulierte AAMVA-Payload tritt nur als BARCODE_VALIDATION_FAILED zutage, und auch nur dann, wenn die Manipulation dazu führt, dass der Barcode nicht mit der MRZ oder den gedruckten/OCR-Daten übereinstimmt – eine gefälschte Signatur auf einer ansonsten intern konsistenten Payload wird ohne jegliches Signal akzeptiert.Der Benutzer wird bei BARCODE_SIGNATURE_INVALID niemals zu einer erneuten Aufnahme aufgefordert: Eine Signatur, die nicht zur Payload passt, lässt sich nicht durch ein besseres Foto beheben.

Identitätsabgleich

Dokumenten-Liveness (Manipulation)

Schwellenwertbasiert pro Betrugstyp in Workflows. Bei der eigenständigen OCR-API führen diese drei Risiken bedingungslos zu einer Ablehnung, und eine angeforderte Prüfung, die keinen verwertbaren Score liefert, gibt In Review statt einer Genehmigung zurück. Die Scores selbst sind in jedem V3-Bericht unter document_liveness enthalten, auch wenn keine Warnung ausgelöst wurde, sodass ein genehmigtes Dokument dennoch auditiert werden kann.

Integrität des Erfassungskanals

Der log_type spiegelt die konfigurierte Aktion wider: error für Ablehnen, warning für Prüfung, information für Keine Aktion. Empfohlene Aktion: Behandeln Sie eine abgelehnte Sitzung als eingeschleuste Aufnahme und fordern Sie die Person auf, den Vorgang auf einem physischen Gerät mit integrierter Kamera zu wiederholen. Signale, die eine echte Person erzeugen kann, lösen niemals INJECTION_ATTACK_DETECTED aus und bleiben rein informativ. Apps, die das Bild einer echten Kamera weiterleiten, wie beispielsweise ein als Webcam genutztes Smartphone oder eine Effektebene über einer echten Webcam, werden nicht als Injection-Angriffe gemeldet. Hierbei handelt es sich um die Erkennung von Injection-Angriffen, die von der Erkennung von Präsentationsangriffen (eine einer echten Kamera vorgehaltene Fälschung) getrennt ist.

Bekannte öffentliche Dokumentenbilder

Abweichungen bei erwarteten Angaben

Wenn Sie expected_details an eine Sitzung übergeben, gibt Didit für jedes nicht übereinstimmende Feld eine Abweichungswarnung aus. Eine Gruppierung (expected_details_mismatch_action, Standard: Prüfung) steuert das Routing für all diese Warnungen: Jede Abweichungswarnung enthält die erwarteten und extrahierten Werte in additional_data.

Alter

Adresse

Sitzungsübergreifende Dokumentenübereinstimmungen

Zusätzlich zu den oben genannten Warnungen liefert der V3-ID-Bericht ein matches[]-Array – bis zu 5 andere Dokumente in Ihrer Anwendung mit demselben Geburtsdatum, demselben Ausstellungsland und einem sehr ähnlichen vollständigen Namen (bei Dokumenten auf der Sperrliste ist zusätzlich eine exakte Übereinstimmung der Dokumentennummer erforderlich), ausgenommen Sitzungen, die demselben Benutzer gehören. Dokumente, die zu Ihrer Sperrliste hinzugefügt wurden, erscheinen mit is_blocklisted: true. Dokumente auf Ihrer Positivliste erscheinen weiterhin in den Übereinstimmungen, aber die Aktion für Benutzerduplikate wird übersprungen. Jede Übereinstimmung enthält session_id, session_number, vendor_data, verification_date, user_details (name, document_type, document_number), status, is_blocklisted, api_service und eine signierte front_image_url.

Beispiele

Konfigurierbare Warnung beim Standard-Routing (Information)

Automatische Ablehnung bei abgelaufenem Dokument

Abweichung bei erwarteten Angaben mit Payload

Warnungstypen

Jedem Risiko wird basierend auf der Konfiguration Ihrer Anwendung ein Schweregrad zugewiesen. Die drei Schweregrade sind:

Verwandte Themen

Zuletzt geändert am 7. November 2026