Buenas prácticas de seguridad con JWT en producción (algorithms, exp, aud/iss y revocación)

¿Por qué son importantes las buenas prácticas de seguridad con JWT?

Los JWT son una forma popular de transmitir información de forma segura entre las partes. Sin embargo, su diseño sin estado y la flexibilidad que ofrecen, también los convierte en un objetivo atractivo para ataques si no se implementan con las precauciones adecuadas. Un JWT comprometido puede permitir a un atacante acceder a recursos protegidos, suplantar la identidad de un usuario, o incluso comprometer todo el sistema. La falta de una configuración segura puede llevar a problemas de seguridad críticos y costosos.

Paso a paso: Implementando JWT seguro en producción

A continuación, te presentamos un enfoque estructurado para implementar JWT de forma segura, con ejemplos prácticos y consideraciones clave:

1. Define una política clara de emisión y consumo de tokens

Establecer una política clara desde el principio es crucial. Define quién emite los tokens (tu servidor de autenticación) y quién los consume (tus APIs, aplicaciones cliente). Documenta los valores de iss (issuer) y aud (audience) por entorno (desarrollo, staging, producción). Esto te ayudará a evitar que tokens emitidos en un entorno de pruebas sean accidentalmente aceptados en producción, lo que podría comprometer la seguridad. Además, define el ciclo de vida de los tokens, incluyendo la duración de los access tokens y refresh tokens.

2. Restringe los algoritmos permitidos (lista blanca)

Nunca confíes en el algoritmo especificado en el header del JWT. En su lugar, configura tu backend para que solo acepte algoritmos específicos y conocidos (por ejemplo, RS256, HS256). Rechaza cualquier token que utilice un algoritmo no permitido, incluyendo alg=none, ya que este es un vector de ataque común. Implementa esta lista blanca en el lado del servidor, en el código que verifica la firma del JWT. Esto protege contra ataques de "algoritmo de firma de clave vacía".

Ejemplo (Node.js con jsonwebtoken):

const jwt = require('jsonwebtoken');
const publicKey = fs.readFileSync('public.pem', 'utf8'); // Carga la clave pública

try {
  jwt.verify(token, publicKey, { 
    algorithms: ['RS256'], // Lista blanca de algoritmos permitidos
    issuer: 'https://tu-idp.com', 
    audience: 'api://tu-app' 
  });
  // Token válido
} catch (err) {
  // Manejo de errores (token inválido, expirado, etc.)
  console.error('Error al verificar el token:', err.message);
}

3. Establece expiraciones cortas y gestiona los refresh tokens

Utiliza expiraciones cortas para los access tokens (por ejemplo, entre 5 y 15 minutos). Esto limita el impacto de un token comprometido. Implementa un mecanismo de refresh tokens para extender la sesión del usuario sin requerir que vuelva a introducir sus credenciales. Los refresh tokens deben tener una vida útil más larga y deben ser almacenados de forma segura (por ejemplo, en cookies HttpOnly y Secure). Implementa rotación de refresh tokens para mayor seguridad.

4. Implementa mecanismos de revocación de tokens

Los JWT por sí mismos no se revocan. Si un token ha sido comprometido (por ejemplo, la cuenta del usuario ha sido hackeada), necesitas tener una forma de invalidarlo inmediatamente. Aquí tienes algunas opciones:

• Denylist (lista negra): Guarda los JWT revocados en una lista negra (puede ser en caché, base de datos, etc.). Antes de validar un token, verifica si está en la lista negra.
• TTL corto + rotación de claves: Usa tiempos de vida muy cortos para los tokens (minutos) y rota las claves de firma con frecuencia. Esto limita el tiempo durante el cual un token comprometido puede ser utilizado.
• Introspección (si usas un proveedor externo): Muchos proveedores de identidad (IdP) ofrecen una API de introspección de tokens. Puedes usar esta API para verificar la validez de un token y su estado de revocación.

5. Valida siempre los claims (iss, aud, exp, jti)

Además de verificar la firma, es crucial validar los claims (declaraciones) del JWT. Esto incluye:

• iss (Issuer): Verifica que el emisor del token sea el esperado (tu servidor de autenticación).
• aud (Audience): Verifica que el token está destinado a tu aplicación o API.
• exp (Expiration Time): Asegúrate de que el token no haya expirado.
• jti (JWT ID - opcional, pero recomendado): Un identificador único para el token. Puedes usarlo para rastrear y revocar tokens individuales.

6. Registra logs detallados y monitoriza

Implementa logs exhaustivos para detectar y diagnosticar problemas de seguridad. Registra la siguiente información:

• Intentos de autenticación fallidos.
• Errores de verificación de JWT (firma inválida, expiración, etc.).
• El kid (Key ID) del token.
• El issuer (iss) y la audience (aud) del token.
• Diferencias significativas en la hora del reloj entre el servidor y el cliente.

Monitoriza estos logs en busca de patrones sospechosos que puedan indicar un ataque.

7. Asegura el almacenamiento de los tokens

La forma en que almacenas los tokens JWT en el lado del cliente (por ejemplo, en el navegador) es fundamental para la seguridad. Evita almacenar los tokens en el localStorage o sessionStorage, ya que son vulnerables a ataques XSS (Cross-Site Scripting). En su lugar, considera las siguientes opciones:

• Cookies HttpOnly y Secure: Esta es la opción más segura para aplicaciones web tradicionales. Las cookies HttpOnly no son accesibles desde JavaScript, lo que mitiga el riesgo de XSS. La bandera Secure asegura que la cookie solo se transmite a través de HTTPS. Asegúrate de configurar también el atributo SameSite de la cookie para proteger contra ataques CSRF (Cross-Site Request Forgery).
• Encabezados de autorización (Authorization Headers): Para aplicaciones de una sola página (SPAs) y APIs, puedes enviar el token en el encabezado Authorization (por ejemplo, Authorization: Bearer <token>).

8. Implementa una rotación segura de claves

La rotación de claves es una práctica esencial. Si la clave de firma se ve comprometida, la rotación de claves limita el daño. Implementa un proceso para rotar periódicamente las claves de firma y verificación. Asegúrate de que tu aplicación pueda manejar las claves antiguas y nuevas durante un período de transición. Documenta el proceso de rotación de claves y comunícalo a tu equipo.

Checklist de buenas prácticas para la seguridad JWT en producción

Usa esta checklist como guía rápida para asegurarte de que tu implementación de JWT es segura:

• [ ] Define y documenta una política de emisión y consumo de tokens, incluyendo iss y aud por entorno.
• [ ] Implementa una lista blanca de algoritmos permitidos y rechaza cualquier otro.
• [ ] Usa expiraciones cortas para access tokens (minutos) y refresh tokens por otro canal.
• [ ] Implementa un mecanismo de revocación (denylist, TTL corto + rotación, o introspección).
• [ ] Valida los claims iss, aud, exp y, opcionalmente, jti en cada solicitud.
• [ ] Implementa logs detallados para monitorizar la actividad de los tokens y detectar anomalías.
• [ ] Almacena los tokens de forma segura (cookies HttpOnly y Secure, o encabezados de autorización).
• [ ] Implementa la rotación de claves periódicamente.

Errores comunes y cómo solucionarlos

Error: Aceptar tokens sin exp

Problema: Aceptar tokens sin una fecha de expiración (exp) crea tokens que nunca expiran, lo que representa un riesgo significativo de seguridad. Este error puede ser el resultado de una configuración incorrecta o de la compatibilidad con sistemas más antiguos.

Solución: Nunca aceptes tokens sin exp. Si necesitas dar soporte a clientes legacy, asegúrate de que el token siempre tenga un exp, incluso si es en un futuro muy lejano. Rechaza cualquier token que no tenga el claim exp.

Error: Usar el mismo issuer y audience en todos los entornos

Problema: Usar los mismos valores de iss y aud en desarrollo, staging y producción facilita que un atacante cree o utilice tokens válidos en diferentes entornos. Esto puede llevar a errores de seguridad y a la exposición de datos sensibles.

Solución: Configura valores diferentes para iss y aud en cada entorno (desarrollo, staging, producción). Documenta claramente estos valores. Esto garantiza que los tokens emitidos para un entorno no sean válidos en otro.

Error: Guardar JWT en localStorage en SPAs sin medidas anti-XSS

Problema: El almacenamiento de JWT en localStorage hace que el token sea vulnerable a ataques XSS (Cross-Site Scripting). Si un atacante puede inyectar código malicioso en tu aplicación, puede robar el token y obtener acceso no autorizado.

Solución: No guardes los JWT en localStorage. Utiliza cookies HttpOnly y Secure, o envía el token en el encabezado de autorización (Authorization) para mitigar el riesgo de XSS.

Error: Verificar la firma, pero no los claims

Problema: La validación de la firma es solo una parte de la seguridad de JWT. Si solo verificas la firma, pero no los claims (como iss y aud), un atacante podría crear un token firmado por él mismo y con claims modificados, que tu aplicación aceptaría como válido.

Solución: Verifica siempre la firma y los claims. Valida iss (emisor), aud (audiencia) y exp (expiración) al recibir el token.

Error: No controlar el tamaño de los tokens

Problema: Los tokens JWT muy grandes pueden afectar el rendimiento de la aplicación y el almacenamiento de logs. Pueden causar problemas de rendimiento en la red y en el lado del servidor, además de dificultar el análisis de logs.

Solución: Mantén los tokens pequeños. Evita incluir datos innecesarios en el payload del token. Si necesitas información adicional, almacénala en el servidor y utiliza el token para identificar al usuario. Considera limitar el tamaño máximo del token en tu aplicación.

Preguntas frecuentes sobre la seguridad JWT en producción

Recomendaciones finales

La seguridad de JWT en producción requiere un enfoque proactivo y la aplicación consistente de las mejores prácticas. Recuerda que la seguridad es un proceso continuo. Mantente actualizado sobre las últimas amenazas y vulnerabilidades, y revisa regularmente tu implementación de JWT. La elección de las opciones de seguridad dependerá de tu arquitectura, tus requisitos de seguridad y el nivel de riesgo que estés dispuesto a asumir.

• Para aplicaciones con alta sensibilidad de datos: Prioriza el uso de RS256 con claves robustas y rotación frecuente. Implementa una sólida estrategia de revocación y monitorización.
• Para microservicios: Utiliza RS256 y un proveedor de identidad centralizado para simplificar la gestión de la autenticación y autorización.
• Para SPAs (Single-Page Applications): Utiliza cookies HttpOnly y Secure para almacenar los tokens y mitigar los riesgos de XSS. Implementa también CSRF protection.