Pomoc/Rozwiązywanie problemów
Rozwiązywanie problemów

Skrypt Flowsery Analytics zablokowany przez Content Security Policy (CSP)

Jeśli fragment kodu śledzenia Flowsery Analytics został dodany, ale odsłony się nie pojawiają, najpewniej jego załadowanie blokują nagłówki Content Security Policy (CSP) Twojej witryny.

Jak rozpoznać problem z CSP

  1. Otwórz witrynę w Chrome lub Firefoksie
  2. Uruchom DevTools (F12 lub Cmd+Shift+I)
  3. Przejdź na kartę Console
  4. Poszukaj błędu podobnego do tego:
Text
Refused to load the script 'https://cdn.flowsery.com/main.js' because it violates the following Content Security Policy directive: "script-src 'self'"

Ten komunikat potwierdza, że reguły CSP uniemożliwiają uruchomienie skryptu Flowsery Analytics.

Czym jest Content Security Policy

CSP to nagłówek HTTP, który informuje przeglądarkę, jakie zewnętrzne zasoby (skrypty, arkusze stylów, obrazy itp.) mogą być ładowane na stronie. Jeśli polityka nie obejmuje cdn.flowsery.com, przeglądarka po cichu blokuje skrypt -- i żadne dane nie są zbierane.

Jak rozwiązać problem

Dodaj cdn.flowsery.com do dyrektywy script-src w nagłówku CSP. Konkretne kroki zależą od platformy.

Next.js

Zaktualizuj nagłówek Content-Security-Policy w pliku 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;

Tag meta w HTML

Jeśli nie możesz zmienić nagłówków serwera, alternatywą jest tag meta w sekcji <head>:

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

Pamiętaj, że ten sposób działa tylko wtedy, gdy na poziomie serwera nie ma jeszcze nagłówka CSP -- nagłówki serwera zawsze mają pierwszeństwo przed tagami 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

Jeśli korzystasz z wtyczki bezpieczeństwa, takiej jak WP Cerber, Sucuri lub Wordfence, przejdź do jej ustawień CSP lub „HTTP headers” i dodaj https://cdn.flowsery.com do listy dozwolonych źródeł skryptów. Jeśli motyw konfiguruje CSP bezpośrednio w functions.php:

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

Korzystasz z proxy?

Jeśli masz skonfigurowane proxy dla Flowsery Analytics, skrypt jest serwowany z twojej domeny. W takim przypadku 'self' w CSP już na niego pozwala, więc dodatkowe zmiany nie powinny być potrzebne. Jeśli po włączeniu proxy problemy nadal występują, sprawdź, czy endpoint proxy znajduje się w tej samej domenie co witryna.

Używasz connect-src?

Jeśli twoja polityka CSP ogranicza też connect-src (określa, dokąd przeglądarka może wysyłać dane przez fetch/XHR), dodaj do tej dyrektywy również analytics.flowsery.com:

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

Problem nadal występuje?

  • Upewnij się, że zmieniasz aktywny nagłówek CSP. Niektórzy dostawcy hostingu lub sieci CDN mogą nadpisywać nagłówki.
  • Sprawdź, czy nie ma kilku nagłówków CSP -- przeglądarki stosują najbardziej restrykcyjne połączenie wszystkich obecnych nagłówków.
  • Wyczyść pamięć podręczną przeglądarki i przetestuj ponownie w oknie prywatnym/incognito.
  • Jeśli używasz proxy, upewnij się, że zarówno script-src, jak i connect-src zawierają domenę proxy.