8. Estrategia de Autenticación de Doble Token: Access Tokens y Refresh Tokens
Diseña un flujo de autenticación profesional: Access Tokens efímeros (15m) firmados con secreto criptográfico y Refresh Tokens de larga duración con rotación y detección de reuso.
Estrategia de Doble Token: Access Token y Refresh Token
Utilizar un único token JWT con expiración de 30 días es una vulnerabilidad grave: si el token es interceptado, el atacante tiene acceso irrestricto durante un mes sin posibilidad de revocarlo sin invalidar a todos los usuarios. La arquitectura de doble token resuelve este dilema.
Figura 8.1: Flujo completo de login, peticiones protegidas y refresco silencioso con rotación.
1. Comparativa entre Tokens
| Propiedad | Access Token (Token de Acceso) | Refresh Token (Token de Actualización) |
|---|---|---|
| Tiempo de Vida (TTL) | 10 a 15 minutos (Efímero). | 7 a 30 días (Larga duración). |
| Ubicación en Cliente | Memoria JavaScript (inmune a persistencia XSS). | Cookie HttpOnly con bandera Secure. |
| ¿Se guarda en Base de Datos? | No (Stateless). Se valida sólo con firma criptográfica. | Sí (Stateful). Su hash se guarda en PostgreSQL/Redis para permitir revocación inmediata. |
| Rotación en cada Refresco | Se genera uno nuevo en cada llamada a /refresh. |
Rotación estricta: el token viejo se invalida y se emite uno nuevo. Si se detecta el reuso de un token ya invalidado, se cierran todas las sesiones por sospecha de robo. |
⚡ Generación, Verificación y Rotación de JWTs con jsonwebtoken
Servicio completo de tokens criptográficos con firmas simétricas separadas.
import jwt from 'jsonwebtoken';
import crypto from 'crypto';
const ACCESS_SECRET = process.env.JWT_ACCESS_SECRET || 'clave_super_secreta_access_15m';
const REFRESH_SECRET = process.env.JWT_REFRESH_SECRET || 'clave_super_secreta_refresh_7d';
export class TokenService {
/**
* Genera el Access Token (15 minutos) con payload mínimo
*/
static generateAccessToken(user) {
return jwt.sign(
{
sub: user.id,
email: user.email,
rol: user.rol,
},
ACCESS_SECRET,
{ expiresIn: '15m', issuer: 'kilopolis.com' }
);
}
/**
* Genera el Refresh Token (7 días)
*/
static generateRefreshToken(user, tokenId = crypto.randomUUID()) {
return jwt.sign(
{
sub: user.id,
jti: tokenId, // ID único del token para control de revocación en BD
},
REFRESH_SECRET,
{ expiresIn: '7d', issuer: 'kilopolis.com' }
);
}
/**
* Valida la firma y expiración del Access Token
*/
static verifyAccessToken(token) {
try {
return jwt.verify(token, ACCESS_SECRET, { issuer: 'kilopolis.com' });
} catch (err) {
if (err.name === 'TokenExpiredError') {
const error = new Error('El token de acceso ha expirado.');
error.code = 'TOKEN_EXPIRED';
error.statusCode = 401;
throw error;
}
const error = new Error('Token de acceso inválido o corrupto.');
error.statusCode = 401;
throw error;
}
}
/**
* Valida la firma del Refresh Token
*/
static verifyRefreshToken(token) {
try {
return jwt.verify(token, REFRESH_SECRET, { issuer: 'kilopolis.com' });
} catch (err) {
const error = new Error('El token de actualización es inválido o ha expirado.');
error.statusCode = 401;
throw error;
}
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la razón primordial de que el Access Token tenga una duración muy corta (por ejemplo 15 minutos)?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Express.js: Framework Backend & APIs Empresariales y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.