Decodificador de JWT
Pega un token para leer lo que dice y comprobarlo.
El token
Encabezado (header)
Contenido (payload)
Los datos, explicados
Comprobar la firma
Cómo está hecho un JWT
Un JSON Web Token son tres trozos de Base64url separados por puntos: un encabezado, un contenido con los datos (claims) y una firma. Los dos primeros son JSON que cualquiera puede decodificar. Este es el clásico token de ejemplo de jwt.io, y lo que dicen sus partes:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ
.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
encabezado: {"alg":"HS256","typ":"JWT"}
contenido: {"sub":"1234567890","name":"John Doe","iat":1516239022}El encabezado dice que el token está firmado con HS256. El contenido dice de quién trata (sub), un nombre y cuándo se emitió: iat es 1516239022 segundos después del 1 de enero de 1970, o sea el 18 de enero de 2018 a las 01:30:22 UTC. La tercera parte son 32 bytes de HMAC-SHA-256, hechos con el secreto your-256-bit-secret; pega el token arriba y escribe ese secreto para verlo verificado.
Los datos registrados
El RFC 7519 define siete nombres de datos que significan lo mismo en cualquier token. Todos son opcionales; el emisor decide cuáles incluir.
| Dato | Nombre | Qué dice |
|---|---|---|
iss | Issuer (emisor) | Quién creó el token, a menudo la dirección del servidor de inicio de sesión. |
sub | Subject (sujeto) | De quién trata, normalmente un id de usuario que nunca cambia. |
aud | Audience (audiencia) | Qué servicios deben aceptarlo; los demás deben rechazarlo. |
exp | Expiration time (vencimiento) | El momento en que deja de ser válido. |
nbf | Not before (no antes de) | El momento en que empieza a ser válido. |
iat | Issued at (emitido) | Cuándo se creó. |
jti | JWT ID | Un id único, para que un servidor pueda rechazar el mismo token dos veces. |
exp, nbf e iat se cuentan en segundos desde el 1970-01-01 00:00 UTC, el tiempo Unix. Esta página muestra cada uno en tu zona horaria, en UTC y como “dentro de 2 horas” o “hace 3 días”; para convertir otros timestamps, usa el convertidor de timestamp Unix.
Firmado no es cifrado
La firma prueba quién hizo el token y que nadie lo cambió, pero no oculta nada. Cualquiera que tenga un JWT puede leer su contenido: es solo Base64url, que también lee el decodificador de Base64. Nunca pongas contraseñas, números de tarjeta ni nada secreto en los datos de un token.
Los tokens cuyo contenido debe ser privado usan otro formato, JWE, que tiene cinco partes en lugar de tres. Esta página los reconoce, pero no puede leerlos sin la clave.
Cómo se comprueba la firma
La firma se calcula sobre las dos primeras partes tal como están escritas, encabezado, un punto y contenido, así que cambiar un solo carácter de cualquiera la invalida. Lo que necesitas para comprobarla depende del algoritmo del encabezado:
| alg | Método | Lo que necesitas |
|---|---|---|
HS256, HS384, HS512 | HMAC con SHA-2 | El mismo secreto que usó el emisor |
RS256, RS384, RS512 | RSA (PKCS#1 v1.5) | La clave pública RSA del emisor |
PS256, PS384, PS512 | RSA-PSS | La clave pública RSA del emisor |
ES256, ES384, ES512 | ECDSA (P-256, P-384, P-521) | La clave pública EC del emisor |
EdDSA | Ed25519 | La clave pública Ed25519 del emisor |
El emisor publica sus claves públicas, normalmente como un conjunto JWK en una dirección como https://emisor/.well-known/jwks.json; un proveedor de OpenID Connect indica esa dirección como jwks_uri en /.well-known/openid-configuration. El kid del encabezado dice cuál clave del conjunto lo firmó. Puedes pegar aquí el conjunto completo: se usa la clave con el mismo kid. También sirven una clave pública PEM, un certificado PEM y un solo JWK.
Problemas comunes
- Venció un poco antes o un poco después: los relojes del emisor y del servidor no coinciden. Los servidores suelen dar uno o dos minutos de margen.
- Una fecha dentro de decenas de miles de años: exp se escribió en milisegundos (Date.now() en JavaScript) en lugar de segundos. Esta página avisa cuando ve una.
- Firma no válida con el secreto correcto: el secreto está guardado en Base64 y hay que decodificarlo primero, o al revés. Prueba la casilla “El secreto está en Base64”.
- Firma no válida con la clave correcta: el emisor rotó sus claves, y el kid del encabezado apunta a una más nueva que la que tienes.
- Firma no válida después de copiar: se cortó o cambió un carácter. Aquí se quitan las comillas, los saltos de línea y “Bearer ”, pero un carácter que falta no se puede recuperar.
- alg “none” o un algoritmo cambiado: un servidor debe decidir qué algoritmo acepta y nunca tomarlo del token, o un atacante puede enviar un token sin firma, o firmar uno con HS256 usando como secreto la clave pública RSA del servidor.
De dónde salen los tokens
La mayoría de los JWT viajan en un encabezado HTTP, Authorization: Bearer seguido del token, o en una cookie. Con OpenID Connect, iniciar sesión devuelve un token de ID, que siempre es un JWT y le describe el usuario a la app. Los tokens de acceso de OAuth 2.0, que una app envía a una API, también suelen ser JWT, pero algunos proveedores los hacen cadenas opacas que no se pueden decodificar; eso no es un error.
Preguntas
¿Es seguro pegar mi token aquí?
Esta página decodifica y verifica el token en tu navegador y no lo envía a ningún lado, cosa que puedes comprobar usándola sin conexión. Aun así, un token vigente funciona como una contraseña hasta que vence: quien lo tenga puede actuar como tú. Pegarlo en un sitio que lo envía a un servidor es entregarlo, así que usa tokens de prueba o vencidos en cualquier sitio en el que no confíes.
¿Puedo cambiar un dato y que el token siga siendo válido?
No. Cambiar cualquier carácter del encabezado o del contenido rompe la firma, y hacer una nueva válida requiere el secreto o la clave privada. Justo para eso existe la firma.
¿Por qué el token dice “Sin fecha de vencimiento”?
No tiene el dato exp. Está permitido, pero un token así sigue siendo válido hasta que el servidor deje de aceptarlo de otra forma, por ejemplo cambiando su clave; por eso la mayoría de los emisores incluyen exp.
¿Qué diferencia hay entre un token de ID y un token de acceso?
Un token de ID le dice a la app quién inició sesión y está hecho para que la app lo lea; su aud es el client id de la app. Un token de acceso es una llave para llamar a una API; su aud es la API, y la app no debería depender de lo que contiene.
Más herramientas para desarrolladores
-
Formateador y validador de JSON
Formatea, minifica y valida JSON, con errores claros y sin alterar los números grandes.
-
Generador de hash
MD5, SHA-1 y SHA-256 de textos o archivos, y comprueba el checksum de una descarga.
-
Convertidor de timestamp Unix
Convierte timestamps Unix en fechas y fechas en timestamps, en tu zona horaria y en UTC.