Decodificador de JWT

Pegue un JSON Web Token y vea al instante la cabecera y la carga útil como JSON legible. El decodificador explica cada claim, convierte las marcas de tiempo en fechas, muestra si el token sigue siendo válido o ha caducado y verifica la firma con un secreto o una clave pública. Todo ocurre localmente: sus tokens no se envían a ningún servidor.

  • 100 % gratis
  • Sin registro
  • Privado & local
  • Funciona en el móvil
Un prefijo «Bearer» se elimina automáticamente.

■ Cabecera

■ Carga útil

Claims

■ Verificar la firma

Privacidad desde el diseño: todos los cálculos se realizan localmente en tu navegador. Tus datos no se envían a ningún servidor ni los guardamos.

Cómo usar el decodificador

  1. Pegue el token: un prefijo «Bearer» se elimina automáticamente.
  2. Lea la cabecera y la carga útil: los colores corresponden a las tres partes del token.
  3. Consulte los claims: exp, iat, nbf y los demás, con su significado y la fecha.
  4. Compruebe el estado: válido, caducado o todavía no válido.
  5. Opcional: verifique la firma con el secreto o la clave pública PEM.

¿Cómo está construido un JWT?

Un JSON Web Token (RFC 7519) consta de tres partes codificadas en Base64url y separadas por puntos: header.payload.signature. La cabecera indica el algoritmo de firma, por ejemplo HS256 o RS256. La carga útil contiene los claims: datos sobre el usuario y el token. La firma prueba que cabecera y carga útil no se han modificado. Importante: la carga útil no está cifrada. Cualquiera que tenga el token puede leerla, como muestra esta herramienta. Por eso nunca debe contener contraseñas ni datos sensibles.

Los claims más importantes

ClaimSignificadoEjemplo
issemisor del tokenhttps://auth.ejemplo.es
subsujeto, normalmente el ID de usuariouser_4711
audaudiencia, la API destinatariaapi.ejemplo.es
expfecha de caducidad (segundos Unix)1767225600
nbfno válido antes de1767222000
iatfecha de emisión1767222000
jtiID único del token9f1c…

Las marcas de tiempo se muestran como fecha y hora locales. Además, el decodificador calcula si el token ha caducado y cuánto tiempo le queda, lo que resulta útil al depurar errores 401 por sesiones caducadas.

Verificar la firma

Con los algoritmos HMAC (HS256, HS384, HS512), la firma se basa en un secreto compartido; introdúzcalo y marque si está codificado en Base64. Con los algoritmos asimétricos (RS256, PS256, ES256 y variantes) necesita la clave pública en formato PEM. La verificación usa la Web Crypto API de su navegador. Si el resultado es «Firma verificada», el token se firmó con la clave correcta y no ha sido modificado. Los tokens con alg: none no tienen firma y nunca deberían aceptarse en un servidor.

Seguridad al trabajar con tokens

  • No use decodificadores en línea desconocidos para tokens de producción: un token válido da acceso a una cuenta. Esta herramienta funciona sin conexión en su navegador.
  • Decodificar no es verificar: el servidor siempre debe comprobar la firma, exp, aud e iss.
  • Duración corta: los tokens de acceso deberían caducar en minutos, no en meses.
  • Almacenamiento: los tokens en localStorage son vulnerables a XSS; una cookie HttpOnly suele ser más segura.

Un ejemplo

Su frontend recibe un error 401 de la API. Copie el token de la cabecera Authorization en la pestaña de red del navegador y péguelo aquí. El decodificador muestra que exp correspondía a ayer a las 14:30: el token ha caducado y la renovación no funciona. En otro caso, aud contiene api-staging en lugar de la API de producción, señal de que la aplicación usa la configuración equivocada.

Errores frecuentes con JWT

Los problemas más comunes son tokens caducados, una diferencia de reloj entre servidores, una audiencia aud que no coincide con la API, o un algoritmo distinto del esperado. Compare siempre la cabecera y los claims con la configuración de su servidor.

Preguntas frecuentes

¿Se envía mi token a un servidor?

No. La decodificación y la verificación se hacen íntegramente en su navegador.

¿Puedo leer un token cifrado?

No. Un token JWE de cinco partes está cifrado y solo puede leerse con la clave de descifrado.

¿Por qué falla la verificación?

Secreto o clave incorrectos, secreto en Base64 sin marcar la opción, o un token modificado.

¿Qué significa «Sin claim de caducidad»?

El token no contiene exp y no caduca nunca, lo que es un riesgo de seguridad.

¿Qué es mejor, HS256 o RS256?

RS256 o ES256 cuando varios servicios verifican tokens, porque solo necesitan la clave pública.