¿Qué es un JWT? Anatomía de la especificación RFC 7519
Un JSON Web Token (JWT), estandarizado en la norma RFC 7519, es un formato contenedor abierto, compacto y seguro para URLs diseñado para transmitir declaraciones (claims) verificables criptográficamente entre dos partes. Los JWT son el mecanismo dominante para la autenticación sin estado (stateless), gestión de sesiones, inicio de sesión único (SSO) y tokens de acceso OAuth 2.0 / OpenID Connect en arquitecturas modernas en la nube.
Un JWT compacto estándar se compone de tres cadenas distintas codificadas
en Base64URL y separadas por puntos (.):
header.payload.signature
-
1. Cabecera (JOSE Header):
Define los metadatos del token, incluido el tipo de token (
"typ": "JWT") y el algoritmo criptográfico de firma (como"alg": "HS256"o"alg": "RS256"). También puede especificar un identificador de clave ("kid") que indica qué clave pública de un conjunto JSON Web Key Set (JWKS) debe utilizarse para verificar la firma. -
2. Carga útil (Payload / Claims Set):
Contiene las declaraciones (claims) sobre el sujeto (usuario o
servicio). Las declaraciones se dividen en tres categorías: registradas
estándar (
iss,sub,exp), declaraciones públicas y declaraciones privadas personalizadas (como roles de usuario o IDs de inquilino). - 3. Firma (Signature): Se genera aplicando un hash a la cabecera y carga útil codificadas utilizando una clave secreta o clave privada. La firma garantiza la integridad de los datos: si un atacante modifica siquiera un solo carácter en la carga útil, la verificación de la firma falla instantáneamente.
Algoritmos Simétricos vs. Asimétricos: HS256 vs. RS256 / ES256
Al diseñar sistemas de autenticación, elegir entre criptografía simétrica y asimétrica es una decisión crítica:
- HS256 (HMAC con SHA-256): Un algoritmo simétrico en el que tanto el emisor del token (servicio de autenticación) como el verificador del token (servidor API) comparten exactamente la misma cadena secreta privada. HS256 es rápido y ligero, pero plantea riesgos de seguridad en microservicios distribuidos: si cualquier servicio secundario se ve comprometido, los atacantes obtienen el secreto compartido y pueden emitir tokens de administrador falsificados para toda la infraestructura.
-
RS256 / ES256 (Criptografía de Clave Pública RSA o ECDSA):
Un algoritmo asimétrico donde la autoridad de autenticación
firma el token usando una clave privada secreta,
mientras que todos los microservicios de API externos verifican la firma
utilizando la clave pública correspondiente. Dado que
las claves públicas pueden distribuirse libremente (normalmente a
través de endpoints estándar
/.well-known/jwks.json), las APIs secundarias pueden verificar tokens sin poseer la autoridad para crearlos.
Vulnerabilidades Críticas de Seguridad en JWT que Todo Ingeniero Debe Conocer
Los JWT introducen superficies de ataque significativas si la verificación en el backend está mal configurada:
-
El ataque del algoritmo "none" (CVE-2015-9235): La
especificación JWT permite un algoritmo llamado
"none"para tokens no asegurados. Las bibliotecas de backend vulnerables que leían ciegamente el campoalgde la cabecera aceptaban tokens falsificados cuyo algoritmo se establecía en"none"con una firma vacía. Los backends modernos deben definir estrictamente una lista blanca de algoritmos permitidos. -
Ataque de confusión de claves (HMAC vs. RSA): En
verificadores mal implementados que admiten tanto HS256 como RS256, un
atacante toma la clave pública RSA publicada por el servidor (visible
públicamente), cambia la cabecera a
"alg": "HS256"y firma el token usando la cadena de la clave pública como secreto simétrico HMAC. El servidor verifica el HMAC usando su clave pública y acepta erróneamente el token. - Decodificar no es Verificar: Las herramientas del lado del cliente (como este decodificador) solo deserializan cadenas JSON en Base64URL para que los humanos puedan inspeccionar las declaraciones. Inspeccionar declaraciones sin verificar criptográficamente la firma en un servidor backend seguro no ofrece ninguna garantía de autenticación.
Declaraciones Registradas Estándar en RFC 7519
Al inspeccionar las declaraciones del payload, encontrará abreviaturas registradas estándar:
-
iss(Issuer / Emisor): Identifica al principal que emitió el JWT (p. ej.,https://auth.empresa.com/). -
sub(Subject / Sujeto): Identifica al principal que es objeto del JWT (p. ej., ID de usuariousr_98124). -
aud(Audience / Audiencia): Identifica a los destinatarios para los que está destinado el JWT (p. ej.,https://api.empresa.com/v1/). -
exp(Expiration Time / Tiempo de Expiración): Marca de tiempo Unix en segundos después de la cual el token no debe ser aceptado. -
nbf(Not Before / No Antes De): Marca de tiempo Unix que identifica el momento antes del cual el JWT no debe ser aceptado. -
iat(Issued At / Emitido En): Marca de tiempo Unix que indica el momento en que se creó el JWT. -
jti(JWT ID): Identificador único criptográfico (nonce) para el token, utilizado para prevenir ataques de repetición (replay attacks).
Almacenamiento Seguro de Tokens: Cookies HttpOnly vs. LocalStorage
¿Dónde deben almacenar las aplicaciones cliente los tokens de acceso?
-
LocalStorage (Alto Riesgo de XSS): Cualquier script de
terceros, fragmento de analítica o extensión de navegador que se ejecute
en su origen tiene acceso total de lectura a
localStorage. Si un atacante descubre una vulnerabilidad XSS en su sitio, puede robar los tokens directamente. -
Cookies HttpOnly + Secure + SameSite (Recomendado): Una
cookie
HttpOnlyno puede ser accedida mediante JavaScript del lado del cliente, mitigando el robo de tokens vía XSS. Combinada conSameSite=LaxoSameSite=Strict, proporciona una sólida defensa contra ataques Cross-Site Request Forgery (CSRF).
Casos de Uso Prácticos en el Mundo Real
-
Diagnosticar solicitudes de API rechazadas: Inspeccione
las declaraciones
exp(expiración) ynbf(no antes de) para comprobar si un token fue rechazado debido a tiempos vencidos o desfase de reloj (clock drift). - Depurar el control de acceso basado en roles (RBAC): Examine las declaraciones personalizadas de rol, alcance (scope) o permisos en el payload para verificar qué privilegios posee realmente el cliente.
-
Solucionar problemas de integración con proveedores de identidad:
Compruebe las declaraciones
iss(emisor) yaud(audiencia) cuando una API rechaza tokens de un proveedor OAuth u OIDC. -
Verificar marcas de tiempo del token: Traduzca
declaraciones numéricas de época Unix (
iat,exp) a fechas legibles durante la depuración de autenticación. -
Inspeccionar metadatos de cabecera: Revise los campos
alg(algoritmo) ykid(ID de clave) de la cabecera al depurar fallos de verificación de firma.
Privacidad Absoluta
Sus tokens jamás tocan nuestros servidores. OmniTools opera bajo una estricta arquitectura de "Cero Subidas a Servidores". Cuando pega su JSON Web Token en este decodificador, la división de cadenas, la decodificación Base64URL, el análisis JSON y la inspección de declaraciones se ejecutan íntegramente dentro del entorno de su navegador local.
Sus credenciales de autenticación, tokens de sesión y declaraciones de identidad permanecen estrictamente confidenciales en su máquina.
Preguntas Frecuentes (FAQ)
¿Es seguro decodificar tokens JWT de producción en esta herramienta?
Sí. La decodificación Base64URL del encabezado y payload se ejecuta 100% en la memoria local de su navegador sin realizar peticiones de red. Sus tokens de acceso jamás salen de su dispositivo.
¿Cuáles son las tres partes de un JSON Web Token (JWT)?
Un token JWT según RFC 7519 consta de tres segmentos Base64URL separados por puntos: Header (algoritmo HS256/RS256), Payload (claims como sub, exp, iat) y Signature (firma criptográfica).