Hva er en SD-JWT?

SD-JWT (Selective Disclosure for JSON Web Tokens) er et signert token der noen påstander er skjult. Utstederen signerer bare saltede hashverdier (digests) av disse påstandene. Innehaveren bestemmer deretter hvilke påstander som skal avsløres, ved å sende utleveringene for dem sammen med tokenet. En verifikator ser påstandene innehaveren valgte, kan kontrollere at hver av dem samsvarer med en hashverdi utstederen har signert, og får ikke vite noe om resten.

SD-JWT VC bruker dette som grunnlag for verifiserbar legitimasjon: En vct-type angir hva slags legitimasjon det er, og en cnf-nøkkel binder legitimasjonen til innehaverens enhet. Det er ett av de to legitimasjonsformatene for EU Digital Identity Wallets, som alle EU-land må tilby innbyggerne sine innen desember 2026, og OpenID for Verifiable Credentials bruker det også.

Slik ser en SD-JWT ut

En SD-JWT er en streng med deler atskilt med tilder (~):

  • Den utstedersignerte JWT-en, header.payload.signature.
  • Én utlevering per avslørt påstand, hver av dem en Base64url-kodet JSON-matrise med et tilfeldig salt, påstandsnavnet og verdien. Utleveringer av matriseelementer utelater navnet.
  • En valgfri nøkkelbindings-JWT til slutt, som innehaveren signerer for å vise at presentasjonen er innehaverens egen og ment for denne verifikatoren. Uten en slik JWT slutter strengen med en tilde.

Slik bruker du den

Lim inn SD-JWT-en. Linjeskift og mellomrom ignoreres, så et token med linjebryting som er kopiert fra en logg, fungerer også.

For å kontrollere utstederens signatur skriver du inn utstederens offentlige nøkkel som en JWK, et JWK-sett (nøkkelen med tokenets kid brukes), en offentlig PEM-nøkkel eller et X.509-sertifikat. En innlimt privat JWK fungerer også; bare den offentlige delen brukes. Når nøkkelfeltet er tomt, brukes sertifikatet i x5c i tokenets header, hvis det finnes.

Dette ser du

  • Kontroller for signaturen, utleveringene, nøkkelbindingen, gyldighetsperioden og hash-algoritmen.
  • Header for utsteder-JWT-en, med algoritme, type (dc+sd-jwt for SD-JWT VC) og nøkkel-ID.
  • Payload slik den er signert, med hashverdiene (_sd) til de skjulte påstandene og plassholdere av typen {"...": digest} for skjulte matriseelementer.
  • Påstander med utleveringer, payloaden med hver utlevering satt inn på sin plass, slik en verifikator ville lest den.
  • Utleveringer, en tabell som viser påstanden og verdien for hver utlevering, hvor den havner blant påstandene, og hashverdien.
  • Nøkkelbindings-JWT, som viser header og payload med mottaker (aud), nonce og sd_hash.

Hva kontrollene betyr

  • Signatur: Utsteder-JWT-en er signert med nøkkelen du skrev inn. Når verktøyet faller tilbake på sertifikatet i headeren, viser det at tokenet samsvarer med sitt eget sertifikat. Om sertifikatet tilhører en betrodd utsteder, for eksempel en på EUs tillitslister, ligger utenfor det denne kontrollen dekker.
  • Utleveringer: Hashverdien til hver utlevering finnes nøyaktig én gang i det signerte tokenet. En endret utlevering har en annen hashverdi, så den samsvarer ikke lenger, og en utlevering som er sendt to ganger, blir markert.
  • Nøkkelbinding: sd_hash i nøkkelbindings-JWT-en er hashverdien av nøyaktig denne presentasjonen (SD-JWT-en frem til siste tilde), og nøkkelen i legitimasjonens cnf har signert den. Hvis en utlevering fjernes eller legges til, stemmer ikke hashverdien lenger.
  • Gyldighetsperiode: tokenets utløpstidspunkt (exp) og starttidspunkt (nbf) sammenlignet med klokken på enheten din.
  • Hash-algoritme: Hashverdiene bruker algoritmen i _sd_alg, eller SHA-256 når tokenet ikke angir noen. Nettlesere kan beregne SHA-256, SHA-384 og SHA-512.

Personvern

Dekodingen og alle kontrollene kjøres i nettleseren din, så tokenet og nøklene sendes ikke noe sted. Ekte legitimasjon inneholder personopplysninger, så bruk testlegitimasjon når du deler skjermbilder.