Content Security Policy (CSP)
Quick Reference Guide

Using a hash with CSP

A hash of a script or style can be used to allow it .

CSP Hash Example

Using a hash is one way to allow the execution of inline scripts in a Content Security Policy (CSP). Here's how one might use it with the CSP with JavaScript:

Suppose we have the following script on our page:


If you compute the SHA-256 hash of our entire JavaScript code block, in our case it is just: doSomething(); you will get the value:


Finally we can add the hash to our script-src directive to allow it to execute via our Content-Security-Policy header:

script-src 'sha256-RFWPLDbv2BY+rCkDzsE+0fr8ylGr2R2faWMhq4lfEQc=';

What CSP hash algorithms are supported?

The CSP Level 2 specification allows sha256, sha384, and sha512

How do you generate the hash?

The easiest way to generate it is to just open the developer tools console and it will output what the expected hash of your script was in the console error message.

You can also use tools such as openssl to generate it, whitespace is not ignored.

Here is an example using openssl, which will be installed by default on most mac or linux systems:

echo -n 'doSomething();' | openssl sha256 -binary | openssl base64

Why is my CSP Hash Not Working?

There are a three common reasons your CSP hash might not be working:

  1. You are missing the single quotes around the hash. If your CSP Header looks like this: script-src sha256-abc123; you need to wrap it in single quotes, for example: script-src 'sha256-abc123';
  2. The hash is not valid.
    • You or someone changed your javascript code making the hash invalid. You have to generate a new hash for the updated script. If the script will change a lot consider if using a CSP nonce is a better approach.
    • Removing or adding whitespace will cause the hash to become invalid.
    • Code Reformatting - causing addition of whitespace or newlines
    • CDN - for example CloudFlare might be optimizing your HTML removing whitespace inside your script tags causing the hash to become invalid. You can work around this by removing all the space in the script ahead of time.
  3. Your browser doesn't support CSP Level 2. This is becoming less common now, as browser support for CSP level 2 is more common than not. Give our CSP Browser Test a try to double check.

CSP Hash Browser Support

The hash source list directive was added to CSP Level 2. This means that support has existed since 2015 in Chrome and Firefox, Safari 10+ or Edge 15+.

It is not supported at all in Internet Explorer, you need to use the Edge browser instead.

CSP Developer Field Guide

CSP Developer Field Guide

Want to learn the ins and outs CSP? Grab a copy of the CSP Developer Field Guide. It's a short and sweet guide to help developers get up to speed quickly.

Grab a Copy

Struggling to stay on top of security advisories?

Advisory Week is a weekly roundup of all the security advisories published by the major software vendors.