# Content Security Policy: ¿cómo limitar lo que su sitio puede cargar?

> La Content Security Policy indica al navegador qué scripts, imágenes y marcos puede cargar su sitio. Directivas, modo de informe, ejemplo y errores comunes.

Actualizado el 15 de octubre de 2026 · https://app.pilotiko.com/es/glosario/content-security-policy

La Content Security Policy (CSP), o política de seguridad de contenido, es un conjunto de instrucciones que un sitio envía al navegador, casi siempre en el encabezado HTTP Content-Security-Policy, para limitar los recursos que la página puede cargar y lo que puede hacer. Sirve sobre todo para reducir los daños de una inyección de scripts (XSS) y del secuestro de clics.

## En resumen
- La política es una serie de directivas separadas por puntos y comas, por ejemplo default-src 'self'.
- Debe acompañar todas las respuestas, no solo la página principal.
- frame-ancestors impide que otros sitios muestren sus páginas dentro de un marco.
- El encabezado Content-Security-Policy-Report-Only permite hacer pruebas sin bloquear nada.
- Google Analytics exige autorizar dominios concretos en script-src-elem, img-src y connect-src.

## ¿Contra qué protege una CSP?

Según MDN, el uso principal de una CSP es controlar los recursos, en particular JavaScript, que un documento puede cargar, como defensa contra la inyección de scripts entre sitios (XSS) [1]. En un ataque XSS, alguien logra que se ejecute su propio código en su página, por ejemplo mediante un campo de formulario o un parámetro de dirección mal filtrado. Ese código puede entonces leer o modificar el contenido, o enviar solicitudes en nombre del visitante [1].

MDN insiste: la primera defensa sigue siendo sanear las entradas; la CSP es una defensa en profundidad que limita los daños si el saneamiento falla [1]. También sirve contra el secuestro de clics, cuando un sitio malicioso muestra el suyo en un marco invisible, y para forzar la carga de los recursos mediante HTTPS [1].

La especificación de referencia la publica el W3C; la versión Content Security Policy Level 3 tiene el estatus de borrador de trabajo (Working Draft) [2].

## ¿Qué directivas se encuentran en una CSP?

La política se envía en el encabezado de respuesta Content-Security-Policy, y debe enviarse en todas las respuestas [1]. También se puede colocar en una etiqueta <meta http-equiv>, pero este método no admite todas las funciones [1]. MDN presenta frame-ancestors como un reemplazo más flexible del antiguo encabezado X-Frame-Options [1].

| Directiva | Qué controla | Valor prudente para un sitio informativo |
|---|---|---|
| default-src | Regla de respaldo para todos los tipos de recursos | 'self' (solo el mismo origen) |
| script-src | Archivos JavaScript permitidos | 'self', más los dominios de las herramientas realmente utilizadas |
| img-src | Fuentes de imágenes | 'self' y los dominios de imágenes necesarios |
| connect-src | Solicitudes enviadas por los scripts | 'self' y los servicios de medición, si los hay |
| frame-ancestors | Quién puede mostrar la página en un marco | 'none' o 'self' |
| upgrade-insecure-requests | Pasa a HTTPS los recursos llamados mediante http:// | Activada si aún quedan enlaces http:// |

Fuentes: MDN [1]. El valor prudente es una sugerencia que debe adaptarse a cada sitio.

## ¿Cómo implementar una CSP sin romper su sitio?

MDN describe una estrategia prudente: publicar primero la política en el encabezado Content-Security-Policy-Report-Only [1]. El navegador informa entonces de lo que habría bloqueado, sin bloquear nada. Se corrige la lista y luego se pasa al encabezado definitivo.

Para los scripts insertados directamente en el HTML, el método que Google recomienda para Tag Manager es un nonce: un valor aleatorio, imposible de adivinar, que el servidor genera para cada respuesta y que se añade a la directiva y a la etiqueta <script> [3]. La opción 'unsafe-inline' existe, pero Google la presenta como último recurso si el nonce o el hash no son viables [3].

## ¿Qué hay que autorizar para añadir una herramienta de medición?

**Ejemplo: una clínica dental ficticia de Saint-Hyacinthe quiere añadir Google Analytics**

El sitio de « Clinique dentaire Yamaska Exemple » tiene una CSP estricta: default-src 'self'. Para añadir Google Analytics sin las funciones publicitarias, la documentación de Google indica los dominios que hay que autorizar en tres directivas [3].

El recuento que sigue proviene de esa documentación; la empresa es ficticia.

- script-src-elem: dominios por añadir : 1 (www.googletagmanager.com)
- img-src: dominios por añadir : 2 dominios (googletagmanager.com, *.google-analytics.com)
- connect-src: dominios por añadir : 3 dominios (googletagmanager.com, *.google-analytics.com, *.google.com)
- Total de entradas por añadir a la política : 6
- Con las funciones publicitarias de Google Ads : más dominios, entre ellos *.g.doubleclick.net
- **= Seis entradas más en la política, que hay que documentar: cada dominio añadido es un tercero que puede ejecutar código o recibir datos de sus visitantes.**

## ¿Qué errores evitar con una Content Security Policy?

- Publicar una política estricta sin un período de prueba en modo de informe: el formulario de envío o el mapa dejan de funcionar [1].
- Añadir 'unsafe-inline' a script-src por comodidad, lo que debilita mucho la protección contra la inyección de scripts.
- Autorizar un dominio completo con un comodín (*) sin saber qué aloja.
- Definir la CSP solo en la página de inicio cuando debe acompañar todas las respuestas [1].
- Olvidar actualizar la política cuando añade una herramienta, como un módulo de reserva de citas o [Google Analytics 4](https://app.pilotiko.com/es/glosario/google-analytics-4).
- Confiar en la CSP en lugar de validar y sanear los datos de los formularios [1].

## ¿Tiene una CSP relación con la Loi 25?

De forma indirecta. Cada dominio autorizado en connect-src o script-src es un servicio externo que puede recibir datos de sus visitantes. Mantener la lista al día le ayuda a saber qué herramientas recopilan información, lo cual es útil para redactar una política de privacidad exacta en el espíritu de la [Loi 25](https://app.pilotiko.com/es/glosario/ley-25) (Ley 25). Nuestra [guía de la Loi 25](https://app.pilotiko.com/es/guias/quebec-law-25-for-service-businesses) detalla las obligaciones; la CSP no es una de ellas.

## ¿Qué hace Pilotiko con la Content Security Policy?

El [sitio alojado por Pilotiko](https://app.pilotiko.com/es/producto/sitio-web) se sirve con una Content Security Policy restrictiva: default-src 'self', scripts y hojas de estilo limitados al propio sitio, imágenes del sitio o mediante HTTPS, formularios enviados solo al sitio, frame-ancestors 'none' y base-uri 'none'. También se envía con el encabezado X-Frame-Options DENY. No se carga ningún script de terceros, y la incorporación de Google Analytics aún no está disponible: esa función está anunciada como próximamente disponible.

## Preguntas frecuentes

### ¿Es útil una CSP para un sitio informativo pequeño?

Sí, sobre todo si contiene un formulario. Incluso un sitio sencillo puede cargar scripts de terceros o ser mostrado en un marco por otro sitio; una CSP limita esos riesgos a bajo costo.

### ¿Puede una CSP romper mi sitio?

Sí, si bloquea un recurso necesario, como un script de mapa o de reserva de citas. Por eso se prueba primero con el encabezado Content-Security-Policy-Report-Only.

### ¿CSP en una etiqueta meta o en un encabezado?

El encabezado HTTP es el método recomendado y cubre todas las funciones. La etiqueta meta sirve de solución cuando no se tiene acceso al servidor, pero algunas directivas no funcionan de esa manera.

### ¿Hace falta todavía X-Frame-Options con frame-ancestors?

MDN presenta frame-ancestors como un reemplazo más flexible de X-Frame-Options. Nada impide enviar ambos al mismo tiempo, siempre que digan lo mismo.

### ¿Qué significa 'self' en una CSP?

Es el origen de la propia página, es decir, su propio sitio. default-src 'self' significa que, por defecto, la página solo carga recursos provenientes de su propio sitio.

## Fuentes

1. MDN Web Docs, « Content Security Policy (CSP) », https://developer.mozilla.org/fr/docs/Web/HTTP/Guides/CSP (consultado el 2026-10-15)
2. W3C, « Content Security Policy Level 3 (Working Draft) », https://www.w3.org/TR/CSP3/ (consultado el 2026-10-15)
3. Google Tag Platform, « Utiliser Tag Manager avec une Content Security Policy », https://developers.google.com/tag-platform/security/guides/csp?hl=fr (consultado el 2026-10-15)
