diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/guides/federation/keys.md | 14 |
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 |
