Skip to content

Commit 3851371

Browse files
docs: update signature verification for deb and rpm packages (aquasecurity#10784)
Co-authored-by: DmitriyLewen <dmitriy.lewen@smartforce.io>
1 parent dccb128 commit 3851371

1 file changed

Lines changed: 15 additions & 10 deletions

File tree

docs/getting-started/signature-verification.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -24,36 +24,41 @@ The following checks were performed on each of these signatures:
2424
....
2525
```
2626

27-
## Verifying binary
27+
## Verifying release assets
2828

29-
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.
29+
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. Every release asset has a corresponding `.sigstore.json` bundle file.
3030

31-
Download the required tarball and its associated `.sigstore.json` bundle file from the [GitHub Release](https://github.com/aquasecurity/trivy/releases).
31+
Download the release asset and its associated `.sigstore.json` bundle file from the [GitHub Release](https://github.com/aquasecurity/trivy/releases).
32+
33+
!!! note
34+
The commands below assume [cosign v3.0.0+](https://github.com/sigstore/cosign). With cosign v2 (≥ 2.4.0), add the `--new-bundle-format` flag.
3235

3336
Use the following command for keyless verification:
3437

3538
```shell
36-
cosign verify-blob-attestation <path to tarball> \
37-
--bundle <path to tarball>.sigstore.json \
39+
cosign verify-blob <path to asset> \
40+
--bundle <path to asset>.sigstore.json \
3841
--certificate-oidc-issuer=https://token.actions.githubusercontent.com \
3942
--certificate-identity 'https://github.com/aquasecurity/trivy/.github/workflows/reusable-release.yaml@refs/tags/<release tag>'
4043
```
4144

42-
Example for `trivy_0.68.1_Linux-64bit.tar.gz`:
45+
Example for `trivy_0.71.0_Linux-64bit.tar.gz`:
4346

4447
```shell
45-
cosign verify-blob-attestation trivy_0.68.1_Linux-64bit.tar.gz \
46-
--bundle trivy_0.68.1_Linux-64bit.tar.gz.sigstore.json \
48+
cosign verify-blob trivy_0.71.0_Linux-64bit.tar.gz \
49+
--bundle trivy_0.71.0_Linux-64bit.tar.gz.sigstore.json \
4750
--certificate-oidc-issuer=https://token.actions.githubusercontent.com \
48-
--certificate-identity 'https://github.com/aquasecurity/trivy/.github/workflows/reusable-release.yaml@refs/tags/v0.68.1'
51+
--certificate-identity 'https://github.com/aquasecurity/trivy/.github/workflows/reusable-release.yaml@refs/tags/v0.71.0'
4952
```
5053

51-
You should get the following output
54+
You should get the following output:
5255

5356
```
5457
Verified OK
5558
```
5659

60+
The same command applies to `.deb`, `.rpm`, and `.zip` packages.
61+
5762
## Verifying a GPG signature
5863

5964
RPM and Deb packages are also signed by GPG.

0 commit comments

Comments
 (0)