Web a vývoj

Politika zabezpečení obsahu (CSP): Jak zkontrolovat, opravit a nastavit na vašich stránkách

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

Naučte se, jak zkontrolovat, přidat a opravit hlavičky Politiky zabezpečení obsahu na Apache, Nginx, WordPress a Joomla, s praktickými diagnostickými nástroji a průvodcem pro hosting.

Zásady bezpečnosti obsahu (Content Security Policy, CSP): Jak ji zkontrolovat, opravit a nakonfigurovat na vašem webu

HTTPS a aktualizace softwaru jsou nezbytné, ale nezabrání spuštění každého škodlivého skriptu v prohlížeči návštěvníka. Zásady bezpečnosti obsahu (Content Security Policy, CSP) přidávají prohlížečem vynucená omezení pro zdroje, které stránka může načítat a spouštět. Pomáhají zmírnit určité útoky skriptování mezi weby (XSS), ale nenahrazují kontextové échappování výstupu, ověřování vstupu ani aktualizace závislostí.

Tento praktický návod ukazuje, jak zkontrolovat vaše aktuální zásady, najít jejich zdroj, bezpečně zavádět změny a opravovat problémy na Apache, Nginx, WordPressu a Joomle.

1. Zkontrolujte své stávající zásady CSP

Chrome nebo Firefox: Otevřete stránku, stiskněte F12, vyberte Network (Síť), obnovte stránku, klikněte na dokument HTML a zkontrolujte Response Headers (Odpovědové hlavičky). Hledejte Content-Security-Policy (vynuceno) nebo Content-Security-Policy-Report-Only (pouze diagnostické). Zkontrolujte Konzolu (Console) pro porušení.

Příkazový řádek: Spusťte curl -I https://example.com/. Na macOS/Linuxu odpověď vyfiltrujte pomocí curl -sSI https://example.com/ | grep -i content-security-policy. Odpovědi HEAD se mohou lišit od odpovědí GET, takže k potvrzení použijte vývojářské nástroje prohlížeče (DevTools).

Online nástroje: SecurityHeaders.com kontroluje bezpečnostní hlavičky; Google CSP Evaluator upozorňuje na slabiny v zásadách. Žádný z nich nedokazuje, že je celý web bezpečný.

Absence jedné hlavičky CSP v jedné odpovědi neznamená, že každá stránka CSP postrádá. Také zkontrolujte libovolnou značku <meta http-equiv="Content-Security-Policy">: zásady v meta mají určitá omezení, včetně absence podpory frame-ancestors nebo Report-Only.

2. Najděte, kde jsou zásady definovány

Prostředí Pravděpodobné umístění
Apache / kompatibilní LiteSpeed .htaccess, konfigurace virtuálního hostitele nebo serveru
Nginx konfigurace server / location
PHP kód aplikace používající header()
WordPress plugin, vlastní kód, reverzní proxy nebo hostitel
Joomla plugin System – HTTP Headers, server nebo proxy
Cloudflare Response Header Transform Rules
Spravovaný hosting (Managed hosting) hostingový panel nebo konfigurace spravovaná poskytovatelem

Před přidáním dalšího zkontrolujte stávající odpovědové hlavičky. Prohlížeče vynucují více zásad kumulativně; nová permissivní hlavička nezruší existující restriktivní hlavičku. Zkontrolujte také pravidla CDN a hostingu.

3. Přidejte CSP v Apache pomocí souboru .htaccess

Pomocí správce souborů vašeho hostitele nebo SFTP (FileZilla/WinSCP) najděte veřejný adresář obsahující index.php, často public_html nebo httpdocs. Povolte skryté soubory, abyste viděli .htaccess. Stáhněte si zálohu a vyhněte se vkládání vlastních pravidel do bloku přepisování spravovaného CMS.

Pokud je mod_headers Apache povoleno a hostitel tyto direktivy povoluje, přidejte:

<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>

Obnovte a ověřte hlavičku v sekci Network → Headers (Síť → Hlavičky). Zkontrolujte Konzolu (Console) pro porušení. Report-Only hlásí možná omezení, ale prostředky neblokuje. Tento příklad je diagnostický, nikoli úplná nasazovací politika.

Pokud je nahlášen důvěryhodný skript CDN, nejprve ověřte jeho účel a vlastnictví. Direktivu můžete upravit na script-src 'self' https://cdn.example.com; nechte přidávat všechny blokované hostitele slepě. Seznamy povolených hostitelů (allowlists) jsou proti XSS méně robustní než dobře navržené zásady nonce/hash.

Po otestování přihlášení, formulářů, pokladny, editorů a dalších pracovních postupů můžete Content-Security-Policy-Report-Only nahradit Content-Security-Policy pro vynucení vaší otestované politiky. Pokud web přestane fungovat, obnovte zálohový soubor, vymažte mezipaměti serveru/CDN a znovu otestujte. HTTP 500 po úpravě naznačuje problém se syntaksií nebo oprávněními serveru.

Illustration of the article's main concept

4. Nakonfigurujte CSP na Nginxu

Nginx ignoruje .htaccess. Pokud spravujete server, zkontrolujte jeho aktivní konfiguraci (často /etc/nginx/sites-available/ nebo /etc/nginx/conf.d/). V relevantním bloku server použijte:

add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;

Otestujte pomocí sudo nginx -t, poté znovu načtěte pomocí sudo systemctl reload nginx. Dbejte na dědičnost add_header a pravidla v konkrétnějších umístěních. Ve spravovaném hostingu bez přístupu ke konfiguraci Nginxu použijte ovládací panel nebo podporu poskytovatele.

5. WordPress: plugin nebo malá vlastní integrace

Bezkódová cesta: Nejprve zkontrolujte, zda váš hostitel nebo existující plugin bezpečnostních hlaviček již CSP odesílá. Vyberte udržovaný plugin, který explicitně podporuje CSP a preferuje Report-Only; nePředpokládejte, že obecný bezpečnostní plugin podporuje cokoli z toho. V jeho nastavení povolte Report-Only, začněte s konzervativní diagnostickou politikou, uložte a otestujte veřejné stránky i wp-admin před vynucením.

Vývojářská cesta: Vytvořte 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'"
    );
});

Aktivujte ho v Plugins → Installed Plugins (Pluginy → Nainstalované pluginy), poté potvrďte odpovědovou hlavičku. Tím nepřepíšete existující CSP z webového serveru, CDN nebo jiného pluginu. Úmyslně vylučuje wp-admin a neposkytuje úplnou vynucenou politiku.

Řešení problémů: Pokud CAPTCHA selže, zkontrolujte blokované požadavky script-src, frame-src a connect-src a prostudujte integrační pokyny poskytovatele CAPTCHA. Pokud tvůrce stránek (page builder) hlásí blokované vložené skripty, zkontrolujte podporu CSP nonces nebo hashů. Nechte automaticky přidávat 'unsafe-inline'. Pro nonces na odpověď se ujistěte, že mezipaměť celé stránky neznovu používá stejný nonce a HTML napříč návštěvníky.

6. Joomla: použijte nativní plugin HTTP Headers

V administraci Joomly otevřete System → Plugins (Systém → Pluginy), vyhledejte HTTP Headers a otevřete System – HTTP Headers. Přesné textové znění nabídky se liší podle verze a jazyka Joomly.

Povolte jeho možnosti CSP a začněte s Report-Only na veřejném webu. Začněte diagnostikou direktivy, jako je script-src 'self'; uložte a prozkoumejte Konzolu (Console). Otestujte šablony, tvůrce stránek, editory, kontaktní formuláře, CAPTCHA, integraci plateb a mediální funkce.

Pokud uvidíte Refused to execute inline script, identifikujte, která šablona nebo rozšíření ji generuje. Kde je to podporováno, raději použijte kompatibilní přístup pomocí nonces nebo hashů; před autorizací ověřte, že skript je legitimní. Administraci testujte samostatně od frontendu. Pokud server již CSP nastavuje, konfigurace slaďte, nikoli vrstvěte konfliktní politiky.

Pro možnosti podporované vaší nainstalovanou verzí se obraťte na dokumentaci Joomla HTTP Headers.

7. Opravte skutečné porušení, nikoli celou politiku

Porušení Co šetřit Typická oprava
script-src Externí nebo vložený JavaScript Ověřte zdroj; použijte vhodný nonce/hash nebo úzce vymezený zdroj
style-src Stylesheet nebo vložené CSS Prozkoumejte vygenerované styly; použijte schválený zdroj nebo kompatibilní hash/nonce
img-src Externí obrázek nebo datová adresa URL Povolte ověřeného hostitele obrázků pouze v případě nutnosti
connect-src fetch/XHR/WebSocket Ověřte původ API a přidejte úzce vymezené oprávnění
frame-src Vložené video/CAPTCHA/platební rámec řiďte se dokumentovanými doménami poskytovatele
form-action Cílové místo odeslání formuláře Povolte legitimní původ odeslání
frame-ancestors Jiný web vkládající vaši stránku Explicitně povolte zamýšlené původy nadřazeného prvku, nebo použijte 'none'

Například, pokud je legitimní obrázek na https://images.example.com/photo.webp blokován img-src 'self', změňte relevantní direktivu na img-src 'self' https://images.example.com po potvrzení, že je hostitel důvěryhodný. Neoslabujte default-src pouze za účelem opravy jednoho obrázku.

Technical workflow illustration

Některé direktivy, včetně frame-ancestors a form-action, nespadají zpět na default-src. V případě potřeby je zahrňte explicitně.

8. Ovlivňuje konfiguraci CSP hostování?

Ano – standard prohlížeče pro CSP zůstává stejný, ale vaše kontrola nad odpovědovými hlavičkami se mění. Sdílené hostování Apache může zpřístupnit .htaccess; spravovaný Nginx může vyžadovat ovládací panel poskytovatele; správci VPS mohou upravit konfiguraci serveru; a CDN mohou přidat hlavičky po vygenerování odpovědi aplikací.

Před výběrem hostovací služby se zeptejte: Mohu bez rootového přístupu nastavovat a odstraňovat hlavičky CSP? Mohu použít Report-Only? Mohu zkontrolovat finální odpověď? Jsou vlastní hlavičky k dispozici v mém tarifu? Může podpora vysvětlit konflikty s pravidly CDN nebo aplikace?

Cloudways: ovládání hlaviček HTTP na úrovni hostování

Cloudways dokumentuje Web Rules → Header Rules pro správu hlaviček odpovědí HTTP, včetně CSP. To nabízí alternativu na úrovni hostování k úpravě souborů aplikací, v závislosti na funkcích dostupných pro vaši aplikaci a tarif. Není to automatické vytvoření bezpečného CSP; stále musíte své direktivy testovat a udržovat.

Zobrazit nabídky Cloudways

9. Silnější ochrana s nonce-based CSP

Strengá CSP používá nepředvídatelné nonces nebo hashy místo spoléhání pouze na seznamy povolených domén. Zjednodušený příklad v PHP:

<?php
$nonce = base64_encode(random_bytes(16));
header(
    "Content-Security-Policy: "
    . "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
    . "object-src 'none'; "
    . "base-uri 'none'"
);

V HTML šabloně:

<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
    console.log('Trusted script');
</script>

Pro každou odpověď vygenerujte nový nepředvídatelný nonce. Udržujte hlavičku a HTML nonce konzistentní a počítejte s reverzními proxy a mezipaměťmi celé stránky. S 'strict-dynamic' může důvěryhodný skript načíst další skripty, takže důvěryhodné načítací nástroje pečlivě auditujte. Toto je ilustrace, nikoli připravená úplná politika pro všechny aplikace.

10. Konečný kontrolní seznam nasazení

  1. Identifikujte všechny existující hlavičky CSP a meta zásady.
  2. Zálohujte konfiguraci serveru a CMS.
  3. Proveďte inventuru skriptů, stylů, rámců, API, obrázků a externích služeb.
  4. Nejprve nasaďte politiku Report-Only.
  5. Šetřete každé porušení a autorizujte pouze důvěryhodné a nezbytné chování.
  6. Otestujte frontend, administraci, přihlášení, pokladnu, formuláře a integrace.
  7. Zkontrolujte mezipaměť, nonces, chování CDN a duplicitní hlavičky.
  8. Vynucení povolujte postupně a monitorujte po aktualizacích softwaru.

Závěr

Užitečné CSP není simplemente hlavičkou zkopírovanou z kontrolního seznamu. Zkontrolujte svou aktuální konfiguraci, najděte, kde je definována, otestujte v režimu Report-Only, opravte přesné problémy kompatibility a teprve poté vynuťte politiku vhodnou pro váš web. Správci WordPressu a Joomly mohou začít s nástroji CMS; vývojáři mohou použít Apache, Nginx nebo PHP; platformy hostování mohou nabízet přímé ovládání hlaviček.

CSP snižuje příležitosti k útokům, ale zůstává jednou vrstvou vedle bezpečného kódování, aktualizací, ověřování identity a monitorování.