Inspector defensivo de seguridad JWT
Ejecute una inspección estática defensiva sobre encabezados y payloads JWT en su navegador sin necesidad de clave secreta. Identifique alg: none, parámetros jku/x5u/jwk, patrones de traversal en kid, omisión de exp/iss/aud, datos sensibles en Base64URL y tokens sobredimensionados.
Cómo funciona
Numerosas vulnerabilidades graves en implementaciones JWT provienen de configuraciones inseguras en encabezados y claims más que de fallos matemáticos. Este analizador defensivo decodifica únicamente el encabezado y el payload en Base64URL dentro de su navegador —sin requerir clave secreta— y puntúa la postura de configuración conforme a RFC 7515/7519 sin realizar fuerza bruta ni generar tokens falsificados.
La inspección comprueba parámetros peligrosos (alg: "none", omisión de alg, firma vacía, URLs remotas jku/x5u, claves incrustadas jwk/x5c y patrones de traversal o inyección en kid), revisa los claims exp, nbf, iss, aud, sub y jti junto a duraciones excesivas, detecta contraseñas o datos personales expuestos en texto Base64URL legible y avisa cuando el token excede los límites de 4 KB y 8 KB.
Guía paso a paso con ejemplo real
Audite cualquier token de prueba en cuatro pasos locales y siga las recomendaciones concretas de mitigación.
1. Pegue un JWT o cargue los ejemplos de prueba
Introduzca un JWT compacto de tres partes o compare los modelos inseguro y sólido para entender el impacto de cada hallazgo.
2. Priorice los hallazgos críticos y altos
Resuelva primero parámetros como alg: "none", firmas ausentes o cabeceras dinámicas jku, x5u y jwk.
3. Revise kid, claims registrados y fuga de datos
Garantice la presencia de exp, iss y aud, y retire cualquier secreto, contraseña o dato sensible de payloads JWS sin cifrar.
4. Valide la corrección en herramientas complementarias
Use los enlaces directos hacia el verificador de firmas o el generador de claves RSA/EC para comprobar la versión corregida.
Ejemplo real: Detección múltiple en encabezado y payload
Header: {"alg":"none","kid":"../../etc/passwd","jku":"https://untrusted.example/jwks.json"} | Payload: {"sub":"user-42","password":"demo-only-plaintext-secret"}Riesgo Crítico · alg: "none" (Crítico), traversal en kid (Crítico), cabecera jku (Alto), falta de exp/iss/aud, clave password expuesta (Alto).Recuerde que Base64URL en un JWS solo codifica, no cifra; cualquier proxy o usuario puede inspeccionar sus claims al instante.
Errores comunes y notas de seguridad
Concatenar header.kid en rutas de archivo o consultas SQL
Un kid con secuencias ../ o comillas permite accesos indebidos. Restrinja kid estrictamente a diccionarios conocidos o al patrón `^[a-zA-Z0-9_-]+$`.
Consultar URLs remotas jku o x5u sin lista blanca
Descargar claves desde la URL declarada en un encabezado no verificado habilita ataques SSRF y suplantación de claves.
Guardar secretos o contraseñas dentro de un payload JWS
Los claims JWS son legibles por cualquiera; nunca incluya credenciales sin cifrar ni datos confidenciales innecesarios.
Emitir tokens sin expiración o de varios kilobytes
La ausencia de exp impide la caducidad automática y superar 4–8 KB provoca errores HTTP 431 o truncado en cookies.
Decodificador vs Analizador de seguridad vs Verificador
| Capacidad | Decodificador JWT | Analizador de seguridad | Verificador de firma |
|---|---|---|---|
| Lectura JSON de header y claims | Sí | Sí | Sí |
| Necesita secreto o clave pública | No | No | Sí |
| Revisión de jku/x5u/kid/PII/tamaño | Básica | Completa con puntuación | Firma y vigencia temporal |
| Prueba criptográfica de firma | No | No (auditoría estática) | Sí (WebCrypto) |
Ejemplos de código (Node.js, Python, Java)
Implemente validaciones defensivas previas equivalentes en el middleware de sus APIs:
export function assertSafeJwtPolicy(hdr: Record<string, unknown>, pay: Record<string, unknown>) {
if (!hdr.alg || String(hdr.alg).toLowerCase() === 'none') throw new Error('alg none');
if ('jku' in hdr || 'x5u' in hdr || 'jwk' in hdr) throw new Error('Dynamic key header');
if (typeof hdr.kid === 'string' && !/^[a-zA-Z0-9_-]+$/.test(hdr.kid)) throw new Error('Bad kid');
if (typeof pay.exp !== 'number' || typeof pay.aud !== 'string') throw new Error('Missing claims');
}import re
SAFE_KID = re.compile(r"^[A-Za-z0-9_-]+$")
def check_jwt_hygiene(hdr: dict, pay: dict) -> list[str]:
issues = []
if str(hdr.get("alg", "")).lower() in ("", "none"): issues.append("Unsafe alg")
if any(k in hdr for k in ("jku", "x5u", "jwk")): issues.append("Header injection")
if isinstance(hdr.get("kid"), str) and not SAFE_KID.match(hdr["kid"]): issues.append("Unsafe kid")
if not all(c in pay for c in ("exp", "iss", "aud")): issues.append("Missing claims")
return issuesPattern SAFE_KID = Pattern.compile("^[A-Za-z0-9_-]+$");
if (alg == null || "none".equalsIgnoreCase(alg)) throw new SecurityException("alg none");
if (hasJkuOrX5u) throw new SecurityException("Remote key header");
if (kid != null && !SAFE_KID.matcher(kid).matches()) throw new SecurityException("Bad kid");Preguntas frecuentes
¿Una puntuación de 100/100 demuestra que la firma del token es válida?
No. El analizador revisa exclusivamente la configuración estática de cabeceras y claims sin validar firmas; combine siempre esta revisión con verificación criptográfica en servidor.
¿Por qué marcan riesgo alto las cabeceras jku, x5u y jwk?
Porque provienen de un encabezado aún sin validar y permiten que un atacante dirija al servidor hacia claves propias o servicios internos (SSRF).
¿Puede esta herramienta crackear secretos débiles?
No. Es estrictamente un analizador defensivo de configuración: no realiza fuerza bruta ni falsifica tokens.
¿Por qué advierte sobre campos como password o email en el payload?
Porque JWS únicamente codifica en Base64URL sin cifrado. Las contraseñas jamás deben ir en tokens y conviene minimizar PII.
¿Por qué importa el tamaño en bytes de un JWT?
Superar los 4,096 bytes rompe el almacenamiento típico por cookie y pasar de 8,192 bytes desencadena rechazos HTTP 431 en proxies.
¿Se envía el token a servidores externos al analizarlo?
Nunca. Toda la inspección ocurre localmente en la memoria de su navegador.
Herramientas relacionadas
Acerca del autor
Avada Labs crea herramientas gratuitas para desarrolladores, incluido este sitio, con seis años de experiencia en desarrollo web y herramientas en línea. Los proyectos y el código fuente están en GitHub.