Skip to content

docs(readme): cosign v3, or v2.6 with --new-bundle-format, to verify the images - #501

Merged
DavidGodefroid merged 1 commit into
mainfrom
docs/488-cosign-v3
Nov 18, 2026
Merged

DavidGodefroid merged 1 commit into
mainfrom
docs/488-cosign-v3

Conversation

@DavidGodefroid

Copy link
Copy Markdown
Owner

Closes #488

What changed

README.md, "Verify a release": the by-hand paragraph now says that the images are signed in the Sigstore bundle format, that verifying them needs cosign v3 or later, or cosign v2.6 or later with --new-bundle-format, and that cosign v2 without the flag answers no signatures found although the image is signed. The example gains a comment line with the exact flag for cosign v2. The cosign verify command itself is unchanged: it succeeds as written with cosign v3.

One difference from the ticket

The ticket says "cosign v2.5+ with --new-bundle-format". By hand, v2.5.0, v2.5.1, v2.5.2 and v2.5.3 accept the flag but still answer no signatures found on both images; v2.6.0 and v2.6.1 succeed. The README therefore says v2.6 or later.

cosign flag lea:0.17.2 lea-proxy:0.17.2
v3.1.4 none (as written) verified verified
v2.6.1 none no signatures found no signatures found
v2.6.1 --new-bundle-format verified verified
v2.6.0 --new-bundle-format verified verified
v2.5.0 to v2.5.3 --new-bundle-format no signatures found no signatures found

How it was verified

cosign v3.1.4 is the one on the PATH (Homebrew); each v2 binary is cosign-linux-amd64 from its Sigstore GitHub release, checked against that release's cosign_checksums.txt. Outputs (the JSON line is cut at 600 characters):

### cosign v3.1.4, as written: lea
$ cosign verify --certificate-identity-regexp ^https://github\.com/DavidGodefroid/lea/\.github/workflows/release\.yml@refs/tags/v[0-9] --certificate-oidc-issuer https://token.actions.githubusercontent.com ghcr.io/davidgodefroid/lea:0.17.2

Verification for ghcr.io/davidgodefroid/lea:0.17.2 --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The code-signing certificate was verified using trusted certificate authority certificates

[{"critical":{"identity":{"docker-reference":"ghcr.io/davidgodefroid/lea:0.17.2"},"image":{"docker-manifest-digest":"sha256:f1f149c3257ec04e1f43d7d1b0053956b94ff391ed5afb6b4f5b2cfb0fd16b0c"},"type":"https://sigstore.dev/cosign/sign/v1"},"optional":{}}]
exit=0

### cosign v2.6.1, without the flag: lea
$ cosign-v2.6.1 verify --certificate-identity-regexp ^https://github\.com/DavidGodefroid/lea/\.github/workflows/release\.yml@refs/tags/v[0-9] --certificate-oidc-issuer https://token.actions.githubusercontent.com ghcr.io/davidgodefroid/lea:0.17.2
Error: no signatures found
error during command execution: no signatures found
exit=10

### cosign v2.6.1 + --new-bundle-format: lea
$ cosign-v2.6.1 verify --new-bundle-format --certificate-identity-regexp ^https://github\.com/DavidGodefroid/lea/\.github/workflows/release\.yml@refs/tags/v[0-9] --certificate-oidc-issuer https://token.actions.githubusercontent.com ghcr.io/davidgodefroid/lea:0.17.2

Verification for ghcr.io/davidgodefroid/lea:0.17.2 --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The code-signing certificate was verified using trusted certificate authority certificates

[{"critical":{"identity":{"docker-reference":"ghcr.io/davidgodefroid/lea:0.17.2"},"image":{"docker-manifest-digest":"sha256:f1f149c3257ec04e1f43d7d1b0053956b94ff391ed5afb6b4f5b2cfb0fd16b0c"},"type":"https://sigstore.dev/cosign/sign/v1"},"optional":null}]
exit=0

### cosign v3.1.4, as written: lea-proxy
$ cosign verify --certificate-identity-regexp ^https://github\.com/DavidGodefroid/lea/\.github/workflows/release\.yml@refs/tags/v[0-9] --certificate-oidc-issuer https://token.actions.githubusercontent.com ghcr.io/davidgodefroid/lea-proxy:0.17.2

Verification for ghcr.io/davidgodefroid/lea-proxy:0.17.2 --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The code-signing certificate was verified using trusted certificate authority certificates

[{"critical":{"identity":{"docker-reference":"ghcr.io/davidgodefroid/lea-proxy:0.17.2"},"image":{"docker-manifest-digest":"sha256:0145fe5523db3698b4ac219f5f5dfe59f957381394d72f4f1b8e04cb62c6a67a"},"type":"https://sigstore.dev/cosign/sign/v1"},"optional":{}}]
exit=0

### cosign v2.6.1, without the flag: lea-proxy
$ cosign-v2.6.1 verify --certificate-identity-regexp ^https://github\.com/DavidGodefroid/lea/\.github/workflows/release\.yml@refs/tags/v[0-9] --certificate-oidc-issuer https://token.actions.githubusercontent.com ghcr.io/davidgodefroid/lea-proxy:0.17.2
Error: no signatures found
error during command execution: no signatures found
exit=10

### cosign v2.6.1 + --new-bundle-format: lea-proxy
$ cosign-v2.6.1 verify --new-bundle-format --certificate-identity-regexp ^https://github\.com/DavidGodefroid/lea/\.github/workflows/release\.yml@refs/tags/v[0-9] --certificate-oidc-issuer https://token.actions.githubusercontent.com ghcr.io/davidgodefroid/lea-proxy:0.17.2

Verification for ghcr.io/davidgodefroid/lea-proxy:0.17.2 --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The code-signing certificate was verified using trusted certificate authority certificates

[{"critical":{"identity":{"docker-reference":"ghcr.io/davidgodefroid/lea-proxy:0.17.2"},"image":{"docker-manifest-digest":"sha256:0145fe5523db3698b4ac219f5f5dfe59f957381394d72f4f1b8e04cb62c6a67a"},"type":"https://sigstore.dev/cosign/sign/v1"},"optional":null}]
exit=0

README only, no code touched, so no test suite was run.

🤖 Generated with Claude Code

…the images (#488)

The lea and lea-proxy images are signed in the Sigstore bundle format
(cosign v3 in the release workflow). cosign v2 answers 'no signatures
found' unless --new-bundle-format is given, and the flag only finds the
bundle from v2.6.0 on (checked by hand on 0.17.2 with v2.5.0 to v2.6.1
and v3.1.4).

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@DavidGodefroid
DavidGodefroid merged commit 94d9946 into main Nov 18, 2026
26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document cosign v3 for verifying lea and lea-proxy images

1 participant