Content Security Policy (CSP): Wie Sie sie auf Ihrer Website prüfen, beheben und konfigurieren
Erfahren Sie, wie Sie Content Security Policy-Header auf Apache, Nginx, WordPress und Joomla prüfen, hinzufügen und beheben, mit praktischen Diagnosewerkzeugen und Hosting-Anleitung.
Content Security Policy (CSP): So überprüfen, reparieren und konfigurieren Sie sie auf Ihrer Website
HTTPS und Software-Updates sind zwar unerlässlich, verhindern aber nicht, dass jeder bösartige Skript-Code im Browser eines Besuchers ausgeführt wird. Die Content Security Policy (CSP) fügt browsererzwungene Einschränkungen hinzu, die festlegen, welche Ressourcen eine Seite laden und ausführen darf. Sie hilft dabei, bestimmte Cross-Site-Scripting- (XSS-)Angriffe zu mildern, ersetzt aber nicht die kontextbezogene Ausgabe-Eskaping, die Eingabebestätigung oder die Aktualisierung von Abhängigkeiten.
Dieses praktische Tutorial zeigt, wie Sie Ihre aktuelle Richtlinie überprüfen, ihren Ursprung finden, Änderungen sicher einführen und Probleme auf Apache, Nginx, WordPress und Joomla beheben können.
1. Überprüfen Sie Ihre bestehende CSP
Chrome oder Firefox: Öffnen Sie die Seite, drücken Sie F12, wählen Sie Netzwerk, laden Sie die Seite neu, klicken Sie auf das HTML-Dokument und überprüfen Sie die Response Headers. Suchen Sie nach Content-Security-Policy (erzwungen) oder Content-Security-Policy-Report-Only (nur für Diagnose). Überprüfen Sie die Konsole auf Verstöße.
Befehlszeile: Führen Sie curl -I https://example.com/ aus. Unter macOS/Linux filtern Sie die Antwort mit curl -sSI https://example.com/ | grep -i content-security-policy. Beachten Sie, dass HEAD-Antworten von GET-Antworten abweichen können; verwenden Sie daher die Browser DevTools zur Bestätigung.
Online-Tools: SecurityHeaders.com überprüft Sicherheits-Header; Google CSP Evaluator weist auf Schwachstellen in einer Richtlinie hin. Keines von beiden beweist jedoch, dass die gesamte Website sicher ist.
Ein fehlender CSP-Header in einer Antwort bedeutet nicht, dass jede Seite über keinen CSP verfügt. Überprüfen Sie auch jedes <meta http-equiv="Content-Security-Policy">-Tag: Meta-Richtlinien haben Einschränkungen, einschließlich der fehlenden Unterstützung für frame-ancestors oder Report-Only.
2. Finden Sie heraus, wo die Richtlinie definiert ist
| Umgebung | Wahrscheinlicher Ort |
|---|---|
| Apache / kompatibler LiteSpeed | .htaccess, virtueller Host oder Serverkonfiguration |
| Nginx | server / location-Konfiguration |
| PHP | Anwendungscode, der header() verwendet |
| WordPress | Plugin, benutzerdefinierter Code, Reverse Proxy oder Host |
| Joomla | System – HTTP-Header Plugin, Server oder Proxy |
| Cloudflare | Response Header Transform Rules |
| Verwaltetes Hosting | Hosting-Panel oder vom Anbieter verwaltete Konfiguration |
Überprüfen Sie die vorhandenen Antwort-Header bevor Sie einen weiteren hinzufügen. Browser erzwingen mehrere CSP-Richtlinien kumulativ; ein neuer, permissive Header hebt keinen bestehenden restriktiven Header auf. Überprüfen Sie auch die CDN- und Hosting-Regeln.
3. Fügen Sie CSP in Apache mit .htaccess hinzu
Suchen Sie mit dem Dateimanager Ihres Hosts oder SFTP (FileZilla/WinSCP) das öffentliche Verzeichnis, das index.php enthält, oft public_html oder httpdocs. Aktivieren Sie versteckte Dateien, um .htaccess zu sehen. Erstellen Sie ein Backup und vermeiden Sie es, benutzerdefinierte Regeln innerhalb eines CMS-verwalteten Rewrite-Blocks zu platzieren.
Wenn Apache's mod_headers aktiviert ist und der Host diese Direktiven zulässt, fügen Sie Folgendes hinzu:
<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>
Laden Sie die Seite neu und überprüfen Sie den Header unter Netzwerk → Header. Überprüfen Sie die Konsole auf Verstöße. Report-Only meldet mögliche Einschränkungen, blockiert aber nicht die Ressourcen. Dieses Beispiel ist diagnostisch und keine vollständige Bereitstellungsrichtlinie.
Wenn ein vertrauenswürdiger CDN-Skript-Block gemeldet wird, bestätigen Sie zunächst dessen Zweck und Eigentümer. Sie können die Directive möglicherweise auf script-src 'self' https://cdn.example.com anpassen; fügen Sie nicht blind jeden blockierten Host hinzu. Host-Allowlists sind weniger robust gegen XSS als gut entworfene Nonce-/Hash-Richtlinien.
Nach dem Testen von Login, Formularen, Checkout, Editoren und anderen Arbeitsabläufen können Sie Content-Security-Policy-Report-Only durch Content-Security-Policy ersetzen, um Ihre getestete Richtlinie durchzusetzen. Wenn die Website abstürzt, stellen Sie die gesicherte Datei wieder her, löschen Sie den Server-/CDN-Cache und testen Sie erneut. Ein HTTP 500 nach der Bearbeitung deutet auf ein Syntax- oder Serverberechtigungsproblem hin.

4. Konfigurieren Sie CSP auf Nginx
Nginx ignoriert .htaccess. Wenn Sie den Server verwalten, überprüfen Sie die aktive Konfiguration (oft /etc/nginx/sites-available/ oder /etc/nginx/conf.d/). Verwenden Sie in dem entsprechenden server-Block Folgendes:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
Testen Sie mit sudo nginx -t und laden Sie dann mit sudo systemctl reload nginx neu. Achten Sie auf add_header-Vererbung und Regeln an spezifischeren Orten. Bei verwaltetem Hosting ohne Zugriff auf die Nginx-Konfiguration verwenden Sie das Control Panel oder den Support des Anbieters.
5. WordPress: Plugin oder kleine benutzerdefinierte Integration
No-Code-Route: Überprüfen Sie zunächst, ob Ihr Host oder ein bestehendes Sicherheits-Header-Plugin bereits CSP sendet. Wählen Sie ein gepflegtes Plugin aus, das CSP explizit unterstützt und vorzugsweise Report-Only; nehmen Sie nicht an, dass ein allgemeines Sicherheitsplugin entweder unterstützt. Aktivieren Sie in den Einstellungen Report-Only, beginnen Sie mit einer konservativen diagnostischen Richtlinie, speichern Sie und testen Sie sowohl öffentliche Seiten als auch wp-admin, bevor Sie sie durchsetzen.
Entwicklerroute: Erstellen Sie 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'"
);
});
Aktivieren Sie es in Plugins → Installierte Plugins und bestätigen Sie dann den Antwort-Header. Dies überschreibt keine bestehende CSP vom Webserver, CDN oder einem anderen Plugin. Es schließt wp-admin absichtlich aus und stellt keine vollständige erzwängte Richtlinie bereit.
Problembehebung: Wenn ein CAPTCHA fehlschlägt, untersuchen Sie blockierte script-src-, frame-src- und connect-src-Anfragen und konsultieren Sie die Integrationsrichtlinien des CAPTCHA-Anbieters. Wenn ein Page-Builder blockierte Inline-Skripte meldet, überprüfen Sie, ob CSP-Nonces oder -Hashes unterstützt werden. Fügen Sie nicht automatisch 'unsafe-inline' hinzu. Für pro-Antwort-Nonces stellen Sie sicher, dass das Full-Page-Caching nicht denselben Nonce und dieselbe HTML-Datei für verschiedene Besucher wiederverwendet.
6. Joomla: Verwenden Sie das native HTTP-Header-Plugin
Öffnen Sie in der Joomla-Administration System → Plugins, suchen Sie nach HTTP-Header und öffnen Sie System – HTTP-Header. Die genaue Menübezeichnung variiert je nach Joomla-Version und Sprache.
Aktivieren Sie seine CSP-Optionen und beginnen Sie mit Report-Only auf der öffentlichen Website. Beginnen Sie mit der Diagnose einer Directive wie script-src 'self'; speichern Sie und untersuchen Sie die Konsole. Testen Sie Vorlagen, Page-Builder, Editoren, Kontaktformulare, CAPTCHAs, Zahlungsintegrationen und Medienfunktionen.
Wenn Sie Refused to execute inline script sehen, identifizieren Sie, welche Vorlage oder Erweiterung es generiert. Bevorzugen Sie einen kompatiblen Nonce- oder Hash-Ansatz, wo unterstützt; validieren Sie, dass das Skript legitim ist, bevor Sie es autorisieren. Testen Sie den Administrator separat vom Frontend. Wenn der Server bereits CSP festlegt, versöhnen Sie die Konfigurationen, anstatt widersprüchliche Richtlinien zu stapeln.
Konsultieren Sie die Joomla HTTP-Header-Dokumentation für die Optionen, die von Ihrer installierten Version unterstützt werden.
7. Beheben Sie den tatsächlichen Verstoß, nicht die gesamte Richtlinie
| Verstoß | Was zu untersuchen ist | Typische Lösung |
|---|---|---|
script-src |
Externe oder Inline-JavaScript | Überprüfen Sie die Quelle; verwenden Sie einen geeigneten Nonce/Hash oder einen eng gefassten Quellort |
style-src |
Stylesheet oder Inline-CSS | Untersuchen Sie die generierten Stile; verwenden Sie eine genehmigte Quelle oder einen kompatiblen Hash/Nonce |
img-src |
Externe Bilddatei oder Daten-URL | Erlauben Sie nur einen verifizierten Bild-Host, falls erforderlich |
connect-src |
fetch/XHR/WebSocket | Überprüfen Sie den API-Herkunftsort und fügen Sie eine eng gefasste Berechtigung hinzu |
frame-src |
Eingebettetes Video/CAPTCHA/Zahlungsrahmen | Befolgen Sie die dokumentierten Domains des Anbieters |
form-action |
Ziel der Formulareingabe | Erlauben Sie eine legitime Übermittlungs-Herkunft |
frame-ancestors |
Andere Website, die Ihre Seite einbettet | Ermöglichen Sie explizit die beabsichtigten Eltern-Herkunftsorte oder verwenden Sie 'none' |
Wenn beispielsweise ein legitimes Bild unter https://images.example.com/photo.webp durch img-src 'self' blockiert wird, ändern Sie die relevante Directive auf img-src 'self' https://images.example.com, nachdem Sie bestätigt haben, dass dieser Host vertrauenswürdig ist. Schwächen Sie default-src nicht nur ab, um ein Bild zu reparieren.

Einige Directives, einschließlich frame-ancestors und form-action, fallen nicht auf default-src zurück. Fügen Sie sie bei Bedarf explizit hinzu.
8. Beeinflusst das Hosting die CSP-Konfiguration?
Ja – der CSP-Browserstandard bleibt gleich, aber Ihre Kontrolle über Antwort-Header ändert sich. Apache-Shared-Hosting kann .htaccess freilegen; verwiertes Nginx kann ein Provider-Panel erfordern; VPS-Administratoren können die Serverkonfiguration ändern; und CDNs können Header nach der Generierung der Antwort durch die Anwendung hinzufügen.
Bevor Sie einen Hosting-Dienst wählen, fragen Sie: Kann ich CSP-Header ohne Root-Zugriff einstellen und entfernen? Kann ich Report-Only verwenden? Kann ich die endgültige Antwort überprüfen? Sind benutzerdefinierte Header in meinem Plan verfügbar? Kann der Support Konflikte mit CDN- oder Anwendungsregeln erklären?
Cloudways: Hosting-Ebene-Steuerelemente für HTTP-Header
Cloudways dokumentiert Web Rules → Header Rules für die Verwaltung von HTTP-Antwort-Headern, einschließlich CSP. Dies bietet eine Hosting-Ebene-Alternative zur Bearbeitung von Anwendungsdateien, abhängig von den Funktionen, die für Ihre Anwendung und Ihren Plan verfügbar sind. Es erstellt nicht automatisch eine sichere CSP; Sie müssen Ihre Direktiven weiterhin testen und pflegen.
9. Stärkere Schutzmaßnahmen mit Nonce-basierter CSP
Eine strenge CSP verwendet unvorhersehbare Nonces oder Hashes anstatt von Domain-Allowlists zu abhängen. Ein vereinfachtes PHP-Beispiel:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
Im HTML-Template:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
Generieren Sie für jede Antwort einen neuen, unvorhersehbaren Nonce. Halten Sie den Header und den HTML-Nonce konsistent und planen Sie Rückproxies und Full-Page-Caches ein. Mit 'strict-dynamic' kann ein vertrauenswürdiger Skript weitere Skripte laden, daher überprüfen Sie vertrauenswürdige Loader sorgfältig. Dies ist eine Illustration, keine fertige Richtlinie für alle Anwendungen.
10. Checkliste für die endgültige Bereitstellung
- Identifizieren Sie alle vorhandenen CSP-Header und Meta-Richtlinien.
- Sichern Sie die Server- und CMS-Konfiguration.
- Erstellen Sie ein Inventar von Skripten, Stilen, Frames, APIs, Bildern und externen Diensten.
- Bereitstellen Sie zunächst eine Report-Only-Richtlinie.
- Untersuchen Sie jeden Verstoß und autorisieren Sie nur vertrauenswürdiges, notwendiges Verhalten.
- Testen Sie Frontend, Administration, Login, Checkout, Formulare und Integrationen.
- Überprüfen Sie Caching, Nonces, CDN-Verhalten und doppelte Header.
- Aktivieren Sie die Durchsetzung schrittweise und überwachen Sie nach Software-Updates.
Fazit
Eine nützliche CSP ist nicht einfach ein Header, der von einer Checkliste kopiert wurde. Untersuchen Sie Ihre aktuelle Konfiguration, finden Sie heraus, wo sie definiert ist, testen Sie im Report-Only-Modus, beheben Sie die genauen Kompatibilitätsprobleme und erst dann sollten Sie eine Richtlinie durchsetzen, die für Ihre Website geeignet ist. WordPress- und Joomla-Administratoren können mit CMS-Tools beginnen; Entwickler können Apache, Nginx oder PHP verwenden; und Hosting-Plattformen können direkte Header-Steuerelemente anbieten.
CSP reduziert Angriffsgelegenheiten, bleibt aber nur eine Schicht neben sicherem Code, Updates, Authentifizierung und Überwachung.