Decoder SD-JWT
Decodifica una credenziale SD-JWT o SD-JWT VC: visualizza l'intestazione, le claim con tutte le disclosure compilate, l'hash di ogni disclosure e il JWT di key binding, e verifica la firma dell'emittente. Funziona nel browser.
Input
Output
| Claim | Valore | Digest |
|---|---|---|
| Nessuna disclosure | ||
Leggimi
Che cos'è un SD-JWT?
SD-JWT (Selective Disclosure for JSON Web Tokens) è un token firmato in cui alcuni claim sono nascosti. L'emittente firma solo gli hash con salt di quei claim, chiamati digest. Il titolare decide poi quali claim rivelare inviando le relative disclosure insieme al token. Un verificatore vede i claim scelti dal titolare, può controllare che ciascuno corrisponda a un digest firmato dall'emittente e non viene a sapere nulla degli altri.
SD-JWT VC si basa su questo formato per creare credenziali verificabili: un tipo vct indica di quale credenziale si tratta e una chiave cnf vincola la credenziale al dispositivo del titolare. È uno dei due formati di credenziali dei portafogli europei di identità digitale, che ogni paese dell'UE deve offrire ai propri cittadini entro dicembre 2026, ed è usato anche da OpenID for Verifiable Credentials.
Com'è fatto un SD-JWT
Un SD-JWT è una stringa composta da parti separate da tilde (~):
- Il JWT firmato dall'emittente,
header.payload.signature. - Una disclosure per ogni claim rivelato, ciascuna costituita da un array JSON codificato in Base64url che contiene un salt casuale, il nome del claim e il suo valore. Le disclosure degli elementi di un array omettono il nome.
- Alla fine, un JWT di associazione della chiave facoltativo, che il titolare firma per dimostrare che la presentazione è sua ed è destinata a questo verificatore. In sua assenza, la stringa termina con una tilde.
Come si usa
Incolla l'SD-JWT. Le interruzioni di riga e gli spazi vengono ignorati, quindi funziona anche un token suddiviso su più righe copiato da un log.
Per verificare la firma dell'emittente, inserisci la sua chiave pubblica come JWK, insieme di JWK (viene usata la chiave con il kid del token), chiave pubblica PEM o certificato X.509. Funziona anche un JWK privato incollato; ne viene usata solo la parte pubblica. Quando il campo della chiave è vuoto, viene usato il certificato presente in x5c nell'intestazione del token, se c'è.
Che cosa vedi
- Verifiche della firma, delle disclosure, dell'associazione della chiave, del periodo di validità e dell'algoritmo hash.
- Intestazione del JWT dell'emittente, con l'algoritmo, il tipo (
dc+sd-jwtper SD-JWT VC) e l'ID della chiave. - Payload firmato, con i digest (
_sd) dei claim nascosti e i segnaposto{"...": digest}per gli elementi nascosti degli array. - Claim con disclosure, il payload con ogni disclosure inserita al suo posto, come lo leggerebbe un verificatore.
- Disclosure, una tabella con il claim, il valore, la posizione nei claim e il digest di ogni disclosure.
- JWT di associazione della chiave, con la sua intestazione e il payload contenente il destinatario (
aud), ilnoncee l'sd_hash.
Che cosa significano le verifiche
- Firma: il JWT dell'emittente è firmato con la chiave che hai inserito. Quando lo strumento ripiega sul certificato dell'intestazione, mostra che il token corrisponde al proprio certificato. Stabilire se quel certificato appartenga a un emittente attendibile, ad esempio uno presente negli elenchi di fiducia dell'UE, esula da questa verifica.
- Disclosure: il digest di ogni disclosure compare nel token firmato esattamente una volta. Una disclosure modificata ha un digest diverso, quindi non corrisponde più, e una disclosure inviata due volte viene segnalata.
- Associazione della chiave: l'
sd_hashdel JWT di associazione della chiave è l'hash di questa esatta presentazione (l'SD-JWT fino all'ultima tilde), e la chiave presente nelcnfdella credenziale lo ha firmato. Rimuovere o aggiungere una disclosure invalida l'hash. - Periodo di validità: gli orari di scadenza (
exp) e di inizio validità (nbf) del token, confrontati con l'orologio del tuo dispositivo. - Algoritmo hash: i digest usano l'algoritmo indicato in
_sd_alg, oppure SHA-256 se il token non ne indica nessuno. I browser possono calcolare SHA-256, SHA-384 e SHA-512.
Privacy
La decodifica e tutte le verifiche vengono eseguite nel tuo browser, quindi il token e le chiavi non vengono inviati da nessuna parte. Le credenziali reali contengono dati personali, quindi usa credenziali di test quando condividi degli screenshot.