Guilherme Dumas Peres

<p>CSP Violation Reporter adds a public WordPress REST endpoint for browser Content Security Policy violation reports and stores received violations in a local database table.</p>
<p>Reports can be reviewed from Tools > CSP Violations. The plugin supports the modern Reporting API payload format as well as the older <code>csp-report</code> JSON shape.</p>
<p>Endpoint:</p>
<pre><code>/wp-json/csp-violation-reporter/v1/report
</code></pre>
<p>The plugin does not create or modify Content Security Policy headers. Site owners should configure CSP headers in their web server, hosting dashboard, theme, or security tooling.</p>
<p>Example report endpoint configuration:</p>
<pre><code>Content-Security-Policy: default-src 'self'; report-uri https://example.com/wp-json/csp-violation-reporter/v1/report
</code></pre>
<p>For the modern Reporting API, use an HTTPS endpoint:</p>
<pre><code>Reporting-Endpoints: csp-endpoint="https://example.com/wp-json/csp-violation-reporter/v1/report"

Content-Security-Policy: default-src 'self'; report-to csp-endpoint
</code></pre>
<h3>Privacy</h3>
<p>This plugin stores CSP violation reports submitted by browsers. Stored fields can include the document URL, referrer URL, blocked URI, violated directive, source file, line and column numbers, a user agent string, a salted hash of the remote address, and the raw report payload.</p>
<p>The plugin does not store raw IP addresses and does not transmit report data to external services.</p>


CSP Violation Reporter

Collect Content Security Policy violation reports through a WordPress REST endpoint and review them in the admin dashboard.

Giuseppe

<p>Content Security Policy (CSP) is a computer security standard introduced to prevent cross-site scripting (XSS), clickjacking and other code injection attacks resulting from execution of malicious content in the trusted web page context.<br />
Cross-site scripting (XSS) is a type of security vulnerability that can be found in some web applications.<br />
XSS attacks enable attackers to inject client-side scripts into web pages viewed by other users.<br />
A cross-site scripting vulnerability may be used by attackers to bypass access controls like the same-origin policy.<br />
Looking at National Vulnerability Database run by US NIST, <em>more than 1100 (November 2025) vulnerabilities</em> are reported as <a href="https://nvd.nist.gov/vuln/search#/nvd/home?vulnRevisionStatusList=published&keyword=XSS%20Wordpress&resultType=records" rel="nofollow ugc">XSS for WordPress’ plugins and themes</a>.</p>
<p><em>Keeping your site up-to-date</em> with the latest versions of plugins and themes is the <strong>first</strong> line of defense to ensure your site’s security.</p>
<p>The second thing to do, is to <strong>deploy a strict Content Security Policy</strong>.</p>
<h3>The main problem</h3>
<p>The main problem with Content Security Policies implemented in the real world is that <a href="https://research.google/pubs/pub45542/" rel="nofollow ugc">they are too weak to really protect your site</a> and that many of them can be trivially bypassed by an attacker.</p>
<h3>The proposed solution</h3>
<p>Google researchers recommend, instead of whole host whitelisting, to activate individual scripts via a CSP nonces approach.<br />
In addition, in order to facilitate the adoption of nonce-based CSP, they proposed the ’strict-dynamic’ keyword.</p>
<h3>The problem(s) with CSP in WordPress</h3>
<ol>
<li>
<p>Manual creation of a policy</p>
<p>Usually, a WordPress project is a mix of code written by different authors who contributed to the Core and or wrote plugins and themes.<br />
If it is possible to whitelist every external script loaded from a <code><script src=""></code>, the real truth is that in a WordPress project you can have dozens of those scripts included with your plugins and calculate a cryptographic hash for each of them to be included in your CSP header can be a frustrating job. However, there are many browser extensions and WordPress’ plugins that can help you in this job.</p>
</li>
<li>
<p>Inline scripts</p>
<p>WordPress core, and plugins, use inline scripts. For these scripts, you can compute hashes to be inserted manually into your policy, only if these scripts do not change at any page load. Unfortunately, this is not very common, as it is frequent to include variable values calculated server side in inline scripts. And it means that your inline scripts change too frequently to manually add their hashes to your policy.<br />
This commonly happens when scripts are <a href="https://github.com/WordPress/WordPress/blob/a793be201b9c23dbe8b90a6ecd53ab52336f0f91/wp-includes/script-loader.php#L636" rel="nofollow ugc">“localized”</a>.</p>
</li>
<li>
<p>WordPress has no API to implement nonces for CSP</p>
<p>Even if it is easy to generate a nonce for each page view, this nonce has to be inserted in every script tag used to embed inline scripts in your page as</p>
<pre><code><script nonce="rAnd0m">
    doWhatever();
</script>
</code></pre>
<p>and in your script-src directive:</p>
<pre><code>script-src 'nonce-rAnd0m';
</code></pre>
<p>And, of course, a nonce must be unique for each HTTP response.</p>
</li>
<li>
<p>Unsafe hashes / Inline styles</p>
<p>Sometimes, HTML elements as images or buttons use HTML Event Attributes (onclick, onsubmit…) to let events trigger actions in a browser.<br />
You cannot use hashes or nonces for script included in event attributes and, adopting a strict CSP, requires refactoring those patterns into safer alternatives or to use ‘unsafe-hashes’.<br />
You got a similar problem when inline styles are used in HTML tags:</p>
<pre><code><h1 style="color:blue;text-align:center;">This is a heading</h1>
<p style="color:red;">This is a paragraph.</p>
</code></pre>
<p>CSP Level 2 browsers may be ok with just putting the hash in your style-src directive. However, to allow hashes in the style attribute on inline CSS on browsers that support CSP Level 3, you may get an error like this</p>
<pre><code>    Refused to apply inline style because it violates the following Content Security Policy directive: "style-src 'self' 'sha256-nMxMqdZhkHxz5vAuW/PAoLvECzzsmeAxD/BNwG15HuA='". Either the 'unsafe-inline' keyword, a hash ('sha256-nMxMqdZhkHxz5vAuW/PAoLvECzzsmeAxD/BNwG15HuA='), or a nonce ('nonce-...') is required to enable inline execution.
</code></pre>
<p>To allow inline styles you need to use ‘unsafe-hashes’ in your style-src directive (that is, in facts, unsafe).<br />
^</p>
</li>
</ol>
<h3>This plugin approach</h3>
<p>This plugin affords those problems in this way:</p>
<ol>
<li>During a capture phase, it detects the scripts, styles and other embedded content present in the pages of your site and stores them in the database.</li>
<li>Then you have to whitelist these contents from plugin admin.</li>
<li>The plugin uses machine learning to cluster inline scripts trying to aggregate scripts generated by the same server side (PHP) code. So, you can authorize one script example to authorize all scripts that the classifier predicts to label as whitelisted clusters.</li>
<li>You can choose to use hashes to authorize external scripts (and the plugin will allow you to include Subresource Integrity in your <code><script></code> and <code><link></code>)</li>
<li>You can use hashes or nonces to authorize inline scripts.</li>
<li>You can ask the plugin to refactor your page to not use event attributes (converted in a inline script) and inline styles (converted in an internal CSS).</li>
<li>You can set one or more violations’ report endpoints.</li>
</ol>
<p>The plugin supports multisite installations and has (too) many options documented in inline help.</p>
<h3>Creating a Content Security Policy</h3>
<p>After plugin activation, go to Settings menu and search for CSP Settings submenu.<br />
The steps you are supposed to do are the following.</p>
<ol>
<li>From the Tools tab, activate the capture of the tags and use your site by visiting all the pages or having your users visit them for a long time long period based on the use of your site (hours or days).</li>
<li>From the Tools tab, perform the data clustering in the database (it can use many server resources).</li>
<li>Go to the Base rules tab and include in the CSP directives the desired values ​​(help you with the table at the bottom of the page).</li>
<li>Go to the external scripts tab, inline scripts tab and scripts invoked by event handlers tab and authorize the execution of all the legitimate scripts present on the pages of your site.</li>
<li>Leaving the tag capture active, activate the policy test (at this stage the plugin will generate some violations of the temporary policy used to record additional values to be included in the directives of your “content security policy”).</li>
<li>After visiting again your site pages, disable the capture of the tags and repeat the previous steps 2, 3 and 4.</li>
<li>Enable site protection.</li>
</ol>
<p>N.B. When you update plugins or themes, if something doesn’t work properly on your site pages, temporarily deactivate the protection and repeat steps 1 to 7.</p>
<h3>Plugin hooks</h3>
<h4>Filters</h4>
<ul>
<li><a href="https://github.com/MocioF/No-unsafe-inline/blob/d068711d56c2d7b228b524f640f5e13af3327097/public/class-no-unsafe-inline-public.php#L419" rel="nofollow ugc">nunil_output_csp_headers_header_csp</a><br />
nunil_output_csp_headers_header_csp is available since version 1.2.3 and can be used to modify the Content-Security-Policy header before it is sent to browser</li>
<li>
<p><a href="https://github.com/MocioF/No-unsafe-inline/blob/d068711d56c2d7b228b524f640f5e13af3327097/src/Nunil_Manipulate_DOM.php#L930" rel="nofollow ugc">no_unsafe_inline_not_sri_sources</a><br />
no_unsafe_inline_not_sri_sources can be used to modify the list of external resources that do not support SRI (Subresource Integrity)</p>
</li>
<li>
<p><a href="https://github.com/MocioF/No-unsafe-inline/blob/d068711d56c2d7b228b524f640f5e13af3327097/mu-plugin/no-unsafe-inline-output-buffering.php#L100" rel="nofollow ugc">no_unsafe_inline_final_output</a><br />
no_unsafe_inline_final_output is an internal filter used to manipulate the output of the WordPress process just before the output is sent to the browser.</p>
</li>
<li><a href="https://github.com/MocioF/No-unsafe-inline/blob/d068711d56c2d7b228b524f640f5e13af3327097/mu-plugin/no-unsafe-inline-output-buffering.php#L107" rel="nofollow ugc">no_unsafe_inline_meta_injector</a><br />
no_unsafe_inline_meta_injector is an internal filter hook used to inject meta http-equiv=”Content-Security-Policy” if variable is set</li>
</ul>
<h4>Actions</h4>
<ul>
<li>
<p><a href="https://github.com/MocioF/No-unsafe-inline/blob/d068711d56c2d7b228b524f640f5e13af3327097/includes/class-no-unsafe-inline.php#L213-L217" rel="nofollow ugc">nunil_upgrade</a> Functions hooked on nunil_upgrade will run when the plugin is upgraded</p>
</li>
<li>
<p><a href="https://github.com/MocioF/No-unsafe-inline/blob/d068711d56c2d7b228b524f640f5e13af3327097/includes/class-no-unsafe-inline.php#L254" rel="nofollow ugc">nunil_output_csp_headers</a> Functions hooked to nunil_output_csp_headers will run when the plugin output the CSP HTTP response header</p>
</li>
</ul>
<h3>Code and libraries</h3>
<p>This version of the plugin uses:<br />
* to parse HTML:<br />
  * <a href="https://github.com/ivopetkov/html5-dom-document-php" rel="nofollow ugc">ivopetkov/HTML5DOMDocument</a> on PHP<8.4 and libxml<=2.13.09<br />
  * <a href="https://github.com/Masterminds/html5-php" rel="nofollow ugc">Masterminds\HTML5</a> on PHP<8.4 and libxml>2.13.09<br />
  * <a href="https://www.php.net/manual/en/migration84.new-features.php#migration84.new-features.dom" rel="nofollow ugc">\Dom\HTMLDocument</a>: The new ext-dom features with HTML5 support on PHP>8.4<br />
* <a href="https://rubixml.com/" rel="nofollow ugc">RubixML</a> for machine learning <strong><em>from version 1.1.0</em></strong> – <em><a href="https://php-ml.readthedocs.io/en/latest/" rel="nofollow ugc">PHP-ML</a> was used in versions 1.0.x</em>;<br />
* <a href="https://github.com/opctim/php-nilsimsa" rel="nofollow ugc">opctim/php-nilsimsa</a> to calculate and compare Nilsimsa digests.</p>
<p>The log functions have been taken from<br />
* <a href="https://github.com/perfectyorg/perfecty-push-wp" rel="nofollow ugc">perfectyorg/perfecty-push-wp</a>, <strong><em>something you should <a href="https://wordpress.org/plugins/perfecty-push-notifications/" rel="ugc">really try</a> if you want to implement web Push notifications in your site.</em></strong></p>
<p>The <strong>complete list of dependencies</strong> used in this plugin can be seen in <a href="https://github.com/MocioF/No-unsafe-inline/network/dependencies" rel="nofollow ugc">dependency graph</a> on GitHub.</p>
<h3>Contributions, Issues, Bugs</h3>
<p>Plugin code is hosted on a public repository on <a href="https://github.com/MocioF/No-unsafe-inline" rel="nofollow ugc">GitHub</a>.<br />
Reach me over there to help and suggest.</p>


No unsafe-inline

No unsafe-inline helps you to build a Content Security Policy avoiding to use 'unsafe-inline' and 'unsafe-hashes'.

CSP Violation Reporter vs No unsafe-inline