Fehlerreferenz: Format und Schema
Ist das Format erkannt, sind die Pflichtfelder vorhanden, ist die Version unterstützt?
Der erste Prüfschritt stellt fest, was eingegeben wurde: ein Token, ein Nachweispaket, eine Beleg-Kette, ein Zeitstempel oder eine signierte HTTP-Anfrage. Er prüft, ob die Struktur lesbar ist und ob die Pflichtangaben des Formats vorhanden sind. Scheitert dieser Schritt, können alle weiteren Schritte nicht sinnvoll arbeiten und melden ihre Voraussetzung als nicht erfüllt.
Die meisten Codes in diesem Schritt entstehen beim Kopieren: abgeschnittene Token, zusätzliche Zeichen oder vertauschte Eingabefelder.
format_unknown
Das Format ist nicht bekannt.
Ursache: Die Eingabe entspricht keinem Format, das der Prüfkern kennt, etwa weil zusätzlicher Text, Anführungszeichen oder ein ganz anderes Dokument eingefügt wurde.
Behebung: Fügen Sie nur den Nachweis selbst ein, ohne Erklärungstext. Unterstützt sind SD-JWT VC, JWS, kya-pack/1, kya-chain/1, Statuslisten, RFC-3161-Zeitstempel, Verifiable Intent und HTTP-Signaturen.
format_recognized_not_supported
Das Format ist erkannt, wird in dieser Version aber nicht geprüft.
Ursache: Das Format ist bekannt, wird in dieser Version aber bewusst nicht geprüft, etwa klassische AP2-Mandate im JSON-Format oder verschlüsselte Token.
Behebung: Verwenden Sie ein unterstütztes Format, zum Beispiel die mit Verifiable Intent zusammengeführte AP2-Kette. Der Prüfschein sagt ausdrücklich, dass nicht geprüft wurde, statt still zu scheitern.
not_evidence_key_material
Das ist Schlüsselmaterial, kein Nachweis. Fügen Sie es unter «Vertrauen der Prüfstelle» ein.
Ursache: Eingefügt wurde Schlüsselmaterial, etwa ein JWK, ein JWKS oder ein PEM-Zertifikat, und kein Nachweis.
Behebung: Fügen Sie Schlüssel unter «Vertrauen der Prüfstelle» ein: öffentliche Schlüssel als JWK oder JWKS, Zertifikate von Zeitstempelstellen als PEM. In das Eingabefeld gehört der Nachweis.
malformed
Die Eingabe ist strukturell fehlerhaft.
Ursache: Die Struktur ist beschädigt: Base64 lässt sich nicht dekodieren, JSON ist ungültig oder Teile fehlen. Häufig ist der Nachweis beim Kopieren abgeschnitten oder durch Zeilenumbrüche verändert worden.
Behebung: Kopieren Sie den Nachweis erneut vollständig und unverändert. Mit den Werkzeugen JWT-Decoder und SD-JWT-Decoder sehen Sie, welcher Teil nicht lesbar ist.
required_claim_missing
Ein Pflichtfeld fehlt.
Ursache: Eine Angabe fehlt, die das Format verlangt, etwa der Aussteller, der Typ, die Bindung an einen Schlüssel oder ein Zeitpunkt.
Behebung: Der Aussteller muss den Nachweis nach dem Prüfprofil ausstellen. Prüfen Sie den Nachweis gegen die veröffentlichten JSON-Schemas und ergänzen Sie die fehlende Angabe bei der Ausstellung.
format_not_supported
Nicht geprüft, weil das Format nicht unterstützt ist.
Ursache: Die Variante des Formats wird nicht unterstützt, etwa eine unbekannte Version eines Nachweispakets oder ein unbekannter Typ.
Behebung: Erzeugen Sie den Nachweis in einer unterstützten Version. Welche Versionen gelten, steht im Prüfprofil und auf der Seite Versionen.