Tema 4 · Helmet & CORS

4. Blindaje de Cabeceras HTTP con Helmet y Configuración de CORS Estricto

Protege la API ocultando X-Powered-By, forzando HSTS, Content Security Policy y configurando CORS con listas blancas dinámicas y credenciales seguras.

Cabeceras de Seguridad y CORS en APIs de Producción

Por defecto, Express incluye la cabecera X-Powered-By: Express, informando a atacantes y escáneres automáticos de vulnerabilidades sobre el stack utilizado. Con Helmet y una configuración estricta de CORS, blindamos la API contra ataques de Cross-Origin, Clickjacking y degradación de protocolo.

1. Las 5 Cabeceras Clave que Inyecta Helmet

Cabecera HTTP Función de Protección
Strict-Transport-Security (HSTS) Fuerza a los navegadores a comunicarse exclusivamente mediante HTTPS durante un período prolongado (evita ataques Man-in-the-Middle y SSL Stripping).
X-Content-Type-Options: nosniff Impide que los navegadores intenten adivinar (MIME-sniffing) el tipo de contenido más allá del declarado en Content-Type.
X-Frame-Options: DENY / SAMEORIGIN Evita que la aplicación o sus respuestas sean incrustadas en <iframe> de sitios externos maliciosos (anti-Clickjacking).
X-XSS-Protection Activa los filtros de Cross-Site Scripting en navegadores heredados.
Eliminación de X-Powered-By Oculta la firma del framework para evitar ataques dirigidos por versión.

2. CORS Estricto y Dinámico (Lista Blanca)

En desarrollo es común ver app.use(cors()) (que permite Access-Control-Allow-Origin: *). Sin embargo, en una API empresarial con autenticación mediante cookies HttpOnly, el navegador bloqueará cualquier respuesta que use comodín * si se envían credenciales. Es indispensable configurar una lista blanca de orígenes explícitos.

⚡ Configuración Segura de Helmet y CORS con Lista Blanca

Configuración profesional para producción en Node.js y Express.

securityMiddlewares.js
Solo lectura
import express from 'express';
import helmet from 'helmet';
import cors from 'cors';

const app = express();

// 1. BLINDAJE DE CABECERAS CON HELMET
app.use(
  helmet({
    // Deshabilitar CSP para APIs puras de JSON (o configurarlo si sirve vistas HTML)
    contentSecurityPolicy: false,
    crossOriginEmbedderPolicy: false,
    hsts: {
      maxAge: 31536000, // 1 año en segundos
      includeSubDomains: true,
      preload: true,
    },
  })
);

// 2. LISTA BLANCA DE ORÍGENES PERMITIDOS PARA CORS
const allowedOrigins = [
  'https://kilopolis.com',
  'https://admin.kilopolis.com',
  ...(process.env.NODE_ENV !== 'production' ? ['http://localhost:5173', 'http://localhost:3000'] : []),
];

const corsOptions = {
  origin: (origin, callback) => {
    // Permitir peticiones sin origen (como Postman, apps móviles nativas o curl de servidor a servidor)
    if (!origin) return callback(null, true);

    if (allowedOrigins.includes(origin)) {
      callback(null, true);
    } else {
      callback(new Error(`Acceso bloqueado por política CORS desde el origen: ${origin}`));
    }
  },
  credentials: true, // Permite el intercambio de cookies HttpOnly y cabeceras Authorization
  methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
  allowedHeaders: ['Content-Type', 'Authorization', 'X-Requested-With'],
  maxAge: 86400, // Cachear la respuesta de pre-flight OPTIONS durante 24 horas
};

app.use(cors(corsOptions));
app.options('*', cors(corsOptions)); // Responder a solicitudes de comprobación previa (OPTIONS)
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué una configuración CORS con Access-Control-Allow-Origin: * falla en el navegador cuando el cliente envía credenciales (credentials: "include" o cookies)?
🦉
¿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.