Soporte/Solución de problemas
Solución de problemas

Script de Flowsery Analytics bloqueado por Content Security Policy (CSP)

Si has agregado el fragmento de seguimiento de Flowsery Analytics pero no aparecen visitas, los encabezados de Content Security Policy (CSP) de tu sitio probablemente están impidiendo que se cargue.

Diagnosticar un problema de CSP

  1. Abre tu sitio en Chrome o Firefox
  2. Abre DevTools (F12 o Cmd+Shift+I)
  3. Cambia a la pestaña Consola
  4. Busca un error similar a:
Text
Refused to load the script 'https://cdn.flowsery.com/main.js' because it violates the following Content Security Policy directive: "script-src 'self'"

Ver este mensaje confirma que las reglas CSP están impidiendo que el script de Flowsery Analytics se ejecute.

Entender Content Security Policy

Un CSP es un encabezado HTTP que indica a los navegadores qué recursos externos (scripts, hojas de estilo, imágenes, etc.) tienen permitido cargarse en una página. Cuando cdn.flowsery.com no está incluido en la política, el navegador bloquea silenciosamente el script -- y no se recopila ningún dato.

Resolver el problema

Agrega cdn.flowsery.com a la directiva script-src dentro de tu encabezado CSP. Los pasos específicos varían según la plataforma.

Next.js

Actualiza el encabezado Content-Security-Policy dentro de tu next.config.js:

JavaScript
const ContentSecurityPolicy = `
  script-src 'self' 'unsafe-inline' 'unsafe-eval' https://cdn.flowsery.com;
`;
 
module.exports = {
  async headers() {
    return [
      {
        source: '/(.*)',
        headers: [
          {
            key: 'Content-Security-Policy',
            value: ContentSecurityPolicy.replace(/\n/g, ''),
          },
        ],
      },
    ];
  },
};
JSON
{
  "headers": [
    {
      "source": "/(.*)",
      "headers": [{ "key": "Content-Security-Policy", "value": "script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;" }]
    }
  ]
}
Text
/*
  Content-Security-Policy: script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;

Etiqueta meta HTML

Cuando no puedes modificar los encabezados del servidor, una etiqueta meta dentro de <head> es una alternativa:

HTML
<meta http-equiv="Content-Security-Policy" content="script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;" />

Ten en cuenta que este enfoque solo tiene efecto cuando no hay un encabezado CSP a nivel de servidor presente -- los encabezados del servidor siempre anulan las etiquetas meta.

Nginx

Nginx
add_header Content-Security-Policy "script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;" always;
APACHE
Header set Content-Security-Policy "script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;"

WordPress

Si dependes de un plugin de seguridad como WP Cerber, Sucuri o Wordfence, navega a su configuración de CSP o "HTTP headers" y agrega https://cdn.flowsery.com a la lista de fuentes de scripts permitidas. Cuando tu tema configura CSP directamente en functions.php:

PHP
header("Content-Security-Policy: script-src 'self' 'unsafe-inline' https://cdn.flowsery.com;");

¿Estás detrás de un proxy?

Si has configurado un proxy para Flowsery Analytics, el script se sirve desde tu propio dominio. En ese escenario, 'self' en tu CSP ya lo permite, por lo que no deberían ser necesarios cambios adicionales. Si los problemas persisten después del proxy, verifica que el endpoint del proxy esté en el mismo dominio que tu sitio web.

¿Usas connect-src?

Si tu CSP también limita connect-src (que controla adónde puede enviar datos el navegador vía fetch/XHR), incluye analytics.flowsery.com también en esa directiva:

Text
Content-Security-Policy: script-src 'self' https://cdn.flowsery.com; connect-src 'self' https://analytics.flowsery.com;

¿Sigues teniendo problemas?

  • Confirma que estás modificando el encabezado CSP activo. Ciertos proveedores de hosting o CDNs pueden anular encabezados.
  • Busca múltiples encabezados CSP -- los navegadores aplican la combinación más restrictiva de todos los encabezados presentes.
  • Limpia la caché de tu navegador y vuelve a probar en una ventana privada/incógnito.
  • Cuando uses un proxy, asegúrate de que tanto script-src como connect-src incluyan tu dominio de proxy.