authfd.h revision 181110 
156893Sfenner/* $OpenBSD: authfd.h,v 1.36 2006/08/03 03:34:41 deraadt Exp $ */
256893Sfenner
356893Sfenner/*
4127668Sbms * Author: Tatu Ylonen <ylo@cs.hut.fi>
556893Sfenner * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
656893Sfenner *                    All rights reserved
756893Sfenner * Functions to interface with the SSH_AUTHENTICATION_FD socket.
856893Sfenner *
956893Sfenner * As far as I am concerned, the code I have written for this software
1056893Sfenner * can be used freely for any purpose.  Any derived versions of this
1156893Sfenner * software must be clearly marked as such, and if the derived work is
1256893Sfenner * incompatible with the protocol description in the RFC file, it must be
1356893Sfenner * called by a name other than "ssh" or "Secure Shell".
1456893Sfenner */
1556893Sfenner
16127668Sbms#ifndef AUTHFD_H
1756893Sfenner#define AUTHFD_H
1856893Sfenner
1956893Sfenner/* Messages for the authentication agent connection. */
2056893Sfenner#define SSH_AGENTC_REQUEST_RSA_IDENTITIES	1
2156893Sfenner#define SSH_AGENT_RSA_IDENTITIES_ANSWER		2
2256893Sfenner#define SSH_AGENTC_RSA_CHALLENGE		3
2356893Sfenner#define SSH_AGENT_RSA_RESPONSE			4
2456893Sfenner#define SSH_AGENT_FAILURE			5
2556893Sfenner#define SSH_AGENT_SUCCESS			6
2656893Sfenner#define SSH_AGENTC_ADD_RSA_IDENTITY		7
2756893Sfenner#define SSH_AGENTC_REMOVE_RSA_IDENTITY		8
2856893Sfenner#define SSH_AGENTC_REMOVE_ALL_RSA_IDENTITIES	9
2956893Sfenner
3056893Sfenner/* private OpenSSH extensions for SSH2 */
31127668Sbms#define SSH2_AGENTC_REQUEST_IDENTITIES		11
32127668Sbms#define SSH2_AGENT_IDENTITIES_ANSWER		12
3356893Sfenner#define SSH2_AGENTC_SIGN_REQUEST		13
3456893Sfenner#define SSH2_AGENT_SIGN_RESPONSE		14
35127668Sbms#define SSH2_AGENTC_ADD_IDENTITY		17
3656893Sfenner#define SSH2_AGENTC_REMOVE_IDENTITY		18
3756893Sfenner#define SSH2_AGENTC_REMOVE_ALL_IDENTITIES	19
3856893Sfenner
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
63typedef struct {
64	int	fd;
65	Buffer	identities;
66	int	howmany;
67}	AuthenticationConnection;
68
69int	ssh_agent_present(void);
70int	ssh_get_authentication_socket(void);
71void	ssh_close_authentication_socket(int);
72
73AuthenticationConnection *ssh_get_authentication_connection(void);
74void	ssh_close_authentication_connection(AuthenticationConnection *);
75int	 ssh_get_num_identities(AuthenticationConnection *, int);
76Key	*ssh_get_first_identity(AuthenticationConnection *, char **, int);
77Key	*ssh_get_next_identity(AuthenticationConnection *, char **, int);
78int	 ssh_add_identity(AuthenticationConnection *, Key *, const char *);
79int	 ssh_add_identity_constrained(AuthenticationConnection *, Key *,
80    const char *, u_int, u_int);
81int	 ssh_remove_identity(AuthenticationConnection *, Key *);
82int	 ssh_remove_all_identities(AuthenticationConnection *, int);
83int	 ssh_lock_agent(AuthenticationConnection *, int, const char *);
84int	 ssh_update_card(AuthenticationConnection *, int, const char *,
85    const char *, u_int, u_int);
86
87int
88ssh_decrypt_challenge(AuthenticationConnection *, Key *, BIGNUM *, u_char[16],
89    u_int, u_char[16]);
90
91int
92ssh_agent_sign(AuthenticationConnection *, Key *, u_char **, u_int *, u_char *,
93    u_int);
94
95#endif				/* AUTHFD_H */
96