# Content Security Policy y headers

> Directivas de CSP que necesita el SDK, reportes de violación, headers monitoreados y relación con PCI DSS.

URL: https://docs.proteside.com/es/docs/integration/csp

Si tu checkout usa Content Security Policy (CSP), debe permitir el snippet de Proteside. El dashboard no genera una CSP
por ti: esta página lista lo que el SDK usa realmente en el navegador, para que lo incluyas en la política de la
tienda.

## Directivas necesarias
| Directiva     | Valor                                                                  | Para qué                                                                            |
| ------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `script-src`  | hash, nonce o `'unsafe-inline'` para los `<script>` inline del snippet | Ejecutar el bootstrapper, que incluye las reglas inline cuando la tienda las tiene. |
| `script-src`  | `https://cdn.proteside.com`                                            | Cargar el `shield.js`.                                                              |
| `connect-src` | `https://app.proteside.com`                                            | Obtener la configuración y enviar eventos.                                          |
| `connect-src` | `'self'`                                                               | Leer los headers de seguridad de la propia página (consulta más abajo).             |
| `connect-src` | orígenes de los scripts externos de la página (opcional)               | Calcular el hash del contenido de los scripts de terceros.                          |

Sin `connect-src` para `app.proteside.com`, el SDK carga y se ejecuta, pero ningún evento llega al dashboard.

### Los scripts inline del snippet
El bootstrapper es inline y debe seguir siéndolo (consulta [Instalación del snippet](https://docs.proteside.com/es/docs/integration/install)). Elige una forma
de autorizarlo:

* **Hash** (`'sha256-…'`): autoriza exactamente ese contenido. El hash cambia cuando cambia el contenido del script:
  cada vez que vuelves a pegar un snippet de una versión nueva y, si la tienda tiene reglas inline, siempre que vuelves
  a pegar el snippet después de cambiar reglas o contenedores de Google Tag Manager, porque las reglas inline van en el
  mismo script. Los snippets antiguos, con la configuración inline en una etiqueta separada, necesitan un segundo hash
  para ella.
* **Nonce:** si tu servidor ya genera un nonce por respuesta, agrega el atributo `nonce` a las etiquetas `<script>`
  del snippet al pegarlo en la plantilla. El snippet del dashboard no trae `nonce`.
* **`'unsafe-inline'`:** funciona, pero habilita cualquier script inline y debilita la política. No se recomienda en
  páginas de pago.

La forma más segura de obtener el hash es dejar que el navegador lo calcule: publica la CSP sin el hash (de preferencia
en modo `Content-Security-Policy-Report-Only`), abre el checkout y mira el mensaje de violación en la consola. Indica el
valor `'sha256-…'` del script bloqueado. Para calcularlo localmente, usa exactamente el contenido entre `<script>` y
`</script>`, sin salto de línea al final:

```bash title="Calcular el hash del bootstrapper"
# bootstrapper.js = contenido entre <script> y </script>, copiado del snippet
printf '%s' "$(cat bootstrapper.js)" | openssl dgst -sha256 -binary | openssl base64
```

## Ejemplo de header
Un ejemplo para un checkout en `mitienda.com` con Stripe. Adapta los demás orígenes a tu tienda.

```http title="Header de respuesta de la página de checkout"
Content-Security-Policy:
  default-src 'self';
  script-src 'self' 'sha256-BOOTSTRAPPER_HASH' https://cdn.proteside.com https://js.stripe.com;
  connect-src 'self' https://app.proteside.com https://api.stripe.com;
  frame-src https://js.stripe.com;
  img-src 'self' data:;
  style-src 'self';
  report-uri https://app.proteside.com/api/sdk/csp-report?key=pk_live_TU_CLAVE;
  report-to proteside
Reporting-Endpoints: proteside="https://app.proteside.com/api/sdk/csp-report?key=pk_live_TU_CLAVE"
```

El header real va en una sola línea; los saltos de arriba son solo para facilitar la lectura. Si tu snippet usa el formato
antiguo, con la configuración inline en una etiqueta `<script>` separada, agrega también el hash de esa etiqueta.

> **Nota**
>
> Si usas el [sello Proteside](https://docs.proteside.com/es/docs/integration/badge), agrega `https://app.proteside.com` en `img-src`. El SDK en sí no necesita
> `style-src` ni `img-src`.

## Reportes de violación
Proteside recibe reportes de CSP en la dirección de abajo. No aparece en ninguna pantalla del dashboard; usa tu clave
del SDK en el parámetro `key`:

```text
https://app.proteside.com/api/sdk/csp-report?key=pk_live_TU_CLAVE
```

* Acepta los dos formatos: `report-uri` y `report-to` (Reporting API).
* El total aparece en **Salud del SDK**, en la tarjeta **Reportes CSP (48 h)**.
* Una violación de `script-src` o `connect-src` hacia un host que **no** está en el inventario de scripts de la tienda
  se convierte en la alerta `CSP_VIOLATION`, con severidad baja. Las violaciones de otras directivas solo entran en el
  conteo.

Para probar una política nueva sin romper el checkout, publícala primero como `Content-Security-Policy-Report-Only`,
sigue los reportes y después cámbiala a `Content-Security-Policy`.

## Headers de seguridad monitoreados
Para respaldar la detección de cambios en los headers, el SDK lee los headers de seguridad de la página de pago en cada
carga y en cada `Proteside.pageChanged()`:

`Content-Security-Policy`, `Content-Security-Policy-Report-Only`, `Strict-Transport-Security`, `X-Frame-Options`,
`X-Content-Type-Options`, `Referrer-Policy`, `Permissions-Policy`, `Cross-Origin-Opener-Policy`,
`Cross-Origin-Embedder-Policy`, `Cross-Origin-Resource-Policy`, `Access-Control-Allow-Origin` y `Set-Cookie` (este
solo como "no legible en el navegador").

El valor de cada header presente se envía al dashboard. Cuando un valor cambia, el dashboard crea la alerta
`HEADER_CHANGED`. Los headers aparecen en **Evidencias PCI DSS**, en la pestaña **Cabeceras**.

> **Una solicitud GET extra por pageview**
>
> Para leer los headers, el SDK hace una solicitud `GET` adicional a la URL de la propia página. Si tu checkout ejecuta alguna acción al recibir un `GET` (crear un pedido, reservar stock,
> generar un cobro), esa acción va a ocurrir dos veces. Asegúrate de que el `GET` de la página de pago no tenga efectos
> secundarios.

## Subresource Integrity (SRI)
No uses el atributo `integrity` en la etiqueta del `shield.js`. La URL es mutable: la misma dirección recibe cada nueva
versión del SDK, así que el hash cambiaría con cada publicación y el navegador empezaría a rechazar el script.

Como control preventivo, restringe `script-src` a `https://cdn.proteside.com` y autoriza el bootstrapper inline por
hash o nonce. El inventario de Proteside registra qué scripts de tu página usan `integrity` y `nonce`.

## Relación con PCI DSS 4.0
| Requisito | Qué pide                                                                                                                                                        | Cómo ayudan Proteside y la CSP                                                                                                                                                                                     |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 6.4.3     | Gestionar los scripts de la página de pago que se ejecutan en el navegador: inventario con justificación, autorización de cada script y garantía de integridad. | El SDK arma el inventario con el hash del contenido; la autorización con justificación se hace en **Scripts**; las reglas bloquean los scripts no autorizados. La CSP limita desde dónde se pueden cargar scripts. |
| 11.6.1    | Detectar y alertar sobre cambios no autorizados en los headers HTTP y en el contenido de la página de pago, tal como los recibe el navegador.                   | El SDK lee los headers de seguridad en cada pageview y detecta scripts nuevos o modificados; el dashboard genera `HEADER_CHANGED`, `SCRIPT_INTEGRITY_MISMATCH` y las demás alertas.                                |

Proteside genera evidencias para estos requisitos en **Evidencias PCI DSS**. La evaluación de cumplimiento sigue siendo
responsabilidad de tu evaluador (QSA) o de tu cuestionario de autoevaluación. Consulta
[Evidencias PCI DSS](https://docs.proteside.com/es/docs/guide/compliance). El contexto de los dos requisitos está en
[PCI DSS 6.4.3 y 11.6.1](https://proteside.com/es/soluciones/cumplimiento-pci), en el sitio.

## Próximos pasos
* [Privacidad y LGPD](https://docs.proteside.com/es/docs/integration/privacy)
* [Solución de problemas](https://docs.proteside.com/es/docs/integration/troubleshooting)
