Supply chain: SBOM, scanning and signatures

Every release (a v* tag) is built by GitHub Actions (.github/workflows/release.yml), not on a laptop, so anyone can see exactly how it was made.

What a release contains

Item Where
Container image ghcr.io/thefirstterminal/sentinel:<version> (and :latest)
Binaries (Linux amd64/arm64, Windows, macOS arm64) GitHub release
checksums.txt GitHub release (SHA-256 of every binary)
SBOM (SPDX JSON): every package inside the image GitHub release, and attached to the image once signing is on
Build provenance (how and from which commit the image was built) Attached to the image by Docker Buildx

Checks before publishing

  1. govulncheck checks the Go code and its dependencies for known vulnerabilities. It reports only the ones Sentinel actually calls, so it doesn’t raise false alarms.
  2. The SBOM is generated from the finished image (Syft).
  3. Grype scans the SBOM. A critical vulnerability stops the release.

CI also runs govulncheck on every push, as a report.

Signatures (Sigstore / cosign)

Signing is keyless: GitHub Actions proves its identity to Sigstore, gets a short-lived certificate for “this repository’s release workflow”, and signs with it. There are no signing keys to steal or lose.

Signing records the repository name in Sigstore’s public transparency log. So while the repository is private, the workflow skips signing. It turns on by itself when the repository is made public.

Verifying (once signed)

# The image was built by this repository's release workflow:
cosign verify ghcr.io/thefirstterminal/sentinel:<version> \
  --certificate-identity-regexp '^https://github.com/TheFirstTerminal/sentinel/.github/workflows/release.yml@refs/tags/v' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

# Its SBOM:
cosign verify-attestation --type spdxjson ghcr.io/thefirstterminal/sentinel:<version> \
  --certificate-identity-regexp '^https://github.com/TheFirstTerminal/sentinel/' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

# A downloaded binary:
cosign verify-blob checksums.txt --bundle checksums.txt.sigstore.json \
  --certificate-identity-regexp '^https://github.com/TheFirstTerminal/sentinel/' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com
sha256sum --check --ignore-missing checksums.txt

Releases up to 0.16.1 were built before the repository moved to the TheFirstTerminal organization: their images are ghcr.io/tsxmamii/sentinel and their signatures name https://github.com/tsxmamii/sentinel/, so use that in the regexps above to verify them.

Making a release

git tag -a v0.11.0 -m "Sentinel v0.11.0"
git push origin v0.11.0

Then watch the Actions tab. The binaries, checksums, SBOM and license files appear on the release, and the image at ghcr.io/thefirstterminal/sentinel. The first time, open the package’s settings on GitHub and make it public (new packages start private).


Sentinel Free, © 2026 Saif Zahid. PolyForm Shield 1.0.0.