2 Unix SMB/CIFS implementation.
3 Standardised Authentication types
4 Copyright (C) Andrew Bartlett 2001
5 Copyright (C) Stefan Metzmacher 2005
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 #include "librpc/gen_ndr/ndr_krb5pac.h"
25 #include "librpc/gen_ndr/auth.h"
26 #include "../auth/common_auth.h"
28 extern const char *krbtgt_attrs
[];
29 extern const char *server_attrs
[];
30 extern const char *user_attrs
[];
32 union netr_Validation
;
33 struct netr_SamBaseInfo
;
35 struct loadparm_context
;
37 /* modules can use the following to determine if the interface has changed
38 * please increment the version number after each interface change
39 * with a comment and maybe update struct auth_critical_sizes.
41 /* version 1 - version from samba 3.0 - metze */
42 /* version 2 - initial samba4 version - metze */
43 /* version 3 - subsequent samba4 version - abartlet */
44 /* version 4 - subsequent samba4 version - metze */
45 /* version 0 - till samba4 is stable - metze */
46 #define AUTH4_INTERFACE_VERSION 0
48 struct auth_method_context
;
49 struct auth_check_password_request
;
51 struct auth_session_info
;
53 struct smb_krb5_context
;
55 struct auth_operations
{
58 /* Given the user supplied info, check if this backend want to handle the password checking */
60 NTSTATUS (*want_check
)(struct auth_method_context
*ctx
, TALLOC_CTX
*mem_ctx
,
61 const struct auth_usersupplied_info
*user_info
);
63 /* Given the user supplied info, check a password */
65 NTSTATUS (*check_password
)(struct auth_method_context
*ctx
, TALLOC_CTX
*mem_ctx
,
66 const struct auth_usersupplied_info
*user_info
,
67 struct auth_user_info_dc
**interim_info
);
69 /* Lookup a 'session info interim' return based only on the principal or DN */
70 NTSTATUS (*get_user_info_dc_principal
)(TALLOC_CTX
*mem_ctx
,
71 struct auth4_context
*auth_context
,
72 const char *principal
,
73 struct ldb_dn
*user_dn
,
74 struct auth_user_info_dc
**interim_info
);
78 struct auth_method_context
{
79 struct auth_method_context
*prev
, *next
;
80 struct auth4_context
*auth_ctx
;
81 const struct auth_operations
*ops
;
86 /* this structure is used by backends to determine the size of some critical types */
87 struct auth_critical_sizes
{
88 int interface_version
;
89 int sizeof_auth_operations
;
90 int sizeof_auth_methods
;
91 int sizeof_auth_context
;
92 int sizeof_auth_usersupplied_info
;
93 int sizeof_auth_user_info_dc
;
96 NTSTATUS
encrypt_user_info(TALLOC_CTX
*mem_ctx
, struct auth4_context
*auth_context
,
97 enum auth_password_state to_state
,
98 const struct auth_usersupplied_info
*user_info_in
,
99 const struct auth_usersupplied_info
**user_info_encrypted
);
101 #include "auth/session.h"
102 #include "auth/unix_token_proto.h"
103 #include "auth/system_session_proto.h"
104 #include "libcli/security/security.h"
108 struct gensec_security
;
109 struct cli_credentials
;
111 NTSTATUS
auth_get_challenge(struct auth4_context
*auth_ctx
, uint8_t chal
[8]);
112 NTSTATUS
authsam_account_ok(TALLOC_CTX
*mem_ctx
,
113 struct ldb_context
*sam_ctx
,
114 uint32_t logon_parameters
,
115 struct ldb_dn
*domain_dn
,
116 struct ldb_message
*msg
,
117 const char *logon_workstation
,
118 const char *name_for_logs
,
119 bool allow_domain_trust
,
120 bool password_change
);
122 struct auth_session_info
*system_session(struct loadparm_context
*lp_ctx
);
123 NTSTATUS
authsam_make_user_info_dc(TALLOC_CTX
*mem_ctx
, struct ldb_context
*sam_ctx
,
124 const char *netbios_name
,
125 const char *domain_name
,
126 const char *dns_domain_name
,
127 struct ldb_dn
*domain_dn
,
128 struct ldb_message
*msg
,
129 DATA_BLOB user_sess_key
, DATA_BLOB lm_sess_key
,
130 struct auth_user_info_dc
**_user_info_dc
);
131 NTSTATUS
auth_system_session_info(TALLOC_CTX
*parent_ctx
,
132 struct loadparm_context
*lp_ctx
,
133 struct auth_session_info
**_session_info
) ;
135 NTSTATUS
auth_context_create_methods(TALLOC_CTX
*mem_ctx
, const char * const *methods
,
136 struct tevent_context
*ev
,
137 struct imessaging_context
*msg
,
138 struct loadparm_context
*lp_ctx
,
139 struct ldb_context
*sam_ctx
,
140 struct auth4_context
**auth_ctx
);
141 const char **auth_methods_from_lp(TALLOC_CTX
*mem_ctx
, struct loadparm_context
*lp_ctx
);
143 NTSTATUS
auth_context_create(TALLOC_CTX
*mem_ctx
,
144 struct tevent_context
*ev
,
145 struct imessaging_context
*msg
,
146 struct loadparm_context
*lp_ctx
,
147 struct auth4_context
**auth_ctx
);
149 NTSTATUS
auth_check_password_wrapper(struct auth4_context
*auth_ctx
,
151 const struct auth_usersupplied_info
*user_info
,
152 void **server_returned_info
,
153 DATA_BLOB
*user_session_key
, DATA_BLOB
*lm_session_key
);
155 NTSTATUS
auth_check_password(struct auth4_context
*auth_ctx
,
157 const struct auth_usersupplied_info
*user_info
,
158 struct auth_user_info_dc
**user_info_dc
);
159 NTSTATUS
auth4_init(void);
160 NTSTATUS
auth_register(const struct auth_operations
*ops
);
161 NTSTATUS
server_service_auth_init(void);
162 NTSTATUS
authenticate_username_pw(TALLOC_CTX
*mem_ctx
,
163 struct tevent_context
*ev
,
164 struct imessaging_context
*msg
,
165 struct loadparm_context
*lp_ctx
,
166 const char *nt4_domain
,
167 const char *nt4_username
,
168 const char *password
,
169 const uint32_t logon_parameters
,
170 struct auth_session_info
**session_info
);
172 struct tevent_req
*auth_check_password_send(TALLOC_CTX
*mem_ctx
,
173 struct tevent_context
*ev
,
174 struct auth4_context
*auth_ctx
,
175 const struct auth_usersupplied_info
*user_info
);
176 NTSTATUS
auth_check_password_recv(struct tevent_req
*req
,
178 struct auth_user_info_dc
**user_info_dc
);
180 bool auth_challenge_may_be_modified(struct auth4_context
*auth_ctx
);
181 NTSTATUS
auth_context_set_challenge(struct auth4_context
*auth_ctx
, const uint8_t chal
[8], const char *set_by
);
183 NTSTATUS
auth_get_user_info_dc_principal(TALLOC_CTX
*mem_ctx
,
184 struct auth4_context
*auth_ctx
,
185 const char *principal
,
186 struct ldb_dn
*user_dn
,
187 struct auth_user_info_dc
**user_info_dc
);
189 NTSTATUS
samba_server_gensec_start(TALLOC_CTX
*mem_ctx
,
190 struct tevent_context
*event_ctx
,
191 struct imessaging_context
*msg_ctx
,
192 struct loadparm_context
*lp_ctx
,
193 struct cli_credentials
*server_credentials
,
194 const char *target_service
,
195 struct gensec_security
**gensec_context
);
197 #endif /* _SMBAUTH_H_ */