Home | History | Annotate | Download | only in openssh
      1 /* $OpenBSD: authfd.h,v 1.38 2015/01/14 20:05:27 djm Exp $ */
      2 
      3 /*
      4  * Author: Tatu Ylonen <ylo (at) cs.hut.fi>
      5  * Copyright (c) 1995 Tatu Ylonen <ylo (at) 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 /* List of identities returned by ssh_fetch_identitylist() */
     20 struct ssh_identitylist {
     21 	size_t nkeys;
     22 	struct sshkey **keys;
     23 	char **comments;
     24 };
     25 
     26 int	ssh_get_authentication_socket(int *fdp);
     27 void	ssh_close_authentication_socket(int sock);
     28 
     29 int	ssh_lock_agent(int sock, int lock, const char *password);
     30 int	ssh_fetch_identitylist(int sock, int version,
     31 	    struct ssh_identitylist **idlp);
     32 void	ssh_free_identitylist(struct ssh_identitylist *idl);
     33 int	ssh_add_identity_constrained(int sock, struct sshkey *key,
     34 	    const char *comment, u_int life, u_int confirm);
     35 int	ssh_remove_identity(int sock, struct sshkey *key);
     36 int	ssh_update_card(int sock, int add, const char *reader_id,
     37 	    const char *pin, u_int life, u_int confirm);
     38 int	ssh_remove_all_identities(int sock, int version);
     39 
     40 int	ssh_decrypt_challenge(int sock, struct sshkey* key, BIGNUM *challenge,
     41 	    u_char session_id[16], u_char response[16]);
     42 int	ssh_agent_sign(int sock, struct sshkey *key,
     43 	    u_char **sigp, size_t *lenp,
     44 	    const u_char *data, size_t datalen, u_int compat);
     45 
     46 /* Messages for the authentication agent connection. */
     47 #define SSH_AGENTC_REQUEST_RSA_IDENTITIES	1
     48 #define SSH_AGENT_RSA_IDENTITIES_ANSWER		2
     49 #define SSH_AGENTC_RSA_CHALLENGE		3
     50 #define SSH_AGENT_RSA_RESPONSE			4
     51 #define SSH_AGENT_FAILURE			5
     52 #define SSH_AGENT_SUCCESS			6
     53 #define SSH_AGENTC_ADD_RSA_IDENTITY		7
     54 #define SSH_AGENTC_REMOVE_RSA_IDENTITY		8
     55 #define SSH_AGENTC_REMOVE_ALL_RSA_IDENTITIES	9
     56 
     57 /* private OpenSSH extensions for SSH2 */
     58 #define SSH2_AGENTC_REQUEST_IDENTITIES		11
     59 #define SSH2_AGENT_IDENTITIES_ANSWER		12
     60 #define SSH2_AGENTC_SIGN_REQUEST		13
     61 #define SSH2_AGENT_SIGN_RESPONSE		14
     62 #define SSH2_AGENTC_ADD_IDENTITY		17
     63 #define SSH2_AGENTC_REMOVE_IDENTITY		18
     64 #define SSH2_AGENTC_REMOVE_ALL_IDENTITIES	19
     65 
     66 /* smartcard */
     67 #define SSH_AGENTC_ADD_SMARTCARD_KEY		20
     68 #define SSH_AGENTC_REMOVE_SMARTCARD_KEY		21
     69 
     70 /* lock/unlock the agent */
     71 #define SSH_AGENTC_LOCK				22
     72 #define SSH_AGENTC_UNLOCK			23
     73 
     74 /* add key with constraints */
     75 #define SSH_AGENTC_ADD_RSA_ID_CONSTRAINED	24
     76 #define SSH2_AGENTC_ADD_ID_CONSTRAINED		25
     77 #define SSH_AGENTC_ADD_SMARTCARD_KEY_CONSTRAINED 26
     78 
     79 #define	SSH_AGENT_CONSTRAIN_LIFETIME		1
     80 #define	SSH_AGENT_CONSTRAIN_CONFIRM		2
     81 
     82 /* extended failure messages */
     83 #define SSH2_AGENT_FAILURE			30
     84 
     85 /* additional error code for ssh.com's ssh-agent2 */
     86 #define SSH_COM_AGENT2_FAILURE			102
     87 
     88 #define	SSH_AGENT_OLD_SIGNATURE			0x01
     89 
     90 #endif				/* AUTHFD_H */
     91