Cómo usar la herramienta Decodificador JWT
- Pega tu tokenPega un JWT en el recuadro. El prefijo “Bearer ” y los saltos de línea se quitan automáticamente.
- Lee el contenidoEl header y el payload se decodifican con colores, y cada claim se explica en lenguaje sencillo.
- Revisa las fechasLa caducidad (exp), la emisión (iat) y el “no antes de” (nbf) se convierten en fechas, con una etiqueta clara de Caducado / No caducado.
- Verifica la firmaEn tokens HS256, HS384 o HS512, introduce el secreto compartido para confirmar que el token es auténtico.
Funciones
- Decodificación instantáneaLos resultados se actualizan al pegar. Sin botones ni esperas.
- Claims legiblesLos claims estándar como iss, sub, aud y exp aparecen etiquetados y explicados.
- Estado de caducidadVe de un vistazo si el token ha caducado o aún no es válido.
- Comprobación de firmaVerifica tokens firmados con HMAC usando WebCrypto, en tu propio navegador.
¿Qué es un JWT?
Un JSON Web Token (JWT, pronunciado «jot») es una forma compacta y segura para URL de transmitir afirmaciones (claims) entre dos partes. Se usa mucho en sesiones de inicio de sesión, autenticación de API y acceso único (OAuth 2.0 y OpenID Connect). Un JWT tiene tres partes separadas por puntos:
- Cabecera: el tipo de token y el algoritmo de firma, como HS256 o RS256.
- Contenido (payload): los claims, por ejemplo quién es el usuario y cuándo caduca el token.
- Firma: demuestra que el token lo creó alguien con la clave y que no se ha modificado.
La cabecera y el contenido solo van codificados en Base64URL, no cifrados. Cualquiera que tenga el token puede leerlos, que es justo lo que hace esta herramienta. Nunca pongas contraseñas u otros secretos en el contenido de un JWT. Los resultados se actualizan al pegar, sin botones ni esperas.
Claims estándar
| Claim | Significado |
|---|---|
| iss | Emisor: quién creó el token |
| sub | Sujeto: normalmente el ID de usuario |
| aud | Audiencia: para qué app o API es el token |
| exp | Fecha de caducidad, como timestamp Unix en segundos |
| nbf | No antes de: el token no es válido antes de esta fecha |
| iat | Emitido: cuándo se creó el token |
| jti | ID del JWT: identificador único para evitar reutilizaciones |
Las fechas se muestran en hora legible, con una etiqueta «Caducado» o «No caducado» según la hora actual de tu dispositivo. Para convertir otro timestamp, usa el Conversor de timestamp.
Decodificar no es verificar
Decodificar solo muestra lo que el token dice. Antes de confiar en él, un servidor debe verificar la firma, comprobar exp y nbf y confirmar el emisor y la audiencia. Los tokens con "alg": "none" no tienen firma y siempre deben rechazarse.
- HS256, HS384, HS512 usan un secreto compartido para firmar y verificar. Escríbelo arriba para verificar; la comprobación se hace con WebCrypto en tu navegador. Si el secreto está codificado, marca «El secreto está en Base64».
- RS256, ES256, PS256 y similares firman con una clave privada y se verifican con una clave pública, que el emisor suele publicar en un endpoint JWKS. Verifícalos en tu backend con una biblioteca de confianza.
Consejos de seguridad
- Haz que los tokens de acceso duren poco (minutos, no días) y usa tokens de actualización para sesiones largas.
- Usa un secreto largo y aleatorio con los algoritmos HMAC; uno corto o adivinable se puede romper sin conexión. Nuestro Generador de contraseñas puede crear uno.
- Pega tokens de producción solo en herramientas que funcionan en local, como esta.