broccoli-sri-hash
v2.1.2
Published
Generates SRI hashes for html files
Downloads
381,928
Keywords
Readme
SRI for broccoli
This plugin looks at an apps html files to rewrite their content with integrity attributes.
Options
- origin - if
crossorigin
isn't specified butprepend
is it will add an integrity ifprepend
starts withorigin
- crossorigin - adds a crossorigin attribute to script and link elements
- This is required for CORS resources values are:
use-credentials
anonymous
- This is required for CORS resources values are:
- prepend - resources with a full path will only get an applied integrity if the md5 checksum passes
- paranoiaCheck - false by default, if enabled turns off the integrity attribute if any Unicode is found within the file
- fingerprintCheck - true by default, if enabled validates the computed md5 checksum against the fingerprint
Example
var sriTree = sri('path/to/code', {
prefix: 'https://example.com/',
crossorigin: 'anonymous'
});
'paranoiaCheck'
There was an encoding issue based on certain characters which is landed in Chrome 46 when using Chrome. This check fails if there is any non ASCII characters. On failure the file won't have a integrity attribute added. Please note this will be removed as a default in the future; with the desire to remove all of the checking code too.
'fingerprintCheck'
If your assets change between the time they are fingerprinted and the time they are processed for SRI, you most likely want to disable this check. The canonical example is if an asset contains a link to a secondary asset and is rewritten to adjust the link after fingerprinting the second asset, rendering the fingerprint invalid (for anything more than a useful unique identifier).