[openssh.git] / authfd.h

/* $OpenBSD: authfd.h,v 1.37 2009/08/27 17:44:52 djm Exp $ */

/*
 * Author: Tatu Ylonen <ylo@cs.hut.fi>
 * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
 *                    All rights reserved
 * Functions to interface with the SSH_AUTHENTICATION_FD socket.
 *
 * As far as I am concerned, the code I have written for this software
 * can be used freely for any purpose.  Any derived versions of this
 * software must be clearly marked as such, and if the derived work is
 * incompatible with the protocol description in the RFC file, it must be
 * called by a name other than "ssh" or "Secure Shell".
 */

#ifndef AUTHFD_H
#define AUTHFD_H

/* Messages for the authentication agent connection. */
#define SSH_AGENTC_REQUEST_RSA_IDENTITIES	1
#define SSH_AGENT_RSA_IDENTITIES_ANSWER		2
#define SSH_AGENTC_RSA_CHALLENGE		3
#define SSH_AGENT_RSA_RESPONSE			4
#define SSH_AGENT_FAILURE			5
#define SSH_AGENT_SUCCESS			6
#define SSH_AGENTC_ADD_RSA_IDENTITY		7
#define SSH_AGENTC_REMOVE_RSA_IDENTITY		8
#define SSH_AGENTC_REMOVE_ALL_RSA_IDENTITIES	9

/* private OpenSSH extensions for SSH2 */
#define SSH2_AGENTC_REQUEST_IDENTITIES		11
#define SSH2_AGENT_IDENTITIES_ANSWER		12
#define SSH2_AGENTC_SIGN_REQUEST		13
#define SSH2_AGENT_SIGN_RESPONSE		14
#define SSH2_AGENTC_ADD_IDENTITY		17
#define SSH2_AGENTC_REMOVE_IDENTITY		18
#define SSH2_AGENTC_REMOVE_ALL_IDENTITIES	19

/* smartcard */
#define SSH_AGENTC_ADD_SMARTCARD_KEY		20
#define SSH_AGENTC_REMOVE_SMARTCARD_KEY		21

/* lock/unlock the agent */
#define SSH_AGENTC_LOCK				22
#define SSH_AGENTC_UNLOCK			23

/* add key with constraints */
#define SSH_AGENTC_ADD_RSA_ID_CONSTRAINED	24
#define SSH2_AGENTC_ADD_ID_CONSTRAINED		25
#define SSH_AGENTC_ADD_SMARTCARD_KEY_CONSTRAINED 26

#define	SSH_AGENT_CONSTRAIN_LIFETIME		1
#define	SSH_AGENT_CONSTRAIN_CONFIRM		2

/* extended failure messages */
#define SSH2_AGENT_FAILURE			30

/* additional error code for ssh.com's ssh-agent2 */
#define SSH_COM_AGENT2_FAILURE			102

#define	SSH_AGENT_OLD_SIGNATURE			0x01

typedef struct {
	int	fd;
	Buffer	identities;
	int	howmany;
}	AuthenticationConnection;

int	ssh_agent_present(void);
int	ssh_get_authentication_socket(void);
void	ssh_close_authentication_socket(int);

AuthenticationConnection *ssh_get_authentication_connection(void);
void	ssh_close_authentication_connection(AuthenticationConnection *);
int	 ssh_get_num_identities(AuthenticationConnection *, int);
Key	*ssh_get_first_identity(AuthenticationConnection *, char **, int);
Key	*ssh_get_next_identity(AuthenticationConnection *, char **, int);
int	 ssh_add_identity_constrained(AuthenticationConnection *, Key *,
    const char *, u_int, u_int);
int	 ssh_remove_identity(AuthenticationConnection *, Key *);
int	 ssh_remove_all_identities(AuthenticationConnection *, int);
int	 ssh_lock_agent(AuthenticationConnection *, int, const char *);
int	 ssh_update_card(AuthenticationConnection *, int, const char *,
    const char *, u_int, u_int);

int
ssh_decrypt_challenge(AuthenticationConnection *, Key *, BIGNUM *, u_char[16],
    u_int, u_char[16]);

int
ssh_agent_sign(AuthenticationConnection *, Key *, u_char **, u_int *, u_char *,
    u_int);

#endif				/* AUTHFD_H */
Commit	Line	Data
b4741f94	1	/* $OpenBSD: authfd.h,v 1.37 2009/08/27 17:44:52 djm Exp $ */
93c3b6de	2
8efc0c15	3	/*
5260325f	4	* Author: Tatu Ylonen <ylo@cs.hut.fi>
5260325f	5	* Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
5260325f	6	* All rights reserved
5260325f	7	* Functions to interface with the SSH_AUTHENTICATION_FD socket.
6ae2364d	8	*
bcbf86ec	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".
5260325f	14	*/
8efc0c15	15
8efc0c15	16	#ifndef AUTHFD_H
	17	#define AUTHFD_H
	18
8efc0c15	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
94ec8c6b	30	/* private OpenSSH extensions for SSH2 */
4c8722d9	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
4c8722d9	35	#define SSH2_AGENTC_ADD_IDENTITY 17
	36	#define SSH2_AGENTC_REMOVE_IDENTITY 18
	37	#define SSH2_AGENTC_REMOVE_ALL_IDENTITIES 19
	38
983def13	39	/* smartcard */
983def13	40	#define SSH_AGENTC_ADD_SMARTCARD_KEY 20
7203d6bb	41	#define SSH_AGENTC_REMOVE_SMARTCARD_KEY 21
983def13	42
3db7f994	43	/* lock/unlock the agent */
3db7f994	44	#define SSH_AGENTC_LOCK 22
7203d6bb	45	#define SSH_AGENTC_UNLOCK 23
3db7f994	46
ee900f87	47	/* add key with constraints */
	48	#define SSH_AGENTC_ADD_RSA_ID_CONSTRAINED 24
	49	#define SSH2_AGENTC_ADD_ID_CONSTRAINED 25
ca719034	50	#define SSH_AGENTC_ADD_SMARTCARD_KEY_CONSTRAINED 26
37500e74	51
405e0c5e	52	#define SSH_AGENT_CONSTRAIN_LIFETIME 1
c4087616	53	#define SSH_AGENT_CONSTRAIN_CONFIRM 2
264572cc	54
65e683bd	55	/* extended failure messages */
	56	#define SSH2_AGENT_FAILURE 30
	57
94ec8c6b	58	/* additional error code for ssh.com's ssh-agent2 */
7203d6bb	59	#define SSH_COM_AGENT2_FAILURE 102
94ec8c6b	60
188adeb2	61	#define SSH_AGENT_OLD_SIGNATURE 0x01
188adeb2	62
5260325f	63	typedef struct {
7203d6bb	64	int fd;
	65	Buffer identities;
	66	int howmany;
	67	} AuthenticationConnection;
2e73a022	68
8b10e20e	69	int ssh_agent_present(void);
7203d6bb	70	int ssh_get_authentication_socket(void);
7203d6bb	71	void ssh_close_authentication_socket(int);
8efc0c15	72
1e3b8b07	73	AuthenticationConnection *ssh_get_authentication_connection(void);
7203d6bb	74	void ssh_close_authentication_connection(AuthenticationConnection *);
255cabd9	75	int ssh_get_num_identities(AuthenticationConnection *, int);
2a1e4639	76	Key ssh_get_first_identity(AuthenticationConnection , char **, int);
2a1e4639	77	Key ssh_get_next_identity(AuthenticationConnection , char **, int);
c4087616	78	int ssh_add_identity_constrained(AuthenticationConnection , Key ,
c4087616	79	const char *, u_int, u_int);
9ff6f66f	80	int ssh_remove_identity(AuthenticationConnection , Key );
255cabd9	81	int ssh_remove_all_identities(AuthenticationConnection *, int);
3db7f994	82	int ssh_lock_agent(AuthenticationConnection , int, const char );
aff51935	83	int ssh_update_card(AuthenticationConnection , int, const char ,
ca719034	84	const char *, u_int, u_int);
8efc0c15	85
6ae2364d	86	int
2a1e4639	87	ssh_decrypt_challenge(AuthenticationConnection , Key , BIGNUM *, u_char[16],
2a1e4639	88	u_int, u_char[16]);
8efc0c15	89
6ae2364d	90	int
c66f9d0e	91	ssh_agent_sign(AuthenticationConnection , Key , u_char *, u_int , u_char *,
c66f9d0e	92	u_int);
8efc0c15	93
5260325f	94	#endif /* AUTHFD_H */