2 Unix SMB/CIFS implementation.
4 dcerpc utility functions
6 Copyright (C) Andrew Tridgell 2003
7 Copyright (C) Jelmer Vernooij 2004
8 Copyright (C) Andrew Bartlett <abartlet@samba.org> 2005
9 Copyright (C) Rafal Szczesniak 2006
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 3 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program. If not, see <http://www.gnu.org/licenses/>.
26 #include "lib/events/events.h"
27 #include "libcli/composite/composite.h"
28 #include "librpc/gen_ndr/ndr_epmapper_c.h"
29 #include "librpc/gen_ndr/ndr_dcerpc.h"
30 #include "librpc/gen_ndr/ndr_misc.h"
31 #include "auth/credentials/credentials.h"
32 #include "param/param.h"
35 find a dcerpc call on an interface by name
37 const struct ndr_interface_call *dcerpc_iface_find_call(const struct ndr_interface_table *iface,
41 for (i=0;i<iface->num_calls;i++) {
42 if (strcmp(iface->calls[i].name, name) == 0) {
43 return &iface->calls[i];
50 push a ncacn_packet into a blob, potentially with auth info
52 NTSTATUS ncacn_push_auth(DATA_BLOB *blob, TALLOC_CTX *mem_ctx,
53 struct smb_iconv_convenience *iconv_convenience,
54 struct ncacn_packet *pkt,
55 struct dcerpc_auth *auth_info)
58 enum ndr_err_code ndr_err;
60 ndr = ndr_push_init_ctx(mem_ctx, iconv_convenience);
62 return NT_STATUS_NO_MEMORY;
65 if (!(pkt->drep[0] & DCERPC_DREP_LE)) {
66 ndr->flags |= LIBNDR_FLAG_BIGENDIAN;
69 if (pkt->pfc_flags & DCERPC_PFC_FLAG_OBJECT_UUID) {
70 ndr->flags |= LIBNDR_FLAG_OBJECT_PRESENT;
74 pkt->auth_length = auth_info->credentials.length;
79 ndr_err = ndr_push_ncacn_packet(ndr, NDR_SCALARS|NDR_BUFFERS, pkt);
80 if (!NDR_ERR_CODE_IS_SUCCESS(ndr_err)) {
81 return ndr_map_error2ntstatus(ndr_err);
85 ndr_err = ndr_push_dcerpc_auth(ndr, NDR_SCALARS|NDR_BUFFERS, auth_info);
86 if (!NDR_ERR_CODE_IS_SUCCESS(ndr_err)) {
87 return ndr_map_error2ntstatus(ndr_err);
91 *blob = ndr_push_blob(ndr);
93 /* fill in the frag length */
94 dcerpc_set_frag_length(blob, blob->length);
99 #define MAX_PROTSEQ 10
101 static const struct {
103 enum dcerpc_transport_t transport;
105 enum epm_protocol protseq[MAX_PROTSEQ];
107 { "ncacn_np", NCACN_NP, 3,
108 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_SMB, EPM_PROTOCOL_NETBIOS }},
109 { "ncacn_ip_tcp", NCACN_IP_TCP, 3,
110 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_TCP, EPM_PROTOCOL_IP } },
111 { "ncacn_http", NCACN_HTTP, 3,
112 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_HTTP, EPM_PROTOCOL_IP } },
113 { "ncadg_ip_udp", NCACN_IP_UDP, 3,
114 { EPM_PROTOCOL_NCADG, EPM_PROTOCOL_UDP, EPM_PROTOCOL_IP } },
115 { "ncalrpc", NCALRPC, 2,
116 { EPM_PROTOCOL_NCALRPC, EPM_PROTOCOL_PIPE } },
117 { "ncacn_unix_stream", NCACN_UNIX_STREAM, 2,
118 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_UNIX_DS } },
119 { "ncadg_unix_dgram", NCADG_UNIX_DGRAM, 2,
120 { EPM_PROTOCOL_NCADG, EPM_PROTOCOL_UNIX_DS } },
121 { "ncacn_at_dsp", NCACN_AT_DSP, 3,
122 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_APPLETALK, EPM_PROTOCOL_DSP } },
123 { "ncadg_at_ddp", NCADG_AT_DDP, 3,
124 { EPM_PROTOCOL_NCADG, EPM_PROTOCOL_APPLETALK, EPM_PROTOCOL_DDP } },
125 { "ncacn_vns_ssp", NCACN_VNS_SPP, 3,
126 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_STREETTALK, EPM_PROTOCOL_VINES_SPP } },
127 { "ncacn_vns_ipc", NCACN_VNS_IPC, 3,
128 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_STREETTALK, EPM_PROTOCOL_VINES_IPC }, },
129 { "ncadg_ipx", NCADG_IPX, 2,
130 { EPM_PROTOCOL_NCADG, EPM_PROTOCOL_IPX },
132 { "ncacn_spx", NCACN_SPX, 3,
133 /* I guess some MS programmer confused the identifier for
134 * EPM_PROTOCOL_UUID (0x0D or 13) with the one for
135 * EPM_PROTOCOL_SPX (0x13) here. -- jelmer*/
136 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_NCALRPC, EPM_PROTOCOL_UUID },
140 static const struct {
143 } ncacn_options[] = {
144 {"sign", DCERPC_SIGN},
145 {"seal", DCERPC_SEAL},
146 {"connect", DCERPC_CONNECT},
147 {"spnego", DCERPC_AUTH_SPNEGO},
148 {"ntlm", DCERPC_AUTH_NTLM},
149 {"krb5", DCERPC_AUTH_KRB5},
150 {"validate", DCERPC_DEBUG_VALIDATE_BOTH},
151 {"print", DCERPC_DEBUG_PRINT_BOTH},
152 {"padcheck", DCERPC_DEBUG_PAD_CHECK},
153 {"bigendian", DCERPC_PUSH_BIGENDIAN},
154 {"smb2", DCERPC_SMB2}
157 const char *epm_floor_string(TALLOC_CTX *mem_ctx, struct epm_floor *epm_floor)
159 struct ndr_syntax_id syntax;
162 switch(epm_floor->lhs.protocol) {
163 case EPM_PROTOCOL_UUID:
164 status = dcerpc_floor_get_lhs_data(epm_floor, &syntax);
165 if (NT_STATUS_IS_OK(status)) {
166 /* lhs is used: UUID */
169 if (GUID_equal(&syntax.uuid, &ndr_transfer_syntax.uuid)) {
173 if (GUID_equal(&syntax.uuid, &ndr64_transfer_syntax.uuid)) {
177 uuidstr = GUID_string(mem_ctx, &syntax.uuid);
179 return talloc_asprintf(mem_ctx, " uuid %s/0x%02x", uuidstr, syntax.if_version);
181 return talloc_asprintf(mem_ctx, "IPX:%s",
182 data_blob_hex_string(mem_ctx, &epm_floor->rhs.uuid.unknown));
185 case EPM_PROTOCOL_NCACN:
188 case EPM_PROTOCOL_NCADG:
191 case EPM_PROTOCOL_NCALRPC:
194 case EPM_PROTOCOL_DNET_NSP:
197 case EPM_PROTOCOL_IP:
198 return talloc_asprintf(mem_ctx, "IP:%s", epm_floor->rhs.ip.ipaddr);
200 case EPM_PROTOCOL_PIPE:
201 return talloc_asprintf(mem_ctx, "PIPE:%s", epm_floor->rhs.pipe.path);
203 case EPM_PROTOCOL_SMB:
204 return talloc_asprintf(mem_ctx, "SMB:%s", epm_floor->rhs.smb.unc);
206 case EPM_PROTOCOL_UNIX_DS:
207 return talloc_asprintf(mem_ctx, "Unix:%s", epm_floor->rhs.unix_ds.path);
209 case EPM_PROTOCOL_NETBIOS:
210 return talloc_asprintf(mem_ctx, "NetBIOS:%s", epm_floor->rhs.netbios.name);
212 case EPM_PROTOCOL_NETBEUI:
215 case EPM_PROTOCOL_SPX:
218 case EPM_PROTOCOL_NB_IPX:
221 case EPM_PROTOCOL_HTTP:
222 return talloc_asprintf(mem_ctx, "HTTP:%d", epm_floor->rhs.http.port);
224 case EPM_PROTOCOL_TCP:
225 return talloc_asprintf(mem_ctx, "TCP:%d", epm_floor->rhs.tcp.port);
227 case EPM_PROTOCOL_UDP:
228 return talloc_asprintf(mem_ctx, "UDP:%d", epm_floor->rhs.udp.port);
231 return talloc_asprintf(mem_ctx, "UNK(%02x):", epm_floor->lhs.protocol);
237 form a binding string from a binding structure
239 char *dcerpc_binding_string(TALLOC_CTX *mem_ctx, const struct dcerpc_binding *b)
241 char *s = talloc_strdup(mem_ctx, "");
243 const char *t_name = NULL;
245 if (b->transport != NCA_UNKNOWN) {
246 for (i=0;i<ARRAY_SIZE(transports);i++) {
247 if (transports[i].transport == b->transport) {
248 t_name = transports[i].name;
256 if (!GUID_all_zero(&b->object.uuid)) {
257 s = talloc_asprintf(s, "%s@",
258 GUID_string(mem_ctx, &b->object.uuid));
261 if (t_name != NULL) {
262 s = talloc_asprintf_append_buffer(s, "%s:", t_name);
269 s = talloc_asprintf_append_buffer(s, "%s", b->host);
272 if (!b->endpoint && !b->options && !b->flags) {
276 s = talloc_asprintf_append_buffer(s, "[");
279 s = talloc_asprintf_append_buffer(s, "%s", b->endpoint);
282 /* this is a *really* inefficent way of dealing with strings,
283 but this is rarely called and the strings are always short,
285 for (i=0;b->options && b->options[i];i++) {
286 s = talloc_asprintf_append_buffer(s, ",%s", b->options[i]);
290 for (i=0;i<ARRAY_SIZE(ncacn_options);i++) {
291 if (b->flags & ncacn_options[i].flag) {
292 s = talloc_asprintf_append_buffer(s, ",%s", ncacn_options[i].name);
297 s = talloc_asprintf_append_buffer(s, "]");
303 parse a binding string into a dcerpc_binding structure
305 NTSTATUS dcerpc_parse_binding(TALLOC_CTX *mem_ctx, const char *s, struct dcerpc_binding **b_out)
307 struct dcerpc_binding *b;
310 int i, j, comma_count;
312 b = talloc(mem_ctx, struct dcerpc_binding);
314 return NT_STATUS_NO_MEMORY;
319 if (p && PTR_DIFF(p, s) == 36) { /* 36 is the length of a UUID */
322 status = GUID_from_string(s, &b->object.uuid);
324 if (NT_STATUS_IS_ERR(status)) {
325 DEBUG(0, ("Failed parsing UUID\n"));
331 ZERO_STRUCT(b->object);
334 b->object.if_version = 0;
339 b->transport = NCA_UNKNOWN;
341 char *type = talloc_strndup(mem_ctx, s, PTR_DIFF(p, s));
343 return NT_STATUS_NO_MEMORY;
346 for (i=0;i<ARRAY_SIZE(transports);i++) {
347 if (strcasecmp(type, transports[i].name) == 0) {
348 b->transport = transports[i].transport;
353 if (i==ARRAY_SIZE(transports)) {
354 DEBUG(0,("Unknown dcerpc transport '%s'\n", type));
355 return NT_STATUS_INVALID_PARAMETER;
365 b->host = talloc_strndup(b, s, PTR_DIFF(p, s));
366 options = talloc_strdup(mem_ctx, p+1);
367 if (options[strlen(options)-1] != ']') {
368 return NT_STATUS_INVALID_PARAMETER;
370 options[strlen(options)-1] = 0;
372 b->host = talloc_strdup(b, s);
376 return NT_STATUS_NO_MEMORY;
379 b->target_hostname = b->host;
383 b->assoc_group_id = 0;
391 comma_count = count_chars(options, ',');
393 b->options = talloc_array(b, const char *, comma_count+2);
395 return NT_STATUS_NO_MEMORY;
398 for (i=0; (p = strchr(options, ',')); i++) {
399 b->options[i] = talloc_strndup(b, options, PTR_DIFF(p, options));
400 if (!b->options[i]) {
401 return NT_STATUS_NO_MEMORY;
405 b->options[i] = options;
406 b->options[i+1] = NULL;
408 /* some options are pre-parsed for convenience */
409 for (i=0;b->options[i];i++) {
410 for (j=0;j<ARRAY_SIZE(ncacn_options);j++) {
411 if (strcasecmp(ncacn_options[j].name, b->options[i]) == 0) {
413 b->flags |= ncacn_options[j].flag;
414 for (k=i;b->options[k];k++) {
415 b->options[k] = b->options[k+1];
424 /* Endpoint is first option */
425 b->endpoint = b->options[0];
426 if (strlen(b->endpoint) == 0) b->endpoint = NULL;
428 for (i=0;b->options[i];i++) {
429 b->options[i] = b->options[i+1];
433 if (b->options[0] == NULL)
440 NTSTATUS dcerpc_floor_get_lhs_data(struct epm_floor *epm_floor, struct ndr_syntax_id *syntax)
442 TALLOC_CTX *mem_ctx = talloc_init("floor_get_lhs_data");
443 struct ndr_pull *ndr = ndr_pull_init_blob(&epm_floor->lhs.lhs_data, mem_ctx, NULL);
444 enum ndr_err_code ndr_err;
445 uint16_t if_version=0;
447 ndr->flags |= LIBNDR_FLAG_NOALIGN;
449 ndr_err = ndr_pull_GUID(ndr, NDR_SCALARS | NDR_BUFFERS, &syntax->uuid);
450 if (!NDR_ERR_CODE_IS_SUCCESS(ndr_err)) {
451 talloc_free(mem_ctx);
452 return ndr_map_error2ntstatus(ndr_err);
455 ndr_err = ndr_pull_uint16(ndr, NDR_SCALARS, &if_version);
456 if (!NDR_ERR_CODE_IS_SUCCESS(ndr_err)) {
457 talloc_free(mem_ctx);
458 return ndr_map_error2ntstatus(ndr_err);
461 syntax->if_version = if_version;
463 talloc_free(mem_ctx);
468 static DATA_BLOB dcerpc_floor_pack_lhs_data(TALLOC_CTX *mem_ctx, const struct ndr_syntax_id *syntax)
470 struct ndr_push *ndr = ndr_push_init_ctx(mem_ctx, NULL);
472 ndr->flags |= LIBNDR_FLAG_NOALIGN;
474 ndr_push_GUID(ndr, NDR_SCALARS | NDR_BUFFERS, &syntax->uuid);
475 ndr_push_uint16(ndr, NDR_SCALARS, syntax->if_version);
477 return ndr_push_blob(ndr);
480 const char *dcerpc_floor_get_rhs_data(TALLOC_CTX *mem_ctx, struct epm_floor *epm_floor)
482 switch (epm_floor->lhs.protocol) {
483 case EPM_PROTOCOL_TCP:
484 if (epm_floor->rhs.tcp.port == 0) return NULL;
485 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.tcp.port);
487 case EPM_PROTOCOL_UDP:
488 if (epm_floor->rhs.udp.port == 0) return NULL;
489 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.udp.port);
491 case EPM_PROTOCOL_HTTP:
492 if (epm_floor->rhs.http.port == 0) return NULL;
493 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.http.port);
495 case EPM_PROTOCOL_IP:
496 return talloc_strdup(mem_ctx, epm_floor->rhs.ip.ipaddr);
498 case EPM_PROTOCOL_NCACN:
501 case EPM_PROTOCOL_NCADG:
504 case EPM_PROTOCOL_SMB:
505 if (strlen(epm_floor->rhs.smb.unc) == 0) return NULL;
506 return talloc_strdup(mem_ctx, epm_floor->rhs.smb.unc);
508 case EPM_PROTOCOL_PIPE:
509 if (strlen(epm_floor->rhs.pipe.path) == 0) return NULL;
510 return talloc_strdup(mem_ctx, epm_floor->rhs.pipe.path);
512 case EPM_PROTOCOL_NETBIOS:
513 if (strlen(epm_floor->rhs.netbios.name) == 0) return NULL;
514 return talloc_strdup(mem_ctx, epm_floor->rhs.netbios.name);
516 case EPM_PROTOCOL_NCALRPC:
519 case EPM_PROTOCOL_VINES_SPP:
520 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.vines_spp.port);
522 case EPM_PROTOCOL_VINES_IPC:
523 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.vines_ipc.port);
525 case EPM_PROTOCOL_STREETTALK:
526 return talloc_strdup(mem_ctx, epm_floor->rhs.streettalk.streettalk);
528 case EPM_PROTOCOL_UNIX_DS:
529 if (strlen(epm_floor->rhs.unix_ds.path) == 0) return NULL;
530 return talloc_strdup(mem_ctx, epm_floor->rhs.unix_ds.path);
532 case EPM_PROTOCOL_NULL:
536 DEBUG(0,("Unsupported lhs protocol %d\n", epm_floor->lhs.protocol));
543 static NTSTATUS dcerpc_floor_set_rhs_data(TALLOC_CTX *mem_ctx,
544 struct epm_floor *epm_floor,
547 switch (epm_floor->lhs.protocol) {
548 case EPM_PROTOCOL_TCP:
549 epm_floor->rhs.tcp.port = atoi(data);
552 case EPM_PROTOCOL_UDP:
553 epm_floor->rhs.udp.port = atoi(data);
556 case EPM_PROTOCOL_HTTP:
557 epm_floor->rhs.http.port = atoi(data);
560 case EPM_PROTOCOL_IP:
561 epm_floor->rhs.ip.ipaddr = talloc_strdup(mem_ctx, data);
562 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.ip.ipaddr);
565 case EPM_PROTOCOL_NCACN:
566 epm_floor->rhs.ncacn.minor_version = 0;
569 case EPM_PROTOCOL_NCADG:
570 epm_floor->rhs.ncadg.minor_version = 0;
573 case EPM_PROTOCOL_SMB:
574 epm_floor->rhs.smb.unc = talloc_strdup(mem_ctx, data);
575 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.smb.unc);
578 case EPM_PROTOCOL_PIPE:
579 epm_floor->rhs.pipe.path = talloc_strdup(mem_ctx, data);
580 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.pipe.path);
583 case EPM_PROTOCOL_NETBIOS:
584 epm_floor->rhs.netbios.name = talloc_strdup(mem_ctx, data);
585 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.netbios.name);
588 case EPM_PROTOCOL_NCALRPC:
591 case EPM_PROTOCOL_VINES_SPP:
592 epm_floor->rhs.vines_spp.port = atoi(data);
595 case EPM_PROTOCOL_VINES_IPC:
596 epm_floor->rhs.vines_ipc.port = atoi(data);
599 case EPM_PROTOCOL_STREETTALK:
600 epm_floor->rhs.streettalk.streettalk = talloc_strdup(mem_ctx, data);
601 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.streettalk.streettalk);
604 case EPM_PROTOCOL_UNIX_DS:
605 epm_floor->rhs.unix_ds.path = talloc_strdup(mem_ctx, data);
606 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.unix_ds.path);
609 case EPM_PROTOCOL_NULL:
613 DEBUG(0,("Unsupported lhs protocol %d\n", epm_floor->lhs.protocol));
617 return NT_STATUS_NOT_SUPPORTED;
620 enum dcerpc_transport_t dcerpc_transport_by_endpoint_protocol(int prot)
624 /* Find a transport that has 'prot' as 4th protocol */
625 for (i=0;i<ARRAY_SIZE(transports);i++) {
626 if (transports[i].num_protocols >= 2 &&
627 transports[i].protseq[1] == prot) {
628 return transports[i].transport;
632 /* Unknown transport */
633 return (unsigned int)-1;
636 enum dcerpc_transport_t dcerpc_transport_by_tower(struct epm_tower *tower)
640 /* Find a transport that matches this tower */
641 for (i=0;i<ARRAY_SIZE(transports);i++) {
643 if (transports[i].num_protocols != tower->num_floors - 2) {
647 for (j = 0; j < transports[i].num_protocols; j++) {
648 if (transports[i].protseq[j] != tower->floors[j+2].lhs.protocol) {
653 if (j == transports[i].num_protocols) {
654 return transports[i].transport;
658 /* Unknown transport */
659 return (unsigned int)-1;
662 NTSTATUS dcerpc_binding_from_tower(TALLOC_CTX *mem_ctx,
663 struct epm_tower *tower,
664 struct dcerpc_binding **b_out)
667 struct dcerpc_binding *binding;
669 binding = talloc(mem_ctx, struct dcerpc_binding);
670 NT_STATUS_HAVE_NO_MEMORY(binding);
672 ZERO_STRUCT(binding->object);
673 binding->options = NULL;
674 binding->host = NULL;
675 binding->target_hostname = NULL;
677 binding->assoc_group_id = 0;
679 binding->transport = dcerpc_transport_by_tower(tower);
681 if (binding->transport == (unsigned int)-1) {
682 return NT_STATUS_NOT_SUPPORTED;
685 if (tower->num_floors < 1) {
689 /* Set object uuid */
690 status = dcerpc_floor_get_lhs_data(&tower->floors[0], &binding->object);
692 if (!NT_STATUS_IS_OK(status)) {
693 DEBUG(1, ("Error pulling object uuid and version: %s", nt_errstr(status)));
697 /* Ignore floor 1, it contains the NDR version info */
699 binding->options = NULL;
702 if (tower->num_floors >= 4) {
703 binding->endpoint = dcerpc_floor_get_rhs_data(mem_ctx, &tower->floors[3]);
705 binding->endpoint = NULL;
708 /* Set network address */
709 if (tower->num_floors >= 5) {
710 binding->host = dcerpc_floor_get_rhs_data(mem_ctx, &tower->floors[4]);
711 NT_STATUS_HAVE_NO_MEMORY(binding->host);
712 binding->target_hostname = binding->host;
718 NTSTATUS dcerpc_binding_build_tower(TALLOC_CTX *mem_ctx, struct dcerpc_binding *binding, struct epm_tower *tower)
720 const enum epm_protocol *protseq = NULL;
721 int num_protocols = -1, i;
725 for (i=0;i<ARRAY_SIZE(transports);i++) {
726 if (transports[i].transport == binding->transport) {
727 protseq = transports[i].protseq;
728 num_protocols = transports[i].num_protocols;
733 if (num_protocols == -1) {
734 DEBUG(0, ("Unable to find transport with id '%d'\n", binding->transport));
735 return NT_STATUS_UNSUCCESSFUL;
738 tower->num_floors = 2 + num_protocols;
739 tower->floors = talloc_array(mem_ctx, struct epm_floor, tower->num_floors);
742 tower->floors[0].lhs.protocol = EPM_PROTOCOL_UUID;
744 tower->floors[0].lhs.lhs_data = dcerpc_floor_pack_lhs_data(mem_ctx, &binding->object);
746 tower->floors[0].rhs.uuid.unknown = data_blob_talloc_zero(mem_ctx, 2);
749 tower->floors[1].lhs.protocol = EPM_PROTOCOL_UUID;
751 tower->floors[1].lhs.lhs_data = dcerpc_floor_pack_lhs_data(mem_ctx,
752 &ndr_transfer_syntax);
754 tower->floors[1].rhs.uuid.unknown = data_blob_talloc_zero(mem_ctx, 2);
756 /* Floor 2 to num_protocols */
757 for (i = 0; i < num_protocols; i++) {
758 tower->floors[2 + i].lhs.protocol = protseq[i];
759 tower->floors[2 + i].lhs.lhs_data = data_blob_talloc(mem_ctx, NULL, 0);
760 ZERO_STRUCT(tower->floors[2 + i].rhs);
761 dcerpc_floor_set_rhs_data(mem_ctx, &tower->floors[2 + i], "");
764 /* The 4th floor contains the endpoint */
765 if (num_protocols >= 2 && binding->endpoint) {
766 status = dcerpc_floor_set_rhs_data(mem_ctx, &tower->floors[3], binding->endpoint);
767 if (NT_STATUS_IS_ERR(status)) {
772 /* The 5th contains the network address */
773 if (num_protocols >= 3 && binding->host) {
774 if (is_ipaddress(binding->host)) {
775 status = dcerpc_floor_set_rhs_data(mem_ctx, &tower->floors[4],
778 /* note that we don't attempt to resolve the
779 name here - when we get a hostname here we
780 are in the client code, and want to put in
781 a wildcard all-zeros IP for the server to
783 status = dcerpc_floor_set_rhs_data(mem_ctx, &tower->floors[4],
786 if (NT_STATUS_IS_ERR(status)) {
795 struct epm_map_binding_state {
796 struct dcerpc_binding *binding;
797 const struct ndr_interface_table *table;
798 struct dcerpc_pipe *pipe;
799 struct policy_handle handle;
801 struct epm_twr_t twr;
802 struct epm_twr_t *twr_r;
807 static void continue_epm_recv_binding(struct composite_context *ctx);
808 static void continue_epm_map(struct rpc_request *req);
812 Stage 2 of epm_map_binding: Receive connected rpc pipe and send endpoint
815 static void continue_epm_recv_binding(struct composite_context *ctx)
817 struct rpc_request *map_req;
819 struct composite_context *c = talloc_get_type(ctx->async.private_data,
820 struct composite_context);
821 struct epm_map_binding_state *s = talloc_get_type(c->private_data,
822 struct epm_map_binding_state);
824 /* receive result of rpc pipe connect request */
825 c->status = dcerpc_pipe_connect_b_recv(ctx, c, &s->pipe);
826 if (!composite_is_ok(c)) return;
828 s->pipe->conn->flags |= DCERPC_NDR_REF_ALLOC;
830 /* prepare requested binding parameters */
831 s->binding->object = s->table->syntax_id;
833 c->status = dcerpc_binding_build_tower(s->pipe, s->binding, &s->twr.tower);
834 if (!composite_is_ok(c)) return;
836 /* with some nice pretty paper around it of course */
837 s->r.in.object = &s->guid;
838 s->r.in.map_tower = &s->twr;
839 s->r.in.entry_handle = &s->handle;
840 s->r.in.max_towers = 1;
841 s->r.out.entry_handle = &s->handle;
843 /* send request for an endpoint mapping - a rpc request on connected pipe */
844 map_req = dcerpc_epm_Map_send(s->pipe, c, &s->r);
845 if (composite_nomem(map_req, c)) return;
847 composite_continue_rpc(c, map_req, continue_epm_map, c);
852 Stage 3 of epm_map_binding: Receive endpoint mapping and provide binding details
854 static void continue_epm_map(struct rpc_request *req)
856 struct composite_context *c = talloc_get_type(req->async.private_data,
857 struct composite_context);
858 struct epm_map_binding_state *s = talloc_get_type(c->private_data,
859 struct epm_map_binding_state);
861 /* receive result of a rpc request */
862 c->status = dcerpc_ndr_request_recv(req);
863 if (!composite_is_ok(c)) return;
865 /* check the details */
866 if (s->r.out.result != 0 || *s->r.out.num_towers != 1) {
867 composite_error(c, NT_STATUS_PORT_UNREACHABLE);
871 s->twr_r = s->r.out.towers[0].twr;
872 if (s->twr_r == NULL) {
873 composite_error(c, NT_STATUS_PORT_UNREACHABLE);
877 if (s->twr_r->tower.num_floors != s->twr.tower.num_floors ||
878 s->twr_r->tower.floors[3].lhs.protocol != s->twr.tower.floors[3].lhs.protocol) {
879 composite_error(c, NT_STATUS_PORT_UNREACHABLE);
883 /* get received endpoint */
884 s->binding->endpoint = talloc_reference(s->binding,
885 dcerpc_floor_get_rhs_data(c, &s->twr_r->tower.floors[3]));
886 if (composite_nomem(s->binding->endpoint, c)) return;
893 Request for endpoint mapping of dcerpc binding - try to request for endpoint
894 unless there is default one.
896 struct composite_context *dcerpc_epm_map_binding_send(TALLOC_CTX *mem_ctx,
897 struct dcerpc_binding *binding,
898 const struct ndr_interface_table *table,
899 struct event_context *ev,
900 struct loadparm_context *lp_ctx)
902 struct composite_context *c;
903 struct epm_map_binding_state *s;
904 struct composite_context *pipe_connect_req;
905 struct cli_credentials *anon_creds;
906 struct event_context *new_ev = NULL;
909 struct dcerpc_binding *epmapper_binding;
912 /* Try to find event context in memory context in case passed
913 * event_context (argument) was NULL. If there's none, just
917 ev = event_context_find(mem_ctx);
919 new_ev = event_context_init(mem_ctx);
920 if (new_ev == NULL) return NULL;
925 /* composite context allocation and setup */
926 c = composite_create(mem_ctx, ev);
931 talloc_steal(c, new_ev);
933 s = talloc_zero(c, struct epm_map_binding_state);
934 if (composite_nomem(s, c)) return c;
937 s->binding = binding;
940 /* anonymous credentials for rpc connection used to get endpoint mapping */
941 anon_creds = cli_credentials_init(mem_ctx);
942 cli_credentials_set_event_context(anon_creds, ev);
943 cli_credentials_set_anonymous(anon_creds);
946 First, check if there is a default endpoint specified in the IDL
949 struct dcerpc_binding *default_binding;
951 /* Find one of the default pipes for this interface */
952 for (i = 0; i < table->endpoints->count; i++) {
953 status = dcerpc_parse_binding(mem_ctx, table->endpoints->names[i], &default_binding);
955 if (NT_STATUS_IS_OK(status)) {
956 if (binding->transport == NCA_UNKNOWN)
957 binding->transport = default_binding->transport;
958 if (default_binding->transport == binding->transport &&
959 default_binding->endpoint) {
960 binding->endpoint = talloc_reference(binding, default_binding->endpoint);
961 talloc_free(default_binding);
967 talloc_free(default_binding);
973 epmapper_binding = talloc_zero(c, struct dcerpc_binding);
974 if (composite_nomem(epmapper_binding, c)) return c;
976 /* basic endpoint mapping data */
977 epmapper_binding->transport = binding->transport;
978 epmapper_binding->host = talloc_reference(epmapper_binding, binding->host);
979 epmapper_binding->target_hostname = epmapper_binding->host;
980 epmapper_binding->options = NULL;
981 epmapper_binding->flags = 0;
982 epmapper_binding->assoc_group_id = 0;
983 epmapper_binding->endpoint = NULL;
985 /* initiate rpc pipe connection */
986 pipe_connect_req = dcerpc_pipe_connect_b_send(c, epmapper_binding,
988 anon_creds, c->event_ctx,
990 if (composite_nomem(pipe_connect_req, c)) return c;
992 composite_continue(c, pipe_connect_req, continue_epm_recv_binding, c);
998 Receive result of endpoint mapping request
1000 NTSTATUS dcerpc_epm_map_binding_recv(struct composite_context *c)
1002 NTSTATUS status = composite_wait(c);
1010 Get endpoint mapping for rpc connection
1012 NTSTATUS dcerpc_epm_map_binding(TALLOC_CTX *mem_ctx, struct dcerpc_binding *binding,
1013 const struct ndr_interface_table *table, struct event_context *ev,
1014 struct loadparm_context *lp_ctx)
1016 struct composite_context *c;
1018 c = dcerpc_epm_map_binding_send(mem_ctx, binding, table, ev, lp_ctx);
1019 return dcerpc_epm_map_binding_recv(c);
1023 struct pipe_auth_state {
1024 struct dcerpc_pipe *pipe;
1025 struct dcerpc_binding *binding;
1026 const struct ndr_interface_table *table;
1027 struct loadparm_context *lp_ctx;
1028 struct cli_credentials *credentials;
1032 static void continue_auth_schannel(struct composite_context *ctx);
1033 static void continue_auth(struct composite_context *ctx);
1034 static void continue_auth_none(struct composite_context *ctx);
1035 static void continue_ntlmssp_connection(struct composite_context *ctx);
1036 static void continue_spnego_after_wrong_pass(struct composite_context *ctx);
1040 Stage 2 of pipe_auth: Receive result of schannel bind request
1042 static void continue_auth_schannel(struct composite_context *ctx)
1044 struct composite_context *c = talloc_get_type(ctx->async.private_data,
1045 struct composite_context);
1047 c->status = dcerpc_bind_auth_schannel_recv(ctx);
1048 if (!composite_is_ok(c)) return;
1055 Stage 2 of pipe_auth: Receive result of authenticated bind request
1057 static void continue_auth(struct composite_context *ctx)
1059 struct composite_context *c = talloc_get_type(ctx->async.private_data,
1060 struct composite_context);
1062 c->status = dcerpc_bind_auth_recv(ctx);
1063 if (!composite_is_ok(c)) return;
1068 Stage 2 of pipe_auth: Receive result of authenticated bind request, but handle fallbacks:
1071 static void continue_auth_auto(struct composite_context *ctx)
1073 struct composite_context *c = talloc_get_type(ctx->async.private_data,
1074 struct composite_context);
1075 struct pipe_auth_state *s = talloc_get_type(c->private_data, struct pipe_auth_state);
1076 struct composite_context *sec_conn_req;
1078 c->status = dcerpc_bind_auth_recv(ctx);
1079 if (NT_STATUS_EQUAL(c->status, NT_STATUS_INVALID_PARAMETER)) {
1081 * Retry with NTLMSSP auth as fallback
1082 * send a request for secondary rpc connection
1084 sec_conn_req = dcerpc_secondary_connection_send(s->pipe,
1086 composite_continue(c, sec_conn_req, continue_ntlmssp_connection, c);
1088 } else if (NT_STATUS_EQUAL(c->status, NT_STATUS_LOGON_FAILURE)) {
1089 if (cli_credentials_wrong_password(s->credentials)) {
1091 * Retry SPNEGO with a better password
1092 * send a request for secondary rpc connection
1094 sec_conn_req = dcerpc_secondary_connection_send(s->pipe,
1096 composite_continue(c, sec_conn_req, continue_spnego_after_wrong_pass, c);
1101 if (!composite_is_ok(c)) return;
1107 Stage 3 of pipe_auth (fallback to NTLMSSP case): Receive secondary
1108 rpc connection (the first one can't be used any more, due to the
1109 bind nak) and perform authenticated bind request
1111 static void continue_ntlmssp_connection(struct composite_context *ctx)
1113 struct composite_context *c;
1114 struct pipe_auth_state *s;
1115 struct composite_context *auth_req;
1116 struct dcerpc_pipe *p2;
1118 c = talloc_get_type(ctx->async.private_data, struct composite_context);
1119 s = talloc_get_type(c->private_data, struct pipe_auth_state);
1121 /* receive secondary rpc connection */
1122 c->status = dcerpc_secondary_connection_recv(ctx, &p2);
1123 if (!composite_is_ok(c)) return;
1125 talloc_steal(s, p2);
1126 talloc_steal(p2, s->pipe);
1129 /* initiate a authenticated bind */
1130 auth_req = dcerpc_bind_auth_send(c, s->pipe, s->table,
1131 s->credentials, s->lp_ctx,
1132 DCERPC_AUTH_TYPE_NTLMSSP,
1133 dcerpc_auth_level(s->pipe->conn),
1134 s->table->authservices->names[0]);
1135 composite_continue(c, auth_req, continue_auth, c);
1139 Stage 3 of pipe_auth (retry on wrong password): Receive secondary
1140 rpc connection (the first one can't be used any more, due to the
1141 bind nak) and perform authenticated bind request
1143 static void continue_spnego_after_wrong_pass(struct composite_context *ctx)
1145 struct composite_context *c;
1146 struct pipe_auth_state *s;
1147 struct composite_context *auth_req;
1148 struct dcerpc_pipe *p2;
1150 c = talloc_get_type(ctx->async.private_data, struct composite_context);
1151 s = talloc_get_type(c->private_data, struct pipe_auth_state);
1153 /* receive secondary rpc connection */
1154 c->status = dcerpc_secondary_connection_recv(ctx, &p2);
1155 if (!composite_is_ok(c)) return;
1157 talloc_steal(s, p2);
1158 talloc_steal(p2, s->pipe);
1161 /* initiate a authenticated bind */
1162 auth_req = dcerpc_bind_auth_send(c, s->pipe, s->table,
1163 s->credentials, s->lp_ctx, DCERPC_AUTH_TYPE_SPNEGO,
1164 dcerpc_auth_level(s->pipe->conn),
1165 s->table->authservices->names[0]);
1166 composite_continue(c, auth_req, continue_auth, c);
1171 Stage 2 of pipe_auth: Receive result of non-authenticated bind request
1173 static void continue_auth_none(struct composite_context *ctx)
1175 struct composite_context *c = talloc_get_type(ctx->async.private_data,
1176 struct composite_context);
1178 c->status = dcerpc_bind_auth_none_recv(ctx);
1179 if (!composite_is_ok(c)) return;
1186 Request to perform an authenticated bind if required. Authentication
1187 is determined using credentials passed and binding flags.
1189 struct composite_context *dcerpc_pipe_auth_send(struct dcerpc_pipe *p,
1190 struct dcerpc_binding *binding,
1191 const struct ndr_interface_table *table,
1192 struct cli_credentials *credentials,
1193 struct loadparm_context *lp_ctx)
1195 struct composite_context *c;
1196 struct pipe_auth_state *s;
1197 struct composite_context *auth_schannel_req;
1198 struct composite_context *auth_req;
1199 struct composite_context *auth_none_req;
1200 struct dcerpc_connection *conn;
1203 /* composite context allocation and setup */
1204 c = composite_create(p, p->conn->event_ctx);
1205 if (c == NULL) return NULL;
1207 s = talloc_zero(c, struct pipe_auth_state);
1208 if (composite_nomem(s, c)) return c;
1209 c->private_data = s;
1211 /* store parameters in state structure */
1212 s->binding = binding;
1214 s->credentials = credentials;
1218 conn = s->pipe->conn;
1219 conn->flags = binding->flags;
1221 /* remember the binding string for possible secondary connections */
1222 conn->binding_string = dcerpc_binding_string(p, binding);
1224 if (cli_credentials_is_anonymous(s->credentials)) {
1225 auth_none_req = dcerpc_bind_auth_none_send(c, s->pipe, s->table);
1226 composite_continue(c, auth_none_req, continue_auth_none, c);
1230 if ((binding->flags & DCERPC_SCHANNEL) &&
1231 !cli_credentials_get_netlogon_creds(s->credentials)) {
1232 /* If we don't already have netlogon credentials for
1233 * the schannel bind, then we have to get these
1235 auth_schannel_req = dcerpc_bind_auth_schannel_send(c, s->pipe, s->table,
1236 s->credentials, s->lp_ctx,
1237 dcerpc_auth_level(conn));
1238 composite_continue(c, auth_schannel_req, continue_auth_schannel, c);
1243 * we rely on the already authenticated CIFS connection
1244 * if not doing sign or seal
1246 if (conn->transport.transport == NCACN_NP &&
1247 !(s->binding->flags & (DCERPC_SIGN|DCERPC_SEAL))) {
1248 auth_none_req = dcerpc_bind_auth_none_send(c, s->pipe, s->table);
1249 composite_continue(c, auth_none_req, continue_auth_none, c);
1254 /* Perform an authenticated DCE-RPC bind
1256 if (!(conn->flags & (DCERPC_SIGN|DCERPC_SEAL))) {
1258 we are doing an authenticated connection,
1259 but not using sign or seal. We must force
1260 the CONNECT dcerpc auth type as a NONE auth
1261 type doesn't allow authentication
1262 information to be passed.
1264 conn->flags |= DCERPC_CONNECT;
1267 if (s->binding->flags & DCERPC_AUTH_SPNEGO) {
1268 auth_type = DCERPC_AUTH_TYPE_SPNEGO;
1270 } else if (s->binding->flags & DCERPC_AUTH_KRB5) {
1271 auth_type = DCERPC_AUTH_TYPE_KRB5;
1273 } else if (s->binding->flags & DCERPC_SCHANNEL) {
1274 auth_type = DCERPC_AUTH_TYPE_SCHANNEL;
1276 } else if (s->binding->flags & DCERPC_AUTH_NTLM) {
1277 auth_type = DCERPC_AUTH_TYPE_NTLMSSP;
1280 /* try SPNEGO with fallback to NTLMSSP */
1281 auth_req = dcerpc_bind_auth_send(c, s->pipe, s->table,
1282 s->credentials, s->lp_ctx, DCERPC_AUTH_TYPE_SPNEGO,
1283 dcerpc_auth_level(conn),
1284 s->table->authservices->names[0]);
1285 composite_continue(c, auth_req, continue_auth_auto, c);
1289 auth_req = dcerpc_bind_auth_send(c, s->pipe, s->table,
1290 s->credentials, s->lp_ctx, auth_type,
1291 dcerpc_auth_level(conn),
1292 s->table->authservices->names[0]);
1293 composite_continue(c, auth_req, continue_auth, c);
1299 Receive result of authenticated bind request on dcerpc pipe
1301 This returns *p, which may be different to the one originally
1302 supllied, as it rebinds to a new pipe due to authentication fallback
1305 NTSTATUS dcerpc_pipe_auth_recv(struct composite_context *c, TALLOC_CTX *mem_ctx,
1306 struct dcerpc_pipe **p)
1310 struct pipe_auth_state *s = talloc_get_type(c->private_data,
1311 struct pipe_auth_state);
1312 status = composite_wait(c);
1313 if (!NT_STATUS_IS_OK(status)) {
1314 char *uuid_str = GUID_string(s->pipe, &s->table->syntax_id.uuid);
1315 DEBUG(0, ("Failed to bind to uuid %s - %s\n", uuid_str, nt_errstr(status)));
1316 talloc_free(uuid_str);
1318 talloc_steal(mem_ctx, s->pipe);
1328 Perform an authenticated bind if needed - sync version
1330 This may change *p, as it rebinds to a new pipe due to authentication fallback
1332 NTSTATUS dcerpc_pipe_auth(TALLOC_CTX *mem_ctx,
1333 struct dcerpc_pipe **p,
1334 struct dcerpc_binding *binding,
1335 const struct ndr_interface_table *table,
1336 struct cli_credentials *credentials,
1337 struct loadparm_context *lp_ctx)
1339 struct composite_context *c;
1341 c = dcerpc_pipe_auth_send(*p, binding, table, credentials, lp_ctx);
1342 return dcerpc_pipe_auth_recv(c, mem_ctx, p);
1346 NTSTATUS dcerpc_generic_session_key(struct dcerpc_connection *c,
1347 DATA_BLOB *session_key)
1349 /* this took quite a few CPU cycles to find ... */
1350 session_key->data = discard_const_p(unsigned char, "SystemLibraryDTC");
1351 session_key->length = 16;
1352 return NT_STATUS_OK;
1356 fetch the user session key - may be default (above) or the SMB session key
1358 NTSTATUS dcerpc_fetch_session_key(struct dcerpc_pipe *p,
1359 DATA_BLOB *session_key)
1361 return p->conn->security_state.session_key(p->conn, session_key);
1366 log a rpc packet in a format suitable for ndrdump. This is especially useful
1367 for sealed packets, where ethereal cannot easily see the contents
1369 this triggers on a debug level of >= 10
1371 void dcerpc_log_packet(const struct ndr_interface_table *ndr,
1372 uint32_t opnum, uint32_t flags,
1375 const int num_examples = 20;
1378 if (DEBUGLEVEL < 10) return;
1380 for (i=0;i<num_examples;i++) {
1382 asprintf(&name, "%s/rpclog/%s-%u.%d.%s",
1383 lp_lockdir(global_loadparm), ndr->name, opnum, i,
1384 (flags&NDR_IN)?"in":"out");
1388 if (!file_exist(name)) {
1389 if (file_save(name, pkt->data, pkt->length)) {
1390 DEBUG(10,("Logged rpc packet to %s\n", name));
1402 create a secondary context from a primary connection
1404 this uses dcerpc_alter_context() to create a new dcerpc context_id
1406 NTSTATUS dcerpc_secondary_context(struct dcerpc_pipe *p,
1407 struct dcerpc_pipe **pp2,
1408 const struct ndr_interface_table *table)
1411 struct dcerpc_pipe *p2;
1413 p2 = talloc_zero(p, struct dcerpc_pipe);
1415 return NT_STATUS_NO_MEMORY;
1417 p2->conn = talloc_reference(p2, p->conn);
1418 p2->request_timeout = p->request_timeout;
1420 p2->context_id = ++p->conn->next_context_id;
1422 p2->syntax = table->syntax_id;
1424 p2->transfer_syntax = ndr_transfer_syntax;
1426 p2->binding = talloc_reference(p2, p->binding);
1428 status = dcerpc_alter_context(p2, p2, &p2->syntax, &p2->transfer_syntax);
1429 if (!NT_STATUS_IS_OK(status)) {
1436 return NT_STATUS_OK;