aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/keys.md
diff options
context:
space:
mode:
authorslopulus <slop@lassul.us>2026-11-17 20:01:42 +0100
committertv <tv@krebsco.de>2026-11-17 21:09:40 +0100
commit2b9bb568603ee10d4f1f3106a687a8642c162df7 (patch)
treea25c18d9c10862cab917ada82769f6544fbbe6da /docs/guides/federation/keys.md
parent45cdc3c64bedb6eefe4a3645afbde82e62f8112a (diff)
guides: keys in an ssh-agentecdsa
A party's key is `ssh-ed25519` or `ecdsa-sha2-nistp256`; the client signs with a private key file or through an ssh-agent holding the key, given its public key. Code of its own signing with ECDSA makes `s` low, which `ssh-keygen` does only half the time.
Diffstat (limited to 'docs/guides/federation/keys.md')
-rw-r--r--docs/guides/federation/keys.md22
1 files changed, 21 insertions, 1 deletions
diff --git a/docs/guides/federation/keys.md b/docs/guides/federation/keys.md
index 48018a3..a84ed5a 100644
--- a/docs/guides/federation/keys.md
+++ b/docs/guides/federation/keys.md
@@ -25,12 +25,32 @@ continuum-party --node http://tv:secret@localhost:3000 --key laptop.key \
Each key goes as one argument, an `authorized_keys` line; its comment is left out. A
set holds up to 16 keys. A node voting by itself keeps a key its version names on that
-node (`--store-vote-key`): one stolen there votes for the party.
+node (`--store-vote-key`), an Ed25519 key in a file: one stolen there votes for the
+party.
A set counts where it is written under a version numbered at least the `since` the
current version gives the party's keys: once a version names a party's keys anew, no set
written before counts, and the party writes its set again.
+## Keys in an ssh-agent
+
+A key no file holds, in a security key, a phone or a Secure Enclave, signs through an
+ssh-agent. Give the client its public key, a `.pub` file, as `--key`: it asks the agent
+at `SSH_AUTH_SOCK` to sign, and writes the signature as `ssh-keygen -Y sign` does
+through that agent. Such a key is `ecdsa-sha2-nistp256` or `ssh-ed25519`.
+
+```sh
+ssh-add -L # ecdsa-sha2-nistp256 AAAA… tv@phone
+ssh-add -L | grep tv@phone > phone.pub
+cut -d' ' -f1,2 phone.pub # the key as a version or a set names it
+continuum-party --node http://tv:secret@localhost:3000 --key phone.pub \
+ --record tv.record write home/tv/motd '"from the phone"'
+```
+
+Of an ECDSA signature, `s` and the curve's order less `s` both check. The federation
+takes the low one alone, so that nobody makes another event of what the party signed;
+the client makes `s` low, whichever the agent gives.
+
## Changing the keys of a set
A write counts only while the key that signed it is among the party's keys: what a key