Skip to content

Commit 3acb9c5

Browse files
committed
add SLSA info and verification doc
1 parent a561101 commit 3acb9c5

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

SECURITY.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,3 +13,20 @@ When a major version is incremented, we'll support the previous major version fo
1313
To report a vulnerability please [create a new GitHub "issue"](https://github.com/StackExchange/dnscontrol/issues/new/choose).
1414

1515
We will respond in a best-effort manner, usually within 1 week. We will communciate via the GitHub issue unless we need to communicate privately, in which case we'll arrange a way to communicate directly.
16+
17+
## Build Attestation
18+
19+
DNSControl uses GitHub Actions and workflows from the SLSA Framework to produce verifiable builds.
20+
21+
<!-- FIXME: version reference below -->
22+
23+
The [releases page](https://github.com/StackExchange/dnscontrol/releases) includes an attestation document (`multiple.intoto.jsonl`) in the list of files associated with each release since vFIXME. This file contains the signed attestation that can be used to verify the provenance of the files associated with each release.
24+
25+
The [SLSA verifier](https://github.com/slsa-framework/slsa-verifier) tool can be used to confirm the authenticity of DNSControl releases. To manually verify a downloaded build artifact and the `multiple.intoto.jsonl` file, use the `slsa-verifier` utility to confirm the artifact was signed:
26+
27+
```shell
28+
slsa-verifier verify-artifact dnscontrol_4.19.0_darwin_all.tar.gz \
29+
--provenance-path multiple.intoto.json \
30+
--source-uri github.com/StackExchange/dnscontrol \
31+
--source-tag v4.20.0
32+
```

0 commit comments

Comments
 (0)