The deprecated HTTP Content-Security-Policy (CSP) report-uri
and the new HTTP Content-Security-Policy report-to
response header directive instructs the user agent to report attempts to violate the Content Security Policy. These violation reports consist of JSON documents sent via an HTTP POST request to the specified URI.
This Rust crate is an endpoint to receive those reports and send theme to an email address.
First, install using cargo:
cargo install morbo
Then, setup some environment variables:
MORBO_TO_NAME=Example
MORBO_TO_EMAIL=example@example.org
MORBO_SMTP_HOSTNAME=localhost
MORBO_SMTP_PORT=1025
MORBO_SMTP_USERNAME=
MORBO_SMTP_PASSWORD=
morbo --port=8080 # (port is optionnal, default 8080)
Then, setup a reverse proxy in your webserver. For example, in nginx:
location /_/csp-reports {
proxy_pass http://127.0.0.1:8080;
}
In the website you want to report CPS, set the following headers:
Report-To: {"group": "csp-endpoint","max_age": 10886400,"endpoints": [{ "url": "http://example.org/_/csp-reports" }]});
Content-Security-Policy: default-src 'self'; report-to csp-endpoint; report-uri http://example.org/_/csp-reports;');
Event though report-uri
is deprecated, report-to
is not supported in every browser.