Vad är en SD-JWT?

SD-JWT (Selective Disclosure for JSON Web Tokens) är en signerad token där vissa anspråk är dolda. Utfärdaren signerar bara saltade hashvärden av dessa anspråk, så kallade sammandrag. Innehavaren bestämmer sedan vilka anspråk som ska avslöjas genom att skicka deras utlämnanden tillsammans med tokenen. En verifierare ser de anspråk som innehavaren har valt, kan kontrollera att vart och ett matchar ett sammandrag som utfärdaren har signerat och får inte veta något om resten.

SD-JWT VC bygger verifierbara intyg ovanpå formatet: en vct-typ anger vilken sorts intyg det är, och en cnf-nyckel binder intyget till innehavarens enhet. Det är ett av de två intygsformaten för EU:s digitala identitetsplånböcker, som varje EU-land måste erbjuda sina medborgare senast i december 2026, och OpenID for Verifiable Credentials använder det också.

Hur en SD-JWT ser ut

En SD-JWT är en sträng med delar som skiljs åt av tilde-tecken (~):

  • Den JWT som utfärdaren har signerat, header.payload.signature.
  • Ett utlämnande per avslöjat anspråk, vart och ett en Base64url-kodad JSON-array med ett slumpmässigt salt, anspråkets namn och dess värde. Utlämnanden av arrayelement utelämnar namnet.
  • En valfri JWT för nyckelbindning i slutet, som innehavaren signerar för att visa att presentationen är innehavarens och avsedd för den här verifieraren. Utan en sådan slutar strängen med ett tilde-tecken.

Så använder du verktyget

Klistra in SD-JWT:n. Radbrytningar och mellanslag ignoreras, så en radbruten token som har kopierats från en logg fungerar också.

För att kontrollera utfärdarens signatur anger du utfärdarens offentliga nyckel som en JWK, en JWK-mängd (nyckeln med tokenens kid används), en offentlig PEM-nyckel eller ett X.509-certifikat. En inklistrad privat JWK fungerar också; bara dess offentliga del används. När nyckelfältet är tomt används certifikatet i tokenheaderns x5c, om det finns något.

Vad du ser

  • Kontroller av signaturen, utlämnandena, nyckelbindningen, giltighetstiden och hashalgoritmen.
  • Header för utfärdarens JWT, med dess algoritm, typ (dc+sd-jwt för SD-JWT VC) och nyckel-ID.
  • Signerad nyttolast, med sammandragen (_sd) för de dolda anspråken och platshållarna {"...": digest} för dolda arrayelement.
  • Anspråk med utlämnanden, nyttolasten med varje utlämnande insatt på sin plats, så som en verifierare skulle läsa den.
  • Utlämnanden, en tabell med varje utlämnandes anspråk, värde, var det hamnar bland anspråken och dess sammandrag.
  • JWT för nyckelbindning, dess header och nyttolast med mottagaren (aud), nonce och sd_hash.

Vad kontrollerna betyder

  • Signatur: utfärdarens JWT är signerad med nyckeln du angav. När verktyget i stället använder certifikatet i headern visar det att tokenen stämmer med sitt eget certifikat. Om certifikatet tillhör en betrodd utfärdare, till exempel en som finns på EU:s förtroendelistor, ligger utanför vad den här kontrollen omfattar.
  • Utlämnanden: varje utlämnandes sammandrag förekommer exakt en gång i den signerade tokenen. Ett ändrat utlämnande har ett annat sammandrag och matchar därför inte längre, och ett utlämnande som har skickats två gånger flaggas.
  • Nyckelbindning: sd_hash i JWT:n för nyckelbindning är hashvärdet av exakt den här presentationen (SD-JWT:n fram till det sista tilde-tecknet), och nyckeln i intygets cnf har signerat den. Om ett utlämnande tas bort eller läggs till stämmer hashvärdet inte längre.
  • Giltighetstid: tokenens utgångstid (exp) och starttid (nbf) jämförs med enhetens klocka.
  • Hashalgoritm: sammandragen använder algoritmen i _sd_alg, eller SHA-256 när tokenen inte anger någon. Webbläsare kan beräkna SHA-256, SHA-384 och SHA-512.

Integritet

Avkodningen och alla kontroller körs i din webbläsare, så tokenen och nycklarna skickas inte någonstans. Riktiga intyg innehåller personuppgifter, så använd testintyg när du delar skärmbilder.