diff options
| author | tv <tv@krebsco.de> | 2026-11-18 11:14:21 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-18 12:22:57 +0100 |
| commit | b6a2649f54741e88a886fe8f64e916415e8a4b72 (patch) | |
| tree | 5872622ec22b5480700cd236da954a93b1d5fc2a /docs | |
| parent | e95909e1c0bf6e0b87b1dd8bafd44c6110656c0d (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.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 |
