The CLI reference lists the commands by task. This page is generated from the development branch's help; run packslip verify --help for the options your installed version supports.

packslip verify

Verify a release bundle or release list, and downloaded files

Check the signature, the transparency log entry, and the statement. Each --artifact file is checked against its signed digest, and an artifact also against its signed size. Nothing is downloaded.

A github.com or gitlab.com project's name sets the policy. It requires the forge's issuer and a certificate whose source repository is the project's, or, if the certificate records none, a signer that is a workflow of the project's repository. A reusable workflow the project calls may therefore sign. --issuer, --identity, and --identity-prefix narrow that policy and never replace it. A domain project, one named after a host such as mytool.example.com, has no such policy, so pass --issuer with --identity, --identity-prefix, --source-repository, or --pin. --pubkey verifies a key-signed release instead. --source-repository and --pin add checks, and --allow-other-repository accepts a signer outside the project's repository, such as a repackager's.

Then check that the verified project and version are the ones you meant. A release list's expiry and sequence are not checked. See https://packslip.dev/docs/verifying/

Arguments

Flags

Trust

Output

Exit status

CodeMeaning
0The bundle verified, and every --artifact matched it
1Verification failed, or an input was unusable: a file could not be read, a key or fingerprint is malformed, or the trust flags conflict or are missing
2The command line is invalid

Examples

Verify a GitHub release and a downloaded artifact

packslip verify packslip.sigstore.json \
        --artifact mytool-1.2.3-linux-x64.tar.gz

Verify hk 2.8.0 against its signer fingerprint

packslip verify packslip.sigstore.json \
        --pin ps1_snirenkjwr7m5ozgcufameodnm \
        --artifact hk-x86_64-unknown-linux-gnu.tar.gz

Verify a release a repackager signed from its own repository

packslip verify packslip.sigstore.json \
        --issuer https://token.actions.githubusercontent.com \
        --identity-prefix https://github.com/repackager/mytool/ \
        --allow-other-repository

Verify a key-signed release

packslip verify packslip.sigstore.json \
        --pubkey release.pub \
        --artifact mytool-1.2.3-linux-x64.tar.gz