From b6a2649f54741e88a886fe8f64e916415e8a4b72 Mon Sep 17 00:00:00 2001 From: tv Date: Wed, 18 Nov 2026 11:14:21 +0000 Subject: 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. --- docs/guides/federation/keys.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) (limited to 'docs') 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 -- cgit v1.3.1