xref: /freebsd/crypto/openssh/authfd.h (revision 1e413cf93298b5b97441a21d9a50fdcd0ee9945e)
1 /* $OpenBSD: authfd.h,v 1.36 2006/08/03 03:34:41 deraadt Exp $ */
2 
3 /*
4  * Author: Tatu Ylonen <ylo@cs.hut.fi>
5  * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
6  *                    All rights reserved
7  * Functions to interface with the SSH_AUTHENTICATION_FD socket.
8  *
9  * As far as I am concerned, the code I have written for this software
10  * can be used freely for any purpose.  Any derived versions of this
11  * software must be clearly marked as such, and if the derived work is
12  * incompatible with the protocol description in the RFC file, it must be
13  * called by a name other than "ssh" or "Secure Shell".
14  */
15 
16 #ifndef AUTHFD_H
17 #define AUTHFD_H
18 
19 /* Messages for the authentication agent connection. */
20 #define SSH_AGENTC_REQUEST_RSA_IDENTITIES	1
21 #define SSH_AGENT_RSA_IDENTITIES_ANSWER		2
22 #define SSH_AGENTC_RSA_CHALLENGE		3
23 #define SSH_AGENT_RSA_RESPONSE			4
24 #define SSH_AGENT_FAILURE			5
25 #define SSH_AGENT_SUCCESS			6
26 #define SSH_AGENTC_ADD_RSA_IDENTITY		7
27 #define SSH_AGENTC_REMOVE_RSA_IDENTITY		8
28 #define SSH_AGENTC_REMOVE_ALL_RSA_IDENTITIES	9
29 
30 /* private OpenSSH extensions for SSH2 */
31 #define SSH2_AGENTC_REQUEST_IDENTITIES		11
32 #define SSH2_AGENT_IDENTITIES_ANSWER		12
33 #define SSH2_AGENTC_SIGN_REQUEST		13
34 #define SSH2_AGENT_SIGN_RESPONSE		14
35 #define SSH2_AGENTC_ADD_IDENTITY		17
36 #define SSH2_AGENTC_REMOVE_IDENTITY		18
37 #define SSH2_AGENTC_REMOVE_ALL_IDENTITIES	19
38 
39 /* smartcard */
40 #define SSH_AGENTC_ADD_SMARTCARD_KEY		20
41 #define SSH_AGENTC_REMOVE_SMARTCARD_KEY		21
42 
43 /* lock/unlock the agent */
44 #define SSH_AGENTC_LOCK				22
45 #define SSH_AGENTC_UNLOCK			23
46 
47 /* add key with constraints */
48 #define SSH_AGENTC_ADD_RSA_ID_CONSTRAINED	24
49 #define SSH2_AGENTC_ADD_ID_CONSTRAINED		25
50 #define SSH_AGENTC_ADD_SMARTCARD_KEY_CONSTRAINED 26
51 
52 #define	SSH_AGENT_CONSTRAIN_LIFETIME		1
53 #define	SSH_AGENT_CONSTRAIN_CONFIRM		2
54 
55 /* extended failure messages */
56 #define SSH2_AGENT_FAILURE			30
57 
58 /* additional error code for ssh.com's ssh-agent2 */
59 #define SSH_COM_AGENT2_FAILURE			102
60 
61 #define	SSH_AGENT_OLD_SIGNATURE			0x01
62 
63 typedef struct {
64 	int	fd;
65 	Buffer	identities;
66 	int	howmany;
67 }	AuthenticationConnection;
68 
69 int	ssh_agent_present(void);
70 int	ssh_get_authentication_socket(void);
71 void	ssh_close_authentication_socket(int);
72 
73 AuthenticationConnection *ssh_get_authentication_connection(void);
74 void	ssh_close_authentication_connection(AuthenticationConnection *);
75 int	 ssh_get_num_identities(AuthenticationConnection *, int);
76 Key	*ssh_get_first_identity(AuthenticationConnection *, char **, int);
77 Key	*ssh_get_next_identity(AuthenticationConnection *, char **, int);
78 int	 ssh_add_identity(AuthenticationConnection *, Key *, const char *);
79 int	 ssh_add_identity_constrained(AuthenticationConnection *, Key *,
80     const char *, u_int, u_int);
81 int	 ssh_remove_identity(AuthenticationConnection *, Key *);
82 int	 ssh_remove_all_identities(AuthenticationConnection *, int);
83 int	 ssh_lock_agent(AuthenticationConnection *, int, const char *);
84 int	 ssh_update_card(AuthenticationConnection *, int, const char *,
85     const char *, u_int, u_int);
86 
87 int
88 ssh_decrypt_challenge(AuthenticationConnection *, Key *, BIGNUM *, u_char[16],
89     u_int, u_char[16]);
90 
91 int
92 ssh_agent_sign(AuthenticationConnection *, Key *, u_char **, u_int *, u_char *,
93     u_int);
94 
95 #endif				/* AUTHFD_H */
96