Web & Udvikling

Content Security Policy (CSP): Sådan tjekker, retter og konfigurerer du det på dit website

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

Lær, hvordan du tjekker, tilføjer og retter Content Security Policy-headere på Apache, Nginx, WordPress og Joomla, med praktiske diagnostiske værktøjer og hosting-vejledning.

Content Security Policy (CSP): Sådan kontrollerer, rettes og konfigurerer du den på din hjemmeside

HTTPS og softwareopdateringer er vigtige, men de forhindrer ikke alle ondsindede scripts i at køre i en besøgers browser. Content Security Policy (CSP) tilføjer browserbaserede begrænsninger på de ressourcer, som en side kan indlæse og udføre. Det hjælper med at reducere visse typer cross-site scripting (XSS)-angreb, men kan ikke erstatte kontekstuel output-escaping, inputvalidering eller opdatering af afhængigheder.

Denne praktiske vejledning viser, hvordan du kontrollerer din nuværende politik, finder dens oprindelse, foretager ændringer sikkert og løser problemer på Apache, Nginx, WordPress og Joomla.

1. Tjek din eksisterende CSP

Chrome eller Firefox: Åbn siden, tryk F12, vælg Netværk, genindlæs, klik på HTML-dokumentet og kontroller Svar-hoveder. Kig efter Content-Security-Policy (enforceret) eller Content-Security-Policy-Report-Only (kun diagnostisk). Tjek Console for fejl.

Kommandolinje: Kør curl -I https://example.com/. På macOS/Linux filtreres svaret med curl -sSI https://example.com/ | grep -i content-security-policy. HEAD-svar kan afvige fra GET-svar, så brug browserens DevTools til at bekræfte.

Onlineværktøjer: SecurityHeaders.com tjekker sikkerhedshedere; Google CSP Evaluator markører svagheder i en politik. Ingen af dem beviser, at hele websiden er sikker.

Hvis der ikke er nogen CSP-header i et svar, betyder det ikke, at alle sider mangler CSP. Tjek også eventuelle <meta http-equiv="Content-Security-Policy">-tags: Metapolitikker har begrænsninger, herunder ingen støtte til frame-ancestors eller Report-Only.

2. Find ud af, hvor politikken er defineret

Miljø Sandsynlig placering
Apache / kompatibel LiteSpeed .htaccess, virtuelt værts- eller serverkonfiguration
Nginx server / location konfiguration
PHP Applikationskode, der bruger header()
WordPress Plugin, tilpasset kode, reverse proxy eller vært
Joomla System – HTTP Headers plugin, server eller proxy
Cloudflare Response Header Transform Rules
Administreret hosting Hostingpanel eller providerstyret konfiguration

Kontroller eksisterende svarhoveder før du tilføjer en ny. Browserne håndhæver flere CSP-politikker kumulativt; en ny tilladelig header annullerer ikke en eksisterende restriktiv header. Tjek også CDN- og hostingregler.

3. Tilføj CSP i Apache ved hjælp af .htaccess

Brug din hosts filmanager eller SFTP (FileZilla/WinSCP) til at finde den offentlige mappe, der indeholder index.php, ofte public_html eller httpdocs. Aktiver skjulte filer for at se .htaccess. Download en backup, og undgå at placere tilpassede regler inde i et CMS-håndteret rewrite-blok.

Hvis Apache's mod_headers er aktiveret, og værten tillader disse direktiver, skal du tilføje:

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

Genindlæs og verificer headern under Netværk → Hoveder. Tjek Console for fejl. Report-Only rapporterer mulige restriktioner, men blokerer ikke ressourcerne. Dette eksempel er diagnostisk, ikke en komplet deploymentspolitik.

Hvis et betroet CDN-script rapporteres, skal du først bekræfte dets formål og ejerskab. Du kan muligvis tilpasse direktivet til script-src 'self' https://cdn.example.com; tilføj ikke alle blokerede værter blindt. Værtsallowlister er mindre robuste mod XSS end veldesignede nonce/hash-politikker.

Efter at have testet login, formularer, checkout, editorer og andre arbejdsgange kan du muligvis erstatte Content-Security-Policy-Report-Only med Content-Security-Policy for at håndhæve din testede politik. Hvis siden går i stykker, skal du gendanne den backed-up fil, rydde server-/CDN-cacherne og genafprøve. Et HTTP 500 efter redigering tyder på et syntax- eller servertilladelsesproblem.

Illustration of the article's main concept

4. Konfigurer CSP på Nginx

Nginx ignorerer .htaccess. Hvis du administrerer serveren, skal du inspicere dens aktive konfiguration (ofte /etc/nginx/sites-available/ eller /etc/nginx/conf.d/). I den relevante server-blok skal du bruge:

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 genindlæs derefter med sudo systemctl reload nginx. Hold øje med add_header-arv og regler i mere specifikke placeringer. På administreret hosting uden adgang til Nginx-konfigurationen skal du bruge udbyderens kontrolpanel eller support.

5. WordPress: plugin eller lille tilpasset integration

No-code rute: Tjek først, om din vært eller et eksisterende sikkerhedshede-plugin allerede sender CSP. Vælg et vedligeholdt plugin, der eksplicit understøtter CSP og helst Report-Only; antag ikke, at et generelt sikkerhedsplugin understøtter nogen af dem. I dets indstillinger skal du aktivere Report-Only, starte med en konservativ diagnostisk politik, gemme og teste både offentlige sider og wp-admin, før du håndhæver den.

Udviklerrute: Opret 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 den i Plugins → Installerede plugins, og bekræft derefter svarheadern. Dette tilsidesætter ikke en eksisterende CSP fra webserveren, CDN eller et andet plugin. Det udelukker bevidst wp-admin og giver ikke en komplet håndhævet politik.

Fejlfinding: Hvis en CAPTCHA mislykkes, skal du inspicere blokerede script-src, frame-src og connect-src-anmodninger og konsultere CAPTCHA-udbyderens integrationsvejledning. Hvis en sidebygger rapporterer blokerede inline scripts, skal du tjekke for understøttelse af CSP-nonces eller -hashing. Tilføj ikke automatisk 'unsafe-inline'. For per-svar nonce'er skal du sikre, at fuldsidecaching ikke genbruger den samme nonce og HTML på tværs af besøgende.

6. Joomla: brug det native HTTP Headers-plugin

I Joomla-administrationen skal du åbne System → Plugins, søge efter HTTP Headers og åbne System – HTTP Headers. Den præcise menuformulering varierer afhængigt af Joomla-version og sprog.

Aktiver dets CSP-indstillinger, og start med Report-Only på den offentlige side. Start med at diagnosticere et direktiv såsom script-src 'self'; gem og inspicer Console. Test skabeloner, sidebyggere, editorer, kontaktformularer, CAPTCHA'er, betalingsoptioner og mediefunktioner.

Hvis du ser Refused to execute inline script, skal du identificere, hvilken skabelon eller udvidelse der genererer det. Foretræk en kompatibel nonce- eller hashingmetode, hvor det understøttes; valider, at scriptet er legitimt, før du autoriserer det. Test administratoren separat fra frontenden. Hvis serveren allerede indstiller CSP, skal du forlige konfigurationerne i stedet for at stable konflikter.

Konsulter Joomla HTTP Headers-dokumentationen for de muligheder, der understøttes af din installerede version.

7. Løs den faktiske overtrædelse, ikke hele politikken

Overtrædelse Hvad skal undersøges Typisk løsning
script-src Eksternt eller inline JavaScript Verificer kilden; brug passende nonce/hash eller snævert afgrænset kilde
style-src Stilark eller inline CSS Inspekter genererede stilark; brug godkendt kilde eller kompatibel hash/nonce
img-src Eksternt billede eller data-URL Tillad kun et verificeret billedevært, hvis det er påkrævet
connect-src fetch/XHR/WebSocket Verificer API-ophav og tilføj snævert afgrænset tilladelse
frame-src Indlejret video/CAPTCHA/betalingsramme Følg udbyderens dokumenterede domæner
form-action Formularindsendelsesmål Tillad legitim indsendelsesophav
frame-ancestors Anden side, der indlejrer din side Tillad eksplicit hensigtmæssige forældreophav eller brug 'none'

Hvis f.eks. et legitimt billede på https://images.example.com/photo.webp blokeres af img-src 'self', skal du ændre det relevante direktiv til img-src 'self' https://images.example.com efter at have bekræftet, at værten er betroet. Svæk ikke default-src blot for at løse et billedeproblem.

Technical workflow illustration

Nogle direktiver, herunder frame-ancestors og form-action, falder ikke tilbage til default-src. Medtag dem eksplicit, når det er nødvendigt.

8. Påvirker hosting CSP-konfigurationen?

Ja—CSP-browserstandarden forbliver den samme, men din kontrol over svarhoveder ændres. Apache delt hosting kan eksponere .htaccess; administreret Nginx kan kræve et udbyderpanel; VPS-administratorer kan ændre serverkonfigurationen; og CDNer kan tilføje hoveder efter at applikationen har genereret svaret.

Før du vælger en hostingtjeneste, skal du spørge: Kan jeg indstille og fjerne CSP-hoveder uden root-adgang? Kan jeg bruge Report-Only? Kan jeg inspicere det endelige svar? Er tilpassede hoveder tilgængelige på min plan? Kan supporten forklare konflikter med CDN- eller applikationsregler?

Cloudways: hostingniveau HTTP-headerkontrol

Cloudways dokumenterer Web Rules → Header Rules til at administrere HTTP-svarhoveder, herunder CSP. Dette tilbyder en hostingniveaualternativ til at redigere applikationsfiler, afhængig af de funktioner, der er tilgængelige for din applikation og plan. Det opretter ikke automatisk en sikker CSP; du skal stadig teste og vedligeholde dine direktiver.

Se tilbud fra Cloudways

9. Stærkere beskyttelse med nonce-baseret CSP

En streng CSP bruger uforudsigelige noncer eller hashing i stedet for kun at stole på domæneallowlister. 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-skabelonen:

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

Generer en frisk uforudsigelig nonce for hvert svar. Hold headern og HTML-nonce'en konsekvente, og planlæg rundt om reverse proxies og fuldsidecaching. Med 'strict-dynamic' kan et betroet script indlæse yderligere scripts, så auditér betroede loadere omhyggeligt. Dette er en illustration, ikke en drop-in komplet politik for alle applikationer.

10. Endelig deployments-tjekliste

  1. Identificer alle eksisterende CSP-hoveder og metapolitiikker.
  2. Sikkerhedskopier server- og CMS-konfigurationen.
  3. Oplist scripts, stilark, rammer, API'er, billeder og eksterne tjenester.
  4. Deploy en Report-Only politik først.
  5. Undersøg hver overtrædelse og autoriser kun betroet, nødvendig adfærd.
  6. Test frontend, administration, login, checkout, formularer og integrationer.
  7. Tjek caching, noncer, CDN-adfærd og duplikerede hoveder.
  8. Aktiver håndhævelse gradvist og overvåg efter softwareopdateringer.

Konklusion

En nyttig CSP er ikke blot en header kopieret fra en tjekliste. Kontroller din aktuelle konfiguration, find ud af, hvor den er defineret, test i Report-Only-tilstand, rets den præcise kompatibilitetsudfordring og håndhæv kun en politik, der passer til din hjemmeside. WordPress- og Joomla-administratorer kan starte med CMS-værktøjer; udviklere kan bruge Apache, Nginx eller PHP; og hostingplatforme kan tilbyde direkte headerkontrol.

CSP reducerer angrebmuligheder, men forbliver et lag ved siden af sikker kodning, opdateringer, godkendelse og overvågning.