aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-18 11:14:21 +0000
committertv <tv@krebsco.de>2026-11-18 12:22:57 +0100
commitb6a2649f54741e88a886fe8f64e916415e8a4b72 (patch)
tree5872622ec22b5480700cd236da954a93b1d5fc2a /docs
parente95909e1c0bf6e0b87b1dd8bafd44c6110656c0d (diff)
guides: which keys an ssh-agent signs a party's events with
A smartcard's or a security key's PIV key, through PKCS#11, or a key in a Secure Enclave or a phone, each ecdsa-sha2-nistp256 or ssh-ed25519; a security key's FIDO key (`-t ecdsa-sk`, `-t ed25519-sk`) is no party's key.
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