Tema 9 · HttpOnly & RBAC

9. Almacenamiento Seguro con Cookies HttpOnly y Middlewares de Autorización RBAC

Elimina el riesgo de robo de tokens por ataques XSS configurando cookies con banderas HttpOnly, Secure y SameSite, y controla accesos por roles granulares (Admin, Editor, User).

Por qué nunca guardar tokens en localStorage

Cualquier script inyectado mediante una vulnerabilidad XSS (Cross-Site Scripting) en un paquete de terceros (npm) o un input no sanitizado tiene acceso total a window.localStorage y puede robar los tokens en segundo plano. Al emitir el token en una cookie HttpOnly, el navegador prohíbe terminantemente su lectura mediante JavaScript.

1. Banderas de Seguridad en Cookies de Express

Atributo Configuración Recomendada Efecto de Protección
httpOnly: true Siempre activo Bloquea el acceso desde document.cookie en JavaScript. Inmune a robo por XSS.
secure: true process.env.NODE_ENV === 'production' El navegador solo transmitirá la cookie a través de conexiones cifradas HTTPS.
sameSite: 'strict' | 'lax' 'strict' o 'lax' Previene ataques CSRF (Cross-Site Request Forgery) impidiendo que la cookie viaje en peticiones automáticas desde sitios web externos.
path: '/api/v1/auth' Ruta restringida La cookie solo se envía al endpoint de refresco o autenticación, no en cada petición a la API.

2. Control de Acceso Basado en Roles (RBAC)

Una vez autenticado el usuario mediante el middleware de verificación de token (que inyecta req.user), se aplican middlewares de autorización de roles parametrizables (por ejemplo authorize('admin', 'editor')) antes de permitir la ejecución del controlador.

⚡ Manejo de Cookies HttpOnly y Middleware de Roles RBAC

Configuración de cookie-parser y autorización de endpoints en Express.

authAndRbac.js
Solo lectura
import express from 'express';
import cookieParser from 'cookie-parser';
import { TokenService } from './tokenService.js';

const app = express();
app.use(express.json());
app.use(cookieParser(process.env.COOKIE_SECRET)); // Firmar cookies opcionalmente

// 1. ENDPOINT DE LOGIN: Emite Access Token y Cookie HttpOnly
app.post('/api/v1/auth/login', async (req, res) => {
  // Simular usuario autenticado tras validar credenciales con Bcrypt
  const user = { id: 'usr_1024', email: '[email protected]', rol: 'admin' };

  const accessToken = TokenService.generateAccessToken(user);
  const refreshToken = TokenService.generateRefreshToken(user);

  // Enviar el Refresh Token en una cookie HttpOnly estricta
  res.cookie('refreshToken', refreshToken, {
    httpOnly: true,
    secure: process.env.NODE_ENV === 'production', // Requiere HTTPS en VPS
    sameSite: 'strict', // Blindaje anti-CSRF
    maxAge: 7 * 24 * 60 * 60 * 1000, // 7 días en milisegundos
    path: '/api/v1/auth', // Limita el envío exclusivamente a rutas de autenticación
  });

  // El Access Token se envía en el cuerpo JSON para guardarse en la memoria RAM del cliente
  return res.status(200).json({
    success: true,
    data: {
      accessToken,
      usuario: { id: user.id, email: user.email, rol: user.rol },
    },
  });
});

// 2. MIDDLEWARE DE AUTENTICACIÓN (Verifica Bearer Token en Header)
export const authenticate = (req, res, next) => {
  const authHeader = req.headers.authorization;
  if (!authHeader || !authHeader.startsWith('Bearer ')) {
    return res.status(401).json({ success: false, error: 'Cabecera Authorization Bearer requerida.' });
  }

  const token = authHeader.split(' ')[1];
  try {
    const payload = TokenService.verifyAccessToken(token);
    req.user = payload; // Inyecta el usuario decodificado en la petición
    next();
  } catch (error) {
    return res.status(401).json({ success: false, error: error.message });
  }
};

// 3. MIDDLEWARE DE AUTORIZACIÓN BASADA EN ROLES (RBAC)
export const authorize = (...allowedRoles) => {
  return (req, res, next) => {
    if (!req.user || !allowedRoles.includes(req.user.rol)) {
      return res.status(403).json({
        success: false,
        error: 'Acceso denegado: no dispones de los permisos suficientes para este recurso.',
      });
    }
    next();
  };
};

// 4. RUTA PROTEGIDA CON CONTROL DE ROLES
app.delete(
  '/api/v1/usuarios/:id',
  authenticate,
  authorize('admin'), // Sólo administradores pueden eliminar usuarios
  async (req, res) => {
    res.status(200).json({ success: true, message: `Usuario ${req.params.id} eliminado correctamente.` });
  }
);
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué función cumple la bandera httpOnly: true en la configuración de una cookie enviada desde Express?
🦉
¿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.