Cabeceras HTTP

Content-Security-Policy: cómo bloquear ataques XSS

Guía práctica sobre la cabecera CSP: qué es, cómo evita los ataques de Cross-Site Scripting, sus directivas principales y cómo implementarla sin romper el sitio.

2026-08-03·Tiempo de lectura: 9 min

Content-Security-Policy (CSP) es una cabecera HTTP que permite al servidor indicar al navegador qué recursos puede cargar y desde qué orígenes. Es la defensa más efectiva contra ataques Cross-Site Scripting (XSS), que aparecen en el primer puesto del OWASP Top 10 de vulnerabilidades web más comunes. Sin CSP, cualquier script malicioso inyectado en la página puede ejecutarse con los mismos privilegios que el código legítimo.

¿Qué daño puede causar XSS sin CSP?

Si un atacante consigue inyectar código JavaScript malicioso en tu página (a través de un formulario sin sanitizar, un comentario, un parámetro de URL o un script de terceros comprometido), puede: robar cookies de sesión y suplantar al usuario, redirigir al visitante a sitios de phishing, registrar pulsaciones de teclado y capturar contraseñas, extraer datos de formularios de pago, o ejecutar mineros de criptomonedas en el navegador del visitante. CSP bloquea la carga de recursos no autorizados antes de que puedan ejecutarse.

Directivas principales de CSP

  • default-src: fuente por defecto para todos los tipos de recursos que no tienen una directiva específica.
  • script-src: orígenes permitidos para scripts JavaScript. La directiva más importante — restringe desde dónde puede ejecutarse JS.
  • style-src: orígenes permitidos para hojas de estilo CSS.
  • img-src: orígenes permitidos para imágenes.
  • font-src: orígenes permitidos para fuentes web (Google Fonts, FontAwesome, etc.).
  • connect-src: orígenes para llamadas fetch, XMLHttpRequest, WebSocket y EventSource.
  • frame-ancestors: controla quién puede incrustar la página en un iframe (reemplaza X-Frame-Options).
  • form-action: restringe los destinos de formularios HTML — importante para prevenir phishing post-XSS.

Ejemplo de política CSP funcional

http
Content-Security-Policy:
  default-src 'self';
  script-src 'self' https://cdn.tudominio.com;
  style-src 'self' 'unsafe-inline';
  img-src 'self' data: https:;
  font-src 'self' https://fonts.gstatic.com;
  connect-src 'self' https://api.tudominio.com;
  frame-ancestors 'none';

Implementación en Nginx

nginx
# En el bloque server de tu sitio HTTPS
add_header Content-Security-Policy "
  default-src 'self';
  script-src 'self';
  style-src 'self' 'unsafe-inline';
  img-src 'self' data: https:;
  font-src 'self' https://fonts.gstatic.com;
  frame-ancestors 'none';
" always;

Implementación en Apache

apache
# En el VirtualHost *:443
Header always set Content-Security-Policy "\
  default-src 'self'; \
  script-src 'self'; \
  style-src 'self' 'unsafe-inline'; \
  img-src 'self' data: https:; \
  frame-ancestors 'none';"

Estrategia: empieza con Report-Only

Para implementar CSP sin romper nada en producción, usa primero la cabecera Content-Security-Policy-Report-Only. Esta variante reporta las infracciones en la consola del navegador (y a un endpoint si configuras report-uri) sin bloquear nada. Cuando hayas identificado y autorizado todos los orígenes legítimos, cambia a la cabecera definitiva.

http
# Fase de prueba — no bloquea, solo reporta
Content-Security-Policy-Report-Only:
  default-src 'self';
  script-src 'self' https:;
  report-uri https://tudominio.com/csp-violations

Errores que debes evitar

  • 'unsafe-eval' en script-src: permite ejecutar eval() y Function constructor — anula la protección contra XSS basado en inyección dinámica.
  • 'unsafe-inline' en script-src: permite scripts inline (<script>...</script>) — el vector de ataque más común de XSS.
  • Olvidar orígenes de terceros usados en producción: Google Analytics, PayPal, fuentes CDN. Revisa la consola del navegador para identificarlos.
  • No incluir frame-ancestors: deja el sitio expuesto a clickjacking, donde se incrusta en un iframe invisible.
  • Saltar el modo Report-Only: implementar directamente puede romper funcionalidades de terceros en producción.

DomainScored detecta si Content-Security-Policy está ausente, si usa directivas peligrosas como 'unsafe-eval', o si falta la protección frame-ancestors. El módulo de Cabeceras HTTP muestra el estado de CSP junto con las otras 5 cabeceras de seguridad relevantes.

Comprueba si tu dominio tiene estos problemas con DomainScored.

Analizar mi dominio
Usamos cookies necesarias para mantener tu sesión y protegerte frente a ataques CSRF. Si aceptas, cargaremos además publicidad de Google, que instala sus propias cookies. Si rechazas, el sitio funciona igual.