Cómo usar el decodificador
- Pegue el token: un prefijo «Bearer» se elimina automáticamente.
- Lea la cabecera y la carga útil: los colores corresponden a las tres partes del token.
- Consulte los claims: exp, iat, nbf y los demás, con su significado y la fecha.
- Compruebe el estado: válido, caducado o todavía no válido.
- 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
| Claim | Significado | Ejemplo |
|---|---|---|
iss | emisor del token | https://auth.ejemplo.es |
sub | sujeto, normalmente el ID de usuario | user_4711 |
aud | audiencia, la API destinataria | api.ejemplo.es |
exp | fecha de caducidad (segundos Unix) | 1767225600 |
nbf | no válido antes de | 1767222000 |
iat | fecha de emisión | 1767222000 |
jti | ID único del token | 9f1c… |
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.