Skip to content

Commit cac2e39

Browse files
authored
Correct release attestation verification (#15)
Use direct workflow-bound artifact verification for v0.4.0 and document immutable releases for subsequent publications.
1 parent b09ef21 commit cac2e39

1 file changed

Lines changed: 19 additions & 4 deletions

File tree

docs/RELEASE_SECURITY.md

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,14 +18,29 @@ code-owner approval; a sole maintainer cannot provide independent review.
1818

1919
## Verify a release
2020

21-
Install a current GitHub CLI, authenticate it, and verify the release before installation:
21+
Install a current GitHub CLI, authenticate it, download both distributions, and verify their
22+
GitHub-signed build provenance before installation:
2223

2324
```bash
24-
gh release verify v0.4.0 -R 0xmrma/mrma
25-
gh release download v0.4.0 -R 0xmrma/mrma --pattern 'mrma-0.4.0-py3-none-any.whl'
26-
gh release verify-asset v0.4.0 ./mrma-0.4.0-py3-none-any.whl -R 0xmrma/mrma
25+
gh release download v0.4.0 -R 0xmrma/mrma \
26+
--pattern 'mrma-0.4.0-py3-none-any.whl' \
27+
--pattern 'mrma-0.4.0.tar.gz'
28+
gh attestation verify ./mrma-0.4.0-py3-none-any.whl \
29+
-R 0xmrma/mrma \
30+
--signer-workflow 0xmrma/mrma/.github/workflows/release.yml \
31+
--source-ref refs/tags/v0.4.0
32+
gh attestation verify ./mrma-0.4.0.tar.gz \
33+
-R 0xmrma/mrma \
34+
--signer-workflow 0xmrma/mrma/.github/workflows/release.yml \
35+
--source-ref refs/tags/v0.4.0
2736
```
2837

38+
Release v0.4.0 predates repository release-immutability enablement. Its protected signed tag and
39+
artifact attestations are independently verifiable, but `gh release verify` and
40+
`gh release verify-asset` require an immutable-release attestation and do not apply to v0.4.0.
41+
Repository release immutability is enabled for subsequent releases, which receive that additional
42+
release-level attestation when published.
43+
2944
Verify the container's GitHub-signed provenance and require the publishing workflow and tag ref:
3045

3146
```bash

0 commit comments

Comments
 (0)