Skip to content

Commit 6d2c4e2

Browse files
committed
README: move Sigsum instructions to separate file
1 parent 75063d2 commit 6d2c4e2

File tree

2 files changed

+32
-33
lines changed

2 files changed

+32
-33
lines changed

README.md

Lines changed: 2 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,8 @@ https://dl.filippo.io/age/v1.1.1?for=darwin/arm64
155155
...
156156
```
157157

158+
If you download the pre-built binaries, you can check their [Sigsum proofs](./SIGSUM.md).
159+
158160
If your system has [a supported version of Go](https://go.dev/dl/), you can build from source.
159161

160162
```
@@ -163,39 +165,6 @@ go install filippo.io/age/cmd/...@latest
163165

164166
Help from new packagers is very welcome.
165167

166-
### Verifying the release signatures
167-
168-
If you download the pre-built binaries, you can check their
169-
[Sigsum](https://www.sigsum.org) proofs, which are like signatures with extra
170-
transparency: you can cryptographically verify that every proof is logged in a
171-
public append-only log, so you can hold the age project accountable for every
172-
binary release we ever produced. This is similar to what the [Go Checksum
173-
Database](https://go.dev/blog/module-mirror-launch) provides.
174-
175-
```
176-
cat << EOF > age-sigsum-key.pub
177-
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIM1WpnEswJLPzvXJDiswowy48U+G+G1kmgwUE2eaRHZG
178-
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAz2WM5CyPLqiNjk7CLl4roDXwKhQ0QExXLebukZEZFS
179-
EOF
180-
cat << EOF > sigsum-trust-policy.txt
181-
log 154f49976b59ff09a123675f58cb3e346e0455753c3c3b15d465dcb4f6512b0b https://poc.sigsum.org/jellyfish
182-
witness poc.sigsum.org/nisse 1c25f8a44c635457e2e391d1efbca7d4c2951a0aef06225a881e46b98962ac6c
183-
witness rgdd.se/poc-witness 28c92a5a3a054d317c86fc2eeb6a7ab2054d6217100d0be67ded5b74323c5806
184-
group demo-quorum-rule all poc.sigsum.org/nisse rgdd.se/poc-witness
185-
quorum demo-quorum-rule
186-
EOF
187-
188-
curl -JLO "https://dl.filippo.io/age/v1.2.0?for=darwin/arm64"
189-
curl -JLO "https://dl.filippo.io/age/v1.2.0?for=darwin/arm64&proof"
190-
191-
go install sigsum.org/sigsum-go/cmd/sigsum-verify@v0.8.0
192-
sigsum-verify -k age-sigsum-key.pub -p sigsum-trust-policy.txt \
193-
age-v1.2.0-darwin-arm64.tar.gz.proof < age-v1.2.0-darwin-arm64.tar.gz
194-
```
195-
196-
You can learn more about what's happening above in the [Sigsum
197-
docs](https://www.sigsum.org/getting-started/).
198-
199168
## Usage
200169

201170
For the full documentation, read [the age(1) man page](https://filippo.io/age/age.1).

SIGSUM.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
If you download the pre-built binaries, you can check their
2+
[Sigsum](https://www.sigsum.org) proofs, which are like signatures with extra
3+
transparency: you can cryptographically verify that every proof is logged in a
4+
public append-only log, so you can hold the age project accountable for every
5+
binary release we ever produced. This is similar to what the [Go Checksum
6+
Database](https://go.dev/blog/module-mirror-launch) provides.
7+
8+
```
9+
cat << EOF > age-sigsum-key.pub
10+
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIM1WpnEswJLPzvXJDiswowy48U+G+G1kmgwUE2eaRHZG
11+
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAz2WM5CyPLqiNjk7CLl4roDXwKhQ0QExXLebukZEZFS
12+
EOF
13+
cat << EOF > sigsum-trust-policy.txt
14+
log 154f49976b59ff09a123675f58cb3e346e0455753c3c3b15d465dcb4f6512b0b https://poc.sigsum.org/jellyfish
15+
witness poc.sigsum.org/nisse 1c25f8a44c635457e2e391d1efbca7d4c2951a0aef06225a881e46b98962ac6c
16+
witness rgdd.se/poc-witness 28c92a5a3a054d317c86fc2eeb6a7ab2054d6217100d0be67ded5b74323c5806
17+
group demo-quorum-rule all poc.sigsum.org/nisse rgdd.se/poc-witness
18+
quorum demo-quorum-rule
19+
EOF
20+
21+
curl -JLO "https://dl.filippo.io/age/v1.2.0?for=darwin/arm64"
22+
curl -JLO "https://dl.filippo.io/age/v1.2.0?for=darwin/arm64&proof"
23+
24+
go install sigsum.org/sigsum-go/cmd/sigsum-verify@v0.8.0
25+
sigsum-verify -k age-sigsum-key.pub -p sigsum-trust-policy.txt \
26+
age-v1.2.0-darwin-arm64.tar.gz.proof < age-v1.2.0-darwin-arm64.tar.gz
27+
```
28+
29+
You can learn more about what's happening above in the [Sigsum
30+
docs](https://www.sigsum.org/getting-started/).

0 commit comments

Comments
 (0)