Content Security Policy (CSP): Hoe je het kunt controleren, repareren en configureren op je website
Leer hoe je Content Security Policy-headers kunt controleren, toevoegen en repareren op Apache, Nginx, WordPress en Joomla, met praktische diagnostische tools en hostingadvies.
Content Security Policy (CSP): Hoe te controleren, repareren en configureren op je website
HTTPS en software-updates zijn essentieel, maar ze voorkomen niet elke schadelijke script die in de browser van een bezoeker wordt uitgevoerd. Content Security Policy (CSP) voegt browser-afgedwongen beperkingen toe aan de bronnen die een pagina mag laden en uitvoeren. Het helpt bepaalde cross-site scripting (XSS)-aanvallen te mitigeren, maar vervangt niet contextuele uitgangsontsnapping, invoervalidatie of dependency-updates.
Dit praktische handboon laat zien hoe je je huidige beleid inspeelt, de bron vindt, veilig wijzigingen doorvoert, en problemen oplost op Apache, Nginx, WordPress en Joomla.
1. Check je bestaand CSP
Chrome of Firefox: Open de pagina, druk op F12, kies Netwerk, herlaad, klik op het HTML-document, en inspecteer Response Headers. Zoek naar Content-Security-Policy (afgedwongen) of Content-Security-Policy-Report-Only (alleen diagnose). Controleer de Console op overtredingen.
Op de commandoregel: Voer curl -I https://example.com/ uit. Op macOS/Linux, filter de reactie met curl -sSI https://example.com/ | grep -i content-security-policy. HEAD-reacties kunnen verschillen van GET-reacties, dus gebruik browser Ontwikkelhulpmiddelen om te bevestigen.
Online tools: SecurityHeaders.com controleert beveiligingsheaders; Google CSP Evaluator flagt zwakken in een beleid. Geen van beiden bewijst dat de entire website veilig is.
Geen CSP-header bij één reactie stelt niet dat elke pagina ontbreekt aan CSP. Controleer ook eventuele <meta http-equiv="Content-Security-Policy"> tag: meta-beleid hebben beperkingen, waaronder geen ondersteuning voor frame-ancestors of Report-Only.
2. Zoek waar het beleid is gedefinieerd
| Omgeving | Waarschijnlijke locatie |
|---|---|
| Apache / compatibele LiteSpeed | .htaccess, virtueel host of serverconfiguratie |
| Nginx | server / location configuratie |
| PHP | Toepassingscode die header() gebruikt |
| WordPress | Plugin, aangepaste code, reverse proxy of host |
| Joomla | System – HTTP Headers plugin, server of proxy |
| Cloudflare | Response Header Transform Rules |
| Managed hosting | Hosting panel of provider-beheerde configuratie |
Inspecteer bestaande response-headers voordat je er nog een toevoegt. Browseren several CSP-beleid cumulatief af; een nieuwe permissieve header niet een bestaande restrictive annuleer. Controleer ook CDN- en hostingregels.
3. Voeg CSP toe in Apache via .htaccess
Met de bestandsbeheerder van je host of via SFTP (FileZilla/WinSCP), zoek de publieke map die index.php bevat, vaak public_html of httpdocs. Schakel verborgen bestanden in om .htaccess te zien. Download een back-up, en vermijd het plaatsen van aangepaste regels binnen een CMS-beheerde herschrijfblok.
Als Apache's mod_headers is ingeschakeld en de host deze toestaan, voeg dan toe:
<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>
Herlaad en verify het header onder Netwerk → Headers. Controleer de Console op overtredingen. Report-Only meldt mogelijke beperkingen, maar blokkeert de bronnen niet. Dit voorbeeld is diagnostisch, niet een complete implementatie-beleid.
Als een vertrouwd CDN-script wordt gemeld, bevestig eerst zijn doel en eigendom. Je kunt de directive aanpassen naar script-src 'self' https://cdn.example.com; voeg elke gemerkte host niet blindelings toe. Host-allowlists zijn weerstandiger tegen XSS dan goed ontworp nonce/hash-beleid.
Na het testen van inloggen, formulieren, afrekenen, editors en andere werkstromen, kun je Content-Security-Policy-Report-Only vervangen door Content-Security-Policy om je geteste beleid af te dwingen. Als de site storeopt, herstel dan het geback-upde bestand, maak server/CDN caches leeg en test opnieuw. Een HTTP 500 na het bewerken suggereert een syntaxis- of server-rechtelijk probleem.

4. Configureer CSP op Nginx
Nginx negeert .htaccess. Als je de server beheert, inspecteer zijn actieve configuratie (vaak /etc/nginx/sites-available/ of /etc/nginx/conf.d/). In de relevante server blok, gebruik:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
Test met sudo nginx -t, daarna herladen met sudo systemctl reload nginx. Let op add_header erfenis en regels in meer-specifieke locaties. Op beheerde hosting zonder toegang tot Nginx-configuratie, gebruik het controlepaneel van de provider of support.
5. WordPress: plugin of kleine aangepaste integratie
Geen-code route: Check eerst of je host of een bestaand security-header-plugin al CSP verzendt. Kies een onderhouden plugin die CSP expliciet ondersteunt en indien mogelijk Report-Only; neem aan een algemene security-plugin niet dat een vanbei. In de instellingen, schakel Report-Only in, begin met een conservatieve diagnostische beleid, sla op, en test zowel publieke pagina's als wp-admin voordat je afdwingt.
Developer route: Maak 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'"
);
});
Activeer het in Plugins → Geïnstalleerde Plugins, dan bevestig het response-header. Dit overschrijdt geen bestaand CSP van de webserver, CDN of andere plugin. Het uitsluit bewust wp-admin en biedt geen volledig afgedwongen beleid.
Probleemoplossing: Als een CAPTCHA mislukt, inspecteer dan geblokkeerde script-src, frame-src en connect-src aanvragen en raadpleeg de integratie-instructies van de CAPTCHA-provider. Als een page builder geblokkeerde inline scripts rapporteert, controleer dan op ondersteuning voor CSP nonces of hashes. Voeg niet automatisch 'unsafe-inline' toe. Voor per-response nonces, zorg dat volledige pagina-caching dezelfde nonce en HTML niet over bezoekers herhaalt.
6. Joomla: gebruik de native HTTP Headers plugin
In de Joomla-beheerder, open System → Plugins, zoek naar HTTP Headers, en open System – HTTP Headers. Exacte menu-formulering varieert per Joomla-versie en taal.
Schakel zijn CSP-opties in en begin met Report-Only op de publieke site. Begin met het diagnosticeren van een richtlijn zoveel script-src 'self'; sla op en inspecteer de Console. Test templates, page builders, editors, contactformulieren, CAPTCHA's, betaalintegraties en media-functies.
Als je Refused to execute inline script ziet, identificeer welk template of extensie het genereert. Verkies een compatibel nonce of hash-aanpak waar ondersteund; valideer dat het script legitiem is voordat je het autoriseert. Test de administrator apart van de frontend. Als de server al CSP ingesteld heeft, reconcileer de configuraties in plaats van conflicterende beleidslagen te stapelen.
Raadpleeg de Joomla HTTP Headers documentatie voor de opties ondersteund door je geïnstalleerde versie.
7. Repareer de daadwerkelijke overtreding, niet het hele beleid
| Overtreding | Wat te onderzoeken | Typische fix |
|---|---|---|
script-src |
Externe of inline JavaScript | Controleer bron; gebruik geschikte nonce/hash of nauw begrensde bron |
style-src |
Stylesheet of inline CSS | Inspecteer gegenereerde styles; gebruik goedgekeurde bron of compatibel hash/nonce |
img-src |
Externe afbeelding of data URL | Toestaan een geverifieerde afbeeldingshost alleen als vereist |
connect-src |
fetch/XHR/WebSocket | API-bron verifiëren en nauw gerichte toestemming toevoegen |
frame-src |
Ingesloten video/CAPTCHA/betalingsframe | Volg de domeinen van de provider |
form-action |
Formulierindindeling | Toestaan legitieme inzendursprung |
frame-ancestors |
Andere site die je pagina inbedt | Toestaan expliciet bestemde ouder-oorsprongen, of gebruik 'none' |
Bijvoorbeeld, als een legitieme afbeelding op https://images.example.com/photo.webp wordt geblokkeerd door img-src 'self', veranders de relevante directive naar img-src 'self' https://images.example.com nadat geconfirmerd is dat de host vertrouwd is. Maak default-src niet zwakker slechts om één afbeelding te fixen.

Sommige directives, waaronder frame-ancestors en form-action, vallen niet terug op default-src. Neem ze expliciet op wanneer nodig.
8. Beïnvloedt hosting CSP-configuratie?
Ja—de CSP-browser standaard blijft hetzelfde, maar jouw controle over response-headers verandert. Apache shared hosting kan .htaccess blootleggen; beheerde Nginx kan een provider-panel vereisen; VPS-beheerders kunnen serverconfiguratie aanpassen; en CDNs kunnen headers toevoegen nadat de toepassing het response genereert.
Voordat je een hosting-service kiest, vraag: Kan ik CSP-headers instellen en verwijderen zonder root-toegang? Kan ik Report-Only gebruiken? Kan ik het eindresponse inspeken? Zijn custom headers beschikbaar op mijn plan? Kan support conflicten met CDN of toepassingsregels uitleggen?
Cloudways: hosting-level HTTP header controls
Cloudways documenteert Web Rules → Header Rules voor het beheren van HTTP response-headers, inclusief CSP. Dit biedt een hosting-level alternatief voor het bewerken van toepassingsbestanden, onderhevig aan de beschikbare features voor je applicatie en plan. Het maakt niet automatisch een veilige CSP; je moet nog steeds testen en onderhouden je directives.
9. Sterkere bescherming met nonce-gebaseerd CSP
Een strikt CSP gebruikt onvoorspelbare nonces of hashes in plaats van alleen domeinallowlists. Een vereenvoudigd PHP-voorbeeld:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
In de HTML-template:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
Genereer een nieuwe onvoorspelbare nonce voor elk response. Houd de header en HTML-nonce consistent, en plan rondom reverse proxies en volledige pagina-caches. Met 'strict-dynamic', kan een vertrouwd script verder scripts laden, dus audit vertrouwde loaders zorgvuldig. Dit is een illustratie, geen drop-in complete beleid voor alle applicaties.
10. Eindelijke deploychecklist
- Identificeer alle bestaande CSP-headers en meta-beleid.
- Back-up server- en CMS-configuratie.
- Inventarisatie scripts, styles, frames, API's, afbeeldingen en externe services.
- Deploy een Report-Only-beleid eerst.
- Onderzoek elke overtreding en autoriseer alleen vertrouwde, noodzakelijke gedragingen.
- Test frontend, administrative, inloggen, afrekenen, formulieren en integraties.
- Controleer caching, nonces, CDN-gedrag en dubbele headers.
- Schakel afdwinging geleidelijk in en monitor na software-updates.
Conclusie
Een nuttelk CSP is niet simpelweg een header gekopieerd van een checklist. Inspecteer je huidige configuratie, vind waar het is gedefinieerd, test in Report-Only-modus, fix de precieze compatibiliteitsproblemen, en alleen dan afdwingen een beleid dat passend is voor je website. WordPress- en Joomla-beheerders kunnen beginnen met CMS-tooling; developers kunnen Apache, Nginx of PHP gebruiken; en hosting-platforms kunnen directe header-controls bieden.
CSP vermindert aanvalsgelegenheden, maar blijft één laag naast veilig coderen, updates, authenticatie en monitoring.