docs: mention -S|--setsddl in sharesec manpage.
[Samba.git] / source4 / librpc / rpc / dcerpc_schannel.c
blobbe1ab240bd7c6a7a1624bae2bce447511cd75c0c
1 /*
2 Unix SMB/CIFS implementation.
4 dcerpc schannel operations
6 Copyright (C) Andrew Tridgell 2004
7 Copyright (C) Andrew Bartlett <abartlet@samba.org> 2004-2005
8 Copyright (C) Rafal Szczesniak 2006
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 #include "includes.h"
25 #include <tevent.h>
26 #include "auth/auth.h"
27 #include "libcli/composite/composite.h"
28 #include "libcli/auth/libcli_auth.h"
29 #include "librpc/gen_ndr/ndr_netlogon.h"
30 #include "librpc/gen_ndr/ndr_netlogon_c.h"
31 #include "auth/credentials/credentials.h"
32 #include "librpc/rpc/dcerpc_proto.h"
33 #include "param/param.h"
35 struct schannel_key_state {
36 struct dcerpc_pipe *pipe;
37 struct dcerpc_pipe *pipe2;
38 struct dcerpc_binding *binding;
39 bool dcerpc_schannel_auto;
40 struct cli_credentials *credentials;
41 struct netlogon_creds_CredentialState *creds;
42 uint32_t local_negotiate_flags;
43 uint32_t remote_negotiate_flags;
44 struct netr_Credential credentials1;
45 struct netr_Credential credentials2;
46 struct netr_Credential credentials3;
47 struct netr_ServerReqChallenge r;
48 struct netr_ServerAuthenticate2 a;
49 const struct samr_Password *mach_pwd;
53 static void continue_secondary_connection(struct composite_context *ctx);
54 static void continue_bind_auth_none(struct composite_context *ctx);
55 static void continue_srv_challenge(struct tevent_req *subreq);
56 static void continue_srv_auth2(struct tevent_req *subreq);
57 static void continue_get_capabilities(struct tevent_req *subreq);
61 Stage 2 of schannel_key: Receive endpoint mapping and request secondary
62 rpc connection
64 static void continue_epm_map_binding(struct composite_context *ctx)
66 struct composite_context *c;
67 struct schannel_key_state *s;
68 struct composite_context *sec_conn_req;
70 c = talloc_get_type(ctx->async.private_data, struct composite_context);
71 s = talloc_get_type(c->private_data, struct schannel_key_state);
73 /* receive endpoint mapping */
74 c->status = dcerpc_epm_map_binding_recv(ctx);
75 if (!NT_STATUS_IS_OK(c->status)) {
76 DEBUG(0,("Failed to map DCERPC/TCP NCACN_NP pipe for '%s' - %s\n",
77 NDR_NETLOGON_UUID, nt_errstr(c->status)));
78 composite_error(c, c->status);
79 return;
82 /* send a request for secondary rpc connection */
83 sec_conn_req = dcerpc_secondary_connection_send(s->pipe,
84 s->binding);
85 if (composite_nomem(sec_conn_req, c)) return;
87 composite_continue(c, sec_conn_req, continue_secondary_connection, c);
92 Stage 3 of schannel_key: Receive secondary rpc connection and perform
93 non-authenticated bind request
95 static void continue_secondary_connection(struct composite_context *ctx)
97 struct composite_context *c;
98 struct schannel_key_state *s;
99 struct composite_context *auth_none_req;
101 c = talloc_get_type(ctx->async.private_data, struct composite_context);
102 s = talloc_get_type(c->private_data, struct schannel_key_state);
104 /* receive secondary rpc connection */
105 c->status = dcerpc_secondary_connection_recv(ctx, &s->pipe2);
106 if (!composite_is_ok(c)) return;
108 talloc_steal(s, s->pipe2);
110 /* initiate a non-authenticated bind */
111 auth_none_req = dcerpc_bind_auth_none_send(c, s->pipe2, &ndr_table_netlogon);
112 if (composite_nomem(auth_none_req, c)) return;
114 composite_continue(c, auth_none_req, continue_bind_auth_none, c);
119 Stage 4 of schannel_key: Receive non-authenticated bind and get
120 a netlogon challenge
122 static void continue_bind_auth_none(struct composite_context *ctx)
124 struct composite_context *c;
125 struct schannel_key_state *s;
126 struct tevent_req *subreq;
128 c = talloc_get_type(ctx->async.private_data, struct composite_context);
129 s = talloc_get_type(c->private_data, struct schannel_key_state);
131 /* receive result of non-authenticated bind request */
132 c->status = dcerpc_bind_auth_none_recv(ctx);
133 if (!composite_is_ok(c)) return;
135 /* prepare a challenge request */
136 s->r.in.server_name = talloc_asprintf(c, "\\\\%s", dcerpc_server_name(s->pipe));
137 if (composite_nomem(s->r.in.server_name, c)) return;
138 s->r.in.computer_name = cli_credentials_get_workstation(s->credentials);
139 s->r.in.credentials = &s->credentials1;
140 s->r.out.return_credentials = &s->credentials2;
142 generate_random_buffer(s->credentials1.data, sizeof(s->credentials1.data));
145 request a netlogon challenge - a rpc request over opened secondary pipe
147 subreq = dcerpc_netr_ServerReqChallenge_r_send(s, c->event_ctx,
148 s->pipe2->binding_handle,
149 &s->r);
150 if (composite_nomem(subreq, c)) return;
152 tevent_req_set_callback(subreq, continue_srv_challenge, c);
157 Stage 5 of schannel_key: Receive a challenge and perform authentication
158 on the netlogon pipe
160 static void continue_srv_challenge(struct tevent_req *subreq)
162 struct composite_context *c;
163 struct schannel_key_state *s;
165 c = tevent_req_callback_data(subreq, struct composite_context);
166 s = talloc_get_type(c->private_data, struct schannel_key_state);
168 /* receive rpc request result - netlogon challenge */
169 c->status = dcerpc_netr_ServerReqChallenge_r_recv(subreq, s);
170 TALLOC_FREE(subreq);
171 if (!composite_is_ok(c)) return;
173 /* prepare credentials for auth2 request */
174 s->mach_pwd = cli_credentials_get_nt_hash(s->credentials, c);
176 /* auth2 request arguments */
177 s->a.in.server_name = s->r.in.server_name;
178 s->a.in.account_name = cli_credentials_get_username(s->credentials);
179 s->a.in.secure_channel_type =
180 cli_credentials_get_secure_channel_type(s->credentials);
181 s->a.in.computer_name = cli_credentials_get_workstation(s->credentials);
182 s->a.in.negotiate_flags = &s->local_negotiate_flags;
183 s->a.in.credentials = &s->credentials3;
184 s->a.out.negotiate_flags = &s->remote_negotiate_flags;
185 s->a.out.return_credentials = &s->credentials3;
187 s->creds = netlogon_creds_client_init(s,
188 s->a.in.account_name,
189 s->a.in.computer_name,
190 &s->credentials1, &s->credentials2,
191 s->mach_pwd, &s->credentials3,
192 s->local_negotiate_flags);
193 if (composite_nomem(s->creds, c)) {
194 return;
197 authenticate on the netlogon pipe - a rpc request over secondary pipe
199 subreq = dcerpc_netr_ServerAuthenticate2_r_send(s, c->event_ctx,
200 s->pipe2->binding_handle,
201 &s->a);
202 if (composite_nomem(subreq, c)) return;
204 tevent_req_set_callback(subreq, continue_srv_auth2, c);
209 Stage 6 of schannel_key: Receive authentication request result and verify
210 received credentials
212 static void continue_srv_auth2(struct tevent_req *subreq)
214 struct composite_context *c;
215 struct schannel_key_state *s;
217 c = tevent_req_callback_data(subreq, struct composite_context);
218 s = talloc_get_type(c->private_data, struct schannel_key_state);
220 /* receive rpc request result - auth2 credentials */
221 c->status = dcerpc_netr_ServerAuthenticate2_r_recv(subreq, s);
222 TALLOC_FREE(subreq);
223 if (!composite_is_ok(c)) return;
225 if (!NT_STATUS_EQUAL(s->a.out.result, NT_STATUS_ACCESS_DENIED) &&
226 !NT_STATUS_IS_OK(s->a.out.result)) {
227 composite_error(c, s->a.out.result);
228 return;
232 * Strong keys could be unsupported (NT4) or disables. So retry with the
233 * flags returned by the server. - asn
235 if (NT_STATUS_EQUAL(s->a.out.result, NT_STATUS_ACCESS_DENIED)) {
236 uint32_t lf = s->local_negotiate_flags;
237 const char *ln = NULL;
238 uint32_t rf = s->remote_negotiate_flags;
239 const char *rn = NULL;
241 if (!s->dcerpc_schannel_auto) {
242 composite_error(c, s->a.out.result);
243 return;
245 s->dcerpc_schannel_auto = false;
247 if (lf & NETLOGON_NEG_SUPPORTS_AES) {
248 ln = "aes";
249 if (rf & NETLOGON_NEG_SUPPORTS_AES) {
250 composite_error(c, s->a.out.result);
251 return;
253 } else if (lf & NETLOGON_NEG_STRONG_KEYS) {
254 ln = "strong";
255 if (rf & NETLOGON_NEG_STRONG_KEYS) {
256 composite_error(c, s->a.out.result);
257 return;
259 } else {
260 ln = "des";
263 if (rf & NETLOGON_NEG_SUPPORTS_AES) {
264 rn = "aes";
265 } else if (rf & NETLOGON_NEG_STRONG_KEYS) {
266 rn = "strong";
267 } else {
268 rn = "des";
271 DEBUG(3, ("Server doesn't support %s keys, downgrade to %s"
272 "and retry! local[0x%08X] remote[0x%08X]\n",
273 ln, rn, lf, rf));
275 s->local_negotiate_flags = s->remote_negotiate_flags;
277 generate_random_buffer(s->credentials1.data,
278 sizeof(s->credentials1.data));
280 subreq = dcerpc_netr_ServerReqChallenge_r_send(s,
281 c->event_ctx,
282 s->pipe2->binding_handle,
283 &s->r);
284 if (composite_nomem(subreq, c)) return;
286 tevent_req_set_callback(subreq, continue_srv_challenge, c);
287 return;
290 s->creds->negotiate_flags = s->remote_negotiate_flags;
292 /* verify credentials */
293 if (!netlogon_creds_client_check(s->creds, s->a.out.return_credentials)) {
294 composite_error(c, NT_STATUS_UNSUCCESSFUL);
295 return;
298 /* setup current netlogon credentials */
299 cli_credentials_set_netlogon_creds(s->credentials, s->creds);
301 composite_done(c);
305 Initiate establishing a schannel key using netlogon challenge
306 on a secondary pipe
308 struct composite_context *dcerpc_schannel_key_send(TALLOC_CTX *mem_ctx,
309 struct dcerpc_pipe *p,
310 struct cli_credentials *credentials,
311 struct loadparm_context *lp_ctx)
313 struct composite_context *c;
314 struct schannel_key_state *s;
315 struct composite_context *epm_map_req;
316 enum netr_SchannelType schannel_type = cli_credentials_get_secure_channel_type(credentials);
318 /* composite context allocation and setup */
319 c = composite_create(mem_ctx, p->conn->event_ctx);
320 if (c == NULL) return NULL;
322 s = talloc_zero(c, struct schannel_key_state);
323 if (composite_nomem(s, c)) return c;
324 c->private_data = s;
326 /* store parameters in the state structure */
327 s->pipe = p;
328 s->credentials = credentials;
329 s->local_negotiate_flags = NETLOGON_NEG_AUTH2_FLAGS;
331 /* allocate credentials */
332 if (s->pipe->conn->flags & DCERPC_SCHANNEL_128) {
333 s->local_negotiate_flags = NETLOGON_NEG_AUTH2_ADS_FLAGS;
335 if (s->pipe->conn->flags & DCERPC_SCHANNEL_AES) {
336 s->local_negotiate_flags = NETLOGON_NEG_AUTH2_ADS_FLAGS;
337 s->local_negotiate_flags |= NETLOGON_NEG_SUPPORTS_AES;
339 if (s->pipe->conn->flags & DCERPC_SCHANNEL_AUTO) {
340 s->local_negotiate_flags = NETLOGON_NEG_AUTH2_ADS_FLAGS;
341 s->local_negotiate_flags |= NETLOGON_NEG_SUPPORTS_AES;
342 s->dcerpc_schannel_auto = true;
345 /* type of authentication depends on schannel type */
346 if (schannel_type == SEC_CHAN_RODC) {
347 s->local_negotiate_flags |= NETLOGON_NEG_RODC_PASSTHROUGH;
350 /* allocate binding structure */
351 s->binding = talloc_zero(c, struct dcerpc_binding);
352 if (composite_nomem(s->binding, c)) return c;
354 *s->binding = *s->pipe->binding;
356 /* request the netlogon endpoint mapping */
357 epm_map_req = dcerpc_epm_map_binding_send(c, s->binding,
358 &ndr_table_netlogon,
359 s->pipe->conn->event_ctx,
360 lp_ctx);
361 if (composite_nomem(epm_map_req, c)) return c;
363 composite_continue(c, epm_map_req, continue_epm_map_binding, c);
364 return c;
369 Receive result of schannel key request
371 NTSTATUS dcerpc_schannel_key_recv(struct composite_context *c)
373 NTSTATUS status = composite_wait(c);
375 talloc_free(c);
376 return status;
380 struct auth_schannel_state {
381 struct dcerpc_pipe *pipe;
382 struct cli_credentials *credentials;
383 const struct ndr_interface_table *table;
384 struct loadparm_context *lp_ctx;
385 uint8_t auth_level;
386 struct netlogon_creds_CredentialState *creds_state;
387 struct netr_Authenticator auth;
388 struct netr_Authenticator return_auth;
389 union netr_Capabilities capabilities;
390 struct netr_LogonGetCapabilities c;
394 static void continue_bind_auth(struct composite_context *ctx);
398 Stage 2 of auth_schannel: Receive schannel key and intitiate an
399 authenticated bind using received credentials
401 static void continue_schannel_key(struct composite_context *ctx)
403 struct composite_context *auth_req;
404 struct composite_context *c = talloc_get_type(ctx->async.private_data,
405 struct composite_context);
406 struct auth_schannel_state *s = talloc_get_type(c->private_data,
407 struct auth_schannel_state);
408 NTSTATUS status;
410 /* receive schannel key */
411 status = c->status = dcerpc_schannel_key_recv(ctx);
412 if (!composite_is_ok(c)) {
413 DEBUG(1, ("Failed to setup credentials: %s\n", nt_errstr(status)));
414 return;
417 /* send bind auth request with received creds */
418 auth_req = dcerpc_bind_auth_send(c, s->pipe, s->table, s->credentials,
419 lpcfg_gensec_settings(c, s->lp_ctx),
420 DCERPC_AUTH_TYPE_SCHANNEL, s->auth_level,
421 NULL);
422 if (composite_nomem(auth_req, c)) return;
424 composite_continue(c, auth_req, continue_bind_auth, c);
429 Stage 3 of auth_schannel: Receivce result of authenticated bind
430 and say if we're done ok.
432 static void continue_bind_auth(struct composite_context *ctx)
434 struct composite_context *c = talloc_get_type(ctx->async.private_data,
435 struct composite_context);
436 struct auth_schannel_state *s = talloc_get_type(c->private_data,
437 struct auth_schannel_state);
438 struct tevent_req *subreq;
440 c->status = dcerpc_bind_auth_recv(ctx);
441 if (!composite_is_ok(c)) return;
443 /* if we have a AES encrypted connection, verify the capabilities */
444 if (ndr_syntax_id_equal(&s->table->syntax_id,
445 &ndr_table_netlogon.syntax_id)) {
446 ZERO_STRUCT(s->return_auth);
448 s->creds_state = cli_credentials_get_netlogon_creds(s->credentials);
449 if (composite_nomem(s->creds_state, c)) return;
451 netlogon_creds_client_authenticator(s->creds_state, &s->auth);
453 s->c.in.server_name = talloc_asprintf(c,
454 "\\\\%s",
455 dcerpc_server_name(s->pipe));
456 if (composite_nomem(s->c.in.server_name, c)) return;
457 s->c.in.computer_name = cli_credentials_get_workstation(s->credentials);
458 s->c.in.credential = &s->auth;
459 s->c.in.return_authenticator = &s->return_auth;
460 s->c.in.query_level = 1;
462 s->c.out.capabilities = &s->capabilities;
463 s->c.out.return_authenticator = &s->return_auth;
465 DEBUG(5, ("We established a AES connection, verifying logon "
466 "capabilities\n"));
468 subreq = dcerpc_netr_LogonGetCapabilities_r_send(s,
469 c->event_ctx,
470 s->pipe->binding_handle,
471 &s->c);
472 if (composite_nomem(subreq, c)) return;
474 tevent_req_set_callback(subreq, continue_get_capabilities, c);
475 return;
478 composite_done(c);
482 Stage 4 of auth_schannel: Get the Logon Capablities and verify them.
484 static void continue_get_capabilities(struct tevent_req *subreq)
486 struct composite_context *c;
487 struct auth_schannel_state *s;
489 c = tevent_req_callback_data(subreq, struct composite_context);
490 s = talloc_get_type(c->private_data, struct auth_schannel_state);
492 /* receive rpc request result */
493 c->status = dcerpc_netr_LogonGetCapabilities_r_recv(subreq, s);
494 TALLOC_FREE(subreq);
495 if (NT_STATUS_EQUAL(c->status, NT_STATUS_RPC_PROCNUM_OUT_OF_RANGE)) {
496 if (s->creds_state->negotiate_flags & NETLOGON_NEG_SUPPORTS_AES) {
497 composite_error(c, NT_STATUS_INVALID_NETWORK_RESPONSE);
498 return;
499 } else {
500 /* This is probably NT */
501 composite_done(c);
502 return;
504 } else if (!composite_is_ok(c)) {
505 return;
508 if (NT_STATUS_EQUAL(s->c.out.result, NT_STATUS_NOT_IMPLEMENTED)) {
509 if (s->creds_state->negotiate_flags & NETLOGON_NEG_SUPPORTS_AES) {
510 /* This means AES isn't supported. */
511 composite_error(c, NT_STATUS_INVALID_NETWORK_RESPONSE);
512 return;
515 /* This is probably an old Samba version */
516 composite_done(c);
517 return;
520 /* verify credentials */
521 if (!netlogon_creds_client_check(s->creds_state,
522 &s->c.out.return_authenticator->cred)) {
523 composite_error(c, NT_STATUS_UNSUCCESSFUL);
524 return;
527 if (!NT_STATUS_IS_OK(s->c.out.result)) {
528 composite_error(c, s->c.out.result);
529 return;
532 /* compare capabilities */
533 if (s->creds_state->negotiate_flags != s->capabilities.server_capabilities) {
534 DEBUG(2, ("The client capabilities don't match the server "
535 "capabilities: local[0x%08X] remote[0x%08X]\n",
536 s->creds_state->negotiate_flags,
537 s->capabilities.server_capabilities));
538 composite_error(c, NT_STATUS_INVALID_NETWORK_RESPONSE);
539 return;
542 /* TODO: Add downgrade dectection. */
544 composite_done(c);
549 Initiate schannel authentication request
551 struct composite_context *dcerpc_bind_auth_schannel_send(TALLOC_CTX *tmp_ctx,
552 struct dcerpc_pipe *p,
553 const struct ndr_interface_table *table,
554 struct cli_credentials *credentials,
555 struct loadparm_context *lp_ctx,
556 uint8_t auth_level)
558 struct composite_context *c;
559 struct auth_schannel_state *s;
560 struct composite_context *schan_key_req;
562 /* composite context allocation and setup */
563 c = composite_create(tmp_ctx, p->conn->event_ctx);
564 if (c == NULL) return NULL;
566 s = talloc_zero(c, struct auth_schannel_state);
567 if (composite_nomem(s, c)) return c;
568 c->private_data = s;
570 /* store parameters in the state structure */
571 s->pipe = p;
572 s->credentials = credentials;
573 s->table = table;
574 s->auth_level = auth_level;
575 s->lp_ctx = lp_ctx;
577 /* start getting schannel key first */
578 schan_key_req = dcerpc_schannel_key_send(c, p, credentials, lp_ctx);
579 if (composite_nomem(schan_key_req, c)) return c;
581 composite_continue(c, schan_key_req, continue_schannel_key, c);
582 return c;
587 Receive result of schannel authentication request
589 NTSTATUS dcerpc_bind_auth_schannel_recv(struct composite_context *c)
591 NTSTATUS status = composite_wait(c);
593 talloc_free(c);
594 return status;
599 Perform schannel authenticated bind - sync version
601 _PUBLIC_ NTSTATUS dcerpc_bind_auth_schannel(TALLOC_CTX *tmp_ctx,
602 struct dcerpc_pipe *p,
603 const struct ndr_interface_table *table,
604 struct cli_credentials *credentials,
605 struct loadparm_context *lp_ctx,
606 uint8_t auth_level)
608 struct composite_context *c;
610 c = dcerpc_bind_auth_schannel_send(tmp_ctx, p, table, credentials, lp_ctx,
611 auth_level);
612 return dcerpc_bind_auth_schannel_recv(c);