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 2 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, write to the Free Software
23 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
27 #include "lib/events/events.h"
28 #include "libcli/composite/composite.h"
29 #include "librpc/gen_ndr/ndr_epmapper.h"
30 #include "librpc/gen_ndr/ndr_dcerpc.h"
31 #include "librpc/gen_ndr/ndr_misc.h"
34 find a dcerpc call on an interface by name
36 const struct dcerpc_interface_call *dcerpc_iface_find_call(const struct dcerpc_interface_table *iface,
40 for (i=0;i<iface->num_calls;i++) {
41 if (strcmp(iface->calls[i].name, name) == 0) {
42 return &iface->calls[i];
49 push a ncacn_packet into a blob, potentially with auth info
51 NTSTATUS ncacn_push_auth(DATA_BLOB *blob, TALLOC_CTX *mem_ctx,
52 struct ncacn_packet *pkt,
53 struct dcerpc_auth *auth_info)
58 ndr = ndr_push_init_ctx(mem_ctx);
60 return NT_STATUS_NO_MEMORY;
63 if (!(pkt->drep[0] & DCERPC_DREP_LE)) {
64 ndr->flags |= LIBNDR_FLAG_BIGENDIAN;
67 if (pkt->pfc_flags & DCERPC_PFC_FLAG_ORPC) {
68 ndr->flags |= LIBNDR_FLAG_OBJECT_PRESENT;
72 pkt->auth_length = auth_info->credentials.length;
77 status = ndr_push_ncacn_packet(ndr, NDR_SCALARS|NDR_BUFFERS, pkt);
78 if (!NT_STATUS_IS_OK(status)) {
83 status = ndr_push_dcerpc_auth(ndr, NDR_SCALARS|NDR_BUFFERS, auth_info);
86 *blob = ndr_push_blob(ndr);
88 /* fill in the frag length */
89 dcerpc_set_frag_length(blob, blob->length);
94 #define MAX_PROTSEQ 10
98 enum dcerpc_transport_t transport;
100 enum epm_protocol protseq[MAX_PROTSEQ];
102 { "ncacn_np", NCACN_NP, 3,
103 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_SMB, EPM_PROTOCOL_NETBIOS }},
104 { "ncacn_ip_tcp", NCACN_IP_TCP, 3,
105 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_TCP, EPM_PROTOCOL_IP } },
106 { "ncacn_http", NCACN_HTTP, 3,
107 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_HTTP, EPM_PROTOCOL_IP } },
108 { "ncadg_ip_udp", NCACN_IP_UDP, 3,
109 { EPM_PROTOCOL_NCADG, EPM_PROTOCOL_UDP, EPM_PROTOCOL_IP } },
110 { "ncalrpc", NCALRPC, 2,
111 { EPM_PROTOCOL_NCALRPC, EPM_PROTOCOL_PIPE } },
112 { "ncacn_unix_stream", NCACN_UNIX_STREAM, 2,
113 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_UNIX_DS } },
114 { "ncadg_unix_dgram", NCADG_UNIX_DGRAM, 2,
115 { EPM_PROTOCOL_NCADG, EPM_PROTOCOL_UNIX_DS } },
116 { "ncacn_at_dsp", NCACN_AT_DSP, 3,
117 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_APPLETALK, EPM_PROTOCOL_DSP } },
118 { "ncadg_at_ddp", NCADG_AT_DDP, 3,
119 { EPM_PROTOCOL_NCADG, EPM_PROTOCOL_APPLETALK, EPM_PROTOCOL_DDP } },
120 { "ncacn_vns_ssp", NCACN_VNS_SPP, 3,
121 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_STREETTALK, EPM_PROTOCOL_VINES_SPP } },
122 { "ncacn_vns_ipc", NCACN_VNS_IPC, 3,
123 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_STREETTALK, EPM_PROTOCOL_VINES_IPC }, },
124 { "ncadg_ipx", NCADG_IPX, 2,
125 { EPM_PROTOCOL_NCADG, EPM_PROTOCOL_IPX },
127 { "ncacn_spx", NCACN_SPX, 3,
128 /* I guess some MS programmer confused the identifier for
129 * EPM_PROTOCOL_UUID (0x0D or 13) with the one for
130 * EPM_PROTOCOL_SPX (0x13) here. -- jelmer*/
131 { EPM_PROTOCOL_NCACN, EPM_PROTOCOL_NCALRPC, EPM_PROTOCOL_UUID },
135 static const struct {
138 } ncacn_options[] = {
139 {"sign", DCERPC_SIGN},
140 {"seal", DCERPC_SEAL},
141 {"connect", DCERPC_CONNECT},
142 {"spnego", DCERPC_AUTH_SPNEGO},
143 {"krb5", DCERPC_AUTH_KRB5},
144 {"validate", DCERPC_DEBUG_VALIDATE_BOTH},
145 {"print", DCERPC_DEBUG_PRINT_BOTH},
146 {"padcheck", DCERPC_DEBUG_PAD_CHECK},
147 {"bigendian", DCERPC_PUSH_BIGENDIAN},
148 {"smb2", DCERPC_SMB2}
151 const char *epm_floor_string(TALLOC_CTX *mem_ctx, struct epm_floor *epm_floor)
157 switch(epm_floor->lhs.protocol) {
158 case EPM_PROTOCOL_UUID:
159 status = dcerpc_floor_get_lhs_data(epm_floor, &uuid, &if_version);
160 if (NT_STATUS_IS_OK(status)) {
161 /* lhs is used: UUID */
164 if (GUID_equal(&uuid, &ndr_transfer_syntax.uuid)) {
168 if (GUID_equal(&uuid, &ndr64_transfer_syntax.uuid)) {
172 uuidstr = GUID_string(mem_ctx, &uuid);
174 return talloc_asprintf(mem_ctx, " uuid %s/0x%02x", uuidstr, if_version);
176 return talloc_asprintf(mem_ctx, "IPX:%s",
177 data_blob_hex_string(mem_ctx, &epm_floor->rhs.uuid.unknown));
180 case EPM_PROTOCOL_NCACN:
183 case EPM_PROTOCOL_NCADG:
186 case EPM_PROTOCOL_NCALRPC:
189 case EPM_PROTOCOL_DNET_NSP:
192 case EPM_PROTOCOL_IP:
193 return talloc_asprintf(mem_ctx, "IP:%s", epm_floor->rhs.ip.ipaddr);
195 case EPM_PROTOCOL_PIPE:
196 return talloc_asprintf(mem_ctx, "PIPE:%s", epm_floor->rhs.pipe.path);
198 case EPM_PROTOCOL_SMB:
199 return talloc_asprintf(mem_ctx, "SMB:%s", epm_floor->rhs.smb.unc);
201 case EPM_PROTOCOL_UNIX_DS:
202 return talloc_asprintf(mem_ctx, "Unix:%s", epm_floor->rhs.unix_ds.path);
204 case EPM_PROTOCOL_NETBIOS:
205 return talloc_asprintf(mem_ctx, "NetBIOS:%s", epm_floor->rhs.netbios.name);
207 case EPM_PROTOCOL_NETBEUI:
210 case EPM_PROTOCOL_SPX:
213 case EPM_PROTOCOL_NB_IPX:
216 case EPM_PROTOCOL_HTTP:
217 return talloc_asprintf(mem_ctx, "HTTP:%d", epm_floor->rhs.http.port);
219 case EPM_PROTOCOL_TCP:
220 return talloc_asprintf(mem_ctx, "TCP:%d", epm_floor->rhs.tcp.port);
222 case EPM_PROTOCOL_UDP:
223 return talloc_asprintf(mem_ctx, "UDP:%d", epm_floor->rhs.udp.port);
226 return talloc_asprintf(mem_ctx, "UNK(%02x):", epm_floor->lhs.protocol);
232 form a binding string from a binding structure
234 const char *dcerpc_binding_string(TALLOC_CTX *mem_ctx, const struct dcerpc_binding *b)
236 char *s = talloc_strdup(mem_ctx, "");
238 const char *t_name=NULL;
240 for (i=0;i<ARRAY_SIZE(transports);i++) {
241 if (transports[i].transport == b->transport) {
242 t_name = transports[i].name;
249 if (!GUID_all_zero(&b->object)) {
250 s = talloc_asprintf(s, "%s@",
251 GUID_string(mem_ctx, &b->object));
254 s = talloc_asprintf_append(s, "%s:", t_name);
258 s = talloc_asprintf_append(s, "%s", b->host);
261 if (!b->endpoint && !b->options && !b->flags) {
265 s = talloc_asprintf_append(s, "[");
268 s = talloc_asprintf_append(s, "%s", b->endpoint);
271 /* this is a *really* inefficent way of dealing with strings,
272 but this is rarely called and the strings are always short,
274 for (i=0;b->options && b->options[i];i++) {
275 s = talloc_asprintf_append(s, ",%s", b->options[i]);
279 for (i=0;i<ARRAY_SIZE(ncacn_options);i++) {
280 if (b->flags & ncacn_options[i].flag) {
281 s = talloc_asprintf_append(s, ",%s", ncacn_options[i].name);
286 s = talloc_asprintf_append(s, "]");
292 parse a binding string into a dcerpc_binding structure
294 NTSTATUS dcerpc_parse_binding(TALLOC_CTX *mem_ctx, const char *s, struct dcerpc_binding **b_out)
296 struct dcerpc_binding *b;
297 char *options, *type;
299 int i, j, comma_count;
301 b = talloc(mem_ctx, struct dcerpc_binding);
303 return NT_STATUS_NO_MEMORY;
308 if (p && PTR_DIFF(p, s) == 36) { /* 36 is the length of a UUID */
311 status = GUID_from_string(s, &b->object);
313 if (NT_STATUS_IS_ERR(status)) {
314 DEBUG(0, ("Failed parsing UUID\n"));
320 ZERO_STRUCT(b->object);
323 b->object_version = 0;
327 return NT_STATUS_INVALID_PARAMETER;
330 type = talloc_strndup(mem_ctx, s, PTR_DIFF(p, s));
332 return NT_STATUS_NO_MEMORY;
335 for (i=0;i<ARRAY_SIZE(transports);i++) {
336 if (strcasecmp(type, transports[i].name) == 0) {
337 b->transport = transports[i].transport;
341 if (i==ARRAY_SIZE(transports)) {
342 DEBUG(0,("Unknown dcerpc transport '%s'\n", type));
343 return NT_STATUS_INVALID_PARAMETER;
350 b->host = talloc_strndup(b, s, PTR_DIFF(p, s));
351 options = talloc_strdup(mem_ctx, p+1);
352 if (options[strlen(options)-1] != ']') {
353 return NT_STATUS_INVALID_PARAMETER;
355 options[strlen(options)-1] = 0;
357 b->host = talloc_strdup(b, s);
362 return NT_STATUS_NO_MEMORY;
374 comma_count = count_chars(options, ',');
376 b->options = talloc_array(b, const char *, comma_count+2);
378 return NT_STATUS_NO_MEMORY;
381 for (i=0; (p = strchr(options, ',')); i++) {
382 b->options[i] = talloc_strndup(b, options, PTR_DIFF(p, options));
383 if (!b->options[i]) {
384 return NT_STATUS_NO_MEMORY;
388 b->options[i] = options;
389 b->options[i+1] = NULL;
391 /* some options are pre-parsed for convenience */
392 for (i=0;b->options[i];i++) {
393 for (j=0;j<ARRAY_SIZE(ncacn_options);j++) {
394 if (strcasecmp(ncacn_options[j].name, b->options[i]) == 0) {
396 b->flags |= ncacn_options[j].flag;
397 for (k=i;b->options[k];k++) {
398 b->options[k] = b->options[k+1];
407 /* Endpoint is first option */
408 b->endpoint = b->options[0];
409 if (strlen(b->endpoint) == 0) b->endpoint = NULL;
411 for (i=0;b->options[i];i++) {
412 b->options[i] = b->options[i+1];
416 if (b->options[0] == NULL)
423 NTSTATUS dcerpc_floor_get_lhs_data(struct epm_floor *epm_floor, struct GUID *uuid, uint16_t *if_version)
425 TALLOC_CTX *mem_ctx = talloc_init("floor_get_lhs_data");
426 struct ndr_pull *ndr = ndr_pull_init_blob(&epm_floor->lhs.lhs_data, mem_ctx);
429 ndr->flags |= LIBNDR_FLAG_NOALIGN;
431 status = ndr_pull_GUID(ndr, NDR_SCALARS | NDR_BUFFERS, uuid);
432 if (NT_STATUS_IS_ERR(status)) {
433 talloc_free(mem_ctx);
437 status = ndr_pull_uint16(ndr, NDR_SCALARS, if_version);
439 talloc_free(mem_ctx);
444 static DATA_BLOB dcerpc_floor_pack_lhs_data(TALLOC_CTX *mem_ctx, const struct GUID *uuid, uint32_t if_version)
446 struct ndr_push *ndr = ndr_push_init_ctx(mem_ctx);
448 ndr->flags |= LIBNDR_FLAG_NOALIGN;
450 ndr_push_GUID(ndr, NDR_SCALARS | NDR_BUFFERS, uuid);
451 ndr_push_uint16(ndr, NDR_SCALARS, if_version);
453 return ndr_push_blob(ndr);
456 const char *dcerpc_floor_get_rhs_data(TALLOC_CTX *mem_ctx, struct epm_floor *epm_floor)
458 switch (epm_floor->lhs.protocol) {
459 case EPM_PROTOCOL_TCP:
460 if (epm_floor->rhs.tcp.port == 0) return NULL;
461 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.tcp.port);
463 case EPM_PROTOCOL_UDP:
464 if (epm_floor->rhs.udp.port == 0) return NULL;
465 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.udp.port);
467 case EPM_PROTOCOL_HTTP:
468 if (epm_floor->rhs.http.port == 0) return NULL;
469 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.http.port);
471 case EPM_PROTOCOL_IP:
472 return talloc_strdup(mem_ctx, epm_floor->rhs.ip.ipaddr);
474 case EPM_PROTOCOL_NCACN:
477 case EPM_PROTOCOL_NCADG:
480 case EPM_PROTOCOL_SMB:
481 if (strlen(epm_floor->rhs.smb.unc) == 0) return NULL;
482 return talloc_strdup(mem_ctx, epm_floor->rhs.smb.unc);
484 case EPM_PROTOCOL_PIPE:
485 if (strlen(epm_floor->rhs.pipe.path) == 0) return NULL;
486 return talloc_strdup(mem_ctx, epm_floor->rhs.pipe.path);
488 case EPM_PROTOCOL_NETBIOS:
489 if (strlen(epm_floor->rhs.netbios.name) == 0) return NULL;
490 return talloc_strdup(mem_ctx, epm_floor->rhs.netbios.name);
492 case EPM_PROTOCOL_NCALRPC:
495 case EPM_PROTOCOL_VINES_SPP:
496 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.vines_spp.port);
498 case EPM_PROTOCOL_VINES_IPC:
499 return talloc_asprintf(mem_ctx, "%d", epm_floor->rhs.vines_ipc.port);
501 case EPM_PROTOCOL_STREETTALK:
502 return talloc_strdup(mem_ctx, epm_floor->rhs.streettalk.streettalk);
504 case EPM_PROTOCOL_UNIX_DS:
505 if (strlen(epm_floor->rhs.unix_ds.path) == 0) return NULL;
506 return talloc_strdup(mem_ctx, epm_floor->rhs.unix_ds.path);
508 case EPM_PROTOCOL_NULL:
512 DEBUG(0,("Unsupported lhs protocol %d\n", epm_floor->lhs.protocol));
519 static NTSTATUS dcerpc_floor_set_rhs_data(TALLOC_CTX *mem_ctx, struct epm_floor *epm_floor, const char *data)
521 switch (epm_floor->lhs.protocol) {
522 case EPM_PROTOCOL_TCP:
523 epm_floor->rhs.tcp.port = atoi(data);
526 case EPM_PROTOCOL_UDP:
527 epm_floor->rhs.udp.port = atoi(data);
530 case EPM_PROTOCOL_HTTP:
531 epm_floor->rhs.http.port = atoi(data);
534 case EPM_PROTOCOL_IP:
535 epm_floor->rhs.ip.ipaddr = talloc_strdup(mem_ctx, data);
536 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.ip.ipaddr);
539 case EPM_PROTOCOL_NCACN:
540 epm_floor->rhs.ncacn.minor_version = 0;
543 case EPM_PROTOCOL_NCADG:
544 epm_floor->rhs.ncadg.minor_version = 0;
547 case EPM_PROTOCOL_SMB:
548 epm_floor->rhs.smb.unc = talloc_strdup(mem_ctx, data);
549 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.smb.unc);
552 case EPM_PROTOCOL_PIPE:
553 epm_floor->rhs.pipe.path = talloc_strdup(mem_ctx, data);
554 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.pipe.path);
557 case EPM_PROTOCOL_NETBIOS:
558 epm_floor->rhs.netbios.name = talloc_strdup(mem_ctx, data);
559 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.netbios.name);
562 case EPM_PROTOCOL_NCALRPC:
565 case EPM_PROTOCOL_VINES_SPP:
566 epm_floor->rhs.vines_spp.port = atoi(data);
569 case EPM_PROTOCOL_VINES_IPC:
570 epm_floor->rhs.vines_ipc.port = atoi(data);
573 case EPM_PROTOCOL_STREETTALK:
574 epm_floor->rhs.streettalk.streettalk = talloc_strdup(mem_ctx, data);
575 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.streettalk.streettalk);
578 case EPM_PROTOCOL_UNIX_DS:
579 epm_floor->rhs.unix_ds.path = talloc_strdup(mem_ctx, data);
580 NT_STATUS_HAVE_NO_MEMORY(epm_floor->rhs.unix_ds.path);
583 case EPM_PROTOCOL_NULL:
587 DEBUG(0,("Unsupported lhs protocol %d\n", epm_floor->lhs.protocol));
591 return NT_STATUS_NOT_SUPPORTED;
594 enum dcerpc_transport_t dcerpc_transport_by_endpoint_protocol(int prot)
598 /* Find a transport that has 'prot' as 4th protocol */
599 for (i=0;i<ARRAY_SIZE(transports);i++) {
600 if (transports[i].num_protocols >= 2 &&
601 transports[i].protseq[1] == prot) {
602 return transports[i].transport;
606 /* Unknown transport */
610 enum dcerpc_transport_t dcerpc_transport_by_tower(struct epm_tower *tower)
614 /* Find a transport that matches this tower */
615 for (i=0;i<ARRAY_SIZE(transports);i++) {
617 if (transports[i].num_protocols != tower->num_floors - 2) {
621 for (j = 0; j < transports[i].num_protocols; j++) {
622 if (transports[i].protseq[j] != tower->floors[j+2].lhs.protocol) {
627 if (j == transports[i].num_protocols) {
628 return transports[i].transport;
632 /* Unknown transport */
636 NTSTATUS dcerpc_binding_from_tower(TALLOC_CTX *mem_ctx, struct epm_tower *tower, struct dcerpc_binding **b_out)
639 struct dcerpc_binding *binding;
641 binding = talloc(mem_ctx, struct dcerpc_binding);
642 NT_STATUS_HAVE_NO_MEMORY(binding);
644 ZERO_STRUCT(binding->object);
645 binding->options = NULL;
646 binding->host = NULL;
649 binding->transport = dcerpc_transport_by_tower(tower);
651 if (binding->transport == -1) {
652 return NT_STATUS_NOT_SUPPORTED;
655 if (tower->num_floors < 1) {
659 /* Set object uuid */
660 status = dcerpc_floor_get_lhs_data(&tower->floors[0], &binding->object, &binding->object_version);
662 if (!NT_STATUS_IS_OK(status)) {
663 DEBUG(1, ("Error pulling object uuid and version: %s", nt_errstr(status)));
667 /* Ignore floor 1, it contains the NDR version info */
669 binding->options = NULL;
672 if (tower->num_floors >= 4) {
673 binding->endpoint = dcerpc_floor_get_rhs_data(mem_ctx, &tower->floors[3]);
675 binding->endpoint = NULL;
678 /* Set network address */
679 if (tower->num_floors >= 5) {
680 binding->host = dcerpc_floor_get_rhs_data(mem_ctx, &tower->floors[4]);
686 NTSTATUS dcerpc_binding_build_tower(TALLOC_CTX *mem_ctx, struct dcerpc_binding *binding, struct epm_tower *tower)
688 const enum epm_protocol *protseq = NULL;
689 int num_protocols = -1, i;
693 for (i=0;i<ARRAY_SIZE(transports);i++) {
694 if (transports[i].transport == binding->transport) {
695 protseq = transports[i].protseq;
696 num_protocols = transports[i].num_protocols;
701 if (num_protocols == -1) {
702 DEBUG(0, ("Unable to find transport with id '%d'\n", binding->transport));
703 return NT_STATUS_UNSUCCESSFUL;
706 tower->num_floors = 2 + num_protocols;
707 tower->floors = talloc_array(mem_ctx, struct epm_floor, tower->num_floors);
710 tower->floors[0].lhs.protocol = EPM_PROTOCOL_UUID;
712 tower->floors[0].lhs.lhs_data = dcerpc_floor_pack_lhs_data(mem_ctx, &binding->object, binding->object_version);
714 tower->floors[0].rhs.uuid.unknown = data_blob_talloc_zero(mem_ctx, 2);
717 tower->floors[1].lhs.protocol = EPM_PROTOCOL_UUID;
719 tower->floors[1].lhs.lhs_data = dcerpc_floor_pack_lhs_data(mem_ctx,
720 &ndr_transfer_syntax.uuid,
721 ndr_transfer_syntax.if_version);
723 tower->floors[1].rhs.uuid.unknown = data_blob_talloc_zero(mem_ctx, 2);
725 /* Floor 2 to num_protocols */
726 for (i = 0; i < num_protocols; i++) {
727 tower->floors[2 + i].lhs.protocol = protseq[i];
728 tower->floors[2 + i].lhs.lhs_data = data_blob_talloc(mem_ctx, NULL, 0);
729 ZERO_STRUCT(tower->floors[2 + i].rhs);
730 dcerpc_floor_set_rhs_data(mem_ctx, &tower->floors[2 + i], "");
733 /* The 4th floor contains the endpoint */
734 if (num_protocols >= 2 && binding->endpoint) {
735 status = dcerpc_floor_set_rhs_data(mem_ctx, &tower->floors[3], binding->endpoint);
736 if (NT_STATUS_IS_ERR(status)) {
741 /* The 5th contains the network address */
742 if (num_protocols >= 3 && binding->host) {
743 if (is_ipaddress(binding->host)) {
744 status = dcerpc_floor_set_rhs_data(mem_ctx, &tower->floors[4],
747 /* note that we don't attempt to resolve the
748 name here - when we get a hostname here we
749 are in the client code, and want to put in
750 a wildcard all-zeros IP for the server to
752 status = dcerpc_floor_set_rhs_data(mem_ctx, &tower->floors[4],
755 if (NT_STATUS_IS_ERR(status)) {
764 struct epm_map_binding_state {
765 struct dcerpc_binding *binding;
766 const struct dcerpc_interface_table *table;
767 struct dcerpc_pipe *pipe;
768 struct policy_handle handle;
770 struct epm_twr_t twr;
771 struct epm_twr_t *twr_r;
776 static void continue_epm_recv_binding(struct composite_context *ctx);
777 static void continue_epm_map(struct rpc_request *req);
781 Stage 2 of epm_map_binding: Receive connected rpc pipe and send endpoint
784 static void continue_epm_recv_binding(struct composite_context *ctx)
786 struct rpc_request *map_req;
788 struct composite_context *c = talloc_get_type(ctx->async.private_data,
789 struct composite_context);
790 struct epm_map_binding_state *s = talloc_get_type(c->private_data,
791 struct epm_map_binding_state);
793 /* receive result of rpc pipe connect request */
794 c->status = dcerpc_pipe_connect_b_recv(ctx, c, &s->pipe);
795 if (!composite_is_ok(c)) return;
797 /* prepare requested binding parameters */
798 s->binding->object = s->table->uuid;
799 s->binding->object_version = s->table->if_version;
801 c->status = dcerpc_binding_build_tower(s->pipe, s->binding, &s->twr.tower);
802 if (!composite_is_ok(c)) return;
804 /* with some nice pretty paper around it of course */
805 s->r.in.object = &s->guid;
806 s->r.in.map_tower = &s->twr;
807 s->r.in.entry_handle = &s->handle;
808 s->r.in.max_towers = 1;
809 s->r.out.entry_handle = &s->handle;
811 /* send request for an endpoint mapping - a rpc request on connected pipe */
812 map_req = dcerpc_epm_Map_send(s->pipe, c, &s->r);
813 if (composite_nomem(map_req, c)) return;
815 composite_continue_rpc(c, map_req, continue_epm_map, c);
820 Stage 3 of epm_map_binding: Receive endpoint mapping and provide binding details
822 static void continue_epm_map(struct rpc_request *req)
824 struct composite_context *c = talloc_get_type(req->async.private,
825 struct composite_context);
826 struct epm_map_binding_state *s = talloc_get_type(c->private_data,
827 struct epm_map_binding_state);
829 /* receive result of a rpc request */
830 c->status = dcerpc_ndr_request_recv(req);
831 if (!composite_is_ok(c)) return;
833 /* check the details */
834 if (s->r.out.result != 0 || s->r.out.num_towers != 1) {
835 composite_error(c, NT_STATUS_PORT_UNREACHABLE);
839 s->twr_r = s->r.out.towers[0].twr;
840 if (s->twr_r == NULL) {
841 composite_error(c, NT_STATUS_PORT_UNREACHABLE);
845 if (s->twr_r->tower.num_floors != s->twr.tower.num_floors ||
846 s->twr_r->tower.floors[3].lhs.protocol != s->twr.tower.floors[3].lhs.protocol) {
847 composite_error(c, NT_STATUS_PORT_UNREACHABLE);
851 /* get received endpoint */
852 s->binding->endpoint = talloc_reference(s->binding,
853 dcerpc_floor_get_rhs_data(c, &s->twr_r->tower.floors[3]));
859 Request for endpoint mapping of dcerpc binding - try to request for endpoint
860 unless there is default one.
862 struct composite_context *dcerpc_epm_map_binding_send(TALLOC_CTX *mem_ctx,
863 struct dcerpc_binding *binding,
864 const struct dcerpc_interface_table *table,
865 struct event_context *ev)
867 struct composite_context *c;
868 struct epm_map_binding_state *s;
869 struct composite_context *pipe_connect_req;
870 struct cli_credentials *anon_creds;
873 struct dcerpc_binding *epmapper_binding;
876 /* composite context allocation and setup */
877 c = talloc_zero(mem_ctx, struct composite_context);
878 if (c == NULL) return NULL;
880 s = talloc_zero(c, struct epm_map_binding_state);
881 if (composite_nomem(s, c)) return c;
883 c->state = COMPOSITE_STATE_IN_PROGRESS;
887 /* Try to find event context in memory context in case passed
888 * event_context (argument) was NULL. If there's none, just
891 if (c->event_ctx == NULL) {
892 c->event_ctx = event_context_find(mem_ctx);
895 s->binding = binding;
898 /* anonymous credentials for rpc connection used to get endpoint mapping */
899 anon_creds = cli_credentials_init(mem_ctx);
900 cli_credentials_set_conf(anon_creds);
901 cli_credentials_set_anonymous(anon_creds);
904 First, check if there is a default endpoint specified in the IDL
907 struct dcerpc_binding *default_binding;
909 /* Find one of the default pipes for this interface */
910 for (i = 0; i < table->endpoints->count; i++) {
911 status = dcerpc_parse_binding(mem_ctx, table->endpoints->names[i], &default_binding);
913 if (NT_STATUS_IS_OK(status)) {
914 if (default_binding->transport == binding->transport && default_binding->endpoint) {
915 binding->endpoint = talloc_reference(binding, default_binding->endpoint);
916 talloc_free(default_binding);
922 talloc_free(default_binding);
928 epmapper_binding = talloc_zero(c, struct dcerpc_binding);
929 if (composite_nomem(epmapper_binding, c)) return c;
931 /* basic endpoint mapping data */
932 epmapper_binding->transport = binding->transport;
933 epmapper_binding->host = talloc_reference(epmapper_binding, binding->host);
934 epmapper_binding->options = NULL;
935 epmapper_binding->flags = 0;
936 epmapper_binding->endpoint = NULL;
938 /* initiate rpc pipe connection */
939 pipe_connect_req = dcerpc_pipe_connect_b_send(c, &s->pipe, epmapper_binding, &dcerpc_table_epmapper,
940 anon_creds, c->event_ctx);
941 if (composite_nomem(pipe_connect_req, c)) return c;
943 composite_continue(c, pipe_connect_req, continue_epm_recv_binding, c);
949 Receive result of endpoint mapping request
951 NTSTATUS dcerpc_epm_map_binding_recv(struct composite_context *c)
953 NTSTATUS status = composite_wait(c);
961 Get endpoint mapping for rpc connection
963 NTSTATUS dcerpc_epm_map_binding(TALLOC_CTX *mem_ctx, struct dcerpc_binding *binding,
964 const struct dcerpc_interface_table *table, struct event_context *ev)
966 struct composite_context *c;
968 c = dcerpc_epm_map_binding_send(mem_ctx, binding, table, ev);
969 return dcerpc_epm_map_binding_recv(c);
973 struct pipe_auth_state {
974 struct dcerpc_pipe *pipe;
975 struct dcerpc_binding *binding;
976 const struct dcerpc_interface_table *table;
977 struct cli_credentials *credentials;
981 static void continue_auth_schannel(struct composite_context *ctx);
982 static void continue_auth(struct composite_context *ctx);
983 static void continue_auth_none(struct composite_context *ctx);
987 Stage 2 of pipe_auth: Receive result of schannel bind request
989 static void continue_auth_schannel(struct composite_context *ctx)
991 struct composite_context *c = talloc_get_type(ctx->async.private_data,
992 struct composite_context);
994 c->status = dcerpc_bind_auth_schannel_recv(ctx);
995 if (!composite_is_ok(c)) return;
1002 Stage 2 of pipe_auth: Receive result of authenticated bind request
1004 static void continue_auth(struct composite_context *ctx)
1006 struct composite_context *c = talloc_get_type(ctx->async.private_data,
1007 struct composite_context);
1009 c->status = dcerpc_bind_auth_recv(ctx);
1010 if (!composite_is_ok(c)) return;
1017 Stage 2 of pipe_auth: Receive result of non-authenticated bind request
1019 static void continue_auth_none(struct composite_context *ctx)
1021 struct composite_context *c = talloc_get_type(ctx->async.private_data,
1022 struct composite_context);
1024 c->status = dcerpc_bind_auth_none_recv(ctx);
1025 if (!composite_is_ok(c)) return;
1032 Request to perform an authenticated bind if required. Authentication
1033 is determined using credentials passed and binding flags.
1035 struct composite_context *dcerpc_pipe_auth_send(struct dcerpc_pipe *p,
1036 struct dcerpc_binding *binding,
1037 const struct dcerpc_interface_table *table,
1038 struct cli_credentials *credentials)
1040 struct composite_context *c;
1041 struct pipe_auth_state *s;
1042 struct composite_context *auth_schannel_req;
1043 struct composite_context *auth_req;
1044 struct composite_context *auth_none_req;
1046 /* composite context allocation and setup */
1047 c = talloc_zero(NULL, struct composite_context);
1048 if (c == NULL) return NULL;
1050 s = talloc_zero(c, struct pipe_auth_state);
1051 if (composite_nomem(s, c)) return c;
1053 c->state = COMPOSITE_STATE_IN_PROGRESS;
1054 c->private_data = s;
1055 c->event_ctx = p->conn->event_ctx;
1057 /* store parameters in state structure */
1058 s->binding = binding;
1060 s->credentials = credentials;
1063 s->pipe->conn->flags = binding->flags;
1065 /* remember the binding string for possible secondary connections */
1066 s->pipe->conn->binding_string = dcerpc_binding_string(p, binding);
1068 if (!cli_credentials_is_anonymous(s->credentials) &&
1069 (binding->flags & DCERPC_SCHANNEL) &&
1070 !cli_credentials_get_netlogon_creds(s->credentials)) {
1072 /* If we don't already have netlogon credentials for
1073 * the schannel bind, then we have to get these
1075 auth_schannel_req = dcerpc_bind_auth_schannel_send(c, s->pipe, s->table,
1077 dcerpc_auth_level(s->pipe->conn));
1078 if (composite_nomem(auth_schannel_req, c)) return c;
1080 composite_continue(c, auth_schannel_req, continue_auth_schannel, c);
1082 } else if (!cli_credentials_is_anonymous(s->credentials) &&
1083 !(s->pipe->conn->transport.transport == NCACN_NP &&
1084 !(s->binding->flags & DCERPC_SIGN) &&
1085 !(s->binding->flags & DCERPC_SEAL))) {
1087 /* Perform an authenticated DCE-RPC bind, except where
1088 * we ask for a connection on NCACN_NP, and that
1089 * connection is not signed or sealed. For that case
1090 * we rely on the already authenticated CIFS connection
1095 if ((s->pipe->conn->flags & (DCERPC_SIGN|DCERPC_SEAL)) == 0) {
1097 we are doing an authenticated connection,
1098 but not using sign or seal. We must force
1099 the CONNECT dcerpc auth type as a NONE auth
1100 type doesn't allow authentication
1101 information to be passed.
1103 s->pipe->conn->flags |= DCERPC_CONNECT;
1106 if (s->binding->flags & DCERPC_AUTH_SPNEGO) {
1107 auth_type = DCERPC_AUTH_TYPE_SPNEGO;
1109 } else if (s->binding->flags & DCERPC_AUTH_KRB5) {
1110 auth_type = DCERPC_AUTH_TYPE_KRB5;
1112 } else if (s->binding->flags & DCERPC_SCHANNEL) {
1113 auth_type = DCERPC_AUTH_TYPE_SCHANNEL;
1116 auth_type = DCERPC_AUTH_TYPE_NTLMSSP;
1119 auth_req = dcerpc_bind_auth_send(c, s->pipe, s->table,
1120 s->credentials, auth_type,
1121 dcerpc_auth_level(s->pipe->conn),
1122 s->table->authservices->names[0]);
1123 if (composite_nomem(auth_req, c)) return c;
1125 composite_continue(c, auth_req, continue_auth, c);
1128 auth_none_req = dcerpc_bind_auth_none_send(c, s->pipe, s->table);
1129 if (composite_nomem(auth_none_req, c)) return c;
1131 composite_continue(c, auth_none_req, continue_auth_none, c);
1139 Receive result of authenticated bind request on dcerpc pipe
1141 NTSTATUS dcerpc_pipe_auth_recv(struct composite_context *c)
1145 struct pipe_auth_state *s = talloc_get_type(c->private_data,
1146 struct pipe_auth_state);
1147 status = composite_wait(c);
1148 if (!NT_STATUS_IS_OK(status)) {
1149 char *uuid_str = GUID_string(s->pipe, &s->table->uuid);
1150 DEBUG(0, ("Failed to bind to uuid %s - %s\n", uuid_str, nt_errstr(status)));
1151 talloc_free(uuid_str);
1160 Perform an authenticated bind if needed - sync version
1162 NTSTATUS dcerpc_pipe_auth(struct dcerpc_pipe *p,
1163 struct dcerpc_binding *binding,
1164 const struct dcerpc_interface_table *table,
1165 struct cli_credentials *credentials)
1167 struct composite_context *c;
1169 c = dcerpc_pipe_auth_send(p, binding, table, credentials);
1170 return dcerpc_pipe_auth_recv(c);
1174 NTSTATUS dcerpc_generic_session_key(struct dcerpc_connection *c,
1175 DATA_BLOB *session_key)
1177 /* this took quite a few CPU cycles to find ... */
1178 session_key->data = discard_const_p(unsigned char, "SystemLibraryDTC");
1179 session_key->length = 16;
1180 return NT_STATUS_OK;
1184 fetch the user session key - may be default (above) or the SMB session key
1186 NTSTATUS dcerpc_fetch_session_key(struct dcerpc_pipe *p,
1187 DATA_BLOB *session_key)
1189 return p->conn->security_state.session_key(p->conn, session_key);
1194 log a rpc packet in a format suitable for ndrdump. This is especially useful
1195 for sealed packets, where ethereal cannot easily see the contents
1197 this triggers on a debug level of >= 10
1199 void dcerpc_log_packet(const struct dcerpc_interface_table *ndr,
1200 uint32_t opnum, uint32_t flags, DATA_BLOB *pkt)
1202 const int num_examples = 20;
1205 if (DEBUGLEVEL < 10) return;
1207 for (i=0;i<num_examples;i++) {
1209 asprintf(&name, "%s/rpclog/%s-%u.%d.%s",
1210 lp_lockdir(), ndr->name, opnum, i,
1211 (flags&NDR_IN)?"in":"out");
1215 if (!file_exist(name)) {
1216 if (file_save(name, pkt->data, pkt->length)) {
1217 DEBUG(10,("Logged rpc packet to %s\n", name));
1229 create a secondary context from a primary connection
1231 this uses dcerpc_alter_context() to create a new dcerpc context_id
1233 NTSTATUS dcerpc_secondary_context(struct dcerpc_pipe *p,
1234 struct dcerpc_pipe **pp2,
1235 const struct dcerpc_interface_table *table)
1238 struct dcerpc_pipe *p2;
1240 p2 = talloc_zero(p, struct dcerpc_pipe);
1242 return NT_STATUS_NO_MEMORY;
1244 p2->conn = talloc_reference(p2, p->conn);
1245 p2->request_timeout = p->request_timeout;
1247 p2->context_id = ++p->conn->next_context_id;
1249 p2->syntax.uuid = table->uuid;
1250 p2->syntax.if_version = table->if_version;
1252 p2->transfer_syntax = ndr_transfer_syntax;
1254 status = dcerpc_alter_context(p2, p2, &p2->syntax, &p2->transfer_syntax);
1255 if (!NT_STATUS_IS_OK(status)) {