Politica de Securitate a Conținutului (CSP): Cum să verifici, repari și configurezi pe website-ul tău
Învață cum să verifici, adaugă și repari antete Policyle de Securitate a Conținutului (CSP) pe Apache, Nginx, WordPress și Joomla, cu instrumente practice de diagnostic și ghidări de hosting.
Politica de Securitate conținut (CSP): Cum să o verifici, coregi și configuri pe site-ul tău
HTTPS și actualizările software sunt esențiale, dar nu previn fiecare script malițios din a rula în browser-ul vizitatorului. Politica de Securitate conținut (CSP) adaugă restricții imposate de browser pe resursele pe care o pagină poate încărca și executa. Ajută la reducerea unei atacuri de tip cross-site scripting (XSS), dar nu înlocuiește scăparea de ieșire contextuală, validarea inputului sau actualizările dependențelor.
Acest ghid practic arată cum să inspectați politica curentă, să găsiți sursa sa, să introduceți modificări în siguranță și să coregi problemele pe Apache, Nginx, WordPress și Joomla.
1. Verificați CSP-ul curent
Chrome sau Firefox: Deschideți pagina, apăsați F12, alegerea Network, reîncărcați, faceți clic pe documentul HTML și inspectați Response Headers. Căutați Content-Security-Policy (imposionat) sau Content-Security-Policy-Report-Only (doar diagnostic). Verificați Console pentru violatii.
Liniul de comandă: Rulează curl -I https://example.com/. Pe macOS/Linux, filtrați răspunsul cu curl -sSI https://example.com/ | grep -i content-security-policy. RĂspunsurile HEAD pot difera de GET, așa că folosiți DevTools browserului pentru confirmare.
Outils online: SecurityHeaders.com verifică antilele de securitate; Google CSP Evaluator identifică slăbiciuni dintr-o politică. Niciuna dintre ele nu confirmă că întregul site este securit.
Fără un header CSP pe o răspuns nu înseamnă că fiecare pagină lipsă de CSP. De asemenea, inspectați orice etichetă <meta http-equiv="Content-Security-Policy">: politicile meta au limitări, inclusiv lipsă de susținere pentru frame-ancestors sau Report-Only.
2. Găsiți unde este definiată politica
| Environment | Likely location |
|---|---|
| Apache / compatible LiteSpeed | .htaccess, virtual host sau configurare serverului |
| Nginx | server / location configurare |
| PHP | Codul aplicației care folosește header() |
| WordPress | Plugin, cod custom, proxy invers sau host |
| Joomla | System – HTTP Headers plugin, server sau proxy |
| Cloudflare | Reguli de Transformare a Headerului de Răspuns |
| Managed hosting | Panoul de hosting sau configurarea gestionată de furnizor |
Inspectați antilele de răspuns curente înainte de a adăuga alte. Browser-ul aplică múltiple politicile CSP în mod cumulativ; un header nou permițăzător nu anulează unul preexistent mai restrictiv. Verificați și regulile CDN și hostingu.
3. Adăugați CSP în Apache folosind .htaccess
Utilizând managerul de fișiere al hostului sau SFTP (FileZilla/WinSCP), localizați directorul public care conține index.php, adesea public_html sau httpdocs. Activați fișiere ascunse pentru a vedea .htaccess. Descărcați un backup și evitați plasarea regulilor custom într-un bloc de rewrite gestionat de CMS.
Dacă mod_headers-ul Apache este activat și hostul permite aceste direcții, adăugați:
<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>
Reîncărcați și verificați header-ul sub Network → Headers. Verificați Console pentru violatii. Report-Only raportează restricțiile posibile, dar nu blochează resursele. Acest exemplu este diagnostic, nu o politică completă de implementare.
Dacă un script CDN încredere este raportat, confirmați mai întâi obiectul și proprietatea sa. Poate adaptați directiva la script-src 'self' https://cdn.example.com; nu adăugați blindat fiecare host blocat. Listele de allowlist pe host sunt mai puțin robuste față de XSS decât politicile bune de nonce/hash.
După testarea login, formulare, plată, editor și alte fluxuri de lucru, puteți înlocui Content-Security-Policy-Report-Only cu Content-Security-Policy pentru a aplica politica testată. Dacă site-ul se rupe, restaurați fișierul backupat, curățați cache-ul serverului/CDN și testați din nou. Un HTTP 500 după editare indică un problemă de sintaxă sau permisiune server.

4. Configurați CSP pe Nginx
Nginx ignorează .htaccess. Dacă administrați serverul, inspectați configurarea sa activă (de obicei /etc/nginx/sites-available/ sau /etc/nginx/conf.d/). În blocul relevant server, folosiți:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
Testați cu sudo nginx -t, apoi reîncărcați cu sudo systemctl reload nginx. Vezi pentru add_header moștenire și reguli în locuri mai specifice. Pe hosting geriat fără acces la configurarea Nginx, folosi panoul de control al furnizorului sau suportul.
5. WordPress: plugin sau integrație custom mică
Rute fără cod: Mai întâi verificați dacă host-ul sau un plugin de securitate-header deja trimite CSP. Alegeți un plugin susținut și explicit suportat CSP, preferabil Report-Only; nu asumați că un plugin de securitate general susține oricare dintre ele. În setările să le activați Report-Only, începeți cu o politică diagnostic conservative, salvați și testați paginile publice și wp-admin înainte de aplicare.
Rute pentru dezvoltatori: Creați 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'"
);
});
Activați-l în Plugins → Installed Plugins, apoi confirmați header-ul de răspuns. Acest lucru nu înlocuiește un CSP preexistent de la server web, CDN sau alt plugin. El este conceput să excludă wp-admin și nu furnizează o politică completă de aplicare.
Troubleshooting: Dacă un CAPTCHA eșuează, inspecați cererea blocată script-src, frame-src și connect-src și consultați ghidul de integrare al furnizorului CAPTCHA. Dacă un builder de pagini raportează scripturi inline blocate, verificați suportul pentru nonce-uri CSP sau hashuri. Nu adăugați automat 'unsafe-inline'. Pentru nonce-uri pe răspuns, asigurați-vă că cache-ul de pagină nu reutilizează același nonce și HTML across vizitatori.
6. Joomla: folosiți pluginul nativ HTTP Headers
În administrația Joomla, deschideți System → Plugins, căutați HTTP Headers și deschideți System – HTTP Headers. Exact wording of the menu varies by Joomla version and language.
Activați opțiunile CSP și începeți cu Report-Only pe site-ul public. Începând cu diagnosticarea unei directiva cum ar fi script-src 'self'; salvați și inspectați Console. testați templete, page builders, editor, formulare contact, CAPTCHA, integrații de plată și funcții multimedia.
Dacă vedeți Refused to execute inline script, identificați care template sau extensie îl generează. Preferă o abordare cu nonce sau hash compatibil, unde suportat; validați că scriptul este legitim înainte de a-l autoriza. Testați administratorul separat de frontend. Dacă serverul deja setează CSP, reconcilierea configurărilor este mai bună decât stivarea politicii conflictive.
Consultați documentația Joomla HTTP Headers pentru opțiuni suportate de versiunea instalați.
7. Coregi violatia specifică, nu întreaga politică
| Violation | What to investigate | Typical fix |
|---|---|---|
script-src |
JavaScript extern sau inline | Verificați sursa; folosiți nonce/hash adecvărat sau sursă limitată îngust |
style-src |
Hârtie de stil (CSS) extern sau inline | Inspecționați stilul generat; folosiți sursă aprobată sau hash/nonce compatibil |
img-src |
Imagine externă sau URL de date | Permiteți un host de imagini verificat doar dacă este necesar |
connect-src |
fetch/XHR/WebSocket | Verificați sursa API și adăugați permisiune limitată |
frame-src |
Video înmetanată/CAPTCHA/frame de plată | Urmări domeniile documentate de furnizor |
form-action |
Destinație de submit formulare | Permiteți originul de submit legitim |
frame-ancestors |
Altre site care înmetanază pagina dvs. | Permiteți explicit origini ale tău părinți sau folosiți 'none' |
De exemplu, dacă o imagine legitimă la https://images.example.com/photo.webp este blocată de img-src 'self', schimbați directiva relevantă la img-src 'self' https://images.example.com după confirmarea faptului că host-ul este încredere. Nu slăbi default-src doar pentru a corecta o singură imagine.

Unele directiva, inclusiv frame-ancestors și form-action, nu se traducă înapoi la default-src. Includeți-le explicit când este necesar.
8. Affectează hosting configurarea CSP?
Da—standardul CSP în browser rămâne același, dar controlul asupra antilei de răspuns se schimbă. Hosting compartilat Apache poate expune .htaccess; Nginx gestionat poate necesita panoul furnizorului; administratorii VPS pot modifica configurarea serverului; și CDN-urile pot adăuga antile după ce aplicația generează răspunsul.
Înainte de a alege un serviciu de hosting, întrebați: Pot să setez și elimin un header CSP fără acces root? Pot să folosesc Report-Only? Pot să inspectez răspunsul final? Antile custom sunt disponibile pe planul meu? Poate suportul să explică conflicte cu CDN sau reguli de aplicație?
Cloudways: controluri de header HTTP la nivel hosting Cloudways documentează Web Rules → Header Rules pentru gestionarea antilei de răspuns HTTP, inclusiv CSP. Acest oferă o alternative la nivel hosting față de editarea fișierelor aplicației, subiect de funcționalități disponibile pentru aplicația și planul dumneavoastră. Nu creează automat o CSP sigură; trebuie să testați și mențineți direcțiile dumneavoastră.
Notă de integrare editorială: înlocuiți URL-ul obișnuit Cloudways cu destinația afiliată Cloudways aprobată de CeiKay când canalul de publicare încorporează linkuri de partener. Nu inventați URL-uri de urmărește.
9. Protecție mai puternică cu CSP bazată pe nonce
O CSP strictă folosește nonce-uri sau hash-uri nepresedinte rather than relying doar pe whitelist-uri de domenii. Un exemplu simplu de PHP:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
În șablonul HTML:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
Generați un nonce nepresedinte nou pentru fiecare răspuns. Mențineți header-ul și nonce-ul HTML consistent, și planificați în jur de proxy-uri inverse și cache-urilor de pagină completă. Cu 'strict-dynamic', un script încredere poate încărca alte scripturi, așa că auditați cu atenție loader-urile încredere. Acest exemplu este doar ilustrație, nu o politică completă și aplicabilă pentru toate aplicațiile.
10. Listă de verificare pentru implementare finală
- Identificați toate antilele CSP curente și politicile meta.
- Respaldoarea configurării serverului și CMS.
- Inventaria script-urilor, stilurilor, frame-urilor, API-urilor, imaginilor și serviciilor externe.
- Deployați prima politică Report-Only.
- Investigați fiecare violație și autorizați doar comportamentul încredere și necesar.
- Testați frontend, administrație, login, plată, formulare și integrații.
- Verificați cache-urile, nonce-urile, comportamentul CDN și antile duplicate.
- Activați aplicarea treptat și monitorizați după actualizări software.
Concluzie
O CSP utilă nu este simplu un header copiat dintr-o listă de verificare. Inspectați configurarea curentă, găsiți unde este definită, testați în mod Report-Only, coregi problemele de compatibilitate precise și doar apoi aplica o politică adecvată site-ului. Administrații WordPress și Joomla pot începe cu utilajele CMS; dezvoltatori pot folosi Apache, Nginx sau PHP; și platformele de hosting pot oferi control direct asupra antilei de răspuns.
CSP reduce oportunitățile de atac, dar rămâne doar o strat lângă cod codificat siguranță, actualizări, autentificare și monitorizare.