Qué Es Realmente un JWT
Un JSON Web Token (JWT) es una forma compacta y segura para URL de representar afirmaciones (claims) entre dos partes. Se usa sobre todo para autenticación y autorización: tras iniciar sesión, un servidor emite un token firmado, y tu cliente lo reenvía en cada petición para demostrar quién eres. Un JWT no está cifrado por defecto — está firmado. Cualquiera que tenga el token puede leer su contenido; la firma solo garantiza que el contenido no se ha alterado y que lo emitió alguien que posee la clave de firma.
Esa distinción es lo más importante que hay que entender sobre los JWT, y es la razón por la que un decodificador como este puede leer cualquier token sin un secreto, mientras que verificar su autenticidad requiere la clave.
Los Tres Segmentos
Un JWT son tres segmentos codificados en base64url unidos por puntos: header.payload.signature.
- Cabecera — un pequeño objeto JSON que describe el token, sobre todo el algoritmo de firma (
alg, p. ej. HS256 o RS256) y el tipo (typ, normalmente "JWT"). Puede incluir un id de clave (kid) que indica qué clave lo firmó.
- Payload — el objeto JSON que lleva los claims: sobre quién es el token, quién lo emitió, cuándo caduca y cualquier dato personalizado que necesite la aplicación.
- Firma — una firma criptográfica sobre la cabecera y el payload, creada con el algoritmo indicado en la cabecera. Es lo que hace fiable al token.
Claims Estándar (Registrados)
La especificación JWT define un conjunto de claims registrados con significados acordados:
iss (issuer) — quién creó y firmó el token.sub (subject) — el principal sobre el que trata el token, a menudo un id de usuario.aud (audience) — el destinatario previsto; un token para una API debería ser rechazado por otra.exp (expiration) — una marca de tiempo Unix tras la cual el token debe rechazarse.nbf (not before) — una marca de tiempo antes de la cual el token aún no es válido.iat (issued at) — cuándo se creó el token.jti (JWT id) — un identificador único, útil para listas de revocación.
Esta herramienta convierte los claims de marca de tiempo en fechas legibles y muestra si el token está dentro de su ventana de validez — la fuente más frecuente de errores de autenticación del tipo "funciona en mi máquina pero falla en staging", que a menudo son solo problemas de reloj o de caducidad.
Cómo Funciona la Verificación de Firma
La firma se calcula sobre la cadena base64url(cabecera) + "." + base64url(payload). Con un algoritmo simétrico como HS256, el mismo secreto firma y verifica, usando un HMAC con SHA-256. Con un algoritmo asimétrico como RS256 o ES256, una clave privada firma y la clave pública correspondiente verifica — por eso los servicios pueden publicar su clave pública (a menudo vía un endpoint JWKS) para que cualquiera valide tokens sin poder falsificarlos. Para verificar en esta herramienta, proporcionas el secreto HMAC o la clave pública PEM, y la Web Crypto API del navegador recalcula y compara la firma localmente.
Errores de Seguridad a Evitar
- Fiarse de un payload decodificado. Decodificar no prueba nada. Nunca actúes sobre los claims hasta que la firma se verifique contra una clave de confianza.
- La trampa "alg: none". Algunas librerías históricamente aceptaban tokens con el algoritmo a "none", saltándose la verificación. Fija siempre el algoritmo esperado en el servidor.
- Poner secretos en el payload. Como el payload es legible por cualquiera, nunca guardes contraseñas ni secretos sensibles en él.
- Ignorar la caducidad. Un token sin un
exp corto, o un servidor que no lo comprueba, es una credencial de larga vida esperando a ser robada.
- Filtrar tokens a terceros. Pegar un token activo en una herramienta online del lado del servidor envía tu credencial de sesión a ese servidor. Usa un decodificador del lado del cliente como este.