Decodificador SD-JWT
Decodifica una credencial SD-JWT o SD-JWT VC: consulta el encabezado, las claims con todas las divulgaciones completadas, el hash de cada divulgación y el JWT de vinculación de clave, y verifica la firma del emisor. Se ejecuta en tu navegador.
Entrada
Salida
| Claim | Valor | Resumen |
|---|---|---|
| No hay divulgaciones | ||
Leerme
¿Qué es un SD-JWT?
SD-JWT (Selective Disclosure for JSON Web Tokens) es un token firmado en el que algunos claims están ocultos. El emisor solo firma hashes con sal de esos claims, llamados resúmenes. Después, el titular decide qué claims revela enviando sus divulgaciones junto con el token. Un verificador ve los claims que eligió el titular, puede comprobar que cada uno coincide con un resumen firmado por el emisor y no sabe nada del resto.
SD-JWT VC construye credenciales verificables sobre esta base: un tipo vct indica qué clase de credencial es y una clave cnf vincula la credencial al dispositivo del titular. Es uno de los dos formatos de credenciales de las Carteras Europeas de Identidad Digital, que todos los países de la UE deben ofrecer a sus ciudadanos a más tardar en diciembre de 2026, y OpenID for Verifiable Credentials también lo usa.
Qué aspecto tiene un SD-JWT
Un SD-JWT es una cadena de partes separadas por virgulillas (~):
- El JWT firmado por el emisor,
header.payload.signature. - Una divulgación por cada claim revelado, cada una de ellas un array JSON codificado en Base64url con una sal aleatoria, el nombre del claim y su valor. Las divulgaciones de elementos de un array omiten el nombre.
- Un JWT de vinculación de clave opcional al final, que el titular firma para demostrar que la presentación es suya y que va destinada a este verificador. Si no lo hay, la cadena termina con una virgulilla.
Cómo usarlo
Pega el SD-JWT. Los saltos de línea y los espacios se ignoran, así que también funciona un token partido en varias líneas copiado de un registro.
Para comprobar la firma del emisor, introduce su clave pública como JWK, como conjunto JWK (se usa la clave con el kid del token), como clave pública PEM o como certificado X.509. También puedes pegar un JWK privado; solo se usa su parte pública. Cuando el campo de la clave está vacío, se usa el certificado del x5c de la cabecera del token, si lo hay.
Qué se muestra
- Comprobaciones de la firma, las divulgaciones, la vinculación de clave, el periodo de validez y el algoritmo de hash.
- Cabecera del JWT del emisor, con su algoritmo, su tipo (
dc+sd-jwtpara SD-JWT VC) y el ID de la clave. - Carga útil firmada, con los resúmenes (
_sd) de los claims ocultos y marcadores{"...": digest}para los elementos de array ocultos. - Claims con divulgaciones, la carga útil con cada divulgación colocada en su sitio, tal como la leería un verificador.
- Divulgaciones, una tabla con el claim de cada divulgación, su valor, el lugar que ocupa en los claims y su resumen.
- JWT de vinculación de clave, su cabecera y su carga útil con la audiencia (
aud), elnoncey elsd_hash.
Qué significan las comprobaciones
- Firma: el JWT del emisor está firmado con la clave que has introducido. Cuando la herramienta recurre al certificado de la cabecera, muestra que el token coincide con su propio certificado. Si ese certificado pertenece a un emisor de confianza, por ejemplo uno de las listas de confianza de la UE, es algo que esta comprobación no cubre.
- Divulgaciones: el resumen de cada divulgación aparece exactamente una vez en el token firmado. Una divulgación modificada tiene un resumen distinto, así que deja de coincidir, y se marca cualquier divulgación enviada dos veces.
- Vinculación de clave: el
sd_hashdel JWT de vinculación de clave es el hash de esta presentación exacta (el SD-JWT hasta la última virgulilla), y el JWT está firmado con la clave delcnfde la credencial. Quitar o añadir una divulgación rompe el hash. - Periodo de validez: las horas de expiración (
exp) y de inicio (nbf) del token, comparadas con el reloj de tu dispositivo. - Algoritmo de hash: los resúmenes usan el algoritmo de
_sd_alg, o SHA-256 cuando el token no indica ninguno. Los navegadores pueden calcular SHA-256, SHA-384 y SHA-512.
Privacidad
La decodificación y todas las comprobaciones se ejecutan en tu navegador, así que el token y las claves no se envían a ningún sitio. Las credenciales reales contienen datos personales, así que usa credenciales de prueba cuando compartas capturas de pantalla.