guía de corrección
Política de seguridad de contenidos: prepare un CSP adecuado
Un CSP limita las fuentes y comportamientos que permite el navegador. La implementación comienza con un inventario de su página, no con una configuración universal.
Qué protege el CSP
La política de seguridad de contenido reduce algunos riesgos de ejecución de código inyectado. Complementa el escape de salida, la validación de entradas y la corrección de vulnerabilidades; no garantiza la ausencia de XSS ni certifica el cumplimiento.
Una cabecera HTTP se aplica a partir de la respuesta al documento. Una metaetiqueta tiene limitaciones: no hay modo Report-Only, no hay directiva frame-ancestors, y no hay protección retroactiva para el contenido ya procesado. Prefiere la cabecera.
Inventario antes del bloqueo
En un entorno de prueba, ejercite el inicio de sesión, los formularios, el pago, las integraciones, las fuentes, las imágenes y los scripts. Registre los orígenes realmente necesarios y los scripts/estilos en línea. Incluya consentimiento y variantes registradas.
- Cree una lista mínima para cada tipo de recurso. Evite comodines amplios y https globales: asignaciones por conveniencia.
- Identifique qué establece los encabezados: aplicación, servidor o CDN. Múltiples políticas aplicadas se aplican juntas; añadir otro no puede relajar al primero.
- Elija nonces impredecibles renovados por respuesta, o hashes para scripts estáticos controlados, cuando se requiera contenido en línea.
Con Report-Only
Para una página de prueba estática con recursos del mismo origen, este ejemplo observa violaciones sin imponer bloqueos. Adapte cada directiva a su inventario. Las violaciones aparecen en la consola; aquí no se configura ningún recopilador de informes.
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'- Recarga y ejercita cada recorrido; leer la directiva afectada y recurso en caso de violaciones.
- Distinguir recursos esperados, ruido de inyección y extensión. No permita que un origen simplemente descarte un mensaje.
- Si agrega un recopilador, controle el acceso, el volumen y la retención: los informes pueden contener URLs confidencial.
Aplicar y luego comprobar si hay regresiones
Una vez que los viajes funcionan, servir a la política a medida bajo Content-Security-Policy. Monitoree los errores y mantenga un procedimiento para restaurar la política anterior. Un CSP ya está vigente cuando se agrega Report-Only.
Evite unsafe-inline en script-src: permite scripts en línea en políticas donde sea efectivo. Un nonce requiere una generación de servidor aleatoria y un atributo coincidente en cada script permitido; nunca copie un ejemplo fijo nonce. Verifique también el almacenamiento en caché de HTML.
Lo que establece el cheque Argos
La comprobación http.security.csp lee el encabezado Content-Security-Policy final y reconoce un subconjunto restrictivo de script-src, o por defecto-src cuando está ausente: auto, ninguno, nonces, hashes y orígenes explícitos HTTPS. Una política no reconocida necesita revisión; esta heurística no puede probar la libertad de XSS. Report-Only no satisface esta comprobación.
Los módulos externos pueden agregar hallazgos cuando estén disponibles. Vuelva a ejecutar la auditoría después de las pruebas funcionales; inspeccionar evidencia y reportar cobertura. HSTS aborda el transporte HTTPS y tiene un proceso de implementación diferente.
Referencias oficiales
Referencias revisadas el 16 de octubre de 2026. Adapte y pruebe los ejemplos dentro de su propio alcance.
Verifica tu solución
Después de las pruebas, vuelva a ejecutar una auditoría del mismo URL público y compare los resultados disponibles.