Sisällön suojauspolitiikka (CSP): Kuinka tarkistaa, korjata ja määrittää se omalla verkkosivustollasi
Opi, miten tarkistaa, lisätä ja korjata Content Security Policy -otsakkeita Apache-, Nginx-, WordPress- ja Joomla-sivustoilla käytännön diagnostiikkatyökalujen ja hosting-ohjeiden avulla.
Sisällön turvallisuuspolitiikka (CSP): Miten tarkistaa, korjata ja määrittää se verkkosivustollasi
HTTPS ja ohjelmistopäivitykset ovat olennaisia, mutta ne eivät estä kaikkia haitallisia komentosarjoja suorittamasta vierailijan selaimessa. Sisällön turvallisuuspolitiikka (CSP) lisää selainta varten pakotetut rajoitukset sivun lataamiin ja suoritettaviin resursseihin. Se auttaa lieventämään tiettyjä ristisivustokommentosarjakoskeita (XSS), mutta se ei korvaa kontekstiriippuvaista tulostuksen poistamista, syötteen validointia tai riippuvuuksien päivityksiä.
Tämä käytännöllinen opetusohjelma näyttää, miten tutkia nykyistä politiikkaasi, löytää sen lähde, ottaa muutokset turvallisesti käyttöön ja korjata ongelmia Apache-, Nginx-, WordPress- ja Joomla-asennuksissa.
1. Tarkista olemassa oleva CSP
Chrome tai Firefox: Avaa sivu, paina F12, valitse Verkko, lataa uudelleen, napsauta HTML-dokumenttia ja tutki Vastausotsakkeita. Etsi Content-Security-Policy (pakotettu) tai Content-Security-Policy-Report-Only (vain diagnostinen). Tarkista Console-luokan rikkomukset.
Komentorivi: Suorita curl -I https://example.com/. macOS-/Linux-järjestelmissä suodata vastaus curl -sSI https://example.com/ | grep -i content-security-policy:lla. HEAD-vastaukset voivat poiketa GET-vastauksista, joten vahvista selaimen DevTools-työkaluilla.
Verkkotyökalut: SecurityHeaders.com tarkistaa turvallisuusotsakkeet; Google CSP Evaluator huomauttaa heikkouksista politiikassa. Kumpikaan ei todista koko verkkosivuston turvallisuutta.
Ei CSP-otsaketta yhdellä vastauksella ei tarkoita, että jokainen sivu puuttuu CSP:ltä. Tarkista myös mahdolliset <meta http-equiv="Content-Security-Policy">-tunnisteet: meta-politiikoilla on rajoituksia, mukaan lukien ei tukea frame-ancestors:lle tai Report-Only-tilalle.
2. Etsi, missä politiikka on määritelty
| Ympäristö | Todennäköinen sijainti |
|---|---|
| Apache / yhteensopiva LiteSpeed | .htaccess, virtuaali-isäntä tai palvelimen kokoonpano |
| Nginx | server / location kokoonpano |
| PHP | Sovelluskoodi, joka käyttää header():ta |
| WordPress | Laajennus, mukautettu koodi, käänteinen proxy tai isäntä |
| Joomla | Järjestelmä – HTTP-otsakkeet -laajennus, palvelin tai proxy |
| Cloudflare | Vastausotsikon muuntosääntöt |
| Hallinnoitu isännöinti | Isännöintipaneeli tai tarjoajan hallinnoima kokoonpano |
Tutki olemassa olevia vastausotsakkeita ennen uuden lisäämistä. Selaimet pakottavat useita CSP-politiikkoja kumulatiivisesti; uusi Permissiivinen otsikko ei kumoa olemassa olevaa rajoittavaa. Tarkista myös CDN- ja isännöintisääntöjä.
3. Lisää CSP Apacheen .htaccess-tiedoston avulla
Käyttäen isäntäsi tiedostohallintaa tai SFTP:tä (FileZilla/WinSCP), löydä julkinen hakemisto, joka sisältää index.php, usein public_html tai httpdocs. Ota piilotetut tiedostot näkyviin nähdäksesi .htaccess. Lataa varmuuskopio ja välttä mukautettujen sääntöjen sijoittamista CMS-hallinnassa olevaan uudelleenkirjoituslohkoon.
Jos Apachen mod_headers on käytössä ja isäntä sallii nämä direktiivit, lisää:
<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>
Lataa uudelleen ja vahvista otsikko Verkko → Otsakkeet -kohdasta. Tarkista Console-luokan rikkomukset. Report-Only raportoi mahdollisia rajoituksia, mutta ei estä resursseja. Tämä esimerkki on diagnostinen, ei täydellinen käyttöönottopolitiikka.
Jos luotettu CDN-komentosarja raportoidaan, varmista ensin sen tarkoitus ja omistajuus. Voit muokata direktiivia script-src 'self' https://cdn.example.com-muotoon; älä lisää estettyjä isäntiä sokeasti. Isäntaluettelot ovat vähemmän vahvoja XSS:ää vastaan kuin hyvin suunnitellut nonce-/hash-poliitiikat.
Kun olet testannut kirjautumisen, lomakkeet, kassan, editorit ja muut työnkulut, voit korvata Content-Security-Policy-Report-Only:lla Content-Security-Policy testatun politiikkasi pakottamiseksi. Jos sivu rikkoutuu, palauta varmuuskopioitu tiedosto, tyhjennä palvelin-/CDN-välimuistit ja testaa uudelleen. HTTP 500 muokkauksen jälkeen viittaa syntaksi- tai palvelinoikeusongelmaan.

4. Määritä CSP Nginxissä
Nginx ohittaa .htaccess. Jos hallinnat palvelinta, tutki sen aktiivista kokoonpanoa (usein /etc/nginx/sites-available/ tai /etc/nginx/conf.d/). Asiantuntijassa server-lohkossa käytä:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
Testaa sudo nginx -t:lla, lataa uudelleen sudo systemctl reload nginx:lla. Huomioi add_header-perintö ja sääntöjä tarkemmissa sijainneissa. Hallinnoidussa isännöinnissä ilman Nginx-kokoonpano-oikeuksia käytä tarjoajan hallintapaneelia tai tukea.
5. WordPress: laajennus tai pieni mukautettu integrointi
Koodittomasti: Tarkista ensin, lähettääkö isäntäsi tai olemassa oleva turvallisuusotsikkolaajennus jo CSP:tä. Valitse ylläpidetty laajennus, joka tukee selkeästi CSP:tä ja mielellään Report-Only-tilaa; älä olettele, että yleinen turvallisuuslaajennus tukee kumpaakaan. Sen asetuksissa ota Report-Only käyttöön, aloita konservatiivisella diagnostisella politiikalla, tallenna ja testaa sekä julkiset sivut että wp-admin ennen pakottamista.
Kehittäjän reitti: Luo 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'"
);
});
Aktivoi se Laajennukset → Asennetut laajennukset -kohdasta, vahvista sitten vastausotsikko. Tämä ei korvaa olemassa olevaa CSP:tä ververkkopalvelimelta, CDN:ltä tai toiselta laajennukselta. Se sulkee tarkoituksella wp-admin pois ja ei tarjoa täydellistä pakotettua politiikkaa.
Vianmääritys: Jos CAPTCHA epäonnistuu, tutki estettyjä script-src-, frame-src- ja connect-src-pyyntöjä ja katso CAPTCHA-toimittajan integrointiopasta. Jos sivurakentaja raportoi estettyjä sisäkkäisiä komentosarjoja, tarkista CSP nonce-/hash-tuen olemassaolo. Älä lisää automaattisesti 'unsafe-inline':ta. Nonce-perusteisessa per-vastaus-mallissa varmista, että täyssivun välimuisti ei uudelleenkäytä samaa noncea ja HTML:ää eri vierailijoille.
6. Joomla: käytä natiivia HTTP-otsikkolaajennusta
Joomla-hallinnassa avaa Järjestelmä → Laajennukset, etsi HTTP-otsakkeet ja avaa Järjestelmä – HTTP-otsakkeet. Tarkka valikkoteksti vaihtelee Joomla-version ja kielen mukaan.
Ota sen CSP-vaihtoehdot käyttöön ja aloita Report-Only-tilassa julkisella sivustolla. Aloita diagnosoimalla direktiivia kuten script-src 'self'; tallenna ja tutki Console-luokkaa. Testaa mallit, sivurakentajat, editorit, yhteydenottolomakkeet, CAPTCHAt, maksuintegraatiot ja median ominaisuudet.
Jos näet Refused to execute inline script, tunnista, mikä malli tai laajennus luo sen. Suosi yhteensopivaa nonce- tai hash-lähestymistapaa, jos tuettu; validoi, että komentosarja on laillinen, ennen kuin lupaat sen. Testaa ylläpito erikseen frontendistä. Jos palvelin asettaa jo CSP:tä, sovita kokoonpanot toisiinsa snailtakiin kuin pinota ristiriitaisia politiikkoja.
Katso Joomla HTTP-otsikkodokumentaatio asennetun version tukemista vaihtoehdoista.
7. Korjaa varsinainen rikkomus, ei koko politiikka
| Rikkomus | Mitä tutkia | Tyypillinen korjaus |
|---|---|---|
script-src |
Ulkoinen tai sisäkkäinen JavaScript | Vahvista lähde; käytä sopivaa noncea/hashia tai kapeasti kohdistettua lähdettä |
style-src |
Tyyliarkki tai sisäkkäinen CSS | Tutki generoidut tyylit; käytä hyväksyttyä lähdettä tai yhteensopivaa hashia/noncea |
img-src |
Ulkoinen kuva tai data-URL | Salli vain varmistettu kuvapalvelin, jos vaaditaan |
connect-src |
fetch/XHR/WebSocket | Vahvista API-lähde ja lisää kapeasti kohdistettu lupa |
frame-src |
Upotettu video/CAPTCHA/maksukehys | Noudata toimittajan dokumentoimia domainnejä |
form-action |
Lomakkeen lähetys kohde | Salli laillinen lähetyslähde |
frame-ancestors |
Toinen sivusto upottaa sivusi | Salli tarkoitettuja vanhempia lähteitä eksplisiittisesti, tai käytä 'none':ta |
Esimerkiksi, jos laillinen kuva osoitteessa https://images.example.com/photo.webp estetään img-src 'self':lla, muuta asiantuntija direktiivia img-src 'self' https://images.example.com-muotoon vahvistamisen jälkeen, että isäntä on luotettava. Älä heikennä default-src:ta pelkästään yhdelle kuvan korjaamiseksi.

Joissakin direktiiveissä, mukaan lukien frame-ancestors ja form-action, ei ole takaisinpaluuta default-src:een. Sisällytä ne eksplisiittisesti, kun tarvitaan.
8. Vaikuttaako isännöinti CSP-kokoonpanoon?
Kyllä – CSP-selaimen standardi pysyy samana, mutta vastausotsikkoihin hallinta muuttuu. Apache-jakautuvassa isännöinnissä voi olla .htaccess; hallinnoidussa Nginxissa voi vaatia tarjoajan paneelia; VPS-hallinnoijat voivat muokata palvelimen kokoonpanoa; ja CDN:t voivat lisätä otsakkeita sovelluksen luoman vastauksen jälkeen.
Ennen isännöintipalvelun valintaa, kysy: Voiko minun asettaa ja poistaa CSP-otsakkeita ilman root-oikeuksia? Voinko käyttää Report-Only-tilaa? Voinko tutkia lopullista vastausta? Ovatko mukautetut otsakkeet käytettävissä suunnitelmassani? Voiko tuki selittää CDN- tai sovellussääntöjen konflikteista?
Cloudways: isännöintitason HTTP-otsikkohallinta
Cloudways dokumentoi Web-sääntöt → Otsikkosääntöt HTTP-vastausotsikkojen hallintaan, mukaan lukien CSP. Tämä tarjoaa isännöintitason vaihtoehdon sovellustiedostojen muokkaamisen sijaan, riippuen sovelluksellesi ja suunnitelmillesi käytettävissä olevista ominaisuuksista. Se ei automaattisesti luo turvallista CSP:tä; sinun on silti testattava ja ylläpidettävä direktiivejäsi.
9. Vahvempi suoja nonce-pohjaisella CSP:llä
Tiukka CSP käyttää arvaamattomia nonceja tai hasheja sen sijaan, että se luottaisi vain domainien sallitusluetteloihin. Yksinkertaistettu PHP-esimerkki:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
HTML-mallissa:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
Luo tuore arvaamaton nonce jokaiselle vastaukselle. Pidä otsikko ja HTML-nonce yhdenmukaisina, ja suunnittele käänteisten proxyjen ja täyssivun välimuistien kanssa. 'strict-dynamic':lla luotettu komentosarja voi ladata muita komentosarjoja, joten valvota luotettuja lataajia huolellisesti. Tämä on esimerkki, ei valmis täydellinen politiikka kaikille sovelluksille.
10. Lopullinen käyttöönoton tarkistuslista
- Tunnista kaikki olemassa olevat CSP-otsakkeet ja meta-politiikat.
- Varmuuskopioi palvelin- ja CMS-kokoonpano.
- Luettele komentosarjat, tyylit, kehys, API:t, kuvat ja ulkoiset palvelut.
- Ota käyttöön Report-Only-politiikka ensin.
- Tutki jokainen rikkomus ja lupaa vain luotettavaa, välttämätöntä käyttäytymistä.
- Testaa frontend, ylläpito, kirjautuminen, kassa, lomakkeet ja integraatiot.
- Tarkista välimuisti, nonseit, CDN-käyttäytyminen ja kaksoisotsakkeet.
- Ota pakottaminen käyttöön vaiheittain ja valvo ohjelmistopäivitysten jälkeen.
Johtopäätös
Hyödyllinen CSP ei ole vain tarkistuslistalta kopioitu otsikko. Tutki nykyinen kokoonpanosi, löydä sen määrittelypaikka, testaa Report-Only-tilassa, korjaa täsmälliset yhteensopivuusongelmat, ja pakota vasta sitten politiikka, joka sopii verkkosivustollesi. WordPress- ja Joomla-hallinnoijat voivat aloittaa CMS-työkaluilla; kehittäjät voivat käyttää Apachea, Nginxiä tai PHP:tä; ja isännöintialustat voivat tarjota suoran otsikkohallinnan.
CSP vähentää hyödyntämismahdollisuuksia, mutta se on edelleen yksi kerros secure codingin, päivitysten, autentikoinnin ja monitoroinnin ohella.