Web e sviluppo

Content Security Policy (CSP): Come verificare, correggere e configurare sul tuo sito web

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

Scopri come verificare, aggiungere e correggere gli header Content Security Policy su Apache, Nginx, WordPress e Joomla, con strumenti diagnostici pratici e consigli per l'hosting.

Content Security Policy (CSP): come verificarla, correggerla e configurarla sul tuo sito web

HTTPS e gli aggiornamenti software sono essenziali, ma non impediscono l'esecuzione di qualsiasi script dannoso nel browser di un visitatore. La Content Security Policy (CSP) aggiunge restrizioni applicate dal browser sulle risorse che una pagina può caricare ed eseguire. Aiuta a mitigare alcuni attacchi di tipo cross-site scripting (XSS), ma non sostituisce l'escaping contestuale dell'output, la validazione dell'input o gli aggiornamenti delle dipendenze.

Questo tutorial pratico mostra come esaminare la policy attuale, individuarne l'origine, introdurre modifiche in sicurezza e risolvere i problemi su Apache, Nginx, WordPress e Joomla.

1. Verifica la CSP esistente

Chrome o Firefox: apri la pagina, premi F12, seleziona Rete (Network), ricarica, fai clic sul documento HTML e controlla le Intestazioni di risposta (Response Headers). Cerca Content-Security-Policy (applicata) o Content-Security-Policy-Report-Only (solo diagnostica). Controlla la Console per individuare eventuali violazioni.

Riga di comando: esegui curl -I https://example.com/. Su macOS/Linux, filtra la risposta con curl -sSI https://example.com/ | grep -i content-security-policy. Le risposte HEAD possono differire da quelle GET, quindi usa i DevTools del browser per conferma.

Strumenti online: SecurityHeaders.com analizza le intestazioni di sicurezza; Google CSP Evaluator evidenzia i punti deboli di una policy. Nessuno dei due dimostra che l'intero sito web sia sicuro.

L'assenza dell'intestazione CSP su una singola risposta non significa che ogni pagina ne sia priva. Ispeziona anche eventuali tag <meta http-equiv="Content-Security-Policy">: le policy definite nei meta tag hanno dei limiti, inclusa l'assenza di supporto per frame-ancestors o Report-Only.

2. Individua dove è definita la policy

Ambiente Posizione probabile
Apache / LiteSpeed compatibile .htaccess, configurazione del virtual host o del server
Nginx Configurazione di server / location
PHP Codice applicativo che utilizza header()
WordPress Plugin, codice personalizzato, reverse proxy o provider di hosting
Joomla Plugin System – HTTP Headers, server o proxy
Cloudflare Response Header Transform Rules
Hosting gestito Pannello di hosting o configurazione gestita dal provider

Esamina le intestazioni di risposta esistenti prima di aggiungerne un'altra. I browser applicano le policy CSP multiple in modo cumulativo; una nuova intestazione più permissiva non annulla una restrittiva già esistente. Controlla anche le regole della CDN e dell'hosting.

3. Aggiungere la CSP in Apache usando .htaccess

Utilizzando il file manager del tuo host o una connessione SFTP (FileZilla/WinSCP), individua la directory pubblica contenente index.php, spesso public_html o httpdocs. Abilita la visualizzazione dei file nascosti per vedere .htaccess. Scarica un backup ed evita di inserire regole personalizzate all'interno di un blocco di rewrite gestito dal CMS.

Se il modulo mod_headers di Apache è abilitato e l'host consente queste direttive, aggiungi:

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

Ricarica e verifica l'intestazione nella scheda Rete → Intestazioni. Controlla la Console per eventuali violazioni. La modalità Report-Only segnala le possibili restrizioni ma non blocca le risorse. Questo esempio ha uno scopo diagnostico, non è una policy completa per la produzione.

Se viene segnalato uno script di una CDN fidata, verifica innanzitutto il suo scopo e la proprietà. Puoi adattare la direttiva in script-src 'self' https://cdn.example.com; non aggiungere alla cieca ogni host bloccato. Le allowlist di host sono meno robuste contro gli attacchi XSS rispetto a policy ben progettate basate su nonce/hash.

Dopo aver testato login, moduli, checkout, editor e altri flussi di lavoro, puoi sostituire Content-Security-Policy-Report-Only con Content-Security-Policy per applicare la policy dopo averla testata. Se il sito presenta anomalie, ripristina il file di backup, svuota la cache del server/della CDN e ripeti i test. Un errore HTTP 500 dopo la modifica suggerisce un problema di sintassi o di permessi del server.

Illustration of the article's main concept

4. Configurare la CSP su Nginx

Nginx ignora il file .htaccess. Se amministri il server, esamina la sua configurazione attiva (spesso /etc/nginx/sites-available/ o /etc/nginx/conf.d/). All'interno del blocco server pertinente, utilizza:

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

Esegui un test con sudo nginx -t, quindi ricarica con sudo systemctl reload nginx. Fai attenzione all'ereditarietà di add_header e alle regole presenti in blocchi di location più specifici. Sull'hosting gestito senza accesso alla configurazione di Nginx, utilizza il pannello di controllo del provider o contatta l'assistenza.

5. WordPress: plugin o piccola integrazione personalizzata

Metodo no-code: per prima cosa verifica se il tuo host o un plugin di intestazioni di sicurezza esistente invia già una CSP. Scegli un plugin mantenuto che supporti esplicitamente la CSP e preferibilmente la modalità Report-Only; non dare per scontato che un generico plugin di sicurezza supporti entrambe. Nelle sue impostazioni, abilita Report-Only, inizia con una policy diagnostica conservativa, salva e testa sia le pagine pubbliche sia wp-admin prima di rendere effettiva l'applicazione.

Metodo per sviluppatori: crea 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'"
    );
});

Attivalo in Plugin → Plugin installati, quindi conferma l'intestazione di risposta. Questo non sovrascrive una CSP esistente inviata dal server web, dalla CDN o da un altro plugin. Esclude deliberatamente wp-admin e non fornisce una policy applicata completa.

Risoluzione dei problemi: se un CAPTCHA non funziona, esamina le richieste bloccate per script-src, frame-src e connect-src e consulta le linee guida di integrazione fornite dal gestore del CAPTCHA. Se un page builder segnala script inline bloccati, verifica il supporto per nonce o hash CSP. Non aggiungere automaticamente 'unsafe-inline'. Per i nonce generati per singola risposta, assicurati che la cache dell'intera pagina non riutilizzi lo stesso nonce e lo stesso HTML tra visitatori diversi.

6. Joomla: utilizzare il plugin nativo HTTP Headers

Nel pannello di amministrazione di Joomla, apri Sistema → Plugin, cerca HTTP Headers e apri System – HTTP Headers. La dicitura esatta del menu varia a seconda della versione di Joomla e della lingua.

Abilita le relative opzioni CSP e inizia con la modalità Report-Only sul sito pubblico. Parti diagnosticando una direttiva come script-src 'self'; salva e controlla la Console. Esegui test su template, page builder, editor, moduli di contatto, CAPTCHA, integrazioni di pagamento e funzionalità multimediali.

Se visualizzi un errore relativo a Refused to execute inline script, individua quale template o estensione lo genera. Preferisci un approccio compatibile basato su nonce o hash ove supportato; verifica che lo script sia legittimo prima di autorizzarlo. Testa l'area di amministrazione separatamente dal frontend. Se il server imposta già una CSP, armonizza le configurazioni invece di sovrapporre policy in conflitto.

Consulta la documentazione di Joomla sugli HTTP Headers per le opzioni supportate dalla versione installata.

7. Correggi la specifica violazione, non l'intera policy

Violazione Cosa analizzare Soluzione tipica
script-src JavaScript esterno o inline Verifica la sorgente; usa un nonce/hash appropriato o una sorgente dall'ambito circoscritto
style-src Foglio di stile o CSS inline Esamina gli stili generati; usa una sorgente approvata o un hash/nonce compatibile
img-src Immagine esterna o URL dati Consenti un host di immagini verificato solo se necessario
connect-src fetch/XHR/WebSocket Verifica l'origine dell'API e aggiungi un permesso dall'ambito circoscritto
frame-src Frame di video/CAPTCHA/pagamenti incorporati Segui i domini documentati dal provider
form-action Destinazione di invio del modulo Consenti l'origine legittima di invio dei dati
frame-ancestors Altro sito che incorpora la tua pagina Consenti esplicitamente le origini genitore previste, o usa 'none'

Ad esempio, se un'immagine legittima su https://images.example.com/photo.webp viene bloccata da img-src 'self', modifica la direttiva pertinente in img-src 'self' https://images.example.com dopo aver confermato che l'host è fidato. Non indebolire default-src solo per risolvere il caricamento di una singola immagine.

Technical workflow illustration

Alcune direttive, tra cui frame-ancestors e form-action, non usano default-src come fallback. Includile esplicitamente quando necessario.

8. L'hosting influisce sulla configurazione della CSP?

Sì: lo standard del browser per la CSP rimane lo stesso, ma il controllo che hai sulle intestazioni di risposta cambia. L'hosting condiviso Apache può esporre .htaccess; Nginx gestito può richiedere un pannello del provider; gli amministratori di VPS possono modificare la configurazione del server; e le CDN possono aggiungere intestazioni dopo che l'applicazione ha generato la risposta.

Prima di scegliere un servizio di hosting, chiediti: Posso impostare e rimuovere le intestazioni CSP senza accesso root? Posso usare Report-Only? Posso ispezionare la risposta finale? Le intestazioni personalizzate sono disponibili sul mio piano? Il supporto tecnico è in grado di chiarire i conflitti con le regole della CDN o dell'applicazione?

Cloudways: controlli delle intestazioni HTTP a livello di hosting

Cloudways documenta la sezione Web Rules → Header Rules per la gestione delle intestazioni di risposta HTTP, inclusa la CSP. Questo offre un'alternativa a livello di hosting rispetto alla modifica dei file dell'applicazione, in base alle funzionalità disponibili per l'applicazione e il piano scelti. Tale strumento non crea automaticamente una CSP sicura: dovrai comunque testare e gestire le tue direttive.

Scopri le offerte Cloudways

9. Protezione più avanzata con CSP basata su nonce

Una CSP rigorosa impiega nonce o hash imprevedibili invece di fare affidamento esclusivamente sulle allowlist di domini. Un esempio semplificato in PHP:

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

Nel template HTML:

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

Genera un nonce nuovo e imprevedibile per ogni risposta. Mantieni coerente il nonce tra intestazione e HTML, e pianifica la gestione tenendo conto di reverse proxy e cache dell'intera pagina. Con 'strict-dynamic', uno script fidato può caricare ulteriori script, pertanto verifica attentamente i loader attendibili. Questa è un'illustrazione concettuale, non una policy completa pronta all'uso per tutte le applicazioni.

10. Checklist finale per il deployment

  1. Identifica tutte le intestazioni CSP e le policy nei meta tag esistenti.
  2. Esegui il backup della configurazione del server e del CMS.
  3. Fai un inventario di script, stili, frame, API, immagini e servizi esterni.
  4. Distribuisci prima una policy in modalità Report-Only.
  5. Esamina ogni violazione e autorizza solo i comportamenti fidati e necessari.
  6. Testa frontend, amministrazione, login, checkout, moduli e integrazioni.
  7. Verifica caching, nonce, comportamento della CDN e intestazioni duplicate.
  8. Attiva l'applicazione della policy in modo graduale e monitora la situazione dopo gli aggiornamenti software.

Conclusione

Una CSP utile non è semplicemente un'intestazione copiata da una lista di controllo. Ispeziona la configurazione attuale, individua dove è definita, esegui test in modalità Report-Only, risolvi i problemi specifici di compatibilità e solo allora applica una policy adeguata al tuo sito web. Gli amministratori di WordPress e Joomla possono iniziare dagli strumenti del CMS; gli sviluppatori possono intervenire tramite Apache, Nginx o PHP; e le piattaforme di hosting possono offrire controlli diretti sulle intestazioni.

La CSP riduce le opportunità di attacco, ma rimane uno dei vari livelli di difesa insieme a una programmazione sicura, agli aggiornamenti, all'autenticazione e al monitoraggio.