Dove il tuo sito manda il rapporto se il browser blocca un file
Chrome 157 ha mandato due rapporti csp-violation su /report, in application/reports+json, e nessuno su report-uri. Lo script inline è rimasto spento.
In questa guida (3)
Se il browser del visitatore blocca uno script o un'immagine che la pagina del tuo sito prova a caricare, il rapporto di quel blocco può partire verso un indirizzo scritto nella risposta HTTP. Il nome di quell'indirizzo sta nell'header Reporting-Endpoints. L'ho provato il 15 novembre 2026 con Chrome 157.0.8103.52.
Il nome e l'indirizzo sono due pezzi
La scheda di Reporting-Endpoints, letta lo stesso giorno, descrive l'header come una mappa: un nome e un URL tra virgolette. L'esempio della scheda è Reporting-Endpoints: csp-endpoint="https://example.com/reports". Lo stesso nome si richiama nella direttiva report-to di Content-Security-Policy. La scheda scrive che gli endpoint non sicuri vengono ignorati. Un nome default è l'endpoint usato quando l'header che genera il rapporto non ha un modo proprio per indicarne uno.
Quali file la pagina può caricare sta in un'altra guida. Qui il punto è solo l'indirizzo a cui parte il rapporto.
Che cosa ha inviato Chrome in questa prova
Ho acceso un server HTTPS su 127.0.0.1 con un certificato creato per il test. Chrome 157.0.8103.52 era in modalità headless ed era istruito ad accettare quel certificato. Senza quell'eccezione un visitatore vedrebbe l'avviso del certificato e potrebbe non aprire la pagina. La risposta portava due header. Reporting-Endpoints assegnava il nome csp-endpoint all'URL https://127.0.0.1, con la porta del test e il percorso /report. Content-Security-Policy valeva default-src 'none', style-src 'unsafe-inline', report-to csp-endpoint, e anche report-uri verso lo stesso host sul percorso /report-uri.
La pagina conteneva uno script inline e un'immagine puntata a https://example.invalid/pixel.png. Chrome non ha eseguito lo script. Il server ha ricevuto due POST su /report, con content-type application/reports+json, e nessun POST su /report-uri.
Il primo corpo è un array JSON con un oggetto di type csp-violation. Nel body, blockedURL vale inline, disposition vale enforce, effectiveDirective vale script-src-elem, age vale 0. Il secondo POST ha blockedURL https://example.invalid/pixel.png, effectiveDirective img-src e age 4020. Nella raccomandazione Reporting il campo age è il numero di millisecondi tra la marca temporale del rapporto e l'invio. In entrambi i JSON lo user agent è HeadlessChrome/157.0.0.0. Il tipo di contenuto coincide con application/reports+json, indicato dalla stessa raccomandazione.
Che cosa il gestore del sito può ricavarne
L'indirizzo del rapporto è una scelta scritta nella risposta del sito. In questa sessione il browser ha usato il nome indicato in report-to. Con report-uri presente nello stesso header, questa build non ha scritto su /report-uri. La raccomandazione dice anche che l'agente può rifiutare un rapporto per qualsiasi motivo e che la consegna non è garantita. Due arrivi su questo programma non diventano una promessa per ogni visitatore.
I due JSON contengono l'URL del documento, la direttiva e l'indirizzo bloccato. Il campo sample, in entrambi, è vuoto. Se l'endpoint sta su un altro dominio, quel dominio riceve l'indirizzo della pagina e l'indirizzo bloccato. Va tenuto con la stessa cura di un registro. Non ho provato un endpoint http, un altro browser o un sito già pubblicato.
L'immagine è un fascio di cavi Ethernet, 19 gennaio 2011, foto di Raysonho, scheda Wikimedia, licenza CC0. È un altro apparato, non il server della prova.


