Decodificador de JWT

Pega un token para leer lo que dice y comprobarlo.

El token y cualquier clave que pegues se quedan en esta pestaña. No se envía nada a ningún lado.

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.

DatoNombreQué dice
issIssuer (emisor)Quién creó el token, a menudo la dirección del servidor de inicio de sesión.
subSubject (sujeto)De quién trata, normalmente un id de usuario que nunca cambia.
audAudience (audiencia)Qué servicios deben aceptarlo; los demás deben rechazarlo.
expExpiration time (vencimiento)El momento en que deja de ser válido.
nbfNot before (no antes de)El momento en que empieza a ser válido.
iatIssued at (emitido)Cuándo se creó.
jtiJWT IDUn 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:

algMétodoLo que necesitas
HS256, HS384, HS512HMAC con SHA-2El mismo secreto que usó el emisor
RS256, RS384, RS512RSA (PKCS#1 v1.5)La clave pública RSA del emisor
PS256, PS384, PS512RSA-PSSLa clave pública RSA del emisor
ES256, ES384, ES512ECDSA (P-256, P-384, P-521)La clave pública EC del emisor
EdDSAEd25519La 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

Ver todas las herramientas