Tema 8 · Flujo JWT Doble

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.

Flujo de Autenticación JWT con Doble Token

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.

tokenService.js
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.