aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/guides/federation/keys.md14
1 files changed, 10 insertions, 4 deletions
diff --git a/docs/guides/federation/keys.md b/docs/guides/federation/keys.md
index a84ed5a..6448f9e 100644
--- a/docs/guides/federation/keys.md
+++ b/docs/guides/federation/keys.md
@@ -34,10 +34,16 @@ 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`.
+A key no file holds signs through an ssh-agent holding it: a smartcard's or a security
+key's PIV key, which the agent reaches through PKCS#11 (`ssh-add -s`), or a key in a
+Secure Enclave or a phone, held by an agent there. Such a key is `ecdsa-sha2-nistp256` or
+`ssh-ed25519`. A security key's FIDO key (`ssh-keygen -t ecdsa-sk` or `-t ed25519-sk`,
+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.
```sh
ssh-add -L # ecdsa-sha2-nistp256 AAAA… tv@phone