aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/keys.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/guides/federation/keys.md')
-rw-r--r--docs/guides/federation/keys.md17
1 files changed, 10 insertions, 7 deletions
diff --git a/docs/guides/federation/keys.md b/docs/guides/federation/keys.md
index 6448f9e..3dd2834 100644
--- a/docs/guides/federation/keys.md
+++ b/docs/guides/federation/keys.md
@@ -41,16 +41,19 @@ Secure Enclave or a phone, held by an agent there. Such a key is `ecdsa-sha2-nis
its type ending in `@openssh.com`) is neither: it signs otherwise than the federation
takes, and is no party's key.
-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.
+Give the client its public key as `--key`, the key itself (an `authorized_keys` line) or
+a file holding it: it asks the agent at `SSH_AUTH_SOCK` to sign, and writes the signature
+as `ssh-keygen -Y sign` does through that agent. Of a file holding several keys (all
+`ssh-add -L` lists, say), the first signs, and the client warns: give another itself to
+sign with it. An agent that doesn't hold the key given signs nothing, and the client stops
+before it records or puts what it would have signed.
```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"'
+ssh-add -L | grep tv@phone | cut -d' ' -f1,2 # the key as a version or a set names it
+continuum-party --node http://tv:secret@localhost:3000 \
+ --key "$(ssh-add -L | grep tv@phone)" --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