Bezpečnostní HTTP hlavičky: jak zavést CSP a HSTS bez výpadku
Bezpečnostní HTTP hlavičky jsou krátké pokyny, které server posílá prohlížeči spolu se stránkou. Určují například, odkud smí stránka načítat skripty, zda ji smí cizí web vložit do rámce nebo zda se má web otevírat pouze přes HTTPS. Podle OWASP pomáhají předcházet zranitelnostem, jako jsou cross-site scripting (XSS), clickjacking či únik informací (OWASP).
Pokud vám jejich chybění vytkl bezpečnostní sken, audit nebo dotazník zákazníka, doplňte je – ale ne najednou a naslepo. Stručně: jednoduché hlavičky nasaďte hned po otestování, Content-Security-Policy (CSP) nejprve v režimu Report-Only, který porušení pouze hlásí, HSTS zapínejte s postupně prodlužovanou platností a o seznamu HSTS preload rozhodněte až nakonec, protože se těžko vrací zpět.
Které bezpečnostní hlavičky má smysl nastavit
Ne každá hlavička, kterou skener zmíní, je stejně důležitá, a některé se už nedoporučují. Tabulka shrnuje doporučení MDN a OWASP pro běžný firemní web nebo e-shop.
| Hlavička | K čemu slouží | Doporučení |
|---|---|---|
Content-Security-Policy |
Určuje, odkud smí stránka načítat zdroje, především JavaScript; slouží hlavně jako obrana proti XSS (MDN: CSP). | Zavádět postupně, nejprve v režimu Report-Only. |
Strict-Transport-Security |
Prohlížeč si na určený počet sekund zapamatuje, že web smí otevírat pouze přes HTTPS (MDN: HSTS). | Zapnout po kontrole subdomén, s postupně rostoucím max-age. |
X-Content-Type-Options |
Hodnota nosniff zakáže prohlížeči hádat typ obsahu (OWASP). | Nastavit v první etapě spolu se správnou hlavičkou Content-Type. |
Referrer-Policy |
Určuje, kolik informací o původní stránce odchází s požadavky v hlavičce Referer (OWASP). | Nastavit výslovně na strict-origin-when-cross-origin. |
frame-ancestors, X-Frame-Options |
Určují, zda a kdo smí stránku vložit do rámce, a tím chrání před clickjackingem (MDN: CSP). | Hlavně direktiva CSP frame-ancestors, X-Frame-Options jako doplněk. |
Permissions-Policy |
Určuje, které funkce prohlížeče, například kameru, mikrofon nebo polohu, smí stránka a vložené rámce používat (OWASP). | Vypnout funkce, které web nepoužívá. |
X-XSS-Protection, Expect-CT, Public-Key-Pins |
Hlavičky, které OWASP nedoporučuje; X-XSS-Protection může v některých případech zranitelnost XSS dokonce vytvořit (OWASP). | X-XSS-Protection nenastavovat nebo vypnout hodnotou 0, ostatní odstranit. |
OWASP doporučuje odstranit i hlavičku X-Powered-By, která prozrazuje použité technologie (OWASP). Nejvíce pozornosti však vyžadují dvě hlavičky, které dokážou při neopatrném nasazení web rozbít: CSP a HSTS.
Ilustrativní příklad: e-shop s analytikou, chatem a platbou
Smyšlená firma pro ilustraci: menší výrobce prodává přes e-shop na WordPressu a WooCommerce. Velkoodběratel mu poslal bezpečnostní dotazník a přiložený sken označil chybějící CSP a HSTS. Na webu běží analytika, chat externího dodavatele, mapa prodejen a platební brána. E-shop je na hlavní doméně a na její subdoméně běží starší skladové rozhraní, které funguje pouze přes HTTP.
Přísná CSP zkopírovaná z návodu by zablokovala skripty, se kterými politika nepočítá, a chat či měření by přestaly fungovat. HSTS s direktivou includeSubDomains platí pro všechny subdomény, takže prohlížeče, které e-shop navštívily, by začaly skladové rozhraní otevírat přes HTTPS, které nepodporuje (MDN: HSTS). Rozumný postup proto začíná inventurou, ne konfigurací.
Postup zavedení krok za krokem
1. Inventura: co web načítá a kde se hlavičky nastavují
Sepište všechny externí služby: analytiku, marketingové skripty, chat, mapy, videa, fonty, platební bránu a ochranu formulářů. Projděte všechny typy stránek včetně košíku, pokladny, zákaznického účtu a administrace; online nástroje obvykle testují pouze úvodní stránku zadané adresy (OWASP).
Zjistěte také, kde se hlavičky dnes nastavují: na hostingu, v CDN, v pluginu nebo v šabloně. Pokud k některému místu nemáte přístup, nejprve ho získejte; pomůže článek o převzetí domény, účtů a přístupů.
2. Jednoduché hlavičky nasaďte jako první
Začněte hlavičkami s jasnou hodnotou, i ty však otestujte: nosniff předpokládá správný Content-Type a Permissions-Policy nesmí vypnout funkci, kterou web používá, například polohu při hledání nejbližší prodejny.
X-Content-Type-Options: nosniff
Referrer-Policy: strict-origin-when-cross-origin
Permissions-Policy: geolocation=(), camera=(), microphone=()
Moderní prohlížeče používají strict-origin-when-cross-origin ve výchozím nastavení, OWASP však doporučuje nastavit hodnotu výslovně (OWASP).
3. Ochranu před rámci vynuťte samostatně
CSP lze zavádět po částech: ochranu před clickjackingem můžete přidat bez omezení skriptů (MDN: CSP). Pokud web nemá být vkládán do jiných stránek, MDN doporučuje frame-ancestors 'none'; pokud systém zobrazuje vlastní stránky v rámci, například náhled v administraci, použijte 'self'. OWASP doporučuje frame-ancestors upřednostnit, pokud je to možné, a MDN ji popisuje jako flexibilnější náhradu X-Frame-Options (OWASP, MDN: CSP).
4. CSP spusťte nejprve v režimu Report-Only
Hlavička Content-Security-Policy-Report-Only sleduje porušení politiky a jejich důsledky, aniž by ji vynucovala, takže chyby opravíte před ostrým nasazením (MDN: Report-Only). Aby hlášení někam odešla, politika potřebuje cíl: MDN uvádí direktivu report-to, jejíž adresu určuje hlavička Reporting-Endpoints. Starší direktivu report-uri označuje za zastaralou, v příkladu však uvádí obě, protože report-to zatím nemá plnou podporu ve všech prohlížečích.
Pokud odpověď obsahuje Content-Security-Policy i Content-Security-Policy-Report-Only, prohlížeč respektuje obě: první vynucuje, druhá pouze hlásí (MDN: CSP). Ochranu před rámci tak vynutíte hned a skripty zatím jen sledujete:
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} je zástupný symbol pro náhodnou hodnotu, kterou server vytvoří pro každou odpověď. Report-Only nelze doručit přes element <meta>, hlavičku musí posílat server (MDN: Report-Only). Hlášení ukládejte, určete, kdo je čte, a nechte režim běžet, dokud nepokryje všechny typy stránek i běžné situace, například kampaň.
5. Z hlášení připravte vynucenou politiku
U každého porušení rozhodněte: legitimní službu povolte, neznámý zdroj prověřte a nepotřebný skript odstraňte. MDN doporučuje takzvanou strict CSP založenou na nonce nebo hashích, protože seznamy povolených domén se obtížně udržují, zejména u skriptů, které nemáte pod kontrolou (MDN: CSP).
Nonce musí být pro každou odpověď jiný a nepředvídatelný, takže server nemůže posílat statické HTML (MDN: CSP). Pokud web používá cache celých stránek, vyřešte to už při návrhu, jinak by uložená stránka opakovala tentýž nonce. Pokud skript třetí strany načítá další skripty, strict CSP je zablokuje; klíčové slovo 'strict-dynamic' přenese důvěru ze skriptu s nonce na skripty, které načte.
Vyhněte se 'unsafe-inline', které podle MDN popírá velkou část smyslu CSP (MDN: CSP). Když hlášení neukazují žádná nevysvětlená porušení, přepněte politiku na Content-Security-Policy a report-to ponechte.
6. HSTS zapínejte po etapách
Hlavičku HSTS musí server posílat pouze přes HTTPS, přes HTTP ji prohlížeče ignorují. Požadavky přes HTTP má trvale přesměrovat na HTTPS, například kódem 301 (MDN: HSTS). Před zapnutím ověřte, že přes HTTPS fungují všechny subdomény včetně interních, které nejsou veřejně dostupné. Poté podle hstspreload.org zvyšujte max-age po etapách – 5 minut, týden, měsíc (hstspreload.org):
Strict-Transport-Security: max-age=300; includeSubDomains
Strict-Transport-Security: max-age=604800; includeSubDomains
Strict-Transport-Security: max-age=2592000; includeSubDomains
V každé etapě sledujte nefunkční stránky a metriky, například návštěvnost a tržby, opravte problémy a před dalším krokem počkejte celou délku max-age dané etapy. Poté můžete platnost prodloužit například na rok (31536000 sekund), což je zároveň minimum pro preload. Při chybné konfiguraci nebo problému s certifikátem se však návštěvníci nemusí na web dostat, dokud platnost HSTS nevyprší (OWASP). Spolehlivá automatická obnova certifikátů je proto podmínkou; věnuje se jí článek o kratší platnosti SSL certifikátů.
7. Preload jen po vědomém rozhodnutí
Seznam HSTS preload je zabudovaný přímo v Chrome a další velké prohlížeče mají seznamy založené na něm. Zařazení vyžaduje platný certifikát, přesměrování z HTTP na HTTPS na tomtéž hostiteli, HTTPS na všech subdoménách a hlavičku s max-age alespoň 31536000 sekund (1 rok), includeSubDomains a preload (hstspreload.org).
Zařazení se těžko vrací: odstranění se k uživatelům Chrome dostane až po měsících a u jiných prohlížečů ho nelze zaručit. Chrome a Safari navíc převádějí navigace z HTTP na HTTPS automaticky bez ohledu na HSTS a preload pomáhá pouze tehdy, když tento převod zmaří aktivní útočník. Stránka hstspreload.org označuje přínos preloadu oproti HSTS za minimální a preload nedoporučuje (hstspreload.org). Pro běžný firemní web stačí HSTS bez preload.
Kde hlavičky nastavit
Každá hlavička má mít jedno jasné místo. CSP má podle MDN chodit se všemi odpověďmi, nejen s hlavním dokumentem (MDN: CSP).
| Místo | Vhodné pro | Na co si dát pozor |
|---|---|---|
| Webový server (Apache, Nginx) | Hlavičky s pevnou hodnotou: HSTS pro odpovědi přes HTTPS, nosniff, Referrer-Policy. | Nginx bez parametru always posílá hlavičku pouze u některých stavových kódů a add_header v bloku location ruší hlavičky nastavené o úroveň výš; v Apache proti duplicitám pomáhá unset a poté always set (OWASP). |
| CDN nebo reverzní proxy | Jednotná pravidla pro více serverů nebo webů. | Hodnoty z CDN a serveru se nesmí zdvojovat ani přepisovat; kontrolujte výslednou odpověď v prohlížeči. |
| Aplikace nebo plugin | CSP s nonce, který je třeba vytvořit pro každou odpověď a vložit do HTML (MDN: CSP). | Cache celých stránek nesmí uložit nonce; pokud hlavičky nastavuje i server, určete, kdo spravuje kterou. |
| Element <meta> v HTML | CSP pro jednostránkovou aplikaci se statickými soubory bez serverové infrastruktury (MDN: CSP). | Nepodporuje všechny funkce CSP a režim Report-Only přes něj nefunguje. |
Kompromisy: ochrana versus údržba
CSP podle OWASP není jednoduché nastavit ani udržovat (OWASP). Každý nový marketingový nástroj, chat nebo vložený obsah může znamenat změnu politiky. Proto určete postup: kdo nový skript schválí, kdo ho otestuje v režimu Report-Only a kdo upraví hlavičku.
Nonce se snáze udržuje u dynamicky generovaných stránek, vyžaduje však zásah do šablon a cache. Hashe se hodí pro statický obsah, po každé změně skriptu se však musí přepočítat. Seznam povolených domén vypadá jako nejjednodušší začátek, MDN však upozorňuje, že takové politiky často nechtěně povolí nebezpečné domény (MDN: CSP).
HSTS je jednoduchá hlavička a chrání například před tím, aby útočník v síti přepsal přesměrování z HTTP na HTTPS (hstspreload.org). Web tím však na celou dobu max-age vážete na funkční HTTPS, takže problém s certifikátem se projeví tvrději.
Časté chyby
- Kopírování hodnot z návodu. Doporučená hodnota HSTS v OWASP obsahuje includeSubDomains i preload a OWASP vyzývá, abyste si před použitím pečlivě přečetli, jak hlavička funguje (OWASP). Direktivu preload přitom hstspreload.org považuje za žádost o zařazení do seznamu (hstspreload.org).
'unsafe-inline'jen kvůli zelenému skeneru. Politika sice existuje, ale velkou část ochrany ztrácí (MDN: CSP).- Report-Only bez cíle hlášení. Bez report-to, a pro prohlížeče bez její podpory i report-uri, hlášení nikam neodejdou (MDN: Report-Only).
- Nonce uložený v cache. Stejný nonce ve více odpovědích porušuje podmínku, že musí být pokaždé jiný a nepředvídatelný.
- Hlavičky na více místech. Server, CDN a plugin mohou hodnoty zdvojit nebo přepsat; v Nginx může blok location potichu zrušit bezpečnostní hlavičky (OWASP).
- Vypnutí HSTS odstraněním hlavičky. Pokud hlavička chybí, předchozí platí až do vypršení; zrušit ji lze hodnotou
max-age=0(MDN: HSTS).
Kontrolní seznam před ostrým nasazením
- Inventura externích služeb pokrývá všechny typy stránek a má vlastníka.
- Každá hlavička se nastavuje na jednom známém místě a výsledná odpověď je ověřená.
- nosniff, Referrer-Policy, Permissions-Policy a frame-ancestors jsou otestované ve formulářích, platbě, přihlášení a administraci.
- CSP běží v režimu Report-Only s report-to a Reporting-Endpoints a hlášení někdo pravidelně čte.
- Vynucená CSP nepoužívá pro skripty
'unsafe-inline'a nonce se vytváří pro každou odpověď. - Všechny subdomény včetně interních fungují přes HTTPS a obnova certifikátů je automatická a sledovaná.
- max-age v HSTS roste po etapách a preload je vědomé rozhodnutí, ne výchozí hodnota.
- Každý nový skript třetí strany projde schválením a testem v režimu Report-Only.
Časté dotazy
Jak dlouho nechat CSP v režimu Report-Only?
Univerzální lhůta neexistuje. Hlášení mají pokrýt všechny typy stránek a běžné situace a před vynucením by v nich neměla být nevysvětlená porušení. I po vynucení můžete další verzi politiky testovat souběžně v režimu Report-Only (MDN: CSP).
Potřebuji X-Frame-Options, když mám frame-ancestors?
Hlavní ochranou má být frame-ancestors. X-Frame-Options můžete ponechat jako doplněk; OWASP doporučuje hodnotu DENY a v příkladu uvádí i SAMEORIGIN (OWASP). Hodnoty by si neměly odporovat: k frame-ancestors 'self' patří SAMEORIGIN, ne DENY.
Jak HSTS vypnout, když se něco pokazí?
Nastavte max-age=0. Projeví se až tehdy, když prohlížeč načte web přes HTTPS a tuto hlavičku dostane (MDN: HSTS). U domény v seznamu preload trvá odstranění měsíce (hstspreload.org), proto začínejte krátkými etapami.
Znamená zelený výsledek skeneru, že je web bezpečný?
Ne. CSP je podle OWASP doplňková vrstva ochrany, která pomáhá odhalit a zmírnit některé typy útoků (OWASP). Hlavičky nenahrazují aktualizace, bezpečný kód, zálohy ani správu přístupů; jsou jednou vrstvou zabezpečení webu, ne celým zabezpečením.
Pomoc s nastavením hlaviček
Pokud chcete doplnit bezpečnostní hlavičky na firemní web nebo e-shop bez zbytečného rizika výpadku, udělám inventuru, nastavím režim Report-Only, vyhodnotím hlášení a připravím postupné zavedení HSTS. Podívejte se, jak pracuji při tvorbě webových stránek a e-shopech na míru, nebo mi napište přes kontakt.
Zdroje
Zdroje byly ověřeny 16. 11. 2026.