Nagłówki bezpieczeństwa HTTP: CSP i HSTS bez przestojów

Nagłówki bezpieczeństwa HTTP to krótkie instrukcje, które serwer wysyła przeglądarce razem ze stroną. Określają na przykład, skąd strona może ładować skrypty, czy obca witryna może osadzić ją w ramce albo czy witrynę wolno otwierać tylko przez HTTPS. Według OWASP pomagają zapobiegać podatnościom, takim jak cross-site scripting (XSS), clickjacking czy ujawnienie informacji (OWASP).

Jeśli ich brak wytknął wam skan bezpieczeństwa, audyt lub kwestionariusz klienta, uzupełnijcie je – ale nie wszystkie naraz i nie na ślepo. W skrócie: proste nagłówki wdróżcie zaraz po teście, Content-Security-Policy (CSP) najpierw w trybie Report-Only, który naruszenia tylko zgłasza, HSTS włączajcie ze stopniowo wydłużaną ważnością, a o liście HSTS preload zdecydujcie na końcu, bo trudno to cofnąć.

Które nagłówki bezpieczeństwa warto ustawić

Nie każdy nagłówek wymieniony przez skaner jest równie ważny, a niektóre nie są już zalecane. Tabela podsumowuje zalecenia MDN i OWASP dla typowej strony firmowej lub sklepu internetowego.

Nagłówek Do czego służy Zalecenie
Content-Security-Policy Określa, skąd strona może ładować zasoby, zwłaszcza JavaScript; służy głównie jako obrona przed XSS (MDN: CSP). Wprowadzać stopniowo, najpierw w trybie Report-Only.
Strict-Transport-Security Przeglądarka zapamiętuje na określoną liczbę sekund, że witrynę wolno otwierać tylko przez HTTPS (MDN: HSTS). Włączyć po sprawdzeniu subdomen, ze stopniowo rosnącym max-age.
X-Content-Type-Options Wartość nosniff zabrania przeglądarce zgadywania typu treści (OWASP). Ustawić w pierwszym etapie razem z poprawnym nagłówkiem Content-Type.
Referrer-Policy Określa, ile informacji o stronie źródłowej trafia wraz z żądaniami do nagłówka Referer (OWASP). Ustawić jawnie na strict-origin-when-cross-origin.
frame-ancestors, X-Frame-Options Określają, czy i kto może osadzić stronę w ramce, a tym samym chronią przed clickjackingiem (MDN: CSP). Przede wszystkim dyrektywa CSP frame-ancestors, X-Frame-Options jako uzupełnienie.
Permissions-Policy Określa, z których funkcji przeglądarki, na przykład kamery, mikrofonu lub geolokalizacji, mogą korzystać strona i osadzone ramki (OWASP). Wyłączyć funkcje, których witryna nie używa.
X-XSS-Protection, Expect-CT, Public-Key-Pins Nagłówki, których OWASP nie zaleca; X-XSS-Protection może w niektórych przypadkach wręcz stworzyć podatność XSS (OWASP). X-XSS-Protection nie ustawiać lub wyłączyć wartością 0, pozostałe usunąć.

OWASP zaleca też usunięcie nagłówka X-Powered-By, który zdradza używane technologie (OWASP). Najwięcej uwagi wymagają jednak dwa nagłówki, które przy nieostrożnym wdrożeniu mogą zepsuć stronę: CSP i HSTS.

Przykład poglądowy: sklep z analityką, czatem i płatnościami

Fikcyjna firma dla ilustracji: mały producent sprzedaje przez sklep internetowy na WordPressie i WooCommerce. Klient hurtowy przesłał mu kwestionariusz bezpieczeństwa, a załączony skan wskazał brak CSP i HSTS. Na stronie działają analityka, czat zewnętrznego dostawcy, mapa sklepów i bramka płatnicza. Sklep działa w domenie głównej, a w jednej z jej subdomen działa starszy interfejs magazynowy, który obsługuje tylko HTTP.

Restrykcyjna polityka CSP skopiowana z poradnika zablokowałaby skrypty, których polityka nie uwzględnia, i czat lub pomiary przestałyby działać. HSTS z dyrektywą includeSubDomains obowiązuje wszystkie subdomeny, więc przeglądarki, które odwiedziły sklep, zaczęłyby otwierać interfejs magazynowy przez HTTPS, którego on nie obsługuje (MDN: HSTS). Rozsądne podejście zaczyna się więc od inwentaryzacji, a nie od konfiguracji.

Wdrożenie krok po kroku

1. Inwentaryzacja: co ładuje strona i gdzie ustawia się nagłówki

Spiszcie wszystkie usługi zewnętrzne: analitykę, skrypty marketingowe, czat, mapy, filmy, czcionki, bramkę płatniczą i ochronę formularzy. Przejdźcie przez wszystkie typy stron, w tym koszyk, kasę, konto klienta i panel administracyjny; narzędzia online zwykle testują tylko stronę główną podanego adresu (OWASP).

Ustalcie też, gdzie dziś ustawiane są nagłówki: na hostingu, w CDN, we wtyczce czy w motywie. Jeśli do któregoś z tych miejsc nie macie dostępu, najpierw go zdobądźcie; pomoże artykuł o przejęciu domeny, kont i dostępów.

2. Najpierw wdróżcie proste nagłówki

Zacznijcie od nagłówków o jasnej wartości, ale je również przetestujcie: nosniff zakłada poprawny Content-Type, a Permissions-Policy nie może wyłączyć funkcji, z której korzysta strona, na przykład geolokalizacji przy wyszukiwaniu najbliższego sklepu.

X-Content-Type-Options: nosniff
Referrer-Policy: strict-origin-when-cross-origin
Permissions-Policy: geolocation=(), camera=(), microphone=()

Nowoczesne przeglądarki domyślnie używają strict-origin-when-cross-origin, OWASP zaleca jednak jawne ustawienie tej wartości (OWASP).

3. Ochronę przed ramkami wymuście osobno

CSP można wprowadzać częściami: ochronę przed clickjackingiem możecie dodać bez ograniczania skryptów (MDN: CSP). Jeśli strona nie powinna być osadzana na innych stronach, MDN zaleca frame-ancestors 'none'; jeśli system wyświetla własne strony w ramce, na przykład podgląd w panelu administracyjnym, użyjcie 'self'. OWASP zaleca, aby tam, gdzie to możliwe, stosować frame-ancestors, a MDN opisuje tę dyrektywę jako bardziej elastyczny zamiennik X-Frame-Options (OWASP, MDN: CSP).

4. CSP uruchomcie najpierw w trybie Report-Only

Nagłówek Content-Security-Policy-Report-Only monitoruje naruszenia polityki i ich skutki bez jej wymuszania, dzięki czemu błędy naprawicie przed wdrożeniem produkcyjnym (MDN: Report-Only). Aby raporty gdziekolwiek trafiły, polityka potrzebuje celu: MDN wskazuje dyrektywę report-to, której adres określa nagłówek Reporting-Endpoints. Starszą dyrektywę report-uri oznacza jako przestarzałą, w przykładzie podaje jednak obie, ponieważ report-to nie ma jeszcze pełnego wsparcia we wszystkich przeglądarkach.

Jeśli odpowiedź zawiera zarówno Content-Security-Policy, jak i Content-Security-Policy-Report-Only, przeglądarka respektuje obie: pierwszą wymusza, druga tylko zgłasza (MDN: CSP). Ochronę przed ramkami wymusicie więc od razu, a skrypty na razie tylko monitorujecie:

Reporting-Endpoints: csp-endpoint="https://example.com/csp-reports"
Content-Security-Policy: frame-ancestors 'self'
Content-Security-Policy-Report-Only: script-src 'nonce-{NONCE}' 'strict-dynamic'; object-src 'none'; base-uri 'none'; report-uri https://example.com/csp-reports; report-to csp-endpoint

{NONCE} to symbol zastępczy losowej wartości, którą serwer generuje dla każdej odpowiedzi. Trybu Report-Only nie da się dostarczyć przez element <meta>, nagłówek musi wysyłać serwer (MDN: Report-Only). Zapisujcie raporty, ustalcie, kto je czyta, i pozostawcie tryb włączony, dopóki nie obejmie wszystkich typów stron i typowych sytuacji, na przykład kampanii.

5. Z raportów przygotujcie wymuszaną politykę

Przy każdym naruszeniu zdecydujcie: legalną usługę dopuśćcie, nieznane źródło sprawdźcie, a zbędny skrypt usuńcie. MDN zaleca tak zwaną strict CSP opartą na nonce lub hashach, ponieważ listy dozwolonych domen trudno utrzymać, zwłaszcza przy skryptach, nad którymi nie macie kontroli (MDN: CSP).

Nonce musi być dla każdej odpowiedzi inny i nieprzewidywalny, więc serwer nie może wysyłać statycznego HTML (MDN: CSP). Jeśli strona korzysta z cache całych stron, rozwiążcie to już na etapie projektu, inaczej zapisana strona powtarzałaby ten sam nonce. Jeśli zewnętrzny skrypt ładuje kolejne skrypty, strict CSP je zablokuje; słowo kluczowe 'strict-dynamic' przenosi zaufanie ze skryptu z nonce na skrypty, które on ładuje.

Unikajcie 'unsafe-inline', które według MDN niweczy znaczną część sensu CSP (MDN: CSP). Gdy raporty nie pokazują już żadnych niewyjaśnionych naruszeń, przełączcie politykę na Content-Security-Policy i zachowajcie report-to.

6. HSTS włączajcie etapami

Nagłówek HSTS serwer musi wysyłać wyłącznie przez HTTPS; jeśli dotrze przez HTTP, przeglądarki go ignorują. Żądania HTTP serwer powinien trwale przekierowywać na HTTPS, na przykład kodem 301 (MDN: HSTS). Przed włączeniem sprawdźcie, czy przez HTTPS działają wszystkie subdomeny, w tym wewnętrzne, niedostępne publicznie. Następnie, zgodnie z hstspreload.org, zwiększajcie max-age etapami – 5 minut, tydzień, miesiąc (hstspreload.org):

Strict-Transport-Security: max-age=300; includeSubDomains
Strict-Transport-Security: max-age=604800; includeSubDomains
Strict-Transport-Security: max-age=2592000; includeSubDomains

Na każdym etapie obserwujcie niedziałające strony i wskaźniki, na przykład ruch i przychody, naprawcie problemy i przed kolejnym krokiem odczekajcie pełny czas max-age danego etapu. Potem możecie wydłużyć ważność na przykład do roku (31536000 sekund), co jest zarazem minimum dla preload. Przy błędnej konfiguracji lub problemie z certyfikatem odwiedzający mogą jednak nie mieć dostępu do strony, dopóki ważność HSTS nie wygaśnie (OWASP). Niezawodne automatyczne odnawianie certyfikatów jest więc warunkiem koniecznym; poświęcony jest mu artykuł o krótszej ważności certyfikatów SSL.

7. Preload tylko po świadomej decyzji

Lista HSTS preload jest wbudowana bezpośrednio w Chrome, a inne duże przeglądarki mają listy na niej oparte. Wpis wymaga ważnego certyfikatu, przekierowania z HTTP na HTTPS w obrębie tego samego hosta, HTTPS na wszystkich subdomenach oraz nagłówka z max-age co najmniej 31536000 sekund (1 rok), includeSubDomains i preload (hstspreload.org).

Wpis trudno cofnąć: usunięcie dociera do użytkowników Chrome dopiero po miesiącach, a w innych przeglądarkach nie da się go zagwarantować. Chrome i Safari ponadto automatycznie przełączają nawigację z HTTP na HTTPS niezależnie od HSTS, a preload pomaga tylko wtedy, gdy to przełączenie udaremni aktywny atakujący. Serwis hstspreload.org uznaje więc korzyść z preload w porównaniu z HSTS za minimalną i nie zaleca preload (hstspreload.org). Dla typowej strony firmowej wystarczy HSTS bez preload.

Gdzie ustawić nagłówki

Każdy nagłówek powinien mieć jedno jasno określone miejsce. Według MDN CSP powinna być wysyłana ze wszystkimi odpowiedziami, a nie tylko z głównym dokumentem (MDN: CSP).

Miejsce Odpowiednie dla Na co uważać
Serwer WWW (Apache, Nginx) Nagłówki o stałej wartości: HSTS dla odpowiedzi HTTPS, nosniff, Referrer-Policy. Bez parametru always Nginx wysyła nagłówek tylko przy niektórych kodach statusu, a add_header w bloku location usuwa nagłówki ustawione poziom wyżej; w Apache przed duplikatami chroni unset, a następnie always set (OWASP).
CDN lub reverse proxy Jednolite reguły dla wielu serwerów lub stron. Wartości z CDN i serwera nie mogą się dublować ani nadpisywać; sprawdzajcie końcową odpowiedź w przeglądarce.
Aplikacja lub wtyczka CSP z nonce, który trzeba wygenerować dla każdej odpowiedzi i wstawić do HTML (MDN: CSP). Cache całych stron nie może zapisać nonce; jeśli nagłówki ustawia też serwer, ustalcie, kto zarządza którym.
Element <meta> w HTML CSP dla aplikacji jednostronicowej ze statycznymi plikami bez infrastruktury serwerowej (MDN: CSP). Nie obsługuje wszystkich funkcji CSP, a tryb Report-Only przez niego nie działa.

Kompromisy: ochrona a utrzymanie

Według OWASP CSP nie jest łatwa w konfiguracji ani w utrzymaniu (OWASP). Każde nowe narzędzie marketingowe, czat lub osadzona treść może oznaczać zmianę polityki. Dlatego ustalcie procedurę: kto zatwierdza nowy skrypt, kto testuje go w trybie Report-Only i kto zmienia nagłówek.

Nonce łatwiej utrzymać przy stronach generowanych dynamicznie, wymaga jednak zmian w szablonach i cache. Hashe pasują do treści statycznych, ale po każdej zmianie skryptu trzeba je przeliczyć. Lista dozwolonych domen wygląda na najprostszy początek, MDN ostrzega jednak, że takie polityki często niezamierzenie dopuszczają niebezpieczne domeny (MDN: CSP).

HSTS to prosty nagłówek, który chroni na przykład przed tym, by atakujący w sieci przepisał przekierowanie z HTTP na HTTPS (hstspreload.org). Na cały czas max-age wiąże jednak stronę z działającym HTTPS, więc problem z certyfikatem ma poważniejsze skutki.

Częste błędy

  • Kopiowanie wartości z poradnika. Zalecana przez OWASP wartość HSTS zawiera zarówno includeSubDomains, jak i preload, a OWASP prosi, by przed użyciem uważnie przeczytać, jak działa ten nagłówek (OWASP). Dyrektywę preload serwis hstspreload.org traktuje przy tym jako wniosek o wpis na listę (hstspreload.org).
  • 'unsafe-inline' tylko dla zielonego wyniku skanera. Polityka wprawdzie istnieje, ale traci znaczną część ochrony (MDN: CSP).
  • Report-Only bez celu raportów. Bez report-to, a dla przeglądarek bez jej obsługi także report-uri, raporty nigdzie nie trafią (MDN: Report-Only).
  • Nonce zapisany w cache. Ten sam nonce w wielu odpowiedziach narusza warunek, że za każdym razem musi być inny i nieprzewidywalny.
  • Nagłówki w wielu miejscach. Serwer, CDN i wtyczka mogą dublować lub nadpisywać wartości; w Nginx blok location może po cichu usunąć nagłówki bezpieczeństwa (OWASP).
  • Wyłączanie HSTS przez usunięcie nagłówka. Jeśli nagłówka brakuje, poprzedni obowiązuje aż do wygaśnięcia; anulować go można wartością max-age=0 (MDN: HSTS).

Lista kontrolna przed wdrożeniem produkcyjnym

  • Inwentaryzacja usług zewnętrznych obejmuje wszystkie typy stron i ma właściciela.
  • Każdy nagłówek ustawiany jest w jednym znanym miejscu, a końcowa odpowiedź jest sprawdzona.
  • nosniff, Referrer-Policy, Permissions-Policy i frame-ancestors są przetestowane w formularzach, płatności, logowaniu i panelu administracyjnym.
  • CSP działa w trybie Report-Only z report-to i Reporting-Endpoints, a ktoś regularnie czyta raporty.
  • Wymuszana CSP nie używa dla skryptów 'unsafe-inline', a nonce jest generowany dla każdej odpowiedzi.
  • Wszystkie subdomeny, w tym wewnętrzne, działają przez HTTPS, a odnawianie certyfikatów jest automatyczne i monitorowane.
  • max-age w HSTS rośnie etapami, a preload jest świadomą decyzją, a nie wartością domyślną.
  • Każdy nowy zewnętrzny skrypt przechodzi zatwierdzenie i test w trybie Report-Only.

Najczęstsze pytania

Jak długo pozostawić CSP w trybie Report-Only?

Nie ma uniwersalnego okresu. Raporty powinny objąć wszystkie typy stron i typowe sytuacje, a przed wymuszeniem nie powinny zawierać niewyjaśnionych naruszeń. Także po wymuszeniu możecie testować kolejną wersję polityki równolegle w trybie Report-Only (MDN: CSP).

Czy potrzebuję X-Frame-Options, jeśli mam frame-ancestors?

Główną ochroną powinna być frame-ancestors. X-Frame-Options możecie zachować jako uzupełnienie; OWASP zaleca wartość DENY, a w przykładzie podaje też SAMEORIGIN (OWASP). Wartości nie powinny sobie przeczyć: do frame-ancestors 'self' pasuje SAMEORIGIN, a nie DENY.

Jak wyłączyć HSTS, gdy coś się zepsuje?

Ustawcie max-age=0. Zadziała to dopiero wtedy, gdy przeglądarka załaduje stronę przez HTTPS i otrzyma ten nagłówek (MDN: HSTS). W przypadku domeny na liście preload usunięcie trwa miesiące (hstspreload.org), dlatego zaczynajcie od krótkich etapów.

Czy zielony wynik skanera oznacza, że strona jest bezpieczna?

Nie. Według OWASP CSP to dodatkowa warstwa ochrony, która pomaga wykrywać i łagodzić niektóre typy ataków (OWASP). Nagłówki nie zastępują aktualizacji, bezpiecznego kodu, kopii zapasowych ani zarządzania dostępami; są jedną warstwą zabezpieczeń strony, a nie całością.

Pomoc w ustawieniu nagłówków

Jeśli chcecie dodać nagłówki bezpieczeństwa do strony firmowej lub sklepu internetowego bez niepotrzebnego ryzyka przestoju, przeprowadzę inwentaryzację, skonfiguruję tryb Report-Only, przeanalizuję raporty i przygotuję stopniowe wdrożenie HSTS. Zobaczcie, jak pracuję przy tworzeniu stron internetowych i sklepach internetowych na zamówienie, albo skontaktujcie się ze mną przez stronę kontaktową.

Źródła

Źródła zweryfikowano 16 listopada 2026 r.

Proszę wybrać, na które pliki cookie Państwo zezwalają. Wybór można w każdej chwili zmienić za pomocą linku w stopce lub przycisku cookies.

Ochrona prywatności i szczegóły dotyczące plików cookie