mirror of
https://github.com/aquasecurity/trivy.git
synced 2025-12-12 07:40:48 -08:00
docs: update binary signature verification for sigstore bundles (#9929)
This commit is contained in:
@@ -26,16 +26,26 @@ The following checks were performed on each of these signatures:
|
|||||||
|
|
||||||
## Verifying binary
|
## Verifying binary
|
||||||
|
|
||||||
Download the required tarball, associated signature and certificate files from the [GitHub Release](https://github.com/aquasecurity/trivy/releases).
|
Since Trivy v0.68.1, GitHub Releases provide [sigstore signature bundles](https://docs.sigstore.dev/cosign/bundle/). Separate `.sig` and certificate (`.pem`) files are no longer published.
|
||||||
|
|
||||||
|
Download the required tarball and its associated `.sigstore.json` bundle file from the [GitHub Release](https://github.com/aquasecurity/trivy/releases).
|
||||||
|
|
||||||
Use the following command for keyless verification:
|
Use the following command for keyless verification:
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
cosign verify-blob <path to binary> \
|
cosign verify-blob-attestation <path to tarball> \
|
||||||
--certificate <path to cert> \
|
--bundle <path to tarball>.sigstore.json \
|
||||||
--signature <path to sig> \
|
--certificate-oidc-issuer=https://token.actions.githubusercontent.com \
|
||||||
--certificate-identity-regexp 'https://github\.com/aquasecurity/trivy/\.github/workflows/.+' \
|
--certificate-identity 'https://github.com/aquasecurity/trivy/.github/workflows/reusable-release.yaml@refs/tags/<release tag>'
|
||||||
--certificate-oidc-issuer "https://token.actions.githubusercontent.com"
|
```
|
||||||
|
|
||||||
|
Example for `trivy_0.68.1_Linux-64bit.tar.gz`:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
cosign verify-blob-attestation trivy_0.68.1_Linux-64bit.tar.gz \
|
||||||
|
--bundle trivy_0.68.1_Linux-64bit.tar.gz.sigstore.json \
|
||||||
|
--certificate-oidc-issuer=https://token.actions.githubusercontent.com \
|
||||||
|
--certificate-identity 'https://github.com/aquasecurity/trivy/.github/workflows/reusable-release.yaml@refs/tags/v0.68.1'
|
||||||
```
|
```
|
||||||
|
|
||||||
You should get the following output
|
You should get the following output
|
||||||
|
|||||||
Reference in New Issue
Block a user