Strony internetowe i programowanie

Polityka Bezpieczeństwa Treści (CSP): Jak sprawdzić, naprawić i skonfigurować ją na swojej stronie internetowej

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

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.

Illustration of the article's main concept

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.

Technical workflow illustration

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.

Zobacz oferty Cloudways

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

  1. Zidentyfikuj wszystkie istniejące nagłówki CSP i polityki meta.
  2. Zrób kopię zapasową konfiguracji serwera i CMS.
  3. spis skryptów, stylów, ramek, API, obrazów i usług zewnętrznych.
  4. Wdroż politykę Report-Only jako pierwszą.
  5. Zbadaj każde naruszenie i autoryzuj tylko zaufane, niezbędne zachowania.
  6. Przetestuj frontend, administrację, logowanie, checkout, formularze i integracje.
  7. Sprawdź buforowanie, nonce, zachowanie CDN i zduplikowane nagłówki.
  8. 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.