diff options
author | Rasmus Dahlberg <rasmus@mullvad.net> | 2022-07-25 15:40:04 +0200 |
---|---|---|
committer | Rasmus Dahlberg <rasmus@mullvad.net> | 2022-07-25 15:40:04 +0200 |
commit | 95053383e21e688699c196b5527546006d83eae9 (patch) | |
tree | d774842cddd299466a42f39d084699cc20b723a8 /docs | |
parent | 43d190d1ec5f1964a85e7b5befe1cde8ab3107d6 (diff) |
add sigsum tool doc placeholdersigsum
Diffstat (limited to 'docs')
-rw-r--r-- | docs/sigsum-tool.md | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/docs/sigsum-tool.md b/docs/sigsum-tool.md new file mode 100644 index 0000000..91d7401 --- /dev/null +++ b/docs/sigsum-tool.md @@ -0,0 +1,44 @@ +# The sigsum tool + +The sigsum tool is used to log and verify SSH-signed checksums. This document +gives you a hands-on introduction to help you get started with sigsum logging +without having to read any lengthy background. + +## Prerequisites + +You will need: + + - [Go][], at least version 1.15. + Check version with `go version`. + - `ssh-keygen`, at least [OpenSSH release 8.9][]. + Check version with `sshd -v`. + +[OpenSSH release 8.9]: https://www.openssh.com/txt/release-8.9 +[Go]: https://go.dev/doc/install + +You may want somewhere to place the data associated with your signed checksums. +Examples include a public git repository or a web server. This is optional. We +will use [git.sigsum.org/testing/tree/data][] for demo purposes. + +[git.sigsum.org/testing/tree/data]: https://git.sigsum.org/testing/tree/data. + +## Install + + $ go install git.sigsum.org/sigsum-go/cmd/sigsum@latest + $ sigsum help + ... + +## Getting started + +docdoc + +## Further reading + + - Introductory blog post on [SSH signing][] by Andrew Ayer + - Sigsum logging [design document][] and [api specification][] + - How sigsum logs can be operated in a [primary-secondary mode][] + +[SSH signing]: https://www.agwa.name/blog/post/ssh_signatures +[design document]: https://git.sigsum.org/sigsum/tree/doc/design.md +[api specification]: https://git.sigsum.org/sigsum/tree/doc/api.md +[primary-secondary mode]: https://git.sigsum.org/log-go/tree/doc/design.md |