Saltar al contenido

Decodificador y depurador de JWT

  • Funciona en tu dispositivo
  • Funciona sin conexión una vez cargada

Pega un JSON Web Token para leer su encabezado y su contenido, ver cuándo caduca y comprobar la firma con un secreto o una clave pública. Los claims de tiempo se muestran como fechas legibles. Los tokens se decodifican en tu navegador y nunca se transmiten.

Cómo funciona

  1. Pega tu JWT.
  2. Lee el encabezado, los claims y el estado de caducidad.
  3. Si quieres, escribe un secreto o una clave pública para verificar la firma.

Por qué usarla

  • Fechas legibles para exp, iat y nbf.
  • Verifica firmas HMAC, RSA y ECDSA.
  • Muestra avisos sobre algoritmos como none.
  • Tu token nunca sale de la página.

Leer y comprobar JSON Web Tokens

Qué hay dentro de un token

Un JSON Web Token son tres trozos de texto Base64 unidos por puntos: una cabecera, una carga útil y una firma. La cabecera nombra el algoritmo de firma; la carga útil contiene los claims, como quién es el usuario y cuándo caduca el token; la firma demuestra que quien creó el token conocía la clave. Pega un token y los dos primeros trozos se decodifican y se muestran como JSON, con los claims estándar explicados con palabras sencillas:

ClaimSignificado
issEmisor: el servicio que creó el token
subSujeto: normalmente el identificador del usuario
audAudiencia: el servicio al que va destinado el token
expCaducidad: después de este momento el token debe rechazarse
nbfNo válido antes de este momento
iatEmitido: cuándo se creó el token
Las horas son marcas de tiempo Unix; el decodificador las muestra como fechas y te dice si el token ha caducado.

Decodificar no es verificar

Cualquiera puede decodificar un JWT; la carga útil no está cifrada, solo codificada. Así que nunca pongas secretos en un token, y nunca confíes en los claims de un token hasta haber comprobado su firma. Para verificar uno aquí, pega la clave:

  • HS256, HS384, HS512 usan un único secreto compartido, el mismo en ambos lados. Marca la opción Base64 si el secreto está guardado así.
  • Los algoritmos RS, PS y ES usan un par de claves: el token se firma con una clave privada y se comprueba con la clave pública, que puedes pegar como clave PEM, certificado o JWK.

Un token firmado con alg: none no tiene ninguna firma, y el decodificador te avisa: un servidor que lo aceptara confiaría en cualquiera que edite la carga útil. Siempre hay que indicar a las bibliotecas qué algoritmos aceptar.

Mantén privados los tokens de producción

Un token válido es una llave: quien lo tiene puede actuar como ese usuario hasta que caduque. Por eso este decodificador funciona por completo en tu navegador, y por eso conviene tener cuidado con las herramientas en línea que envían el token a un servidor. Usa tokens de prueba cuando puedas, y considera filtrado cualquier token real que hayas pegado en un sitio público.

Crear tokens de prueba

La pestaña Codificar firma tokens con tu propia cabecera, carga útil y clave, usando cualquiera de los doce algoritmos. Puede añadir la hora de emisión y una caducidad un número elegido de minutos más adelante. Útil para probar cómo maneja una API los tokens caducados, las audiencias equivocadas o los claims que faltan, sin tocar un inicio de sesión real.

Si algo sale mal

  • Dice que el token no es válido. Un JWT debe tener exactamente dos puntos. Comprueba que no se cortó nada al copiar; un Bearer al principio se quita por ti.
  • La firma no se verifica. La clave es incorrecta, el secreto debe leerse como Base64, o el token se modificó después de firmarlo.
  • Dice que el token caducó, pero el servidor lo acepta. El servidor puede permitir cierto margen de reloj, o no comprobar la caducidad en absoluto, lo que conviene corregir.

Preguntas y respuestas

¿Es seguro pegar un token real?

La decodificación se hace en local y no se envía nada. Aun así, trata los tokens de producción como secretos y usa tokens de prueba cuando puedas.

¿Puede verificar una firma?

Sí, con el secreto compartido para HS256 o la clave pública para RS256 y ES256.

¿Por qué mi token aparece como caducado?

El claim exp es una hora Unix. La herramienta la compara con el reloj de tu dispositivo.

Esc