1. Nascita di RFC 9901
19 novembre 2025, "Divulgazione selettiva per token Web JSON", noto anche come SD-JWT Le specifiche che definiscono (SDJOT) RFC 9901 È stato rilasciato come.
Gli autori sono le tre persone seguenti.
- Daniel Fett (Autleta)
- Kristina Yasuda (PRIMAVERA)
- Brian Campbell (Ping identità)
Token Web JSON (JWT) [RFC 7519]と Firma Web JSON (JWS) [RFC 7515]は,Gettone identificativoやToken di accesso JWT [RFC 9068]È uno standard Internet ampiamente utilizzato in
SD-JWT ci offre la nuova capacità di estrarre e visualizzare solo le parti di cui avremo bisogno in seguito.
Nella linea della famiglia JOSE (JWS / JWT / JWE),
Ciò può essere visto come l'aggiunta di un nuovo pilastro denominato "Divulgazione selettiva" come RFC ufficiale.
2. A cosa serve la specifica SD-JWT?
2-1. Problemi con il JWT convenzionale: "emesso su richiesta" o "tutto compreso"
I JWT tradizionali si basavano su un modello in cui un "blocco di JSON firmato" veniva passato direttamente al servizio.
- L'emittente (IdP o server di autenticazione) compila le informazioni dell'utente in un JWT.
- Il servizio ricevente (parte affidabile) può leggere l'intero contenuto
Ciò significa che se si utilizza un modello come OpenID Connect, in cui i certificati vengono emessi dinamicamente in base alle esigenze, è possibile ottenere la divulgazione selettiva, la minimizzazione dei dati e l'incollegabilità tra RP (RP+RP'-U Unlinkability) (in genere utilizzando PPID = Pairwise Pseudonymous Identifier). Tuttavia, se si desidera "emettere un certificato in anticipo senza conoscerne lo scopo e utilizzarlo in un secondo momento", il problema è che nessuna di queste opzioni è possibile.
Ad esempio, se un singolo JWT contiene "età", "indirizzo", "nome" e "indirizzo email", il lato servizio potrebbe aver bisogno solo di sapere se l'utente ha più di 20 anni, ma se utilizza un JWT emesso e salvato in anticipo, sarà in grado di vedere tutto, inclusi l'indirizzo e il nome dell'utente.
Questa struttura "tutto in uno" è semplice da implementare, ma se vuoi salvare e utilizzare,
- La divulgazione selettiva non è possibile = il principio di minimizzazione della raccolta dati non può essere rispettato
- Anche l'incollegabilità RP+RP'-U non è soddisfatta
Questi erano i limiti (anche se si trattava di un compromesso con la semplicità dell'implementazione).
2-2. Compatibilità con i modelli di portafoglio
D'altro canto, ci sono certamente casi d'uso in cui si desidera utilizzare i dati salvati in un secondo momento. I casi d'uso tipici includono l'utilizzo in luoghi senza segnale o la presentazione di un certificato di laurea dopo la chiusura di una scuola. Si potrebbe pensare: "È davvero così comune non avere segnale?", ma questo perché il Giappone si trova in un ambiente favorevole. In Europa, la qualità del segnale è scarsa, soprattutto all'interno degli edifici in pietra, e anche se ci si allontana di poco dalla stazione, si può perdere il segnale anche all'aperto, persino in grandi città come Mannheim. Questo vale ovviamente anche per i vasti Stati Uniti. Forse per questo motivo, in Europa, Portafoglio EUDI I portafogli di identità più recenti includono:
- Un portafoglio (app per smartphone) può gestire più transazioni Credenziali verificabili (VC) Risparmia il
- L'utente seleziona "Mostra solo questo elemento per questo servizio" e lo presenta.
Questo modello è la premessa. In questo caso, il portafoglio e l'emittente devono essere connessi online solo al momento dell'emissione.
Ciò che serve qui è
"Un formato che consente di selezionare e visualizzare in modo sicuro una porzione di un file di dati firmato memorizzato in un secondo momento."
Questo è definito da RFC 9901 Questo è SD-JWT.
3. SD-JWT in breve
In parole povere, SD-JWT funziona come segue:
- La base è la stessa di prima Firmato JWT (JWS)
- Tuttavia, alcune affermazioni sonoSolo il valore hash" nel JWT
- Valore originale e sale combinati Rivelazione Tienilo separato e passalo al verificatore solo quando necessario
- Il verificatore è
- Ricalcola l'hash dalla divulgazione
- Verificando che corrisponda all'hash nel JWT firmato
- Puoi confermare che "fa effettivamente parte dei dati firmati dall'emittente"
Inoltre, per impedire il trasferimento non autorizzato di token, Un meccanismo per il collegamento alla coppia di chiavi di un utente (Key Binding) sono anche disponibili.
La struttura combinata SD-JWT+KB Chiamalo
4. Tre personaggi e il flusso di SD-JWT
Il cast di base dei personaggi in SD-JWT è lo stesso del mondo VC.
- Emittente
Uffici governativi, banche, università, ecc. Organizzazioni responsabili dei fatti. - Titolare
L'utente stesso detiene le credenziali nell'app wallet sul suo smartphone. - Verificatore
Fornitori di servizi, come l'apertura di conti bancari, la verifica dell'età e il controllo degli ingressi.
Il flusso tipico è il seguente:
- Emissione
- L'emittente compila le informazioni sugli attributi dell'utente (indirizzo, data di nascita, ecc.) in JSON.
- Per quanto riguarda gli "elementi che vorresti divulgare selettivamente in seguito",
Calcola un hash dal valore + un sale casuale e incorpora solo quell'hash nel JWT - Il valore originale + sale viene preparato separatamente come Divulgazione
- Il JWT firmato e le molteplici Divulgazioni vengono raggruppati e trasmessi al Titolare come "SD-JWT".
- Presentazione
- Un utente tenta di utilizzare un servizio
- Il portafoglio seleziona solo le informazioni che desidera mostrare al verificatore dall'SD-JWT.
- Inviare il JWT firmato + la Disclosure selezionata + (e il JWT di associazione chiave, se necessario) al verificatore
- Verifica
- Il verificatore è
- Verificare la firma JWT con la chiave pubblica dell'emittente
- Utilizzare Disclosure per ricalcolare l'hash per ogni elemento e verificare che corrisponda all'hash nel JWT
- Ciò garantisce che i dati facciano parte dei dati firmati dall'emittente, proteggendo al contempo gli elementi non divulgati.
- Il verificatore è
5. Un po' di tecnica: sale e divulgazione
5-1. Divulgazione selettiva mediante hashing salato
Ogni richiesta (indirizzo, data di nascita, ecc.)
- Sale + Valore + (possibilmente nome del reclamo)
Calcola l'hash dal JWT e incorpora il valore hash nel JWT.
Quando si effettua una divulgazione effettiva, è necessario specificarlo come Divulgazione.
- "Sale, Nome della rivendicazione, Valore"
al Verificatore.
Il verificatore ricalcola l'hash utilizzando la stessa procedura e controlla se corrisponde all'hash nel JWT per vedere se è stato manomesso.
Il sale rende difficile indovinare il valore delle rivendicazioni non dichiarate.
5-2. Divulgazione
L'RFC definisce una Disclosure come un array JSON codificato in Base64url, ad esempio:
- Elemento 0: Sale
- Elemento 1: Nome della richiesta (può essere omesso per gli elementi dell'array)
- Elemento 2: Valore della richiesta
All'interno del portafoglio,
"Conserva una grande credenziale come una raccolta di piccole informazioni e invia solo ciò di cui hai bisogno."
Penso che sia più facile capirlo se lo si vede in questo modo.
5-3. Associazione dei tasti e SD-JWT+KB
Con solo SD-JWT, rimane il rischio di un attacco (attacco di replay) in cui un token viene copiato e presentato da qualcun altro.
Pertanto, RFC 9901 specifica un meccanismo per associare un SD-JWT alla coppia di chiavi di un titolare. Rilegatura a chiave definisce:
- Includere la chiave pubblica del Titolare (o un riferimento ad essa) nell'SD-JWT
- Il Titolare firma con quella chiave al momento della presentazione. Associazione tasti JWT (KB-JWT) Invia insieme
- Il verificatore è
- SD-JWT e KB-JWT sono vincolati alla stessa chiave
- Verificare che il titolare abbia effettivamente la chiave privata
Ora è richiesta l'associazione dei tasti SD-JWT+KB Ciò aumenterà la resistenza alla copia VC.
NotaIl binding del titolare può essere basato su una chiave, un claim o un binding biometrico. +KB implementa il binding delle chiavi. Tuttavia, con il binding delle chiavi, se il dispositivo o altro supporto che memorizza la chiave viene trasferito, è possibile che qualcuno si spacci per te (questo è noto come attacco Alice-to-Bob). L'acquisto e la vendita di un conto bancario sono un esempio perfetto di questo fenomeno. Per evitarlo, di solito è necessario il binding biometrico.
5-4. Supporto per strutture e array JSON
RFC 9901 va oltre il semplice JSON.
- Oggetti annidati
- Divulgazione elemento per elemento degli array
- Nascondere i modelli con "hash fittizi (digest esca)"
Definisce anche come gestire tali casi.
Di conseguenza,
- Impedire alle persone di supporre che "tutti hanno le stesse credenziali"
- Ridurre il rischio di essere tracciati solo in base al numero di elementi divulgati
Ciò rende possibile elaborare idee come:
6. Portafogli di identità SD-JWT e VC
6-1. SD-JWT VC: Posizionamento come formato VC
L'IETF utilizza SD-JWT in RFC 9901. Una specifica per esprimere credenziali verificabili come
"Credenziali verificabili basate su SD-JWT (SD-JWT VC)" È in preparazione una bozza.
Questo è
- VC in formato JSON
- SD-JWT consente la divulgazione selettiva
- Determinare il metodo di verifica
Questa è una specifica che ha il seguente ruolo. Attualmente, il WG è in fase di revisione prima di entrare nel WG Last Call, e anch'io sono un revisore.Circa 28 miglioramenti editoriali(Alcuni suggerimenti potrebbero essere considerati tecnici.) (Questi suggerimenti includono la scomposizione di frasi lunghe e difficili da leggere se scritte da americani o tedeschi, l'affrontamento della questione dell'esecutore degli obblighi che diventa poco chiaro a causa dell'uso eccessivo della forma passiva e considerazioni di sicurezza, privacy ed equità.) Inoltre, per verificare gli esempi inclusi nella bozza delle specifiche, abbiamo creato una pagina HTML/JavaScript statica "decodificatore sd-jwt" è stato creato anche.È disponibile anche su GitHub(È solo una singola pagina HTML, quindi può essere facilmente eseguita localmente: mi serviva per verificare la bozza su un aereo), quindi se trovate dei bug, inviate una richiesta di pull.
6-2. Utilizzo con portafoglio EUDI
Commissione Europea Quadro di riferimento dell'architettura EUDI (ARF) Pertanto, lo standard da utilizzare nei portafogli digitali europei è:
- OpenID per credenziali verificabili (OpenID4VCI / OpenID4VP)
- SD-JWT / SD-JWT VC
- Patente di guida mobile ISO/IEC 18013-5 (mDL)
È stato dimostrato che è possibile utilizzare una combinazione dei seguenti elementi.
In questo contesto, RFC 9901 afferma:
"VC archiviati in portafogli di identità come i portafogli EUDI
Formato principale per l'implementazione basata su JWT/JOSE
È posizionato come segue.
6-3. Vantaggi dal punto di vista degli utenti del portafoglio
L'esperienza utente generale sarà simile a questa:
- Conferma dell'età
Nei minimarket, ti basta fornire la verità: hai più di 20 anni, non la tua data di nascita. - Verifica dell'indirizzo
Fornisci solo l'indirizzo necessario per la consegna al sito di shopping online e nascondi gli altri attributi - Conosci il tuo cliente (KYC)
Presentare solo gli attributi necessari alle banche e alle società di intermediazione mobiliare e riutilizzare lo stesso VC per altri servizi.
Tutto ciò è reso possibile dalla natura di SD-JWT, che consente di scomporre un singolo pezzo di dati firmato in parti più piccole ed estrarre solo le parti necessarie.
7. Espansione dell'ecosistema (panoramica)
Diverse soluzioni OSS e commerciali stanno già incorporando SD-JWT/SD-JWT VC nelle loro implementazioni.
- Supporto SD-JWT in vari framework di portafoglio:Fondazione Siros Uno di questi è wwWallet, sviluppato da .
- Fornitura di endpoint di emissione VC SD-JWT da parte di Authlete e altre organizzazioni
- Adozione nel progetto EUDI Wallet e nell'iniziativa SPRIND
- La OpenID Foundation ha sviluppato un profilo di sicurezza elevato (HAIP) che combina OpenID4VC e SD-JWT VC.
L'RFC 9901 è posizionato come "pezzo fondamentale" sopra questo movimento.
8. Riepilogo
- RFC 9901 è uno standard Internet che conferisce a JWT/JWS la possibilità di "divulgare selettivamente".
- SD-JWT è
- Il JWT firmato contiene solo l'hash.
- Il valore originale e il sale vengono presentati come Informazioni solo quando necessario.
- Tuttavia, la firma dell'emittente ne garantisce comunque l'autenticità.
Definisce il formato.
- Aggiunta associazione tasti SD-JWT+KB Ciò consente una presentazione sicura, legata al proprietario del portafoglio.
- In combinazione con la bozza SD-JWT VC, EUDI ARF e il profilo OpenID4VC,
Uno dei formati principali per VC archiviati nei portafogli di identità Sarà utilizzato come.
Questo nuovo elemento è stato aggiunto alla famiglia di tecnologie JOSE/JWT e si può affermare che è diventato chiaro un modello di implementazione realistico per l'infrastruttura di identità digitale basata su portafoglio.
