auths-dev/Verify with Auths

Verify cryptographic commit and artifact signatures on every PR using Auths identity keys.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jun 20, 2026
License
None

Pinned Snippet

workflow.ymlSHA-pinned
uses: auths-dev/verify@c7bee200ff881005bd13bd67f514b57edbfd0500 # v1.4.2

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
identity-bundleIdentity bundle for stateless verification. Accepts: identity bundle JSON, CI token JSON, or a file path to a bundle (e.g. .auths/ci-bundle.json). Leave empty for KEL-native verification against the local identity store. Generate one with `auths id export-bundle`.no""
commitsGit commit range to verify (defaults to PR commits or push commits)no""
auths-versionAuths CLI version to pin (e.g. "0.1.3"). Required unless `auths` is already on PATH — a verification action must not resolve `latest` (supply-chain hardening). The pinned release must publish a `.sha256` checksum.no""
fail-on-unsignedWhether to fail the action if unsigned commits are foundnotrue
skip-merge-commitsWhether to skip merge commits during verificationnotrue
post-pr-commentPost a PR comment with verification results and fix instructions (requires pull-requests: write)nofalse
github-tokenGitHub token used to post the PR comment (required when post-pr-comment is true)no""
filesGlob patterns for artifact files to verify, one per line (e.g., "dist/*.tar.gz")no""
artifact-attestation-dirDirectory containing .auths.json attestation files (default: alongside artifacts)no""
fail-on-unattestedFail the action if any artifact lacks a valid attestationnotrue
namedescription
verifiedWhether all commits were verified successfully
resultsJSON array of per-commit verification results
totalTotal number of commits checked
passedNumber of commits that passed verification
failedNumber of commits that failed verification
artifacts-verifiedWhether all artifacts were verified (true/false)
artifact-resultsJSON array of per-artifact verification results