4.8 KiB
outputs | title | date | description | |
---|---|---|---|---|
|
CSP bug reproduction | 2022-11-10T18:05:00-08:00 | A demonstration page to help diagnose Content-Security-Policy issues in browser software. |
If you're on this page, chances are you followed a link from a Content-Security-Policy (CSP)-related bug report. This page should help diagnose the offending part of the CSP.
I made this page because [I noticed my site breaking browser software]({{<relref "/notes/things-my-site-breaks.md">}}), and wanted to fix said software.
What this page demonstrates
This is a test page that demonstrates the following Content-Security-Policy (CSP):
default-src 'none' 'report-sample';img-src 'self';style-src 'sha256-7cS8Hu9ov7dRhfioeeb9J8mtB9/iLLpVIZsMM+BJUcs=' 'report-sample';frame-ancestors 'none';base-uri 'none';form-action https://seirdy.one/webmentions/receive https://seirdy.one/search/;manifest-src 'self';sandbox allow-same-origin allow-scripts allow-forms;report-uri https://collector.seirdy.one;connect-src https://collector.seirdy.one
Here's a multi-line version, to reduce horizontal scrolling:
default-src 'none' 'report-sample';
img-src 'self';
style-src 'sha256-HASH' 'report-sample';
frame-ancestors 'none';
base-uri 'none';
form-action https://seirdy.one/webmentions/receive https://seirdy.one/search/;
manifest-src 'self';
sandbox allow-same-origin allow-scripts allow-forms;
report-uri https://collector.seirdy.one;
connect-src https://collector.seirdy.one
How to use this page
All pages on my site contain a strict CSP. Most pages on my site have a CSP containing a sandbox
directive that does not specify the allow-scripts
parameter. Here's the CSP for most of my other pages, such as my homepage:
default-src 'none';
img-src 'self';
style-src 'sha256-HASH';
frame-ancestors 'none';
base-uri 'none';
form-action https://seirdy.one/webmentions/receive https://seirdy.one/search/;
manifest-src 'self';
upgrade-insecure-requests;
sandbox allow-same-origin allow-forms
This page has a CSP that differs in three ways:
- It includes a reporting endpoint
- It specifies an
allow-scripts
parameter on itssandbox
directive - It removes
upgrade-insecure-requests
.1
Additionally, I have a 404 page that includes a blank sandbox
directive (i.e., it has no parameters such as allow-same-origin
).
Some browser software breaks upon encountering strict CSPs. It's difficult to pinpoint whether the offending CSP directive is a fetch directive (default-src
, script-src
, style-src
, etc.), or if it's the sandbox
directive without allow-scripts
.
Try reproducing the bug on the following pages:
- This page's canonical location
- This page again, but with a
sandbox
query parameter - My homepage
- My 404 page
Note the following:
-
If you can reproduce the bug on all four pages: the offending directive is probably a fetch directive.
-
If you can reproduce the bug on all pages except the second (this page with the query parameter): the offending directive is probably a
sandbox
directive, even if it containsallow-same-origin
andallow-scripts
. -
If you can not reproduce the bug on this page, but can reproduce the bug on my homepage and my 404 page: the offending directive is a
sandbox
directive that blocks scripts (noallow-scripts
present). -
If you can only reproduce the bug on my 404 page: the offending directive is
sandbox
withoutallow-same-origin
.
Other places to test
Here are some more sites with very strict CSPs containing sandbox
directives:
If you feel the need to regularly test a specific CSP, I recommend using netcat. In a UNIX-like environment, save this to an executable file and run it:
#!/bin/sh
set -e -u
while true; do echo "\
HTTP/1.1 200 OK
Content-Type: text/html;charset=UTF-8
Content-Security-Policy: default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'; upgrade-insecure-requests; sandbox
<!DOCTYPE html>
<html><body>poggers</body></html>\
" | nc -l 8000; done
You'll get a plain page with the specified CSP on port 8000. Edit as you see fit.
-
I removed
upgrade-insecure-requests
so that my Tor onion service could have the same CSP as this page. The onion service does not support TLS: TLS on onion services is redundant, and no certificate authority offers free .onion certificates. ↩︎