diff --git a/docs/getting-started/signature-verification.md b/docs/getting-started/signature-verification.md index d805106b39..ea76b72f3c 100644 --- a/docs/getting-started/signature-verification.md +++ b/docs/getting-started/signature-verification.md @@ -26,16 +26,26 @@ The following checks were performed on each of these signatures: ## 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: ```shell -cosign verify-blob \ ---certificate \ ---signature \ ---certificate-identity-regexp 'https://github\.com/aquasecurity/trivy/\.github/workflows/.+' \ ---certificate-oidc-issuer "https://token.actions.githubusercontent.com" +cosign verify-blob-attestation \ + --bundle .sigstore.json \ + --certificate-oidc-issuer=https://token.actions.githubusercontent.com \ + --certificate-identity 'https://github.com/aquasecurity/trivy/.github/workflows/reusable-release.yaml@refs/tags/' +``` + +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