3 * Unix SMB/Netbios implementation.
5 * RPC Pipe client / server routines
6 * Copyright (C) Andrew Tridgell 1992-1998
7 * Copyright (C) Luke Kenneth Casson Leighton 1996-1998,
8 * Copyright (C) Paul Ashton 1997-1998.
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 2 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, write to the Free Software
22 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 /* this module apparently provides an implementation of DCE/RPC over a
26 * named pipe (IPC$ connection using SMBtrans). details of DCE/RPC
27 * documentation are available (in on-line form) from the X-Open group.
29 * this module should provide a level of abstraction between SMB
30 * and DCE/RPC, while minimising the amount of mallocs, unnecessary
31 * data copies, and network traffic.
33 * in this version, which takes a "let's learn what's going on and
34 * get something running" approach, there is additional network
35 * traffic generated, but the code should be easier to understand...
37 * ... if you read the docs. or stare at packets for weeks on end.
44 extern int DEBUGLEVEL;
45 extern DOM_SID global_machine_sid;
48 * A list of the rids of well known BUILTIN and Domain users
52 rid_name builtin_alias_rids[] =
54 { BUILTIN_ALIAS_RID_ADMINS , "Administrators" },
55 { BUILTIN_ALIAS_RID_USERS , "Users" },
56 { BUILTIN_ALIAS_RID_GUESTS , "Guests" },
57 { BUILTIN_ALIAS_RID_POWER_USERS , "Power Users" },
59 { BUILTIN_ALIAS_RID_ACCOUNT_OPS , "Account Operators" },
60 { BUILTIN_ALIAS_RID_SYSTEM_OPS , "System Operators" },
61 { BUILTIN_ALIAS_RID_PRINT_OPS , "Print Operators" },
62 { BUILTIN_ALIAS_RID_BACKUP_OPS , "Backup Operators" },
63 { BUILTIN_ALIAS_RID_REPLICATOR , "Replicator" },
67 /* array lookup of well-known Domain RID users. */
68 rid_name domain_user_rids[] =
70 { DOMAIN_USER_RID_ADMIN , "Administrator" },
71 { DOMAIN_USER_RID_GUEST , "Guest" },
75 /* array lookup of well-known Domain RID groups. */
76 rid_name domain_group_rids[] =
78 { DOMAIN_GROUP_RID_ADMINS , "Domain Admins" },
79 { DOMAIN_GROUP_RID_USERS , "Domain Users" },
80 { DOMAIN_GROUP_RID_GUESTS , "Domain Guests" },
84 int make_dom_gids(char *gids_str, DOM_GID **ppgids)
93 DEBUG(4,("make_dom_gids: %s\n", gids_str));
95 if (gids_str == NULL || *gids_str == 0)
98 for (count = 0, ptr = gids_str;
99 next_token(&ptr, s2, NULL, sizeof(s2));
103 gids = (DOM_GID *)malloc( sizeof(DOM_GID) * count );
106 DEBUG(0,("make_dom_gids: malloc fail !\n"));
110 for (count = 0, ptr = gids_str;
111 next_token(&ptr, s2, NULL, sizeof(s2)) &&
112 count < LSA_MAX_GROUPS;
115 /* the entries are of the form GID/ATTR, ATTR being optional.*/
120 attr = strchr(s2,'/');
125 attr = "7"; /* default value for attribute is 7 */
127 /* look up the RID string and see if we can turn it into a rid number */
128 for (i = 0; builtin_alias_rids[i].name != NULL; i++)
130 if (strequal(builtin_alias_rids[i].name, s2))
132 rid = builtin_alias_rids[i].rid;
142 DEBUG(1,("make_dom_gids: unknown well-known alias RID %s/%s\n", s2, attr));
147 gids[count].g_rid = rid;
148 gids[count].attr = atoi(attr);
150 DEBUG(5,("group id: %d attr: %d\n", gids[count].g_rid, gids[count].attr));
158 /*******************************************************************
159 turns a DCE/RPC request into a DCE/RPC reply
161 this is where the data really should be split up into an array of
162 headers and data sections.
164 ********************************************************************/
165 BOOL create_rpc_reply(pipes_struct *p,
166 uint32 data_start, uint32 data_end)
168 DEBUG(5,("create_rpc_reply: data_start: %d data_end: %d max_tsize: %d\n",
169 data_start, data_end, p->hdr_ba.bba.max_tsize));
171 mem_buf_init(&(p->rhdr.data), 0);
172 mem_alloc_data(p->rhdr.data, 0x18);
177 p->hdr_resp.alloc_hint = data_end - data_start; /* calculate remaining data to be sent */
178 p->hdr.pkt_type = RPC_RESPONSE; /* mark header as an rpc response */
180 /* set up rpc header (fragmentation issues) */
183 p->hdr.flags = RPC_FLG_FIRST;
190 if (p->hdr_resp.alloc_hint + 0x18 <= p->hdr_ba.bba.max_tsize)
192 p->hdr.flags |= RPC_FLG_LAST;
193 p->hdr.frag_len = p->hdr_resp.alloc_hint + 0x18;
197 p->hdr.frag_len = p->hdr_ba.bba.max_tsize;
200 p->rhdr.data->offset.start = 0;
201 p->rhdr.data->offset.end = 0x18;
203 /* store the header in the data stream */
205 smb_io_rpc_hdr ("hdr", &(p->hdr ), &(p->rhdr), 0);
206 smb_io_rpc_hdr_resp("resp", &(p->hdr_resp), &(p->rhdr), 0);
208 return p->rhdr.data != NULL && p->rhdr.offset == 0x18;
211 static BOOL api_pipe_ntlmssp_verify(pipes_struct *p)
216 DEBUG(5,("api_pipe_ntlmssp_verify: checking user details\n"));
218 if (p->ntlmssp_resp.hdr_lm_resp.str_str_len == 0) return False;
219 if (p->ntlmssp_resp.hdr_nt_resp.str_str_len == 0) return False;
220 if (p->ntlmssp_resp.hdr_usr .str_str_len == 0) return False;
221 if (p->ntlmssp_resp.hdr_domain .str_str_len == 0) return False;
222 if (p->ntlmssp_resp.hdr_wks .str_str_len == 0) return False;
224 memset(p->user_name, 0, sizeof(p->user_name));
225 memset(p->domain , 0, sizeof(p->domain ));
226 memset(p->wks , 0, sizeof(p->wks ));
228 if (IS_BITS_SET_ALL(p->ntlmssp_chal.neg_flags, NTLMSSP_NEGOTIATE_UNICODE))
230 fstrcpy(p->user_name, unistrn2((uint16*)p->ntlmssp_resp.user , p->ntlmssp_resp.hdr_usr .str_str_len/2));
231 fstrcpy(p->domain , unistrn2((uint16*)p->ntlmssp_resp.domain, p->ntlmssp_resp.hdr_domain.str_str_len/2));
232 fstrcpy(p->wks , unistrn2((uint16*)p->ntlmssp_resp.wks , p->ntlmssp_resp.hdr_wks .str_str_len/2));
236 fstrcpy(p->user_name, p->ntlmssp_resp.user );
237 fstrcpy(p->domain , p->ntlmssp_resp.domain);
238 fstrcpy(p->wks , p->ntlmssp_resp.wks );
241 DEBUG(5,("user: %s domain: %s wks: %s\n", p->user_name, p->domain, p->wks));
243 memcpy(lm_owf, p->ntlmssp_resp.lm_resp, sizeof(lm_owf));
244 memcpy(nt_owf, p->ntlmssp_resp.nt_resp, sizeof(nt_owf));
246 #ifdef DEBUG_PASSWORD
247 DEBUG(100,("lm, nt owfs:\n"));
248 dump_data(100, lm_owf, sizeof(lm_owf));
249 dump_data(100, nt_owf, sizeof(nt_owf));
252 p->ntlmssp_validated = pass_check_smb(p->user_name, p->domain,
253 p->ntlmssp_chal.challenge, lm_owf, nt_owf, NULL);
256 return p->ntlmssp_validated;
259 static BOOL api_pipe_ntlmssp(pipes_struct *p, prs_struct *pd)
261 /* receive a negotiate; send a challenge; receive a response */
262 switch (p->auth_verifier.msg_type)
264 case NTLMSSP_NEGOTIATE:
266 smb_io_rpc_auth_ntlmssp_neg("", &p->ntlmssp_neg, pd, 0);
271 smb_io_rpc_auth_ntlmssp_resp("", &p->ntlmssp_resp, pd, 0);
272 if (!api_pipe_ntlmssp_verify(p))
280 /* NTLMSSP expected: unexpected message type */
281 DEBUG(3,("unexpected message type in NTLMSSP %d\n",
282 p->auth_verifier.msg_type));
287 return (pd->offset != 0);
292 char * pipe_clnt_name;
293 char * pipe_srv_name;
294 BOOL (*fn) (pipes_struct *, prs_struct *);
297 static struct api_cmd api_fd_commands[] =
299 { "lsarpc", "lsass", api_ntlsa_rpc },
300 { "samr", "lsass", api_samr_rpc },
301 { "srvsvc", "ntsvcs", api_srvsvc_rpc },
302 { "wkssvc", "ntsvcs", api_wkssvc_rpc },
303 { "NETLOGON", "lsass", api_netlog_rpc },
304 { "winreg", "winreg", api_reg_rpc },
308 static BOOL api_pipe_bind_auth_resp(pipes_struct *p, prs_struct *pd)
310 p->ntlmssp_auth = False;
312 DEBUG(5,("api_pipe_bind_auth_resp: decode request. %d\n", __LINE__));
314 if (p->hdr.auth_len != 0)
316 /* decode the authentication verifier response */
317 smb_io_rpc_hdr_autha("", &p->autha_info, pd, 0);
318 if (pd->offset == 0) return False;
320 p->ntlmssp_auth = p->auth_info.auth_type = 0x0a;
324 smb_io_rpc_auth_verifier("", &p->auth_verifier, pd, 0);
325 if (pd->offset == 0) return False;
327 p->ntlmssp_auth = strequal(p->auth_verifier.signature, "NTLMSSP");
332 if (!api_pipe_ntlmssp(p, pd)) return False;
336 return p->ntlmssp_auth;
339 static BOOL api_pipe_bind_req(pipes_struct *p, prs_struct *pd)
342 fstring ack_pipe_name;
345 p->ntlmssp_auth = False;
347 DEBUG(5,("api_pipe_bind_req: decode request. %d\n", __LINE__));
349 for (i = 0; api_fd_commands[i].pipe_clnt_name; i++)
351 if (strequal(api_fd_commands[i].pipe_clnt_name, p->name) &&
352 api_fd_commands[i].fn != NULL)
354 DEBUG(3,("api_pipe_bind_req: \\PIPE\\%s -> \\PIPE\\%s\n",
355 api_fd_commands[i].pipe_clnt_name,
356 api_fd_commands[i].pipe_srv_name));
357 fstrcpy(p->pipe_srv_name, api_fd_commands[i].pipe_srv_name);
362 if (api_fd_commands[i].fn == NULL) return False;
364 /* decode the bind request */
365 smb_io_rpc_hdr_rb("", &p->hdr_rb, pd, 0);
367 if (pd->offset == 0) return False;
369 if (p->hdr.auth_len != 0)
371 /* decode the authentication verifier */
372 smb_io_rpc_hdr_auth ("", &p->auth_info , pd, 0);
373 if (pd->offset == 0) return False;
375 p->ntlmssp_auth = p->auth_info.auth_type = 0x0a;
379 smb_io_rpc_auth_verifier("", &p->auth_verifier, pd, 0);
380 if (pd->offset == 0) return False;
382 p->ntlmssp_auth = strequal(p->auth_verifier.signature, "NTLMSSP");
387 if (!api_pipe_ntlmssp(p, pd)) return False;
391 /* name has to be \PIPE\xxxxx */
392 fstrcpy(ack_pipe_name, "\\PIPE\\");
393 fstrcat(ack_pipe_name, p->pipe_srv_name);
395 DEBUG(5,("api_pipe_bind_req: make response. %d\n", __LINE__));
397 prs_init(&(p->rdata), 1024, 4, 0, False);
398 prs_init(&(p->rhdr ), 0x10, 4, 0, False);
399 prs_init(&(p->rauth), 1024, 4, 0, False);
400 prs_init(&(p->rverf), 0x08, 4, 0, False);
401 prs_init(&(p->rntlm), 1024, 4, 0, False);
404 /*** do the bind ack first ***/
413 assoc_gid = p->hdr_rb.bba.assoc_gid;
416 make_rpc_hdr_ba(&p->hdr_ba,
417 p->hdr_rb.bba.max_tsize,
418 p->hdr_rb.bba.max_rsize,
422 &(p->hdr_rb.transfer));
424 smb_io_rpc_hdr_ba("", &p->hdr_ba, &p->rdata, 0);
425 mem_realloc_data(p->rdata.data, p->rdata.offset);
428 /*** now the authentication ***/
434 generate_random_buffer(challenge, 8, False);
436 /*** authentication info ***/
438 make_rpc_hdr_auth(&p->auth_info, 0x0a, 0x06, 0, 1);
439 smb_io_rpc_hdr_auth("", &p->auth_info, &p->rverf, 0);
440 mem_realloc_data(p->rverf.data, p->rverf.offset);
442 /*** NTLMSSP verifier ***/
444 make_rpc_auth_verifier(&p->auth_verifier,
445 "NTLMSSP", NTLMSSP_CHALLENGE);
446 smb_io_rpc_auth_verifier("", &p->auth_verifier, &p->rauth, 0);
447 mem_realloc_data(p->rauth.data, p->rauth.offset);
449 /* NTLMSSP challenge ***/
451 make_rpc_auth_ntlmssp_chal(&p->ntlmssp_chal,
452 0x000082b1, challenge);
453 smb_io_rpc_auth_ntlmssp_chal("", &p->ntlmssp_chal, &p->rntlm, 0);
454 mem_realloc_data(p->rntlm.data, p->rntlm.offset);
458 /*** then do the header, now we know the length ***/
461 make_rpc_hdr(&p->hdr, RPC_BINDACK, RPC_FLG_FIRST | RPC_FLG_LAST,
463 p->rdata.offset + p->rverf.offset + p->rauth.offset + p->rntlm.offset + 0x10,
464 p->rauth.offset + p->rntlm.offset);
466 smb_io_rpc_hdr("", &p->hdr, &p->rhdr, 0);
467 mem_realloc_data(p->rhdr.data, p->rdata.offset);
470 /*** link rpc header, bind acknowledgment and authentication responses ***/
475 prs_link(NULL , &p->rhdr , &p->rdata);
476 prs_link(&p->rhdr , &p->rdata, &p->rverf);
477 prs_link(&p->rdata, &p->rverf, &p->rauth);
478 prs_link(&p->rverf, &p->rauth, &p->rntlm);
479 prs_link(&p->rauth, &p->rntlm, NULL );
483 prs_link(NULL , &p->rhdr , &p->rdata);
484 prs_link(&p->rhdr, &p->rdata, NULL );
491 static BOOL api_pipe_auth_process(pipes_struct *p, prs_struct *pd)
496 static BOOL api_pipe_request(pipes_struct *p, prs_struct *pd)
500 if (p->ntlmssp_auth && p->ntlmssp_validated)
502 if (!api_pipe_auth_process(p, pd)) return False;
504 DEBUG(0,("api_pipe_request: **** MUST CALL become_user() HERE **** \n"));
510 for (i = 0; api_fd_commands[i].pipe_clnt_name; i++)
512 if (strequal(api_fd_commands[i].pipe_clnt_name, p->name) &&
513 api_fd_commands[i].fn != NULL)
515 DEBUG(3,("Doing \\PIPE\\%s\n", api_fd_commands[i].pipe_clnt_name));
516 return api_fd_commands[i].fn(p, pd);
522 BOOL rpc_command(pipes_struct *p, prs_struct *pd)
525 if (pd->data == NULL) return False;
527 /* process the rpc header */
528 smb_io_rpc_hdr("", &p->hdr, pd, 0);
530 if (pd->offset == 0) return False;
532 switch (p->hdr.pkt_type)
536 reply = api_pipe_bind_req(p, pd);
541 reply = api_pipe_request (p, pd);
544 case RPC_BINDRESP: /* not the real name! */
546 reply = api_pipe_bind_auth_resp(p, pd);
556 /*******************************************************************
557 receives a netlogon pipe and responds.
558 ********************************************************************/
559 static BOOL api_rpc_command(pipes_struct *p,
560 char *rpc_name, struct api_struct *api_rpc_cmds,
564 DEBUG(4,("api_rpc_command: %s op 0x%x - ", rpc_name, p->hdr_req.opnum));
566 for (fn_num = 0; api_rpc_cmds[fn_num].name; fn_num++)
568 if (api_rpc_cmds[fn_num].opnum == p->hdr_req.opnum && api_rpc_cmds[fn_num].fn != NULL)
570 DEBUG(3,("api_rpc_command: %s\n", api_rpc_cmds[fn_num].name));
575 if (api_rpc_cmds[fn_num].name == NULL)
577 DEBUG(4, ("unknown\n"));
581 /* start off with 1024 bytes, and a large safety margin too */
582 mem_buf_init(&(p->rdata.data), SAFETY_MARGIN);
583 mem_alloc_data(p->rdata.data, 1024);
588 p->rdata.data->offset.start = 0;
589 p->rdata.data->offset.end = 0xffffffff;
591 /* do the actual command */
593 api_rpc_cmds[fn_num].fn(p->vuid, data, &(p->rdata));
595 if (p->rdata.data == NULL || p->rdata.offset == 0)
597 mem_free_data(p->rdata.data);
601 mem_realloc_data(p->rdata.data, p->rdata.offset);
603 DEBUG(10,("called %s\n", rpc_name));
609 /*******************************************************************
610 receives a netlogon pipe and responds.
611 ********************************************************************/
612 BOOL api_rpcTNP(pipes_struct *p, char *rpc_name, struct api_struct *api_rpc_cmds,
615 if (data == NULL || data->data == NULL)
617 DEBUG(2,("%s: NULL data received\n", rpc_name));
621 /* read the rpc header */
622 smb_io_rpc_hdr_req("req", &(p->hdr_req), data, 0);
624 /* interpret the command */
625 if (!api_rpc_command(p, rpc_name, api_rpc_cmds, data))
630 /* create the rpc header */
631 if (!create_rpc_reply(p, 0, p->rdata.offset))
636 p->frag_len_left = p->hdr.frag_len - p->file_offset;
637 p->next_frag_start = p->hdr.frag_len;
639 /* set up the data chain */
640 p->rhdr.data->offset.start = 0;
641 p->rhdr.data->offset.end = p->rhdr.offset;
642 p->rhdr.data->next = p->rdata.data;
644 p->rdata.data->offset.start = p->rhdr.data->offset.end;
645 p->rdata.data->offset.end = p->rhdr.data->offset.end + p->rdata.offset;
646 p->rdata.data->next = NULL;
652 /*******************************************************************
653 gets a domain user's groups
654 ********************************************************************/
655 void get_domain_user_groups(char *domain_groups, char *user)
659 if (domain_groups == NULL || user == NULL) return;
661 /* any additional groups this user is in. e.g power users */
662 pstrcpy(domain_groups, lp_domain_groups());
664 /* can only be a user or a guest. cannot be guest _and_ admin */
665 if (user_in_list(user, lp_domain_guest_group()))
667 slprintf(tmp, sizeof(tmp) - 1, " %ld/7 ", DOMAIN_GROUP_RID_GUESTS);
668 pstrcat(domain_groups, tmp);
670 DEBUG(3,("domain guest group access %s granted\n", tmp));
674 slprintf(tmp, sizeof(tmp) -1, " %ld/7 ", DOMAIN_GROUP_RID_USERS);
675 pstrcat(domain_groups, tmp);
677 DEBUG(3,("domain group access %s granted\n", tmp));
679 if (user_in_list(user, lp_domain_admin_group()))
681 slprintf(tmp, sizeof(tmp) - 1, " %ld/7 ", DOMAIN_GROUP_RID_ADMINS);
682 pstrcat(domain_groups, tmp);
684 DEBUG(3,("domain admin group access %s granted\n", tmp));
690 /*******************************************************************
692 ********************************************************************/
693 uint32 lookup_group_name(uint32 rid, char *group_name, uint32 *type)
696 (*type) = SID_NAME_DOM_GRP;
698 DEBUG(5,("lookup_group_name: rid: %d", rid));
700 while (domain_group_rids[i].rid != rid && domain_group_rids[i].rid != 0)
705 if (domain_group_rids[i].rid != 0)
707 fstrcpy(group_name, domain_group_rids[i].name);
708 DEBUG(5,(" = %s\n", group_name));
712 DEBUG(5,(" none mapped\n"));
713 return 0xC0000000 | NT_STATUS_NONE_MAPPED;
716 /*******************************************************************
718 ********************************************************************/
719 uint32 lookup_alias_name(uint32 rid, char *alias_name, uint32 *type)
722 (*type) = SID_NAME_WKN_GRP;
724 DEBUG(5,("lookup_alias_name: rid: %d", rid));
726 while (builtin_alias_rids[i].rid != rid && builtin_alias_rids[i].rid != 0)
731 if (builtin_alias_rids[i].rid != 0)
733 fstrcpy(alias_name, builtin_alias_rids[i].name);
734 DEBUG(5,(" = %s\n", alias_name));
738 DEBUG(5,(" none mapped\n"));
739 return 0xC0000000 | NT_STATUS_NONE_MAPPED;
742 /*******************************************************************
744 ********************************************************************/
745 uint32 lookup_user_name(uint32 rid, char *user_name, uint32 *type)
747 struct sam_disp_info *disp_info;
749 (*type) = SID_NAME_USER;
751 DEBUG(5,("lookup_user_name: rid: %d", rid));
753 /* look up the well-known domain user rids first */
754 while (domain_user_rids[i].rid != rid && domain_user_rids[i].rid != 0)
759 if (domain_user_rids[i].rid != 0)
761 fstrcpy(user_name, domain_user_rids[i].name);
762 DEBUG(5,(" = %s\n", user_name));
766 /* ok, it's a user. find the user account */
768 disp_info = getsamdisprid(rid);
771 if (disp_info != NULL)
773 fstrcpy(user_name, disp_info->smb_name);
774 DEBUG(5,(" = %s\n", user_name));
778 DEBUG(5,(" none mapped\n"));
779 return 0xC0000000 | NT_STATUS_NONE_MAPPED;
782 /*******************************************************************
784 ********************************************************************/
785 uint32 lookup_group_rid(char *group_name, uint32 *rid)
788 int i = -1; /* start do loop at -1 */
790 do /* find, if it exists, a group rid for the group name*/
793 (*rid) = domain_group_rids[i].rid;
794 grp_name = domain_group_rids[i].name;
796 } while (grp_name != NULL && !strequal(grp_name, group_name));
798 return (grp_name != NULL) ? 0 : 0xC0000000 | NT_STATUS_NONE_MAPPED;
801 /*******************************************************************
803 ********************************************************************/
804 uint32 lookup_alias_rid(char *alias_name, uint32 *rid)
807 int i = -1; /* start do loop at -1 */
809 do /* find, if it exists, a alias rid for the alias name*/
812 (*rid) = builtin_alias_rids[i].rid;
813 als_name = builtin_alias_rids[i].name;
815 } while (als_name != NULL && !strequal(als_name, alias_name));
817 return (als_name != NULL) ? 0 : 0xC0000000 | NT_STATUS_NONE_MAPPED;
820 /*******************************************************************
822 ********************************************************************/
823 uint32 lookup_user_rid(char *user_name, uint32 *rid)
825 struct sam_passwd *sam_pass;
828 /* find the user account */
830 sam_pass = getsam21pwnam(user_name);
833 if (sam_pass != NULL)
835 (*rid) = sam_pass->user_rid;
839 return 0xC0000000 | NT_STATUS_NONE_MAPPED;