> ## 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. # NFC-Verifizierung: Warnungen & Fehlercodes > Alle Warnungen des Didit-NFC-Moduls zu Chip-Auslesung, OCR-Abweichungen und Zertifikaten mit Ursache, Schweregrad und Lösung. ## Overview Warnungen im NFC-Bericht kennzeichnen jeden Zustand, den Didit beim Auslesen und Validieren des Chips festgestellt hat. Sie werden im Array `warnings[]` jedes Elements in `nfc_verifications[]` aufgeführt (siehe [NFC-Bericht](https://docs.didit.me/de/core-technology/nfc-verification/report-nfc-verification.md)), wobei `feature` auf `"NFC"` gesetzt ist. Jeder Eintrag folgt dem gemeinsamen Aufbau des [Warnungsobjekts](https://docs.didit.me/de/reference/data-models.md#warnungsobjekt): `feature`, `risk`, `additional_data`, `log_type`, `short_description`, `long_description`, `node_id`. Jede Warnung hat drei Ebenen: 1. **Der `risk`-Code** – eine stabile Kennung, die Sie in Ihrem Code abgleichen können (die unten aufgeführten Codes). 2. **Der `log_type`** – entweder `information`, `warning` oder `error`. Er wird aus der Aktion abgeleitet, die Ihr Workflow für dieses Risiko konfiguriert: **Keine Aktion** → `information`, **Überprüfung** → `warning`, **Ablehnen** → `error`. 3. **Die Auswirkung auf die Entscheidung** – dieselbe konfigurierte Aktion steuert auch den `status` des NFC-Berichts: Eine Aktion vom Typ „Überprüfung“ setzt ihn auf `In Review`, eine Aktion vom Typ „Ablehnen“ auf `Declined`. Vier NFC-Risiken sind auf diese Weise konfigurierbar (`SKIPPED_NFC_VALIDATION`, `NFC_CHIP_NOT_VERIFIED`, `NFC_TRUST_ANCHOR_MISSING`, `NFC_AND_OCR_DATA_NOT_SAME`), zuzüglich der fünf [Japan My Number Card](#japan-my-number-card-jpki)-Risiken mit jeweils eigener Einstellung. Die beiden Zertifikatsrisiken (`DSC_CERTIFICATE_REVOKED`, `DSC_CERTIFICATE_EXPIRED`) sind **ausschließlich informativ**: Sie weisen stets `log_type: "information"` auf und ändern den NFC-Status niemals von sich aus. Die vollständige Liste der Risikocodes, die das NFC-Modul erzeugt, finden Sie unten. Es existieren keine weiteren NFC-Risikocodes. ## Erzeugte Warnungen | `risk` | Ursache | Schweregrad (`log_type`) | Beeinflusst Status? | Fehlerbehebung | | - | - | - | - | - | | `SKIPPED_NFC_VALIDATION` | Das Auslesen des Chips wurde übersprungen — der Workflow erlaubt das Überspringen (`allow_nfc_skip`) und der Benutzer hat auf Überspringen getippt, oder der Client hat den Schritt übersprungen, weil er kein NFC lesen konnte. Der genaue Grund wird in `additional_data.skip_reason` erfasst (siehe [Gründe für das Überspringen](#gründe-für-das-überspringen)) und bestimmt die `long_description` der Warnung. | Folgt der Einstellung für die **Aktion bei NFC-Überspringen** (`skip_nfc_action`): information / warning / error. | Konfigurierbar — Keine Aktion, Prüfung oder Ablehnen. | Wenn Ihre Richtlinie NFC erfordert, setzen Sie die Aktion bei Überspringen auf Ablehnen (oder deaktivieren Sie das Überspringen vollständig) und fordern Sie den Benutzer auf, es mit einem NFC-fähigen Gerät erneut zu versuchen. Belassen Sie es andernfalls bei Keine Aktion, um auf die reine OCR-Verifizierung zurückzugreifen. | | `NFC_CHIP_NOT_VERIFIED` | Der Chip wurde ausgelesen, schlug jedoch bei der kryptografischen Verifizierung aus einem anderen Grund als einem explizit identifizierten fehlenden Vertrauensanker fehl. Ein Hash einer Data Group, die SOD-Signatur oder eine andere Prüfung der passiven Authentifizierung konnte nicht verifiziert werden. | Folgt der Einstellung für die **Aktion bei nicht verifiziertem Chip** (`unverified_chip_action`). | Konfigurierbar — Keine Aktion, Prüfung oder Ablehnen. | Behandeln Sie dies als potenziell ungültigen oder manipulierten Chip. Prüfen Sie `authenticity` und `certificate_summary.validation`, um zu sehen, welche Prüfung fehlgeschlagen ist. | | `NFC_TRUST_ANCHOR_MISSING` | Das Document Signer Certificate (DSC) des Chips gehört zu einer Generation der Country Signing Certification Authority (CSCA), die im Didit-Trust-Store nicht verfügbar ist (`certificate_summary.validation.csca_missing` ist `true`). Didit kann daher die Vertrauenskette des SOD nicht herstellen. | Folgt der Einstellung für die **Aktion bei nicht verifiziertem Chip** (`unverified_chip_action`). | Konfigurierbar — Keine Aktion, Prüfung oder Ablehnen. | Dies ist eine Abdeckungslücke im Trust-Store und kein Beleg dafür, dass der Chip manipuliert wurde. Prüfen Sie das Dokument über Ihre Fallback-Prüfungen und kontaktieren Sie den Didit-Support unter Angabe des Ausstellungslandes, damit die fehlende CSCA untersucht werden kann. | | `NFC_AND_OCR_DATA_NOT_SAME` | Die vom Chip ausgelesene MRZ stimmt nicht mit der MRZ überein, die per OCR von der sichtbaren Seite des Dokuments erfasst wurde (Vergleich nach Normalisierung unter Ignorieren von `<`-Füllzeichen). Starkes Manipulationssignal. | Folgt der Einstellung für die **Aktion bei Dateninkonsistenz** (`inconsistent_data_action`) — dieselbe Einstellung, die auch für die Datenkonsistenzprüfungen der Ausweisverifizierung gilt. | Konfigurierbar — Keine Aktion, Prüfung oder Ablehnen. | Bis zum Beweis des Gegenteils als Manipulation behandeln; Ablehnen ist die typische Einstellung. Die `additional_data`-Payload enthält die OCR-MRZ-Zeilen (`ocr_mrz`, Array) und die Chip-MRZ (`nfc_mrz`, einzelner String) für den manuellen Vergleich. | | `DSC_CERTIFICATE_REVOKED` | Das Document Signer Certificate, das diesen Chip signiert hat, ist in der Certificate Revocation List (CRL) des Ausstellungslandes aufgeführt. | Immer `information`. | Nein — ändert den NFC-Status für sich genommen nie. | Starkes Signal, dass der Signaturschlüssel kompromittiert worden sein könnte; leiten Sie diese Sitzungen bei Bedarf über Ihre eigene Logik in die manuelle Prüfung weiter. Beachten Sie, dass der Chip normalerweise auch `NFC_CHIP_NOT_VERIFIED` auslöst, was konfigurierbar ist. | | `DSC_CERTIFICATE_EXPIRED` | Das Gültigkeitsfenster des DSC ist abgelaufen (`certificate_summary.validation.dsc_expired` ist `true`). | Immer `information`. | Nein — ändert den NFC-Status für sich genommen nie. | Häufig bei älteren Dokumenten. Wie beim Widerruf schlägt bei einem abgelaufenen DSC auch die vollständige SOD-Validierung fehl, sodass `NFC_CHIP_NOT_VERIFIED` daneben ausgelöst wird und dafür Ihre konfigurierte Aktion gilt. | | `JPKI_CERTIFICATE_INVALID` | Japan My Number Card: Ein von der Karte ausgelesenes Zertifikat lässt sich nicht auf die JPKI-Zertifizierungsstelle seines Typs zurückführen, liegt außerhalb seiner Gültigkeitsdauer oder ist kein My-Number-Card-Zertifikat dieses Typs. `additional_data.certificate_types` listet die fehlgeschlagenen Zertifikate auf; `jpki.certificates[].failure` gibt den Grund an. | Folgt `jpki_certificate_invalid_action` (Standard: Ablehnen). | Konfigurierbar: Keine Aktion, Prüfung oder Ablehnen. | Als ungültige oder manipulierte Karte behandeln. Ein abgelaufenes Kartenzertifikat fällt ebenfalls hierunter: Der Inhaber erneuert es bei seiner Gemeindeverwaltung. | | `JPKI_SIGNATURE_INVALID` | Japan My Number Card: Die Signatur der Karte über die einmalige Challenge lässt sich anhand ihres Zertifikats nicht verifizieren, sodass der Besitz der Karte und die Kenntnis ihrer PIN nicht nachgewiesen sind. Wird auch ausgelöst, wenn der NFC-Schritt beendet wurde, ohne dass eine Karte ausgelesen wurde (`additional_data.certificate_types` ist dann leer). | Folgt `jpki_signature_invalid_action` (Standard: Ablehnen). | Konfigurierbar: Keine Aktion, Prüfung oder Ablehnen. | Den Kartenauslesevorgang nicht als Nachweis akzeptieren. Bitten Sie die Person, es mit der physischen Karte erneut zu versuchen. | | `JPKI_CERTIFICATE_REVOKED` | Japan My Number Card: Die Widerrufsprüfung meldet ein Zertifikat als widerrufen, beispielsweise weil die Karte als verloren gemeldet wurde oder sich die Registrierungsdaten des Inhabers geändert haben (`jpki.revocation_status` ist `revoked`). | Folgt `jpki_certificate_revoked_action` (Standard: Ablehnen). | Konfigurierbar: Keine Aktion, Prüfung oder Ablehnen. | Die Karte nicht akzeptieren. | | `JPKI_REVOCATION_UNCHECKED` | Japan My Number Card: Die Zertifikate und die Signatur wurden verifiziert, es war jedoch keine Widerrufsantwort verfügbar (`jpki.revocation_status` ist `unchecked`), sodass eine widerrufene Karte nicht ausgeschlossen werden kann. Wird nicht ausgelöst, wenn die Zertifikatskette oder die Signatur bereits fehlgeschlagen sind. | Folgt `jpki_revocation_unchecked_action` (Standard: Prüfung). | Konfigurierbar: Keine Aktion, Prüfung oder Ablehnen. | Entscheiden Sie, welchen Stellenwert eine verifizierte Karte ohne Widerrufsantwort für Sie hat, und legen Sie die Aktion entsprechend fest. | | `JPKI_AND_OCR_DATA_NOT_SAME` | Japan My Number Card: Name, Geburtsdatum, Geschlecht oder Adresse im Signaturzertifikat weichen von den aus dem Foto derselben Karte ausgelesenen Daten ab. `additional_data.fields` nennt die abweichenden Attribute, niemals deren Werte. | Folgt `jpki_inconsistent_data_action` (Standard: Prüfung). | Konfigurierbar: Keine Aktion, Prüfung oder Ablehnen. | Vergleichen Sie `jpki.attributes` mit den Daten der Ausweisverifizierung, bevor Sie eine Entscheidung treffen. Ein Name mit einem seltenen Schriftzeichen kann abweichen, da das Zertifikat ein Ersatzzeichen enthält (`jpki.attributes.name_substitute_characters`). | > [!NOTE] > > `SKIPPED_NFC_VALIDATION` schließt `NFC_CHIP_NOT_VERIFIED` und `NFC_TRUST_ANCHOR_MISSING` gegenseitig aus: Warnungen zur Chip-Verifizierung werden nur ausgewertet, wenn das Auslesen des Chips nicht übersprungen wurde. Die beiden Warnungen zur Chip-Verifizierung schließen sich ebenfalls gegenseitig aus. ## Exakte Beschreibungs-Strings Die API gibt für jedes Risiko genau diese Strings für `short_description` und `long_description` zurück: | `risk` | `short_description` | `long_description` | | - | - | - | | `SKIPPED_NFC_VALIDATION` | Skipped NFC Validation | Reason-specific — see [Skip reasons](#gründe-für-das-überspringen). Falls back to "The Near Field Communication (NFC) chip validation process was not completed, potentially due to technical issues or lack of NFC support." on legacy sessions recorded before skip reasons existed. | | `NFC_CHIP_NOT_VERIFIED` | NFC chip not verified | The Near Field Communication (NFC) chip failed passive authentication for a reason other than an explicitly identified missing trust anchor. The chip data or signature could be invalid or altered. | | `NFC_TRUST_ANCHOR_MISSING` | NFC trust anchor unavailable | The Near Field Communication (NFC) chip could not be verified because the issuing country's Country Signing Certification Authority (CSCA) trust anchor is not available. This is a trust-store coverage gap, not evidence that the chip was altered. | | `NFC_AND_OCR_DATA_NOT_SAME` | NFC and OCR data not same | The Near Field Communication (NFC) chip data and the OCR data don't match, indicating potential document tampering or data inconsistency. | | `DSC_CERTIFICATE_REVOKED` | Document Signer Certificate revoked | The Document Signer Certificate (DSC) used to sign the ePassport chip data has been revoked by the issuing country's Certificate Revocation List (CRL), indicating the signing key may have been compromised. | | `DSC_CERTIFICATE_EXPIRED` | Document Signer Certificate expired | The Document Signer Certificate (DSC) used to sign the ePassport chip data has expired, meaning the certificate's validity period has passed. | | `JPKI_CERTIFICATE_INVALID` | My Number Card certificate not valid | A certificate read from the My Number Card chip is not valid: it does not chain to the Japanese public key infrastructure (JPKI) certification authority, it is outside its validity period, or it is not a My Number Card certificate of the requested type. | | `JPKI_SIGNATURE_INVALID` | My Number Card signature not valid | The signature the My Number Card made over the one-time verification challenge does not verify against the card's certificate, so possession of the card and knowledge of its PIN are not proven. | | `JPKI_CERTIFICATE_REVOKED` | My Number Card certificate revoked | The revocation check reports that a certificate read from the My Number Card has been revoked, for example because the card was reported lost or the holder's registration changed. | | `JPKI_REVOCATION_UNCHECKED` | My Number Card revocation status not checked | The certificate and signature of the My Number Card were verified, but its revocation status could not be checked, so a revoked card cannot be ruled out. | | `JPKI_AND_OCR_DATA_NOT_SAME` | My Number Card chip and OCR data not same | The name, date of birth, sex or address in the My Number Card's signature certificate does not match the data read from the card's image (OCR), indicating a possible substitution or data inconsistency. | ## Gründe für das Überspringen `SKIPPED_NFC_VALIDATION`-Warnungen enthalten `additional_data.skip_reason`, einen von sieben stabilen Codes, der genau angibt, warum NFC nicht ausgeführt wurde (bei Sitzungen, die vor der Einführung von Gründen für das Überspringen aufgezeichnet wurden, kann `additional_data` den Wert `null` haben – behandeln Sie das Feld bei der Verarbeitung historischer Entscheidungen als optional). Dieselbe Taxonomie erscheint auf Sitzungsebene als `nfc_skip_reason` im Entscheidungs-Payload – einschließlich bei Sitzungen, bei denen NFC überhaupt nicht ausgeführt werden konnte (chiploses Dokument, Web-Integration) und daher kein NFC-Bericht oder keine Warnung existiert. | `skip_reason` | Bedeutung | `long_description` | | - | - | - | | `USER_SKIPPED` | NFC wurde auf einem kompatiblen Gerät angeboten und der Benutzer hat sich für das Überspringen entschieden. | Der Schritt zum Auslesen des NFC-Chips wurde auf einem kompatiblen Gerät angeboten, aber der Benutzer hat sich entschieden, ihn zu überspringen (das Überspringen ist durch die Workflow-Konfiguration zulässig). | | `DOCUMENT_WITHOUT_CHIP` | Das Dokumentendesign verfügt über keinen lesbaren NFC-Chip (kein elektronisches Dokument nach ICAO 9303). | Die NFC-Verifizierung konnte nicht durchgeführt werden, da dieses Dokument keinen lesbaren NFC-Chip enthält: Es handelt sich nicht um ein elektronisches Dokument nach ICAO 9303. | | `CHIP_CERTIFICATE_UNAVAILABLE` | Der Chip ist vorhanden, aber es ist kein Signaturzertifikat des Ausstellungslandes (CSCA) für den Ausstellungszeitraum des Dokuments verfügbar, sodass die Signatur nicht verifiziert werden kann. | Die NFC-Verifizierung konnte nicht durchgeführt werden, da das Signaturzertifikat des Ausstellungslandes (CSCA) für den Ausstellungszeitraum dieses Dokuments nicht verfügbar ist, sodass die Signatur des Chips nicht verifiziert werden kann. | | `DEVICE_WITHOUT_NFC` | Ein natives SDK hat gemeldet, dass das Smartphone über keinen verfügbaren NFC-Leser verfügt. | Die NFC-Verifizierung konnte nicht durchgeführt werden, da das Gerät des Benutzers gemeldet hat, dass kein NFC-Leser verfügbar ist. | | `INTEGRATION_WITHOUT_NFC_ACCESS` | Die Verifizierung wurde ohne ein natives SDK ausgeführt (beispielsweise in einem Webbrowser), das keinen Zugriff auf den NFC-Leser des Smartphones hat. | Die NFC-Verifizierung konnte nicht durchgeführt werden, da die Verifizierung nicht über ein natives mobiles SDK ausgeführt wurde und daher kein Zugriff auf den NFC-Leser des Smartphones bestand (Webbrowser können keine NFC-Chips lesen). | | `MRZ_KEY_UNAVAILABLE` | Der Chip-Zugangsschlüssel (BAC/PACE-Seed) konnte nicht aus der MRZ des Dokuments abgeleitet werden. | Die NFC-Verifizierung konnte nicht durchgeführt werden, da der Chip-Zugangsschlüssel nicht aus der maschinenlesbaren Zone (MRZ) des Dokuments abgeleitet werden konnte. | | `JPKI_UNAVAILABLE` | Bei dem Dokument handelt es sich um eine Japan My Number Card, deren Chip über JPKI ausgelesen wird, und JPKI war für diese Verifizierung nicht verfügbar: Es ist nicht aktiviert oder die native SDK-Version der App kann keine My Number Cards lesen. Eine in einem Browser verifizierte My Number Card erhält `INTEGRATION_WITHOUT_NFC_ACCESS`, und eine auf einem Smartphone ohne NFC erhält `DEVICE_WITHOUT_NFC`, wie bei jedem Chip. | Die NFC-Verifizierung konnte nicht durchgeführt werden, da diese My Number Card über JPKI ausgelesen wird, was für diese Verifizierung nicht verfügbar war: Es ist nicht aktiviert oder das SDK der App kann keine My Number Cards lesen. | > [!NOTE] > > Ein NFC-Bericht und seine Warnung `SKIPPED_NFC_VALIDATION` existieren nur dann, wenn der Client den NFC-Schritt erreicht und diesen explizit übersprungen hat (typischerweise `USER_SKIPPED` oder `DEVICE_WITHOUT_NFC`, wenn sich der Leser zum Zeitpunkt des Scannens als nicht verfügbar herausstellte). Wurde der NFC-Schritt umgangen, bevor er überhaupt angeboten werden konnte – chiploses Dokument, fehlendes Zertifikat, keine gemeldete NFC-Funktionalität, unlesbarer MRZ-Schlüssel, JPKI nicht verfügbar –, wird kein Bericht und keine Warnung erstellt und der Grund erscheint ausschließlich im Feld `nfc_skip_reason` auf Sitzungsebene, ohne den Sitzungsstatus zu beeinflussen. ## Konfiguration Drei Workflow-Einstellungen steuern, wie NFC-Warnungen weitergeleitet werden. Jede kann auf **Keine Aktion**, **Überprüfung** oder **Ablehnen** gesetzt werden: 1. **NFC-Überspringen-Aktion** (`skip_nfc_action`) – gilt für `SKIPPED_NFC_VALIDATION`. Das Überspringen wird Benutzern nur angeboten, wenn `allow_nfc_skip` aktiviert ist. 2. **Aktion für nicht verifizierten Chip** (`unverified_chip_action`) – gilt sowohl für `NFC_CHIP_NOT_VERIFIED` als auch für `NFC_TRUST_ANCHOR_MISSING`, sodass das Verhalten des Sitzungsstatus unverändert bleibt, während der Risiko-Code erklärt, warum die Verifizierung fehlgeschlagen ist. 3. **Aktion bei Dateninkonsistenz** (`inconsistent_data_action`) – gilt für `NFC_AND_OCR_DATA_NOT_SAME`. Dies ist dieselbe Einstellung für Dateninkonsistenzen, die auch bei der Ausweisverifizierung verwendet wird. Die beiden `DSC_CERTIFICATE_*`-Risiken verfügen über keine Aktionseinstellung – sie sind immer rein informativ. Für die Risiken der Japan My Number Card gibt es fünf weitere Einstellungen, die im nächsten Abschnitt aufgeführt sind. ## Japan My Number Card (JPKI) Eine Japan My Number Card wird über JPKI anstelle von ICAO 9303 ausgelesen (`chip_protocol: "jpki"`), sodass die oben genannten ICAO-Risiken dafür niemals ausgelöst werden. Das Auslesen löst stattdessen diese fünf Risiken aus, jeweils mit einer eigenen Einstellung am NFC-Knoten: | Einstellung | Risiko | Standard | | - | - | - | | `jpki_certificate_invalid_action` | `JPKI_CERTIFICATE_INVALID` | Ablehnen | | `jpki_signature_invalid_action` | `JPKI_SIGNATURE_INVALID` | Ablehnen | | `jpki_certificate_revoked_action` | `JPKI_CERTIFICATE_REVOKED` | Ablehnen | | `jpki_revocation_unchecked_action` | `JPKI_REVOCATION_UNCHECKED` | Überprüfung | | `jpki_inconsistent_data_action` | `JPKI_AND_OCR_DATA_NOT_SAME` | Überprüfung | Das Überspringen des Auslesens der My Number Card löst `SKIPPED_NFC_VALIDATION` aus und folgt wie bei jedem Chip `skip_nfc_action`. Unter [Japan My Number Card (JPKI)](https://docs.didit.me/de/core-technology/nfc-verification/overview.md#japan-my-number-card-jpki) erfahren Sie, wie das Auslesen funktioniert. > [!WARNING] > > Das Auslesen von My Number Cards über JPKI ist in der Produktion noch nicht aktiviert. Bis dahin überspringt eine My Number Card den NFC-Schritt mit dem Grund für das Überspringen `JPKI_UNAVAILABLE` und keines dieser Risiken wird ausgelöst. ## Beispiele ### In Prüfung – Chip konnte nicht verifiziert werden ```json theme={null} { "warnings": [ { "feature": "NFC", "risk": "NFC_CHIP_NOT_VERIFIED", "additional_data": null, "log_type": "warning", "short_description": "NFC chip not verified", "long_description": "The Near Field Communication (NFC) chip failed passive authentication for a reason other than an explicitly identified missing trust anchor. The chip data or signature could be invalid or altered.", "node_id": "nfc_primary" }, { "feature": "NFC", "risk": "DSC_CERTIFICATE_EXPIRED", "additional_data": null, "log_type": "information", "short_description": "Document Signer Certificate expired", "long_description": "The Document Signer Certificate (DSC) used to sign the ePassport chip data has expired, meaning the certificate's validity period has passed.", "node_id": "nfc_primary" } ] } ``` Hier ist die Aktion für nicht verifizierte Chips auf Review gesetzt, sodass `NFC_CHIP_NOT_VERIFIED` `log_type: "warning"` aufweist und der Status des NFC-Berichts `In Review` lautet. Der Eintrag für das abgelaufene DSC dient rein der Information. ### Abgelehnt – Diskrepanz zwischen Chip und OCR ```json theme={null} { "warnings": [ { "feature": "NFC", "risk": "NFC_AND_OCR_DATA_NOT_SAME", "additional_data": { "ocr_mrz": ["P