Web y desarrollo

Política de Seguridad de Contenido (CSP): Cómo comprobar, corregir y configurarla en tu sitio web

Content Security Policy (CSP): How to Check, Fix and Configure It on Your Website

Aprende a comprobar, añadir y corregir encabezados de Política de Seguridad de Contenido en Apache, Nginx, WordPress y Joomla, con herramientas de diagnóstico prácticas y orientación de hosting.

Política de Seguridad de Contenido (CSP): Cómo Verificar, Corregir y Configurarla en tu Sitio Web

HTTPS y las actualizaciones de software son esenciales, pero no impiden que todo script malicioso se ejecute en el navegador del visitante. La Política de Seguridad de Contenido (CSP) añade restricciones impuestas por el navegador sobre los recursos que una página puede cargar y ejecutar. Ayuda a mitigar ciertos ataques de scripts entre sitios (XSS), pero no reemplaza el escape contextual de salida, la validación de entrada o las actualizaciones de dependencias.

Este tutorial práctico muestra cómo inspeccionar tu política actual, encontrar su origen, introducir cambios de forma segura y corregir problemas en Apache, Nginx, WordPress y Joomla.

1. Verifica tu CSP existente

Chrome o Firefox: Abre la página, presiona F12, elige Red, recarga, haz clic en el documento HTML e inspecciona Cabeceras de Respuesta. Busca Content-Security-Policy (aplicada) o Content-Security-Policy-Report-Only (solo diagnóstico). Revisa la Consola por violaciones.

Línea de comandos: Ejecuta curl -I https://example.com/. En macOS/Linux, filtra la respuesta con curl -sSI https://example.com/ | grep -i content-security-policy. Las respuestas HEAD pueden diferir de las GET, así que usa las DevTools del navegador para confirmar.

Herramientas en línea: SecurityHeaders.com verifica cabeceras de seguridad; Google CSP Evaluator señala debilidades en una política. Ninguna demuestra que todo el sitio web sea seguro.

La ausencia de cabecera CSP en una respuesta no establece que todas las páginas carezcan de CSP. Inspecciona también cualquier etiqueta <meta http-equiv="Content-Security-Policy">: las políticas meta tienen limitaciones, incluyendo ausencia de soporte para frame-ancestors o Report-Only.

2. Encuentra dónde se define la política

Entorno Ubicación probable
Apache / LiteSpeed compatible .htaccess, host virtual o configuración del servidor
Nginx server / location configuración
PHP Código de aplicación usando header()
WordPress Plugin, código personalizado, proxy inverso o proveedor
Joomla Plugin Sistema – Cabeceras HTTP, servidor o proxy
Cloudflare Reglas de Transformación de Cabeceras de Respuesta
Hosting gestionado Panel del proveedor o configuración gestionada por el proveedor

Inspecciona las cabeceras de respuesta existentes antes de añadir otra. Los navegadores aplican múltiples políticas CSP de forma acumulativa; una nueva cabecera permisiva no anula una restrictiva existente. Verifica también las reglas del CDN y del hosting.

3. Añade CSP en Apache usando .htaccess

Usando el gestor de archivos de tu proveedor o SFTP (FileZilla/WinSCP), localiza el directorio público que contiene index.php, a menudo public_html o httpdocs. Habilita archivos ocultos para ver .htaccess. Descarga una copia de seguridad y evita colocar reglas personalizadas dentro de un bloque de reescritura gestionado por el CMS.

Si el mod_headers de Apache está habilitado y el proveedor permite estas directivas, añade:

<IfModule mod_headers.c>
    Header always set Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'"
</IfModule>

Recarga y verifica la cabecera en Red → Cabeceras. Revisa la Consola por violaciones. Report-Only informa sobre posibles restricciones pero no bloquea los recursos. Este ejemplo es diagnóstico, no una política de despliegue completa.

Si se reporta un script de CDN confiable, primero confirma su propósito y titularidad. Podrías adaptar la directiva a script-src 'self' https://cdn.example.com; no añadas cada host bloqueado ciegamente. Las listas de permitidos por host son menos robustas contra XSS que políticas nonce/hash bien diseñadas.

Tras probar inicio de sesión, formularios, compra, editores y otros flujos, puedes reemplazar Content-Security-Policy-Report-Only con Content-Security-Policy para aplicar tu política probada. Si el sitio falla, restaura el archivo respaldado, limpia cachés del servidor/CDN y vuelve a probar. Un HTTP 500 tras editar sugiere un problema de sintaxis o permisos del servidor.

Illustration of the article's main concept

4. Configura CSP en Nginx

Nginx ignora .htaccess. Si administras el servidor, inspecciona su configuración activa (a menudo /etc/nginx/sites-available/ o /etc/nginx/conf.d/). En el bloque server relevante, usa:

add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;

Prueba con sudo nginx -t, luego recarga con sudo systemctl reload nginx. Vigila la herencia add_header y reglas en ubicaciones más específicas. En hosting gestionado sin acceso a configuración de Nginx, usa el panel del proveedor o soporte.

5. WordPress: plugin o pequeña integración personalizada

Ruta sin código: Primero verifica si tu proveedor o un plugin existente de cabeceras de seguridad ya envía CSP. Elige un plugin mantenido que soporte explícitamente CSP y preferiblemente Report-Only; no asumas que un plugin de seguridad general soporte ninguno. En sus ajustes, habilita Report-Only, comienza con una política diagnóstica conservadora, guarda y prueba tanto páginas públicas como wp-admin antes de aplicar.

Ruta para desarrolladores: Crea wp-content/plugins/ceikay-csp/ceikay-csp.php:

<?php
/**
 * Plugin Name: CeiKay CSP Example
 * Description: CSP diagnostics on the WordPress frontend.
 */
add_action('send_headers', function () {
    if (is_admin()) {
        return;
    }

    header(
        "Content-Security-Policy-Report-Only: "
        . "default-src 'self'; "
        . "script-src 'self'; "
        . "object-src 'none'; "
        . "base-uri 'self'"
    );
});

Actívalo en Plugins → Plugins Instalados, luego confirma la cabecera de respuesta. Esto no anula un CSP existente del servidor web, CDN u otro plugin. Excluye deliberadamente wp-admin y no proporciona una política de cumplimiento completa.

Solución de problemas: Si falla un CAPTCHA, inspecciona las solicitudes script-src, frame-src y connect-src bloqueadas y consulta la guía de integración del proveedor del CAPTCHA. Si un constructor de páginas reporta scripts en línea bloqueados, verifica soporte para nonces o hashes CSP. No añadas 'unsafe-inline' automáticamente. Para nonces por respuesta, asegúrate de que el caché de página completa no reutilice el mismo nonce y HTML entre visitantes.

6. Joomla: usa el plugin nativo HTTP Headers

En la administración de Joomla, abre Sistema → Plugins, busca Cabeceras HTTP y abre Sistema – Cabeceras HTTP. La redacción exacta del menú varía según la versión e idioma de Joomla.

Habilita sus opciones CSP y comienza con Report-Only en el sitio público. Empieza diagnosticando una directiva como script-src 'self'; guarda e inspecciona la Consola. Prueba plantillas, constructores de páginas, editores, formularios de contacto, CAPTCHAs, integraciones de pago y funciones multimedia.

Si ves Refused to execute inline script, identifica qué plantilla o extensión la genera. Prefiere un enfoque compatible de nonce o hash donde haya soporte; valida que el script sea legítimo antes de autorizarlo. Prueba el administrador por separado del frontend. Si el servidor ya establece CSP, concilia las configuraciones en lugar de apilar políticas conflictivas.

Consulta la documentación de Joomla HTTP Headers para las opciones soportadas por tu versión instalada.

7. Corrige la violación real, no toda la política

Violación Qué investigar Corrección típica
script-src JavaScript externo o en línea Verifica la fuente; usa nonce/hash apropiado o fuente de alcance estrecho
style-src Hoja de estilos o CSS en línea Inspecciona estilos generados; usa fuente aprobada o hash/nonce compatible
img-src Imagen externa o URL de datos Permite un host de imágenes verificado solo si es necesario
connect-src fetch/XHR/WebSocket Verifica origen de la API y añade permiso de alcance estrecho
frame-src Video/CAPTCHA/pago en iframe Sigue los dominios documentados por el proveedor
form-action Destino de envío de formulario Permite origen de envío legítimo
frame-ancestors Otro sitio incrustando tu página Permite explícitamente orígenes padre previstos, o usa 'none'

Por ejemplo, si una imagen legítima en https://images.example.com/photo.webp es bloqueada por img-src 'self', cambia la directiva relevante a img-src 'self' https://images.example.com tras confirmar que el host es de confianza. No debilites default-src solo para arreglar una imagen.

Technical workflow illustration

Algunas directivas, incluyendo frame-ancestors y form-action, no recurren a default-src. Inclúyelas explícitamente cuando sea necesario.

8. ¿Afecta el hosting a la configuración CSP?

Sí—el estándar CSP del navegador permanece igual, pero tu control sobre las cabeceras de respuesta cambia. El hosting compartido Apache puede exponer .htaccess; Nginx gestionado puede requerir panel del proveedor; administradores de VPS pueden modificar configuración del servidor; y los CDN pueden añadir cabeceras tras la generación de la respuesta por la aplicación.

Antes de elegir un servicio de hosting, pregunta: ¿Puedo establecer y eliminar cabeceras CSP sin acceso root? ¿Puedo usar Report-Only? ¿Puedo inspeccionar la respuesta final? ¿Están disponibles cabeceras personalizadas en mi plan? ¿Puede el soporte explicar conflictos con reglas de CDN o aplicación?

Cloudways: controles de cabecera HTTP a nivel de hosting

Cloudways documenta Reglas Web → Reglas de Cabecera para gestionar cabeceras de respuesta HTTP, incluyendo CSP. Esto ofrece una alternativa a nivel de hosting a editar archivos de aplicación, sujeta a las funciones disponibles para tu aplicación y plan. No crea automáticamente un CSP seguro; tú debes seguir probando y manteniendo tus directivas.

Ver las ofertas de Cloudways

9. Protección más fuerte con CSP basado en nonce

Un CSP estricto usa nonces o hashes impredecibles en lugar de confiar solo en listas de permitidos por dominio. Un ejemplo simplificado en PHP:

<?php
$nonce = base64_encode(random_bytes(16));
header(
    "Content-Security-Policy: "
    . "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
    . "object-src 'none'; "
    . "base-uri 'none'"
);

En la plantilla HTML:

<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
    console.log('Trusted script');
</script>

Genera un nonce fresco e impredecible para cada respuesta. Mantén consistentes la cabecera y el nonce HTML, y planifica alrededor de proxies inversos y cachés de página completa. Con 'strict-dynamic', un script de confianza puede cargar más scripts, así que audita cuidadosamente los cargadores de confianza. Esto es una ilustración, no una política completa lista para usar en todas las aplicaciones.

10. Lista de verificación final de despliegue

  1. Identifica todas las cabeceras CSP y políticas meta existentes.
  2. Haz copia de seguridad de la configuración del servidor y del CMS.
  3. Inventaria scripts, estilos, iframes, APIs, imágenes y servicios externos.
  4. Despliega primero una política Report-Only.
  5. Investiga cada violación y autoriza solo comportamiento confiable y necesario.
  6. Prueba frontend, administración, inicio de sesión, compra, formularios e integraciones.
  7. Verifica caché, nonces, comportamiento del CDN y cabeceras duplicadas.
  8. Habilita el cumplimiento gradualmente y monitoriza tras actualizaciones de software.

Conclusión

Un CSP útil no es simplemente una cabecera copiada de una lista de verificación. Inspecciona tu configuración actual, encuentra dónde se define, prueba en modo Report-Only, corrige los problemas de compatibilidad precisos y solo entonces aplica una política apropiada a tu sitio web. Los administradores de WordPress y Joomla pueden empezar con herramientas del CMS; los desarrolladores pueden usar Apache, Nginx o PHP; y las plataformas de hosting pueden ofrecer controles directos de cabeceras.

CSP reduce oportunidades de ataque, pero sigue siendo una capa más junto con codificación segura, actualizaciones, autenticación y monitorización.