Scripts to generate SRI hashes via POSIX shell and PowerShell.

Go to file

Asif Bacchus 87cd22f1a4 add checksum for posix-script		2020-06-22 00:30:12 -06:00
.vscode	handle null directory parameter	2020-06-20 03:39:03 -06:00
.gitattributes	initial commit	2020-06-20 00:51:54 -06:00
.gitignore	ignore files in test directory	2020-06-20 03:08:56 -06:00
README.md	add TOC to readme	2020-06-20 09:08:05 -06:00
sri	update embedded help	2020-06-20 04:58:30 -06:00
sri.ps1	sign POSH	2020-06-22 00:23:50 -06:00
sri.sha256	add checksum for posix-script	2020-06-22 00:30:12 -06:00

README.md

Sub-Resource Integrity Hash Generator Scripts

Basic scripts to generate SRI hashes. POSIX-compliant shell script for use on *nix and PowerShell for use on Windows.

common features
Linux script
- copy to path location
- troubleshooting
PowerShell (POSH) script
- execution policy
final thoughts

common features

Hash individual files or a list of files.
Hash all files within a specified directory with one command.
Hash a filtered-list of files within a directory with one command.
Process a list of files and a directory (filtered or not) at the same time, saving you typing!

Linux script

This script requires openssl be installed and will exit if it cannot find openssl.
You can rename sri to anything you like.
I suggest copying sri somewhere like /usr/local/bin or /usr/bin so it can be run easier and from anywhere (see note below).
Complete instructions are included in the script. Simply run without any parameters or run with '--help'.
```
./sri --help
```

copy to path location

Copying the script to a location within your path makes running it more convenient. For example:

Assuming you store it in your home directory /Downloads and need to hash files in your webroot (eg: /var/www/css/...)

~/SRIhelper/sri -f /var/www/css/style.css

Whereas, if it's in your path, you can omit the source path and just run

sri -f /var/www/css/style.css

To make this work, just copy the file to a location in your path. There are no dependencies or anything to worry about, the file is self-contained and POSIX compliant.

# copy to local/bin
cp ~/SRIhelper/sri /usr/local/bin/sri
# copy and rename to something else
cp ~/SRIhelper/sri /usr/local/bin/hashSRI
# copy to your global bin directory (usually local is preferred!)
cp ~/SRIhelper/sri /usr/bin/sri

troubleshooting

About the only thing that can go wrong is the script not being marked executable. In that case, simply make it executable:

# make executable
chmod +x /path/to/sri
# verify
ls -lA /path/to/sri
# output something like:
# -rwxr-xr-x 1 user user 3622 Jun 20 01:18 sri
# note the x's --> -rwXr-Xr-X (capitals for emphasis)

PowerShell (POSH) script

You can rename this script to anything you want.
I suggest copying this script to a simple path since you must execute POSH scripts using their full path.

Complete instructions are included in the script. Run Get-Help as you would with any other POSH script.

Get-Help .\sri.ps1  # basic help including syntax
Get-Help .\sri.ps1 -examples  # detailed examples of script usage
Get-Help .\sri.ps1 -detailed   # full help document

execution policy

By default, Windows does not permit running any POSH scripts. You can change this behaviour by opening PowerShell as an administrator and entering the following command:

Set-ExecutionPolicy RemoteSigned

This will allow scripts created on your machine to run as well an as signed scripts created on other machines. My script is signed, so it should run without any problems. This setting is far safer than bypassing the execution policy.

You can search for alternate bypass methods, but I have not included them here since switching to RemoteSigned is the technically correct approach.

final thoughts

I hope these scripts help you out! If you have any comments, suggestions or improvements, please file an issue. I love getting feedback and learning new ways of doing things. For more scripts like this or solutions to common computing annoyances, check out my blog at MyTechieThoughts.com.