Annotation of src/usr.bin/ssh/auth.h, Revision 1.16
1.5 deraadt 1: /*
2: * Copyright (c) 2000 Markus Friedl. All rights reserved.
3: *
4: * Redistribution and use in source and binary forms, with or without
5: * modification, are permitted provided that the following conditions
6: * are met:
7: * 1. Redistributions of source code must retain the above copyright
8: * notice, this list of conditions and the following disclaimer.
9: * 2. Redistributions in binary form must reproduce the above copyright
10: * notice, this list of conditions and the following disclaimer in the
11: * documentation and/or other materials provided with the distribution.
12: *
13: * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
14: * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
15: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
16: * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
17: * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
18: * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
19: * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
20: * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
22: * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
1.7 djm 23: *
1.16 ! markus 24: * $OpenBSD: auth.h,v 1.15 2001/04/12 19:15:24 markus Exp $
1.5 deraadt 25: */
1.1 markus 26: #ifndef AUTH_H
27: #define AUTH_H
28:
1.10 markus 29: #include <openssl/rsa.h>
30:
1.13 markus 31: #ifdef HAVE_LOGIN_CAP
32: #include <login_cap.h>
33: #endif
34: #ifdef BSD_AUTH
35: #include <bsd_auth.h>
36: #endif
37:
1.6 markus 38: typedef struct Authctxt Authctxt;
1.16 ! markus 39: typedef struct KbdintDevice KbdintDevice;
! 40:
1.6 markus 41: struct Authctxt {
42: int success;
1.9 markus 43: int postponed;
1.6 markus 44: int valid;
45: int attempt;
1.8 markus 46: int failures;
1.6 markus 47: char *user;
48: char *service;
49: struct passwd *pw;
1.9 markus 50: char *style;
1.16 ! markus 51: void *kbdintctxt;
1.13 markus 52: #ifdef BSD_AUTH
53: auth_session_t *as;
54: #endif
1.6 markus 55: };
1.10 markus 56:
57: /*
1.16 ! markus 58: * Keyboard interactive device:
! 59: * init_ctx returns: non NULL upon success
! 60: * query returns: 0 - success, otherwise failure
! 61: * respond returns: 0 - success, 1 - need further interaction,
! 62: * otherwise - failure
! 63: */
! 64: struct KbdintDevice
! 65: {
! 66: const char *name;
! 67: void* (*init_ctx) __P((Authctxt*));
! 68: int (*query) __P((void *ctx, char **name, char **infotxt,
! 69: u_int *numprompts, char ***prompts,
! 70: u_int **echo_on));
! 71: int (*respond) __P((void *ctx, u_int numresp, char **responses));
! 72: void (*free_ctx) __P((void *ctx));
! 73: };
! 74:
! 75: /*
1.10 markus 76: * Tries to authenticate the user using the .rhosts file. Returns true if
77: * authentication succeeds. If ignore_rhosts is non-zero, this will not
78: * consider .rhosts and .shosts (/etc/hosts.equiv will still be used).
79: */
80: int auth_rhosts(struct passwd * pw, const char *client_user);
1.15 markus 81:
82: /* extended interface similar to auth_rhosts() */
83: int
84: auth_rhosts2(struct passwd *pw, const char *client_user, const char *hostname,
85: const char *ipaddr);
1.10 markus 86:
87: /*
88: * Tries to authenticate the user using the .rhosts file and the host using
89: * its host key. Returns true if authentication succeeds.
90: */
91: int
92: auth_rhosts_rsa(struct passwd * pw, const char *client_user, RSA* client_host_key);
93:
94: /*
95: * Tries to authenticate the user using password. Returns true if
96: * authentication succeeds.
97: */
1.13 markus 98: int auth_password(Authctxt *authctxt, const char *password);
1.10 markus 99:
100: /*
101: * Performs the RSA authentication dialog with the client. This returns 0 if
102: * the client could not be authenticated, and 1 if authentication was
103: * successful. This may exit if there is a serious protocol violation.
104: */
105: int auth_rsa(struct passwd * pw, BIGNUM * client_n);
106:
107: /*
108: * Parses an RSA key (number of bits, e, n) from a string. Moves the pointer
109: * over the key. Skips any whitespace at the beginning and at end.
110: */
111: int auth_rsa_read_key(char **cpp, u_int *bitsp, BIGNUM * e, BIGNUM * n);
112:
113: /*
114: * Performs the RSA authentication challenge-response dialog with the client,
115: * and returns true (non-zero) if the client gave the correct answer to our
116: * challenge; returns zero if the client gives a wrong answer.
117: */
118: int auth_rsa_challenge_dialog(RSA *pk);
119:
120: #ifdef KRB4
121: #include <krb.h>
122: /*
123: * Performs Kerberos v4 mutual authentication with the client. This returns 0
124: * if the client could not be authenticated, and 1 if authentication was
125: * successful. This may exit if there is a serious protocol violation.
126: */
127: int auth_krb4(const char *server_user, KTEXT auth, char **client);
128: int krb4_init(uid_t uid);
129: void krb4_cleanup_proc(void *ignore);
130: int auth_krb4_password(struct passwd * pw, const char *password);
131:
132: #ifdef AFS
133: #include <kafs.h>
134:
135: /* Accept passed Kerberos v4 ticket-granting ticket and AFS tokens. */
136: int auth_kerberos_tgt(struct passwd * pw, const char *string);
137: int auth_afs_token(struct passwd * pw, const char *token_string);
138: #endif /* AFS */
139:
140: #endif /* KRB4 */
1.6 markus 141:
1.1 markus 142: void do_authentication(void);
1.2 markus 143: void do_authentication2(void);
144:
1.9 markus 145: Authctxt *authctxt_new(void);
146: void auth_log(Authctxt *authctxt, int authenticated, char *method, char *info);
1.14 markus 147: void userauth_finish(Authctxt *authctxt, int authenticated, char *method);
1.11 markus 148: int auth_root_allowed(char *method);
1.6 markus 149:
1.9 markus 150: int auth2_challenge(Authctxt *authctxt, char *devs);
1.1 markus 151:
1.6 markus 152: int allowed_user(struct passwd * pw);
1.9 markus 153:
1.16 ! markus 154: char *get_challenge(Authctxt *authctxt);
! 155: int verify_response(Authctxt *authctxt, const char *response);
1.9 markus 156:
1.6 markus 157: struct passwd * auth_get_user(void);
1.3 markus 158:
159: #define AUTH_FAIL_MAX 6
160: #define AUTH_FAIL_LOG (AUTH_FAIL_MAX/2)
161: #define AUTH_FAIL_MSG "Too many authentication failures for %.100s"
162:
1.1 markus 163: #endif