4 Unix SMB/CIFS implementation.
5 Standardised Authentication types
6 Copyright (C) Andrew Bartlett 2001
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 /* AUTH_STR - string */
24 typedef struct normal_string
30 /* AUTH_UNISTR - unicode string or buffer */
31 typedef struct unicode_string
37 typedef struct interactive_password
39 OWF_INFO lm_owf; /* LM OWF Password */
40 OWF_INFO nt_owf; /* NT OWF Password */
41 } auth_interactive_password;
43 #define AUTH_FLAG_NONE 0x000000
44 #define AUTH_FLAG_PLAINTEXT 0x000001
45 #define AUTH_FLAG_LM_RESP 0x000002
46 #define AUTH_FLAG_NTLM_RESP 0x000004
47 #define AUTH_FLAG_NTLMv2_RESP 0x000008
49 typedef struct auth_usersupplied_info
54 auth_interactive_password * interactive_password;
55 DATA_BLOB plaintext_password;
61 AUTH_STR client_domain; /* domain name string */
62 AUTH_STR domain; /* domain name after mapping */
63 AUTH_STR internal_username; /* username after mapping */
64 AUTH_STR smb_name; /* username before mapping */
65 AUTH_STR wksta_name; /* workstation name (netbios calling name) unicode string */
67 } auth_usersupplied_info;
69 #define SAM_FILL_NAME 0x01
70 #define SAM_FILL_INFO3 0x02
71 #define SAM_FILL_SAM 0x04
72 #define SAM_FILL_UNIX 0x08
73 #define SAM_FILL_ALL (SAM_FILL_NAME | SAM_FILL_INFO3 | SAM_FILL_SAM | SAM_FILL_UNIX)
75 typedef struct auth_serversupplied_info
82 /* This groups info is needed for when we become_user() for this uid */
86 /* NT group information taken from the info3 structure */
90 uint8 session_key[16];
92 uint8 first_8_lm_hash[8];
94 uint32 sam_fill_level; /* How far is this structure filled? */
96 SAM_ACCOUNT *sam_account;
102 } auth_serversupplied_info;
104 struct auth_context {
107 /* Who set this up in the first place? */
108 const char *challenge_set_by;
110 struct auth_methods *challenge_set_method;
111 /* What order are the various methods in? Try to stop it changing under us */
112 struct auth_methods *auth_method_list;
115 const uint8 *(*get_ntlm_challenge)(struct auth_context *auth_context);
116 NTSTATUS (*check_ntlm_password)(const struct auth_context *auth_context,
117 const struct auth_usersupplied_info *user_info,
118 struct auth_serversupplied_info **server_info);
119 NTSTATUS (*nt_status_squash)(NTSTATUS nt_status);
120 void (*free)(struct auth_context **auth_context);
123 typedef struct auth_methods
125 struct auth_methods *prev, *next;
126 const char *name; /* What name got this module */
128 NTSTATUS (*auth)(const struct auth_context *auth_context,
129 void *my_private_data,
131 const struct auth_usersupplied_info *user_info,
132 auth_serversupplied_info **server_info);
134 DATA_BLOB (*get_chal)(const struct auth_context *auth_context,
135 void **my_private_data,
136 TALLOC_CTX *mem_ctx);
138 /* Used to keep tabs on things like the cli for SMB server authentication */
141 /* Function to clean up the above arbitary structure */
142 void (*free_private_data)(void **private_data);
144 /* Function to send a keepalive message on the above structure */
145 void (*send_keepalive)(void **private_data);
149 typedef NTSTATUS (*auth_init_function)(struct auth_context *, const char *, struct auth_methods **);
151 struct auth_init_function_entry {
153 /* Function to create a member of the authmethods list */
155 auth_init_function init;
157 struct auth_init_function_entry *prev, *next;
160 typedef struct auth_ntlmssp_state
163 struct auth_context *auth_context;
164 struct auth_serversupplied_info *server_info;
165 struct ntlmssp_state *ntlmssp_state;
166 } AUTH_NTLMSSP_STATE;
168 #define AUTH_INTERFACE_VERSION 1
170 #endif /* _SMBAUTH_H_ */