What is it?
preflight helps you verify scripts and executables to mitigate chain of supply attacks such as the recent Codecov hack.
First of all, it's the chicken and the egg. How do you pull a legit
preflight binary from us without verifying it with
preflight? having that
preflight is solving this exact problem?
The best way, is that you grab the source, compile it yourself, and use your own binary which you put in a place that you trust. People usually have several options of how to do that safely:
- Put it on your own S3 bucket
- Drop it on your own Artifactory or similar
- Push it directly into your repos (it should be as small as 4mb, and almost never change so, Git should work nicely with it)
If you want to just get started quickly on your workstation, you can download a release or install
preflight with homebrew:
$ brew tap spectralops/tap && brew install preflight
Someone changed the script or binary you're running. Abort!
$ curl -L https://XXX | preflight run sha256=1ce...2244a6e86 ⌛️ Preflight starting ❌ Preflight failed: Digest does not match. Expected: <...> Actual: <...> Information: It is recommended to inspect the modified file contents.
A hash is verified, but it is actually vulnerable. Abort!
$ curl -L https://XXX | preflight run sha256=1ce...2244a6e86 ⌛️ Preflight starting using file lookup: malshare.current.sha256.txt ❌ Preflight failed: Digest matches but marked as vulnerable. Digest matches but marked as vulnerable. Information: Vulnerability: Hash was found in a vulnerable digest list More: malshare.current.sha256.txt
All ok, let's fly.
$ curl -L https://XXX | preflight run sha256=1ce...2244a6e86 ⌛️ Preflight starting ✅ Preflight verified ... actual script output ...
Running codecov safely in your CI
First, let's create a hash (before creating it, review the script manually and see that it's not doing anything funny):
$ curl -s https://codecov.io/bash | ./preflight create sha256=d6aa3207c4908d123bd8af62ec0538e3f2b9f257c3de62fad4e29cd3b59b41d9
Now, we're going to take
And use this to secure our pulls from Codecov. In this case,
preflight is checked safely into your repo under
steps: - curl -s https://codecov.io/bash | sh
AFTER (safe, yay!):
steps: - curl -s https://codecov.io/bash | ./ci/preflight run sha256=d6aa3207c4908d123bd8af62ec0538e3f2b9f257c3de62fad4e29cd3b59b41d9
Running scripts and binaries
$ curl -s https://example.com/some-script | preflight run sha256=d6aa3207c4<...>b4
$ preflight run sha256=d6aa3207c4<...>b4 ./my-script.sh
Checking scripts and binaries
$ curl -s https://example.com/some-script | preflight check sha256=d6aa3207c4<...>b4 | sh
preflight check is built in a way that you could continue to pipe to the next process:
- If a check passes, the checked script or binary content will be dumped to
- If a check fails, you'll get an
exit(1), and an error message
$ preflight check sha256=d6aa3207c4<...>b4 ./my-script.sh
In this case:
- If a check passes, you'll get an
exit(0)and no output (so you can compose with other tooling)
- If a check fails, you'll get an
exit(1)and an error message
Creating new hashes
You can easily create new hashes with
preflight. The default is a SHA256 hash, but you could also create a
$ preflight create test.sh sha256=fe6d02cf15642ff8d5f61cad6d636a62fd46a5e5a49c06733fece838f5fa9d85
Though not recommended, you can create other kinds (weaker kinds) of hashes for legacy/compatibility reasons:
$ preflight create test.sh --digest md5 md5=cb62874fea06458b2b0cabf2322c9d55
Using optional malware lookup
preflight comes with lookup providers, which is optional -- you can enable them by using environment variables:
With this configured
preflight will search for all digest types in this file before approving.
Here is a full example for your CI, combining
preflight with Malshare:
env: PF_FILE_LOOKUP: malshare.current.sha256.txt steps: - wget https://www.malshare.com/daily/malshare.current.sha256.txt - curl https://... | preflight <sha>
$ PF_FILE_LOOKUP=malshare.current.sha256.txt preflight run fe6d02cf15642ff8d5f61cad6d636a62fd46a5e5a49c06733fece838f5fa9d85 test.sh ⌛️ Preflight starting using file lookup: malshare.current.sha256.txt ❌ Preflight failed: Digest matches but marked as vulnerable. Information: Vulnerability: Hash was found in a vulnerable digest list More: malshare.current.sha256.txt
Other lookup types?
We've established that a file lookup is universal and general enough to be useful to everyone. However, you might prefer your own vendor, or a service such as VirusTotal --
preflight's architecture is pluggable and we're accepting pull requests.
To all Contributors - you make this happen, thanks!