Nett og utvikling

Innholds-sikkerhetspolicy (CSP): Slik sjekker, retter og konfigurerer du den på nettstedet ditt

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

Lær hvordan du kan sjekke, legge til og rette Content Security Policy-hoder på Apache, Nginx, WordPress og Joomla, med praktiske diagnostiske verktøy og hostingveiledning.

Innholds sikkerhetspolicy (CSP): Slik sjekker, retter og konfigurerer du den på nettstedet ditt

HTTPS og programoppdateringer er viktige, men de hindrer ikke hver ondsaksfulle skript fra å kjøre i en besøkendes nettleser. Innholds sikkerhetspolicy (CSP) legger til nettleserens enforbudte restriksjoner på ressursene en side kan laste og kjøre. Det hjelper med å dempe visse kryssstedsskriptangrep (XSS), men erstatter ikke kontekstbasert utdataescaping, inntogsgodkjenning eller avhengighetsoppdateringer.

Denne praktiske veiledningen viser hvordan du sjekker den gjeldende politikkken, finner dens kilde, introduserer endringer trygt og fikser problemer på Apache, Nginx, WordPress og Joomla.

1. Sjekk den eksisterende CSP-en

Chrome eller Firefox: Åpne siden, trykk F12, velg Network, last inn på nytt, klikk på HTML-dokumentet og inspiser Response Headers. Se etter Content-Security-Policy (pålagt) eller Content-Security-Policy-Report-Only (bare diagnostikk). Sjekk Console for overtritser.

Kommandolinje: Kjør curl -I https://example.com/. På macOS/Linux, filtrer svaret med curl -sSI https://example.com/ | grep -i content-security-policy. HEAD-svar kan avvike fra GET-svar, så bruk nettleserens DevTools for å bekrefte.

Onlineverktøy: SecurityHeaders.com sjekker sikkerhetshader; Google CSP Evaluator merker svakheter i en politikk. Ingen av dem verifiserer at hele nettstedet er sikret.

Ingen CSP-header på ett svar etter ikke etter at alle sider mangler CSP. Se også på eventuelle <meta http-equiv="Content-Security-Policy">-tagger: metapolikker har begrensninger, inkludert at støtte for frame-ancestors eller Report-Only mangler.

2. Finn hvor politikkken er definert

Miljø Sannsynlig plass
Apache / kompatibel LiteSpeed .htaccess, virtuell vert eller serverkonfigurasjon
Nginx server / location-konfigurasjon
PHP Applikasjonskode som bruker header()
WordPress Plugin, egendringkode, omvendt proxy eller vert
Joomla System – HTTP Headers-plugin, server eller proxy
Cloudflare Response Header Transform Rules
Managed hosting Hostingpanel eller leverandørstyrt konfigurasjon

Sjekk eksisterende svarshader før du legger til en mer. Nettlesere håndhever flere CSP-polikker cumulative; en ny tilligende header kansellerer ikke en eksisterende restriktiv en. Sjekk også CDN- og hostingregler.

3. Legg til CSP i Apache ved hjelp av .htaccess

Bruk filstyringsverktøy eller SFTP (FileZilla/WinSCP) fra verten din, finn den offentlige katalogen som inneholder index.php, ofte public_html eller httpdocs. Aktiver skjulte filer for å se .htaccess. Last ned en sikkerhetskopi, og unngå å sette inn egne regler i en CMS-håndtert omwriterblokk.

Hvis Apache sin mod_headers er aktivert og verten tillater disse retningslinjene, legg til:

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

Last inn på nytt og verifiser headeren under Network → Headers. Sjekk Console for overtritser. Report-Only rapporterer mulige restriksjoner, men blokkerer ikke ressursene. Dette eksempelet er diagnostikk, ikke en fullstendig implementeringspolitikk.

Hvis et tillitsskript fra et CDN er rapportert, bekreft først dets formål og eiendom. Du kan tilpasse retningslinjen til script-src 'self' https://cdn.example.com; ikke legg til hvert blokkert host. Host-tillatelser er mindre robuste mot XSS enn veldesignte nonce-/hashpolitikkker.

Etter testing av innlogging, skjemaer, kasse, redigeringsverktøy og andre arbeidsflyter kan du erstatte Content-Security-Policy-Report-Only med Content-Security-Policy for å håndheve den testede politikkken. Hvis nettstedet går i stykk, gjenopprett den sikkerhetskopierte filen, tøm server-/CDN-buffer og test på nytt. En HTTP 500 etter redigering tyder på syntaktk or server-permissionsproblem.

Illustration of the article's main concept

4. Konfigurer CSP på Nginx

Nginx ignorerer .htaccess. Hvis du administrerer serveren, inspiser dens aktive konfigurasjon (ofte /etc/nginx/sites-available/ eller /etc/nginx/conf.d/). I den relevante server-blokken, bruk:

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

Test med sudo nginx -t, og last inn på nytt med sudo systemctl reload nginx. Pass på arv og regler i mer spesifikke steder for add_header. På managed hosting uten tilgang til Nginx-konfigurasjon, bruk utstillingsverktøyets kontrollpanel eller støtte.

5. WordPress: plugin eller liten egendring

Rute uten kode: Sjekk først om verten din eller et eksisterende sikkerhetsh-plugin allerede sender CSP. Velg et vedlikeholdt plugin som eksplisitt støtter CSP og helst Report-Only; ikke antall at et generelt sikkerhetplugin støtter begge. I innstillingene, aktiver Report-Only, start med en konservativ diagnostisk politikk, lagre og test både offentlige sider og wp-admin før håndheving.

Rute for utvikler: Opprett 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'"
    );
});

Aktiver det i Plugins → Installed Plugins, og bekreft deretter svarshaderen. Dette overstyrer ikke en eksisterende CSP fra webserver, CDN eller et annet plugin. Det ekskluderer bevisst wp-admin og gir ikke en fullstendig håndhevet politikk.

Feilsøking: Hvis CAPTCHA mislykkes, inspiser blokkert script-src, frame-src og connect-src-spørsmål og konsulter CAPTCHA-leverandørens integrasjonshjelp. Hvis en sidesbygger rapporterer blokkert inline-skript, sjekk støtte for CSP-nonce eller hash. Ikke legg automatisk til 'unsafe-inline'. For per-response nonce, sørg for at full-sidebuffer ikke gjenbruker samme nonce og HTML for alle besøkende.

6. Joomla: bruk det native HTTP Headers-plugin

I Joomla-administrasjon, åpne System → Plugins, søk etter HTTP Headers, og åpne System – HTTP Headers. Praktisk menyord vil variere med Joomla-versjon og språk.

Aktiver dens CSP-alternativer og start med Report-Only på offentlig nettsted. Start med å diagnostisere en retningslinje som script-src 'self'; lagre og inspiser Console. Test maler, sidesbygger, redigeringsverktøy, kontaktformer, CAPTCHAs, betalingsintegrasjoner og mediefunksjoner.

Hvis du ser Refused to execute inline script, identifiser hvilken mal eller utvidelse som genererer den. Foretrek en kompatibel nonce- eller hashmetode der den støttes; valider at skriptet er legitimer før du godkjenner det. Test administrasjonen separat fra frontend. Hvis serveren allerede setter CSP, avstem konfigurasjonene i stedet for å stable sammen motstridende politikkker.

Consult the Joomla HTTP Headers documentation for the options supported by your installed version.

7. Fiks den faktiske overtritten, ikke hele politikkken

Overtritt Hva du bør undersøke Vanlig fiks
script-src Ekstern eller inline JavaScript Verifiser kilde; bruk passende nonce/hash eller svært begrenset kilde
style-src Stilmal eller inline CSS Inspiser genererte stiler; bruk godkjent kilde eller kompatibel hash/nonce
img-src Ekstern bilde eller data-URL Tillat verifisert bildehost bare om nødvendig
connect-src fetch/XHR/WebSocket Verifiser API-orig og legg til svært begrenset tillatelse
frame-src Innbygd video/CAPTCHA/betalingsramme Følg leverandørens dokumenterte domener
form-action Formsendingsmål Tillat legitim innsendelsesorig
frame-ancestors Annen nettside som innebygger siden din Godta eksplisitt intended foreldreorig, eller bruk 'none'

For eksempel, hvis et legitimt bilde på https://images.example.com/photo.webp er blokkert av img-src 'self', endre den relevante retningslinjen til img-src 'self' https://images.example.com etter å ha bekreftet at hosten er tillit. Ikke svekk default-src bare for å fikse ett bilde.

Technical workflow illustration

Noen retningslinjer, inkludert frame-ancestors og form-action, faller ikke tilbake på default-src. Inkluder dem eksplisitt når de trengs.

8. Påvirker hosting CSP-konfigurasjon?

Ja—standarden for CSP i nettleseren er den samme, men kontrollen din over svarshader endres. Apache delingst hosting kan eksponere .htaccess; managed Nginx kan kreve utstillingspanel; VPS-administratører kan endre serverkonfigurasjon; og CDNs kan legge til handler etter at applikasjonen genererer svaret.

Før du velger en hostingtjeneste, spør: Kan jeg sette og fjerne CSP-handler uten rottilgang? Kan jeg bruke Report-Only? Kan jeg inspisere det endelige svaret? Er egendringshandler tilgjengelige på min plan? Kan støtte forklare konflikter med CDN eller appregler?

Cloudways: hostingnivåkontroller for HTTP-handler

Cloudways dokumenterer Web Rules → Header Rules for å administrere HTTP-svarshader, inkludert CSP. Dette tilbyr et hostingnivåalternativ til å redigere applikasjonsfiler, underforutsatt funksjoner tilgjengelige for appen og planen. Det gjør ikke ikke automatisk en sikker CSP; du må fortsatt teste og vedlikeholde retningslinjene dine.

Se tilbud fra Cloudways

9. Strengere beskyttelse med nonce-basert CSP

En streng CSP bruker uprediktible nonce-er eller hasher i stedet for å kun stole på domänntilatelser. Et forenklet PHP-eksempel:

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

I HTML-malen:

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

Generer en ny uprediktabel nonce for hvert svar. Hold headeren og HTML-nonce konsistent, og plan for omvendte proxier og full-sidebuffer. Med 'strict-dynamic' kan et tillitsskript laste opp ytterligere skript, så gjennomgå tillitsfulle lastere nøye. Dette er et illustrasjons eksempel, ikke en innbyttbar fullstendig politikk for alle applikasjoner.

10. Sluttlig implementeringssjekkliste

  1. Identifiser alle eksisterende CSP-handler og metapolikker.
  2. Ta sikkerhetskopi av server- og CMS-konfigurasjon.
  3. Lag inventar over skript, stiler, rammer, API-er, bilder og eksterne tjenester.
  4. Implementer først en Report-Only-politikk.
  5. Utforsk hver overtritt og godkjenn bare tillitssikre, nødvendige atferder.
  6. Test frontend, administrasjon, innlogging, kasse, former og integrasjoner.
  7. Sjekk buffer, nonce-er, CDN-atferd og dupliserte handler.
  8. Aktiver håndheving gradvis og overvåk etter programoppdateringer.

Konklusjon

En nyttig CSP er ikke bare en header kopiert fra en sjekkliste. Inspiser den gjeldende konfigurasjonen, finn hvor den er definert, test i Report-Only-modus, fikser de nøyaktige kompatibilitetsproblemene og påførst deretter en politikk som passer nettstedet ditt. WordPress- og Joomla-administratører kan starte med CMS-verktøy; utviklere kan bruke Apache, Nginx eller PHP; og hostingplattformer kan tilby direkte håndheving av handler.

CSP reduserer angrepsmuligheter, men er fortsatt én lag sammen med sikker kodning, oppdateringer, autentisering og overvåkning.