Buenas prácticas para implementar JWT de forma segura

Los JWT solo son tan seguros como su implementación. La especificación es flexible; la flexibilidad crea vulnerabilidades. Siga estas prácticas recomendadas para evitar los errores comunes que han provocado omisiones de autenticación en sistemas de producción.

Especifique siempre explícitamente el algoritmo esperado: jwt.decode(token, key, algorithms=["RS256"]). Nunca lea el algoritmo del encabezado del token para seleccionar la clave de verificación o la ruta de código. Esto evita los ataques alg=none y de confusión de claves.

Tokens de acceso: 15-60 minutos. Tokens de actualización: 7-30 días, almacenados en cookies httpOnly (no en localStorage). Al caducar, el cliente utiliza el token de actualización para obtener un token de acceso nuevo del servidor de autenticación sin volver a autenticarse.

Valide aud (audiencia) para asegurarse de que el token se emitió para su servicio y no para otro. Valide iss (emisor) frente a la URL de su servidor de autenticación. Sin estas comprobaciones, se aceptaría un token de otra aplicación firmado con la misma clave.

Tokens de acceso en memoria (variable de JS): se eliminan al cerrar la pestaña. Tokens de actualización en cookies httpOnly, Secure, SameSite=Strict: inaccesibles para JavaScript. Nunca almacene JWT en localStorage: XSS puede robárselos.

Los JWT no tienen estado: no existe una revocación incorporada. Opciones: mantener una lista de revocación (denylist) que se compruebe en cada solicitud; usar una caducidad muy breve; usar tokens opacos con una consulta centralizada para contextos de alta seguridad.

Rote periódicamente las claves de firma. Publique varias claves en JWKS con distintos valores de kid. Durante la rotación: emita tokens nuevos con el kid nuevo, mantenga activa la clave antigua hasta que caduquen los tokens antiguos y, después, elimine la clave antigua de JWKS.

Nunca incluya datos sensibles (contraseñas, SSN, tarjetas de crédito) en la carga útil del JWT: está codificada en base64url, no cifrada. Use JWE (JSON Web Encryption) si necesita declaraciones cifradas o mantenga los datos sensibles en el servidor.

Transmita JWT únicamente mediante HTTPS. Un JWT interceptado mediante HTTP permite omitir por completo la autenticación. Establezca la marca Secure en las cookies. Use HSTS para evitar la degradación del protocolo. Nunca registre cadenas JWT completas en los registros del servidor.

Use bibliotecas con mantenimiento activo: PyJWT 2+, python-jose, auth0/node-jsonwebtoken 9+, Nimbus JOSE + JWT (Java). Evite implementar la verificación de JWT desde cero. Consulte periódicamente las bases de datos de CVE para detectar vulnerabilidades en las bibliotecas.

Pruebe todos los vectores de ataque: envíe un token alg=none, un token de confusión RS256→HS256, un token caducado, un token con una audiencia incorrecta y una carga útil manipulada. Use jwt.io para crear tokens de prueba. Añada pruebas de integración que verifiquen que se rechazan con 401.

¿Dónde deben almacenarse los tokens de actualización en una aplicación web?

El uso seguro de JWT requiere algoritmos fijados, una caducidad breve de los tokens de acceso, almacenamiento de los tokens de actualización en cookies httpOnly, validación de audiencia y emisor y rotación de claves. Siguiente: esquemas criptográficos de compartición de secretos.