PS PrestaShop Średnio zaawansowany

Security Headers: nagłówki bezpieczeństwa i CSP dla PrestaShop 8 i 9

Instalacja i konfiguracja Security Headers 2.0: asystent, obserwacja w trybie Report-Only, nonce i edytor CSP, usługi, raporty, wersje, eksport dla serwera, HSTS i zatrzymanie awaryjne.

Zaktualizowano Wersja modułu 2.0.0

DataFirefly Security Headers wysyła nagłówki bezpieczeństwa HTTP sklepu w PrestaShop 1.7.8, 8 i 9: Content-Security-Policy z losowym nonce na każdej stronie, HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy oraz opcjonalnie COOP, COEP i CORP. Asystent konfiguracji analizuje sklep, okres obserwacji w trybie Report-Only pokazuje, co CSP by zablokowała, zanim cokolwiek zostanie zablokowane, a uruchomienie produkcyjne przebiega krok po kroku, z opcjonalną siatką bezpieczeństwa. Wszystko znajduje się w Zaawansowane > Nagłówki bezpieczeństwa.

Pulpit modułu Nagłówki bezpieczeństwa: wynik konfiguracji, status i etapy wdrożenia
Pulpit modułu Nagłówki bezpieczeństwa: wynik konfiguracji, status i etapy wdrożenia

Instalacja

  1. W Moduły > Menedżer modułów należy kliknąć Wgraj moduł i przesłać plik ZIP.
  2. Należy otworzyć Zaawansowane > Nagłówki bezpieczeństwa. Do odwiedzających nic nie jest wysyłane, dopóki asystent konfiguracji nie zostanie ukończony.
  3. Aktualizacja z wersji 1.0 lub 1.1: ustawienia, tokeny, usługi, wersje i zapisane raporty zostają zachowane, a asystent jest oznaczony jako ukończony.

Pulpit

Nagłówek pokazuje status (brak nagłówków, obserwacja, tylko urządzenia testowe, produkcja z CSP w trybie Report-Only lub blokującą) oraz orientacyjny wskaźnik Ocena konfiguracji, obliczany na podstawie nagłówków, które odwiedzający otrzymują w produkcji. Karta Wdrożenie śledzi cztery etapy: analiza i usługi, obserwacja, produkcja, blokująca CSP.

Nagłówki wysyłane w produkcji i praktyczne zalecenia
Nagłówki wysyłane w produkcji i praktyczne zalecenia

Lista Zalecenia jest obliczana na podstawie ustawień, ostatniej analizy, raportów i zainstalowanych modułów: każda pozycja wskazuje, co należy zrobić, i otwiera właściwą sekcję. Ocena korzysta z własnych wag tego modułu: publiczne skanery stosują własne kryteria i mogą oceniać inaczej. Nie jest to certyfikat.

Asystent konfiguracji

  1. Analiza: asystent odczytuje stronę główną tak, jak otrzymuje ją odwiedzający w produkcji: bieżące nagłówki, skrypty inline, procedury obsługi zdarzeń inline (onclick=...), linki javascript: oraz hosty zewnętrzne według dyrektywy. Analizować można tylko własne strony sklepu.
Asystent konfiguracji, krok 1: analiza strony głównej (skrypty, procedury inline, wykryte usługi)
Asystent konfiguracji, krok 1: analiza strony głównej (skrypty, procedury inline, wykryte usługi)
  1. Usługi: usługi wykryte na stronie lub wśród zainstalowanych modułów (PrestaShop Checkout, DataFirefly Google Tag Manager, Product Videos…) są wstępnie zaznaczone.
Asystent, krok 2: usługi zewnętrzne wstępnie wybrane na podstawie sklepu
Asystent, krok 2: usługi zewnętrzne wstępnie wybrane na podstawie sklepu
  1. Poziom: Podstawowy filtruje domeny, ale dopuszcza skrypty inline; Zalecany dodaje losowy nonce na każdej stronie, tak aby uruchamiały się tylko skrypty generowane przez sklep i skrypty z dozwolonych domen, przy czym procedury obsługi zdarzeń inline pozostają dozwolone; Ścisły dodaje 'strict-dynamic' i usuwa 'unsafe-eval' oraz procedury obsługi inline. W motywie Classic 'unsafe-eval' jest zachowywane na każdym poziomie: jego biblioteka Bootstrap 4 alpha używa new Function().
Asystent, krok 3: poziom ochrony CSP (Podstawowy, Zalecany, Ścisły)
Asystent, krok 3: poziom ochrony CSP (Podstawowy, Zalecany, Ścisły)
  1. Obserwacja: do wyboru 3, 7, 14 lub 30 dni. Każdy odwiedzający otrzymuje CSP w trybie Report-Only (jego przeglądarka zgłasza, co CSP by zablokowała, nic nie jest blokowane) albo nic, jeśli wybrano Tylko urządzenia testowe. Można podać adres e-mail dla alertów.

Uruchomienie produkcyjne

Podczas obserwacji należy przejrzeć główne strony (strona główna, kategoria, produkt, koszyk, proces zamówienia, konto) na urządzeniu testowym i obsłużyć raporty. Następnie w asystencie należy wybrać tryb CSP po uruchomieniu: Blokowanie (zalecane) lub Na razie Report-Only, zaznaczyć potwierdzenie i kliknąć Uruchomienie produkcyjne.

Uruchomienie produkcyjne z asystentem: blokująca CSP i 48-godzinna siatka bezpieczeństwa
Uruchomienie produkcyjne z asystentem: blokująca CSP i 48-godzinna siatka bezpieczeństwa

Opcjonalna siatka bezpieczeństwa nadzoruje 48 godzin po przełączeniu na blokowanie: jeśli co najmniej 25 nowych blokad pochodzi od 3 różnych odwiedzających, CSP samoczynnie wraca do trybu Report-Only, zapisywana jest wersja i wysyłany jest e-mail z powiadomieniem. Kompromis: raporty są publiczne, więc mogłyby ją uruchomić również fałszywe raporty wysłane z kilku adresów. Przycisk Wróć do Report-Only na pulpicie w dowolnym momencie robi to samo ręcznie.

Tryb testowy i urządzenia testowe

  • Urządzenia testowe (adres IP na liście lub przeglądarka otwarta za pomocą linku testowego): wszystkie nagłówki, CSP blokująca niezależnie od wybranego trybu, HSTS ograniczony do 5 minut i nigdy z preload.
  • Pozostali odwiedzający: CSP w trybie Report-Only albo nic (Tylko urządzenia testowe).

Lista IP akceptuje adresy IPv4, IPv6 i zakresy CIDR. Link testowy oznacza przeglądarkę jako urządzenie testowe na 24 godziny, co jest przydatne na telefonie; aby zakończyć, należy otworzyć adres z ?dfsh_test=off. Za serwerem proxy lub load balancerem należy wpisać jego adresy w polu Zaufane proxy: X-Forwarded-For jest odczytywany tylko dla tych adresów, od prawej do lewej, aby odwiedzający nie mógł podszyć się pod urządzenie testowe, samodzielnie wpisując ten nagłówek.

Edytor CSP i nonce

Opcje nonce: losowy nonce na stronę, strict-dynamic, ochrona przed odbiciem, procedury inline
Opcje nonce: losowy nonce na stronę, strict-dynamic, ochrona przed odbiciem, procedury inline
  • Losowy nonce na każdej stronie: moduł dodaje nową wartość do skryptów generowanych przez sklep i do CSP oraz usuwa 'unsafe-inline' z script-src. Motyw nie jest modyfikowany.
  • Skrypty otrzymujące nonce: skrypty inline i skrypty z dozwolonych hostów (zalecane) albo każdy znacznik script. Znacznik script z nieznanego hosta pozostaje bez nonce: przeglądarka go zgłasza, a jego host można dopuścić jednym kliknięciem.
  • Ochrona przed wstrzyknięciami odbitymi: znacznik script, którego treść pochodzi z adresu URL, formularza lub pliku cookie żądania, nigdy nie otrzymuje nonce.
  • strict-dynamic: skrypty ładowane przez zaufany skrypt (Google Tag Manager, menedżer zgód, SDK płatności) również są zaufane.
  • Zezwalaj na procedury obsługi zdarzeń inline dodaje script-src-attr 'unsafe-inline': atrybuty onclick nie mogą zawierać nonce.
  • Nonce w blokach stylów (zaawansowane) wymaga nonce w blokach <style>; powoduje to błędy w bibliotekach wstrzykujących style, w tym w Tarteaucitron.
Ograniczenie: znacznik script zapisany w bazie danych (opis produktu, strona CMS) jest częścią strony i otrzymuje nonce. Należy pozostawić włączoną opcję HTMLPurifier w PrestaShop i ograniczyć grono osób, które mogą edytować treści.

Każda dyrektywa jest edytowana jako lista źródeł: należy wpisać źródło i nacisnąć Enter ('self', domena, np. https://cdn.example.com lub *.example.com, schemat, np. data:, słowo kluczowe). Ryzykowne źródła są wyróżnione, domeny dodane przez włączone usługi są wyświetlane w przerywanej ramce, a ostatnio zablokowane domeny pojawiają się pod dyrektywą wraz z przyciskiem umożliwiającym ich dodanie.

Wizualny edytor CSP dla każdej dyrektywy z poziomami ryzyka i sugerowanymi zablokowanymi domenami
Wizualny edytor CSP dla każdej dyrektywy z poziomami ryzyka i sugerowanymi zablokowanymi domenami

Dla programistów: nonce strony jest dostępny w Smarty jako {$dfsh_nonce}, a w PHP przez DfSecurityHeaders::getNonce().

Usługi zewnętrzne

Każda usługa dodaje domeny udokumentowane przez jej dostawcę, z linkiem do tej dokumentacji: Stripe, PayPal (JS SDK, PrestaShop Checkout), Mollie, Google Tag Manager / GA4 i jego tryb podglądu, Google Ads, Meta Pixel, TikTok, Pinterest, Microsoft Clarity, Hotjar, Tarteaucitron.js, Cookiebot, Axeptio, YouTube, Vimeo, Google Fonts, Google Maps, reCAPTCHA, CDN obrazów (Cloudinary, imgix, Cloudflare Images, Bunny), Trustpilot i Crisp. Uwagi wskazują ograniczenia: PayPal wymaga COOP same-origin-allow-popups, Stripe nie obsługuje COEP, Tarteaucitron wymaga 'unsafe-inline' w style-src, niestandardowe zmienne JavaScript w GTM wymagają 'unsafe-eval'. Dostawcy od czasu do czasu zmieniają swoje domeny: raporty pokazują, czego jeszcze brakuje.

Gotowe usługi zewnętrzne (Stripe, PayPal, GTM/GA4, YouTube…) z odnośnikiem do dokumentacji dostawcy
Gotowe usługi zewnętrzne (Stripe, PayPal, GTM/GA4, YouTube…) z odnośnikiem do dokumentacji dostawcy

Raporty

Przeglądarki wysyłają raporty do modułu (report-uri oraz report-to z Reporting-Endpoints, gdy sklep używa https). Raporty są grupowane według dyrektywy i zablokowanego źródła, z liczbą wystąpień, liczbą rzeczywiście zablokowanych wystąpień, liczbą różnych odwiedzających, ostatnią stroną i skryptem oraz pierwszymi znakami zablokowanego kodu.

Zbiorcze raporty CSP: wystąpienia, różni odwiedzający, strony i sugestia „zezwól na tę domenę”
Zbiorcze raporty CSP: wystąpienia, różni odwiedzający, strony i sugestia „zezwól na tę domenę”
  • Włącz włącza usługę odpowiadającą domenie, Zezwól dodaje źródło do właściwej dyrektywy, Ignoruj przenosi wiersz na listę „Ignorowane”, gdzie jest nadal zliczany bez powiadomień.
  • Kod inline, eval, data: w skryptach i skrypty przez zwykłe http nigdy nie są dopuszczane jednym kliknięciem: podpowiedź wyjaśnia właściwe rozwiązanie.
  • Każdy może wysyłać raporty: źródło zgłoszone tylko przez jednego odwiedzającego jest odpowiednio oznaczone. Należy dopuszczać tylko to, co jest rozpoznawalne.
  • Punkt końcowy przyjmuje najwyżej 120 raportów na minutę od jednego nadawcy, 1500 na minutę dla sklepu i 64 KB na żądanie; raporty dotyczące stron spoza sklepu są odrzucane. Żaden adres IP nie jest zapisywany, adresy URL są przechowywane bez parametrów, a grupy niewidziane przez okres przechowywania (od 7 do 90 dni) są usuwane.

Wersje

Każda zmiana zachowuje poprzednie ustawienia wraz z datą, pracownikiem, działaniem i opcjonalną notatką wpisaną na pasku zapisu. Przechowywanych jest 30 ostatnich wersji. Porównaj z bieżącymi pokazuje różnice ustawienie po ustawieniu, można porównać ze sobą dwie wersje, a Przywróć jednym kliknięciem przywraca wybraną wersję; zastąpiony stan trafia do historii.

Wersje: porównanie z bieżącymi ustawieniami i przywracanie jednym kliknięciem
Wersje: porównanie z bieżącymi ustawieniami i przywracanie jednym kliknięciem

Eksport dla serwera

Aby statyczne nagłówki wysyłał Apache lub nginx, należy skopiować blok z sekcji Eksport dla serwera, a następnie włączyć Nagłówki wysyłane przez serwer w sekcji Ustawienia i zabezpieczenia: moduł wysyła wtedy tylko CSP (nonce i raporty wymagają PHP).

Eksport konfiguracji Apache i nginx bez duplikowania nagłówków wysyłanych przez PHP
Eksport konfiguracji Apache i nginx bez duplikowania nagłówków wysyłanych przez PHP
  • Bez duplikatów: Apache usuwa kopię wysłaną przez PHP (Header onsuccess unset), nginx ją ukrywa (fastcgi_hide_header).
  • HSTS jest wysyłany tylko przez https (wyrażenie Apache, map w nginx).
  • Przed przeładowaniem należy wykonać kopię zapasową pliku i sprawdzić składnię za pomocą apachectl -t lub nginx -t. W nginx dyrektywy add_header w bloku location zastępują te z bloku server.

Skaner

Analizuj bieżące nagłówki pobiera stronę sklepu z poziomu serwera; Podgląd produkcyjny pokazuje nagłówki, które otrzyma każdy odwiedzający po wyłączeniu trybu testowego. Wynik zawiera każdy nagłówek z jego punktami, wycieki informacji (X-Powered-By, wersja serwera), duplikaty oraz zawartość strony. Można odpytywać tylko domeny i porty sklepu, przekierowania do innej witryny nie są śledzone, a na hostingach, na których serwer nie może połączyć się z własnym adresem (Docker, NAT), analiza jest wykonywana bezpośrednio na serwerze.

Skaner nagłówków: orientacyjny wynik, szczegóły każdego nagłówka i zawartość strony (tylko strony sklepu)
Skaner nagłówków: orientacyjny wynik, szczegóły każdego nagłówka i zawartość strony (tylko strony sklepu)

HSTS i inne nagłówki

  • HSTS jest wysyłany tylko przez https. Należy zacząć od krótkiego czasu i zwiększać go stopniowo: przeglądarka zachowuje HSTS przez cały ustawiony okres, nawet jeśli zostanie on usunięty. includeSubDomains wymusza https w każdej subdomenie. preload jest wysyłany tylko z includeSubDomains i czasem co najmniej 1 roku oraz wymaga potwierdzenia: usunięcie z listy preload trwa miesiące.
  • X-Frame-Options SAMEORIGIN dla starszych przeglądarek; nowoczesne przeglądarki stosują dyrektywę CSP frame-ancestors.
  • Referrer-Policy strict-origin-when-cross-origin; no-referrer może zakłócić działanie osadzonych filmów YouTube.
  • COOP, COEP, CORP są domyślnie wyłączone: COOP same-origin przerywa wyskakujące okna płatności, COEP blokuje ramki iframe i pliki, które wyraźnie tego nie dopuszczają.
  • Panel administracyjny: opcjonalny zestaw ustawień dla panelu administracyjnego wysyła HSTS (https), X-Frame-Options SAMEORIGIN, nosniff i Referrer-Policy, nigdy CSP.
Ustawienia HSTS z ostrzeżeniami dotyczącymi preload i includeSubDomains, tylko przez https
Ustawienia HSTS z ostrzeżeniami dotyczącymi preload i includeSubDomains, tylko przez https

Permissions-Policy: dla każdej funkcji „Zablokowane”, „Tylko ta witryna” (oraz wpisane źródła i źródła włączonych usług) lub „Wszystkie witryny”. Wyświetlane są tylko funkcje znane obecnym przeglądarkom, aby nie powstawał żaden błąd w konsoli.

Alerty

Gdy CSP blokuje w produkcji, każdy zasób rzeczywiście zablokowany po raz pierwszy jest dodawany do zbiorczego e-maila: najwyżej jeden e-mail na godzinę i 12 dziennie, do 5 odbiorców. Przycisk Wyślij wiadomość testową pozwala sprawdzić konfigurację.

Zbiorczy e-mail z alertem: zasoby nowo zablokowane przez CSP i co zrobić
Zbiorczy e-mail z alertem: zasoby nowo zablokowane przez CSP i co zrobić

Zatrzymanie awaryjne i rozwiązywanie problemów

Ustawienia i zabezpieczenia: zatrzymanie awaryjne przez plik, stałą lub wiersz poleceń
Ustawienia i zabezpieczenia: zatrzymanie awaryjne przez plik, stałą lub wiersz poleceń
  • Jeśli nagłówek zakłóca działanie sklepu lub panelu administracyjnego, każdy z poniższych sposobów zatrzymuje od razu wszystkie nagłówki, nawet bez dostępu do panelu administracyjnego: utworzenie pustego pliku modules/dfsecurityheaders/EMERGENCY_OFF, dodanie define('_DFSH_EMERGENCY_OFF_', true); do config/defines_custom.inc.php lub uruchomienie php bin/console prestashop:module disable dfsecurityheaders.
  • Strona przestała działać: należy użyć przycisku Wróć do Report-Only lub przywrócić poprzednią wersję.
  • Moduły pamięci podręcznej stron, które odpowiadają na samym początku żądania (DataFirefly Speed Pack), serwują swoje strony przed modułem. Opcja Umieść moduł na pierwszej pozycji (Ustawienia i zabezpieczenia) zapewnia im nagłówki; gdy taka pamięć podręczna sama wyświetla zapisaną stronę, moduł wysyła dla tej odpowiedzi tę samą politykę bez nonce, aby nic nie przestało działać.
  • Przeglądarka, która otrzymała HSTS, odrzuca http do upływu ustawionego okresu, nawet po wyłączeniu modułu.
Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia