SD-JWT-decoder
Decodeer een SD-JWT- of SD-JWT VC-credential: bekijk de header, de claims met alle disclosures ingevuld, de hash van elke disclosure en de key binding-JWT, en verifieer de handtekening van de uitgever. Werkt in je browser.
Invoer
Uitvoer
| Claim | Waarde | Digest |
|---|---|---|
| Geen onthullingen | ||
Readme
Wat is een SD-JWT?
SD-JWT (Selective Disclosure for JSON Web Tokens) is een ondertekend token waarin sommige claims verborgen zijn. De uitgever ondertekent van die claims alleen gezouten hashes, digests genoemd. De houder bepaalt daarna welke claims hij onthult door de bijbehorende onthullingen met het token mee te sturen. Een verificateur ziet de claims die de houder heeft gekozen, kan controleren of elke claim overeenkomt met een digest die de uitgever heeft ondertekend, en komt niets te weten over de rest.
SD-JWT VC gebruikt dit als basis voor verifieerbare credentials: een vct-type geeft aan wat voor credential het is, en een cnf-sleutel koppelt de credential aan het apparaat van de houder. Het is een van de twee credentialformaten van de EU Digital Identity Wallets, die elk EU-land uiterlijk in december 2026 aan zijn burgers moet aanbieden, en ook OpenID for Verifiable Credentials gebruikt het.
Hoe een SD-JWT eruitziet
Een SD-JWT is een string van delen die door tildes (~) worden gescheiden:
- De door de uitgever ondertekende JWT,
header.payload.signature. - Eén onthulling per onthulde claim, telkens een Base64url-gecodeerde JSON-array met een willekeurige salt, de naam van de claim en de waarde ervan. Onthullingen van array-elementen laten de naam weg.
- Een optionele JWT voor sleutelbinding aan het einde, die de houder ondertekent om te laten zien dat de presentatie van hem is en voor deze verificateur is bedoeld. Zonder die JWT eindigt de string op een tilde.
Zo gebruik je de tool
Plak de SD-JWT. Regeleinden en spaties worden genegeerd, dus een token dat over meerdere regels is verdeeld en uit een log is gekopieerd, werkt ook.
Wil je de handtekening van de uitgever controleren, voer dan de openbare sleutel van de uitgever in als JWK, als JWK-set (de sleutel met de kid van het token wordt gebruikt), als openbare PEM-sleutel of als X.509-certificaat. Een geplakte privé-JWK werkt ook; alleen het openbare deel wordt gebruikt. Als het sleutelveld leeg is, wordt het certificaat in x5c in de header van het token gebruikt, als dat er is.
Wat je ziet
- Controles voor de handtekening, de onthullingen, de sleutelbinding, de geldigheidsperiode en het hash-algoritme.
- Koptekst van de JWT van de uitgever, met het algoritme, het type (
dc+sd-jwtvoor SD-JWT VC) en de sleutel-ID. - Ondertekende payload, met de digests (
_sd) van de verborgen claims en{"...": digest}-plaatshouders voor verborgen array-elementen. - Claims met onthullingen, de payload met elke onthulling op zijn plaats, zoals een verificateur die zou lezen.
- Onthullingen, een tabel met per onthulling de claim, de waarde, waar die in de claims terechtkomt en de digest.
- JWT voor sleutelbinding, de header en payload ervan met de audience (
aud), denonceen desd_hash.
Wat de controles betekenen
- Handtekening: de JWT van de uitgever is ondertekend met de sleutel die je hebt ingevoerd. Als de tool terugvalt op het certificaat in de header, laat hij zien dat het token overeenkomt met zijn eigen certificaat. Of dat certificaat van een vertrouwde uitgever is, bijvoorbeeld een uitgever op de vertrouwenslijsten van de EU, valt buiten deze controle.
- Onthullingen: de digest van elke onthulling komt precies één keer voor in het ondertekende token. Een gewijzigde onthulling heeft een andere digest en komt dus niet meer overeen, en een onthulling die twee keer is verzonden, wordt gemarkeerd.
- Sleutelbinding: de
sd_hashvan de JWT voor sleutelbinding is de hash van precies deze presentatie (de SD-JWT tot en met de laatste tilde), en de sleutel in decnfvan de credential heeft de JWT ondertekend. Als je een onthulling weglaat of toevoegt, klopt de hash niet meer. - Geldigheidsperiode: de vervaltijd (
exp) en de begintijd (nbf) van het token, vergeleken met de klok van je apparaat. - Hash-algoritme: de digests gebruiken het algoritme in
_sd_alg, of SHA-256 als het token er geen noemt. Browsers kunnen SHA-256, SHA-384 en SHA-512 berekenen.
Privacy
Het decoderen en alle controles worden in je browser uitgevoerd, dus het token en de sleutels worden nergens naartoe gestuurd. Echte credentials bevatten persoonsgegevens, dus gebruik testcredentials als je schermafbeeldingen deelt.