Polityka Bezpieczeństwa Treści (CSP): Jak sprawdzić, naprawić i skonfigurować ją na swojej stronie internetowej
Dowiedz się, jak sprawdzić, dodać i naprawić nagłówki Polityki Bezpieczeństwa Treści na Apache, Nginx, WordPress i Joomla, korzystając z praktycznych narzędzi diagnostycznych i wskazówek dotyczących hostingu.
Polityka Bezpieczeństwa Treści (CSP): Jak Sprawdzić, Naprawić i Skonfigurować na Stronie WWW
HTTPS i aktualizacje oprogramowania są niezbędne, ale nie zapobiegają uruchomieniu każdego złośliwego skryptu w przeglądarce odwiedzającego. Polityka Bezpieczeństwa Treści (CSP) dodaje narzucone przez przeglądarkę ograniczenia dotyczące zasobów, które strona może ładować i wykonywać. Pomaga łagodzić niektóre ataki cross-site scripting (XSS), ale nie zastępuje kontekstowego escapowania wyjścia, walidacji wejścia ani aktualizacji zależności.
Ten praktyczny poradnik pokazuje, jak zbadać obecną politykę, znaleźć jej źródło, bezpiecznie wprowadzić zmiany i rozwiązać problemy na Apache, Nginx, WordPress i Joomla.
1. Sprawdź swoją istniejącą politykę CSP
Chrome lub Firefox: Otwórz stronę, naciśnij F12, wybierz Sieć, przeładuj, kliknij dokument HTML i zbadaj Nagłówki odpowiedzi. Szukaj Content-Security-Policy (wymuszone) lub Content-Security-Policy-Report-Only (tylko diagnostyczne). Sprawdź Konsolę pod kątem naruszeń.
Wiersz poleceń: Uruchom curl -I https://example.com/. Na macOS/Linux odfiltruj odpowiedź za pomocą curl -sSI https://example.com/ | grep -i content-security-policy. Odpowiedzi HEAD mogą różnić się od odpowiedzi GET, więc użyj Narzędzi deweloperskich przeglądarki do potwierdzenia.
Narzędzia online: SecurityHeaders.com sprawdza nagłówki bezpieczeństwa; Google CSP Evaluator sygnalizuje słabości w polityce. Żadne z nich nie dowodzi, że cała witryna jest bezpieczna.
Brak nagłówka CSP w jednej odpowiedzi nie oznacza, że każda strona go nie ma. Zbadaj również wszelki tag <meta http-equiv="Content-Security-Policy">: polityki meta mają ograniczenia, w tym brak obsługi frame-ancestors lub Report-Only.
2. Znajdź, gdzie zdefiniowana jest polityka
| Środowisko | Prawdopodobna lokalizacja |
|---|---|
| Apache / kompatybilny LiteSpeed | .htaccess, wirtualny host lub konfiguracja serwera |
| Nginx | server / location konfiguracja |
| PHP | Kod aplikacji używający header() |
| WordPress | Wtyczka, kod niestandardowy, reverse proxy lub hosting |
| Joomla | Wtyczka System – Nagłówki HTTP, serwer lub proxy |
| Cloudflare | Reguły transformacji nagłówków odpowiedzi |
| Zarządzany hosting | Panel hostingu lub konfiguracja zarządzana przez dostawcę |
Zbadaj istniejące nagłówki odpowiedzi przed dodaniem kolejnego. Przeglądarki wymuszają wiele polityk CSP kumulatywnie; nowy uprawniający nagłówek nie anuluje istniejącego restrykcyjnego. Sprawdź również reguły CDN i hostingu.
3. Dodaj CSP w Apache za pomocą .htaccess
Używając menedżera plików hostingu lub SFTP (FileZilla/WinSCP), zlokalizuj katalog publiczny zawierający index.php, często public_html lub httpdocs. Włącz pliki ukryte, aby zobaczyć .htaccess. Pobierz kopię zapasową i unikaj umieszczania niestandardowych reguł wewnątrz bloku przepisywania zarządzanego przez CMS.
Jeśli mod_headers Apache jest włączone i host pozwala na te dyrektywy, dodaj:
<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>
Przeładuj i zweryfikuj nagłówek w zakładce Sieć → Nagłówki. Sprawdź Konsolę pod kątem naruszeń. Report-Only raportuje możliwe ograniczenia, ale nie blokuje zasobów. Ten przykład jest diagnostyczny, a nie kompletną polityką wdrożeniową.
Jeśli zgłoszony zostanie zaufany skrypt CDN, najpierw potwierdź jego cel i własność. Możesz dostosować dyrektywę do script-src 'self' https://cdn.example.com; nie dodawaj każdego zablokowanego hosta na ślepo. Listy dozwolonych hostów są mniej odporne na XSS niż dobrze zaprojektowane polityki oparte na nonce/hash.
Po przetestowaniu logowania, formularzy, checkoutu, edytorów i innych przepływów pracy, możesz zamienić Content-Security-Policy-Report-Only na Content-Security-Policy, aby wymusić swoją przetestowaną politykę. Jeśli strona przestanie działać, przywróć kopię zapasową, wyczyść pamięć podręczną serwera/CDN i przetestuj ponownie. Błąd HTTP 500 po edycji sugeruje problem ze składnią lub uprawnieniami serwera.

4. Skonfiguruj CSP na Nginx
Nginx ignoruje .htaccess. Jeśli administrujesz serwerem, zbadaj jego aktywną konfigurację (często /etc/nginx/sites-available/ lub /etc/nginx/conf.d/). W odpowiednim bloku server użyj:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
Przetestuj za pomocą sudo nginx -t, a następnie przeładuj za pomocą sudo systemctl reload nginx. Obserwuj dziedziczenie add_header i reguły w bardziej specyficznych lokalizacjach. Na zarządzanym hostingu bez dostępu do konfiguracji Nginx, użyj panelu sterowania dostawcy lub wsparcia.
5. WordPress: wtyczka lub mała integracja niestandardowa
Ścieżka bez kodu: Najpierw sprawdź, czy Twój hosting lub istniejąca wtyczka nagłówków bezpieczeństwa już wysyła CSP. Wybierz utrzymywaną wtyczkę, która jawnie obsługuje CSP i preferuje Report-Only; nie zakładaj, że ogólna wtyczka bezpieczeństwa obsługuje którejkolwiek. W jej ustawieniach włącz Report-Only, zacznij od zachowawczej polityki diagnostycznej, zapisz i przetestuj zarówno strony publiczne, jak i wp-admin przed egzekwowaniem.
Ścieżka dewelopera: Utwórz 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'"
);
});
Aktywuj w Wtyczki → Zainstalowane wtyczki, a następnie potwierdź nagłówek odpowiedzi. To nie nadpisuje istniejącego CSP z serwera WWW, CDN lub innej wtyczki. Celowo wyklucza wp-admin i nie zapewnia kompletnej egzekwowanej polityki.
Rozwiązywanie problemów: Jeśli CAPTCHA się nie powiedzie, zbadaj zablokowane żądania script-src, frame-src i connect-src oraz skonsultuj się z wskazówkami integracyjnymi dostawcy CAPTCHA. Jeśli budowniczy stron raportuje zablokowane skrypty inline, sprawdź obsługę CSP nonce lub hash. Nie dodawaj automatycznie 'unsafe-inline'. Dla nonce per-odpowiedź, upewnij się, że pełne buforowanie strony nie ponowne używa tego samego nonce i HTML dla różnych odwiedzających.
6. Joomla: użyj natywnej wtyczki Nagłówki HTTP
W administracji Joomla, otwórz System → Wtyczki, znajdź Nagłówki HTTP i otwórz System – Nagłówki HTTP. Dokładne nazewnictwo menu zależy od wersji Joomla i języka.
Włącz opcje CSP i zacznij od Report-Only na stronie publicznej. Zacznij od diagnozowania dyrektywy takiej jak script-src 'self'; zapisz i zbadaj Konsolę. Przetestuj szablony, budowniczych stron, edytory, formularze kontaktowe, CAPTCHE, integracje płatności i funkcje mediów.
Jeśli zobaczysz Refused to execute inline script, zidentyfikuj, który szablon lub rozszerzenie je generuje. Preferuj kompatybilne podejście oparte na nonce lub hash, gdzie jest wspierane; zweryfikuj, że skrypt jest legalny przed autoryzacją. Przetestuj administratora oddzielnie od frontendu. Jeśli serwer już ustawia CSP, pogodź konfiguracje zamiast nakładać konfliktujące polityki.
Skonsultuj się z dokumentacją Joomla HTTP Headers dla opcji obsługiwanych przez Twoją zainstalowaną wersję.
7. Napraw rzeczywiste naruszenie, a nie całą politykę
| Naruszenie | Co zbadać | Typowe rozwiązanie |
|---|---|---|
script-src |
Zewnętrzny lub inline JavaScript | Zweryfikuj źródło; użyj odpowiedniego nonce/hash lub wąsko określonego źródła |
style-src |
Arkusz stylów lub inline CSS | Zbadaj generowane style; użyj zatwierdzonego źródła lub kompatybilnego hash/nonce |
img-src |
Zewnętrzny obraz lub data URL | Pozwól na zweryfikowanego hosta obrazów tylko jeśli wymagane |
connect-src |
fetch/XHR/WebSocket | Zweryfikuj pochodzenie API i dodaj wąsko określone uprawnienie |
frame-src |
Osadzone wideo/CAPTCHA/ramka płatności | Postępuj zgodnie z udokumentowanymi domenami dostawcy |
form-action |
Cel przesyłania formularza | Pozwól na legalne pochodzenie przesyłania |
frame-ancestors |
Inna strona osadzająca Twoją stronę | Jawnie pozwól na zamierzone pochodzenia rodzica, lub użyj 'none' |
Na przykład, jeśli legalny obraz pod https://images.example.com/photo.webp jest blokowany przez img-src 'self', zmień odpowiednią dyrektywę na img-src 'self' https://images.example.com po potwierdzeniu, że host jest zaufany. Nie osłabiaj default-src tylko po to, by naprawić jeden obraz.

Niektóre dyrektywy, w tym frame-ancestors i form-action, nie wracają do default-src. Dołącz je jawnie, gdy są potrzebne.
8. Czy hosting wpływa na konfigurację CSP?
Tak – standard CSP przeglądarki pozostaje ten sam, ale Twoja kontrola nad nagłówkami odpowiedzi się zmienia. Wspólny hosting Apache może udostępniać .htaccess; zarządzany Nginx może wymagać panelu dostawcy; administratorzy VPS mogą modyfikować konfigurację serwera; a CDN mogą dodawać nagłówki po wygenerowaniu odpowiedzi przez aplikację.
Przed wyborem usługi hostingowej zapytaj: Czy mogę ustawiać i usuwać nagłówki CSP bez dostępu root? Czy mogę używać Report-Only? Czy mogę zbadać końcową odpowiedź? Czy nagłówki niestandardowe są dostępne w moim planie? Czy wsparcie może wyjaśnić konflikty z regułami CDN lub aplikacji?
Cloudways: kontrole nagłówków HTTP na poziomie hostingu
Cloudways udokumentuje Web Rules → Header Rules do zarządzania nagłówkami odpowiedzi HTTP, w tym CSP. Oferuje to alternatywę na poziomie hostingu dla edycji plików aplikacji, zależną od funkcji dostępnych dla Twojej aplikacji i planu. Nie automatycznie tworzy bezpiecznego CSP; nadal musisz testować i utrzymywać swoje dyrektywy.
9. Silniejsza ochrona z CSP opartym na nonce
Ścisła CSP używa nieprzewidywalnych nonce lub hash zamiast polegać tylko na listach dozwolonych domen. Uproszczony przykład PHP:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
W szablonie HTML:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
Generuj świeży, nieprzewidywalny nonce dla każdej odpowiedzi. Zachowaj spójność nagłówka i nonce HTML, i planuj wokół reverse proxy i pełnego buforowania stron. Z 'strict-dynamic' zaufany skrypt może ładować dalsze skrypty, więc starannie audytuj zaufane loadery. To jest ilustracja, a nie gotowa kompletna polityka dla wszystkich aplikacji.
10. Lista kontrolna końcowego wdrożenia
- Zidentyfikuj wszystkie istniejące nagłówki CSP i polityki meta.
- Zrób kopię zapasową konfiguracji serwera i CMS.
- spis skryptów, stylów, ramek, API, obrazów i usług zewnętrznych.
- Wdroż politykę Report-Only jako pierwszą.
- Zbadaj każde naruszenie i autoryzuj tylko zaufane, niezbędne zachowania.
- Przetestuj frontend, administrację, logowanie, checkout, formularze i integracje.
- Sprawdź buforowanie, nonce, zachowanie CDN i zduplikowane nagłówki.
- Włącz egzekwowanie stopniowo i monitoruj po aktualizacjach oprogramowania.
Podsumowanie
Użyteczna CSP to nie po prostu nagłówek skopiowany z listy kontrolnej. Zbadaj swoją obecną konfigurację, znajdź, gdzie jest zdefiniowana, przetestuj w trybie Report-Only, napraw precyzyjne problemy kompatybilności, a dopiero wtedy wymuś politykę odpowiednią dla Twojej witryny. Administratorzy WordPress i Joomla mogą zacząć od narzędzi CMS; deweloperzy mogą używać Apache, Nginx lub PHP; a platformy hostingowe mogą oferować bezpośrednie kontrole nagłówków.
CSP zmniejsza możliwości ataków, ale pozostaje jedną warstwą obok bezpiecznego kodowania, aktualizacji, uwierzytelniania i monitorowania.