Was ist ein SD-JWT?

SD-JWT (Selective Disclosure for JSON Web Tokens) ist ein signiertes Token, in dem einige Claims verborgen sind. Der Aussteller signiert von diesen Claims nur gesalzene Hashwerte, sogenannte Digests. Der Inhaber entscheidet dann, welche Claims er preisgibt, indem er deren Offenlegungen zusammen mit dem Token sendet. Ein Verifizierer sieht die vom Inhaber gewählten Claims, kann prüfen, ob jeder davon zu einem vom Aussteller signierten Hashwert passt, und erfährt nichts über die übrigen.

SD-JWT VC setzt darauf auf und bildet verifizierbare Nachweise ab: Ein vct-Typ gibt an, um welche Art von Nachweis es sich handelt, und ein cnf-Schlüssel bindet den Nachweis an das Gerät des Inhabers. Es ist eines der beiden Nachweisformate der EU Digital Identity Wallets, die jedes EU-Land seinen Bürgerinnen und Bürgern bis Dezember 2026 anbieten muss, und auch OpenID for Verifiable Credentials verwendet es.

Wie ein SD-JWT aussieht

Ein SD-JWT ist eine Zeichenkette aus Teilen, die durch Tilden (~) getrennt sind:

  • Das vom Aussteller signierte JWT, header.payload.signature.
  • Eine Offenlegung pro offengelegtem Claim, jeweils ein Base64url-kodiertes JSON-Array aus einem zufälligen Salt, dem Claim-Namen und seinem Wert. Offenlegungen von Array-Elementen lassen den Namen weg.
  • Am Ende optional ein Key-Binding-JWT, das der Inhaber signiert, um zu zeigen, dass die Präsentation von ihm stammt und für diesen Verifizierer bestimmt ist. Ohne Key-Binding-JWT endet die Zeichenkette mit einer Tilde.

So verwenden Sie das Tool

Fügen Sie das SD-JWT ein. Zeilenumbrüche und Leerzeichen werden ignoriert, daher funktioniert auch ein umbrochenes Token, das aus einem Log kopiert wurde.

Um die Signatur des Ausstellers zu prüfen, geben Sie den öffentlichen Schlüssel des Ausstellers als JWK, als JWK-Satz (verwendet wird der Schlüssel mit der kid des Tokens), als öffentlichen PEM-Schlüssel oder als X.509-Zertifikat ein. Auch ein eingefügter privater JWK funktioniert; verwendet wird nur sein öffentlicher Teil. Ist das Schlüsselfeld leer, wird das Zertifikat aus x5c im Header des Tokens verwendet, sofern vorhanden.

Was Sie sehen

  • Prüfungen für die Signatur, die Offenlegungen, die Schlüsselbindung, den Gültigkeitszeitraum und den Hash-Algorithmus.
  • Header des Aussteller-JWTs mit Algorithmus, Typ (dc+sd-jwt bei SD-JWT VC) und Schlüssel-ID.
  • Signierte Payload mit den Hashwerten (_sd) der verborgenen Claims und Platzhaltern der Form {"...": digest} für verborgene Array-Elemente.
  • Claims mit Offenlegungen, die Payload mit allen Offenlegungen an ihrer Stelle, so wie ein Verifizierer sie lesen würde.
  • Offenlegungen, eine Tabelle mit Claim, Wert, Position in den Claims und Hashwert jeder Offenlegung.
  • Key-Binding-JWT, sein Header und seine Payload mit der Zielgruppe (aud), der nonce und dem sd_hash.

Was die Prüfungen bedeuten

  • Signatur: Das Aussteller-JWT ist mit dem eingegebenen Schlüssel signiert. Greift das Tool auf das Zertifikat im Header zurück, zeigt es, dass das Token zu seinem eigenen Zertifikat passt. Ob dieses Zertifikat zu einem vertrauenswürdigen Aussteller gehört, etwa einem auf den Vertrauenslisten der EU, geht über diese Prüfung hinaus.
  • Offenlegungen: Der Hashwert jeder Offenlegung kommt im signierten Token genau einmal vor. Eine veränderte Offenlegung hat einen anderen Hashwert und passt daher nicht mehr, und eine doppelt übermittelte Offenlegung wird markiert.
  • Schlüsselbindung: Der sd_hash des Key-Binding-JWTs ist der Hash genau dieser Präsentation (das SD-JWT bis zur letzten Tilde), und der Schlüssel in cnf des Nachweises hat es signiert. Wird eine Offenlegung entfernt oder hinzugefügt, stimmt der Hash nicht mehr.
  • Gültigkeitszeitraum: Ablaufzeit (exp) und Startzeit (nbf) des Tokens im Vergleich zur Uhr Ihres Geräts.
  • Hash-Algorithmus: Die Hashwerte verwenden den Algorithmus aus _sd_alg bzw. SHA-256, wenn das Token keinen angibt. Browser können SHA-256, SHA-384 und SHA-512 berechnen.

Datenschutz

Die Dekodierung und alle Prüfungen laufen in Ihrem Browser, daher werden Token und Schlüssel nirgendwohin gesendet. Echte Nachweise enthalten personenbezogene Daten. Verwenden Sie daher Testnachweise, wenn Sie Screenshots teilen.