[PATCH] Document transfer of ed25519 secret keys to the ssh-agent

Daniel Kahn Gillmor dkg at fifthhorseman.net
Wed May 18 21:52:45 AEST 2016


This documentation is based on sshkey_private_serialize() in sshkey.c,
which is eventually called by ssh-add.
---
 PROTOCOL.agent | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/PROTOCOL.agent b/PROTOCOL.agent
index c386d16..5188225 100644
--- a/PROTOCOL.agent
+++ b/PROTOCOL.agent
@@ -252,13 +252,34 @@ RSA certificates may be added with this request:
 	string			key_comment
 	constraint[]		key_constraints
 
+ED25519 keys may be added with this request:
+
+	byte			SSH2_AGENTC_ADD_IDENTITY or
+				SSH2_AGENTC_ADD_ID_CONSTRAINED
+	string			"ssh-ed25519"
+	mpint			ed25519_pk
+	mpint			ed25519_sk
+	string			key_comment
+	constraint[]		key_constraints
+
+ED25519 certificates may be added with this request:
+
+	byte			SSH2_AGENTC_ADD_IDENTITY or
+				SSH2_AGENTC_ADD_ID_CONSTRAINED
+	string			"ssh-ed25519-cert-v01 at openssh.com"
+	string			certificate
+	mpint			ed25519_pk
+	mpint			ed25519_sk
+	string			key_comment
+	constraint[]		key_constraints
+
 Note that the 'rsa_p' and 'rsa_q' parameters are sent in the reverse
 order to the protocol 1 add keys message. As with the corresponding
 protocol 1 "add key" request, the private key is overspecified to avoid
 redundant processing.
 
-For DSA, ECDSA and RSA key add requests, "key_constraints" may only be
-present if the request type is SSH2_AGENTC_ADD_ID_CONSTRAINED.
+For DSA, ECDSA, RSA, and ED25519 key add requests, "key_constraints" may
+only be present if the request type is SSH2_AGENTC_ADD_ID_CONSTRAINED.
 
 The agent will reply with a SSH_AGENT_SUCCESS if the key has been
 successfully added or a SSH_AGENT_FAILURE if an error occurred.
-- 
2.8.1



More information about the openssh-unix-dev mailing list