[gssapi-openssh.git] / openssh / authfd.h

/* $OpenBSD: authfd.h,v 1.36 2006/08/03 03:34:41 deraadt 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(AuthenticationConnection *, Key *, const char *);
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
9108f8d9	1	/* $OpenBSD: authfd.h,v 1.36 2006/08/03 03:34:41 deraadt Exp $ */
e9a17296	2
3c0ef626	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
3c0ef626	16	#ifndef AUTHFD_H
	17	#define AUTHFD_H
	18
3c0ef626	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
f5799ae1	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
0fff78ff	50	#define SSH_AGENTC_ADD_SMARTCARD_KEY_CONSTRAINED 26
f5799ae1	51
f5799ae1	52	#define SSH_AGENT_CONSTRAIN_LIFETIME 1
6a9b3198	53	#define SSH_AGENT_CONSTRAIN_CONFIRM 2
3c0ef626	54
	55	/* extended failure messages */
	56	#define SSH2_AGENT_FAILURE 30
	57
	58	/* additional error code for ssh.com's ssh-agent2 */
f5799ae1	59	#define SSH_COM_AGENT2_FAILURE 102
3c0ef626	60
	61	#define SSH_AGENT_OLD_SIGNATURE 0x01
	62
	63	typedef struct {
f5799ae1	64	int fd;
	65	Buffer identities;
	66	int howmany;
	67	} AuthenticationConnection;
3c0ef626	68
41b2f314	69	int ssh_agent_present(void);
f5799ae1	70	int ssh_get_authentication_socket(void);
f5799ae1	71	void ssh_close_authentication_socket(int);
3c0ef626	72
3c0ef626	73	AuthenticationConnection *ssh_get_authentication_connection(void);
f5799ae1	74	void ssh_close_authentication_connection(AuthenticationConnection *);
3c0ef626	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 *);
6a9b3198	79	int ssh_add_identity_constrained(AuthenticationConnection , Key ,
6a9b3198	80	const char *, u_int, u_int);
3c0ef626	81	int ssh_remove_identity(AuthenticationConnection , Key );
3c0ef626	82	int ssh_remove_all_identities(AuthenticationConnection *, int);
f5799ae1	83	int ssh_lock_agent(AuthenticationConnection , int, const char );
cdd66111	84	int ssh_update_card(AuthenticationConnection , int, const char ,
0fff78ff	85	const char *, u_int, u_int);
3c0ef626	86
	87	int
	88	ssh_decrypt_challenge(AuthenticationConnection , Key , BIGNUM *, u_char[16],
	89	u_int, u_char[16]);
	90
	91	int
e9a17296	92	ssh_agent_sign(AuthenticationConnection , Key , u_char *, u_int , u_char *,
e9a17296	93	u_int);
3c0ef626	94
3c0ef626	95	#endif /* AUTHFD_H */