s3: Use IS_DC macro in get_global_sam_name()
[gd/samba-autobuild/.git] / source3 / lib / util_sid.c
1 /* 
2    Unix SMB/CIFS implementation.
3    Samba utility functions
4    Copyright (C) Andrew Tridgell                1992-1998
5    Copyright (C) Luke Kenneth Caseson Leighton  1998-1999
6    Copyright (C) Jeremy Allison                 1999
7    Copyright (C) Stefan (metze) Metzmacher      2002
8    Copyright (C) Simo Sorce                     2002
9    Copyright (C) Jim McDonough <jmcd@us.ibm.com> 2005
10
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.
15
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.
20
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/>.
23 */
24
25 #include "includes.h"
26
27 /*
28  * Some useful sids, more well known sids can be found at
29  * http://support.microsoft.com/kb/243330/EN-US/
30  */
31
32
33 const DOM_SID global_sid_World_Domain =               /* Everyone domain */
34 { 1, 0, {0,0,0,0,0,1}, {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
35 const DOM_SID global_sid_World =                      /* Everyone */
36 { 1, 1, {0,0,0,0,0,1}, {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
37 const DOM_SID global_sid_Creator_Owner_Domain =       /* Creator Owner domain */
38 { 1, 0, {0,0,0,0,0,3}, {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
39 const DOM_SID global_sid_NT_Authority =                 /* NT Authority */
40 { 1, 0, {0,0,0,0,0,5}, {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
41 const DOM_SID global_sid_System =                       /* System */
42 { 1, 1, {0,0,0,0,0,5}, {18,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
43 const DOM_SID global_sid_NULL =                         /* NULL sid */
44 { 1, 1, {0,0,0,0,0,0}, {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
45 const DOM_SID global_sid_Authenticated_Users =  /* All authenticated rids */
46 { 1, 1, {0,0,0,0,0,5}, {11,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
47 #if 0
48 /* for documentation */
49 const DOM_SID global_sid_Restriced =                    /* Restriced Code */
50 { 1, 1, {0,0,0,0,0,5}, {12,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
51 #endif
52 const DOM_SID global_sid_Network =                      /* Network rids */
53 { 1, 1, {0,0,0,0,0,5}, {2,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
54
55 const DOM_SID global_sid_Creator_Owner =                /* Creator Owner */
56 { 1, 1, {0,0,0,0,0,3}, {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
57 const DOM_SID global_sid_Creator_Group =                /* Creator Group */
58 { 1, 1, {0,0,0,0,0,3}, {1,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
59 const DOM_SID global_sid_Anonymous =                    /* Anonymous login */
60 { 1, 1, {0,0,0,0,0,5}, {7,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
61
62 const DOM_SID global_sid_Builtin =                      /* Local well-known domain */
63 { 1, 1, {0,0,0,0,0,5}, {32,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
64 const DOM_SID global_sid_Builtin_Administrators =       /* Builtin administrators */
65 { 1, 2, {0,0,0,0,0,5}, {32,544,0,0,0,0,0,0,0,0,0,0,0,0,0}};
66 const DOM_SID global_sid_Builtin_Users =                /* Builtin users */
67 { 1, 2, {0,0,0,0,0,5}, {32,545,0,0,0,0,0,0,0,0,0,0,0,0,0}};
68 const DOM_SID global_sid_Builtin_Guests =               /* Builtin guest users */
69 { 1, 2, {0,0,0,0,0,5}, {32,546,0,0,0,0,0,0,0,0,0,0,0,0,0}};
70 const DOM_SID global_sid_Builtin_Power_Users =  /* Builtin power users */
71 { 1, 2, {0,0,0,0,0,5}, {32,547,0,0,0,0,0,0,0,0,0,0,0,0,0}};
72 const DOM_SID global_sid_Builtin_Account_Operators =    /* Builtin account operators */
73 { 1, 2, {0,0,0,0,0,5}, {32,548,0,0,0,0,0,0,0,0,0,0,0,0,0}};
74 const DOM_SID global_sid_Builtin_Server_Operators =     /* Builtin server operators */
75 { 1, 2, {0,0,0,0,0,5}, {32,549,0,0,0,0,0,0,0,0,0,0,0,0,0}};
76 const DOM_SID global_sid_Builtin_Print_Operators =      /* Builtin print operators */
77 { 1, 2, {0,0,0,0,0,5}, {32,550,0,0,0,0,0,0,0,0,0,0,0,0,0}};
78 const DOM_SID global_sid_Builtin_Backup_Operators =     /* Builtin backup operators */
79 { 1, 2, {0,0,0,0,0,5}, {32,551,0,0,0,0,0,0,0,0,0,0,0,0,0}};
80 const DOM_SID global_sid_Builtin_Replicator =           /* Builtin replicator */
81 { 1, 2, {0,0,0,0,0,5}, {32,552,0,0,0,0,0,0,0,0,0,0,0,0,0}};
82 const DOM_SID global_sid_Builtin_PreWin2kAccess =       /* Builtin pre win2k access */
83 { 1, 2, {0,0,0,0,0,5}, {32,554,0,0,0,0,0,0,0,0,0,0,0,0,0}};
84
85 const DOM_SID global_sid_Unix_Users =                   /* Unmapped Unix users */
86 { 1, 1, {0,0,0,0,0,22}, {1,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
87 const DOM_SID global_sid_Unix_Groups =                  /* Unmapped Unix groups */
88 { 1, 1, {0,0,0,0,0,22}, {2,0,0,0,0,0,0,0,0,0,0,0,0,0,0}};
89
90 /* Unused, left here for documentary purposes */
91 #if 0
92 #define SECURITY_NULL_SID_AUTHORITY    0
93 #define SECURITY_WORLD_SID_AUTHORITY   1
94 #define SECURITY_LOCAL_SID_AUTHORITY   2
95 #define SECURITY_CREATOR_SID_AUTHORITY 3
96 #define SECURITY_NT_AUTHORITY          5
97 #endif
98
99 /*
100  * An NT compatible anonymous token.
101  */
102
103 static DOM_SID anon_sid_array[3] =
104 { { 1, 1, {0,0,0,0,0,1}, {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}},
105   { 1, 1, {0,0,0,0,0,5}, {2,0,0,0,0,0,0,0,0,0,0,0,0,0,0}},
106   { 1, 1, {0,0,0,0,0,5}, {7,0,0,0,0,0,0,0,0,0,0,0,0,0,0}} };
107 NT_USER_TOKEN anonymous_token = { 3, anon_sid_array, SE_NONE };
108
109 static DOM_SID system_sid_array[1] =
110 { { 1, 1, {0,0,0,0,0,5}, {18,0,0,0,0,0,0,0,0,0,0,0,0,0,0}} };
111 NT_USER_TOKEN system_token = { 1, system_sid_array, SE_ALL_PRIVS };
112
113 /****************************************************************************
114  Lookup string names for SID types.
115 ****************************************************************************/
116
117 static const struct {
118         enum lsa_SidType sid_type;
119         const char *string;
120 } sid_name_type[] = {
121         {SID_NAME_USER, "User"},
122         {SID_NAME_DOM_GRP, "Domain Group"},
123         {SID_NAME_DOMAIN, "Domain"},
124         {SID_NAME_ALIAS, "Local Group"},
125         {SID_NAME_WKN_GRP, "Well-known Group"},
126         {SID_NAME_DELETED, "Deleted Account"},
127         {SID_NAME_INVALID, "Invalid Account"},
128         {SID_NAME_UNKNOWN, "UNKNOWN"},
129         {SID_NAME_COMPUTER, "Computer"},
130
131         {(enum lsa_SidType)0, NULL}
132 };
133
134 const char *sid_type_lookup(uint32 sid_type) 
135 {
136         int i = 0;
137
138         /* Look through list */
139         while(sid_name_type[i].sid_type != 0) {
140                 if (sid_name_type[i].sid_type == sid_type)
141                         return sid_name_type[i].string;
142                 i++;
143         }
144
145         /* Default return */
146         return "SID *TYPE* is INVALID";
147 }
148
149 /**************************************************************************
150  Create the SYSTEM token.
151 ***************************************************************************/
152
153 NT_USER_TOKEN *get_system_token(void) 
154 {
155         return &system_token;
156 }
157
158 /******************************************************************
159  get the default domain/netbios name to be used when dealing 
160  with our passdb list of accounts
161 ******************************************************************/
162
163 const char *get_global_sam_name(void) 
164 {
165         if (IS_DC) {
166                 return lp_workgroup();
167         }
168         return global_myname();
169 }
170
171 /*****************************************************************
172  Convert a SID to an ascii string.
173 *****************************************************************/
174
175 char *sid_to_fstring(fstring sidstr_out, const DOM_SID *sid)
176 {
177         char *str = sid_string_talloc(talloc_tos(), sid);
178         fstrcpy(sidstr_out, str);
179         TALLOC_FREE(str);
180         return sidstr_out;
181 }
182
183 /*****************************************************************
184  Essentially a renamed dom_sid_string from librpc/ndr with a
185  panic if it didn't work
186
187  This introduces a dependency on librpc/ndr/sid.o which can easily
188  be turned around if necessary
189 *****************************************************************/
190
191 char *sid_string_talloc(TALLOC_CTX *mem_ctx, const DOM_SID *sid)
192 {
193         char *result = dom_sid_string(mem_ctx, sid);
194         SMB_ASSERT(result != NULL);
195         return result;
196 }
197
198 /*****************************************************************
199  Useful function for debug lines.
200 *****************************************************************/
201
202 char *sid_string_dbg(const DOM_SID *sid)
203 {
204         return sid_string_talloc(talloc_tos(), sid);
205 }
206
207 /*****************************************************************
208  Use with care!
209 *****************************************************************/
210
211 char *sid_string_tos(const DOM_SID *sid)
212 {
213         return sid_string_talloc(talloc_tos(), sid);
214 }
215
216 /*****************************************************************
217  Convert a string to a SID. Returns True on success, False on fail.
218 *****************************************************************/  
219
220 bool string_to_sid(DOM_SID *sidout, const char *sidstr)
221 {
222         const char *p;
223         char *q;
224         /* BIG NOTE: this function only does SIDS where the identauth is not >= 2^32 */
225         uint32 conv;
226
227         if ((sidstr[0] != 'S' && sidstr[0] != 's') || sidstr[1] != '-') {
228                 goto format_error;
229         }
230
231         ZERO_STRUCTP(sidout);
232
233         /* Get the revision number. */
234         p = sidstr + 2;
235
236         if (!isdigit(*p)) {
237                 goto format_error;
238         }
239
240         conv = (uint32) strtoul(p, &q, 10);
241         if (!q || (*q != '-')) {
242                 goto format_error;
243         }
244         sidout->sid_rev_num = (uint8) conv;
245         q++;
246
247         if (!isdigit(*q)) {
248                 goto format_error;
249         }
250
251         /* get identauth */
252         conv = (uint32) strtoul(q, &q, 10);
253         if (!q || (*q != '-')) {
254                 goto format_error;
255         }
256         /* identauth in decimal should be <  2^32 */
257         /* NOTE - the conv value is in big-endian format. */
258         sidout->id_auth[0] = 0;
259         sidout->id_auth[1] = 0;
260         sidout->id_auth[2] = (conv & 0xff000000) >> 24;
261         sidout->id_auth[3] = (conv & 0x00ff0000) >> 16;
262         sidout->id_auth[4] = (conv & 0x0000ff00) >> 8;
263         sidout->id_auth[5] = (conv & 0x000000ff);
264
265         q++;
266         sidout->num_auths = 0;
267
268         while (true) {
269                 char *end;
270
271                 if (!isdigit(*q)) {
272                         goto format_error;
273                 }
274
275                 conv = strtoul(q, &end, 10);
276                 if (end == q) {
277                         goto format_error;
278                 }
279
280                 if (!sid_append_rid(sidout, conv)) {
281                         DEBUG(3, ("Too many sid auths in %s\n", sidstr));
282                         return false;
283                 }
284
285                 q = end;
286                 if (*q == '\0') {
287                         break;
288                 }
289                 if (*q != '-') {
290                         goto format_error;
291                 }
292                 q += 1;
293         }
294         return true;
295
296 format_error:
297         DEBUG(3, ("string_to_sid: SID %s is not in a valid format\n", sidstr));
298         return false;
299 }
300
301 /*****************************************************************
302  Add a rid to the end of a sid
303 *****************************************************************/  
304
305 bool sid_append_rid(DOM_SID *sid, uint32 rid)
306 {
307         if (sid->num_auths < MAXSUBAUTHS) {
308                 sid->sub_auths[sid->num_auths++] = rid;
309                 return True;
310         }
311         return False;
312 }
313
314 bool sid_compose(DOM_SID *dst, const DOM_SID *domain_sid, uint32 rid)
315 {
316         sid_copy(dst, domain_sid);
317         return sid_append_rid(dst, rid);
318 }
319
320 /*****************************************************************
321  Removes the last rid from the end of a sid
322 *****************************************************************/  
323
324 bool sid_split_rid(DOM_SID *sid, uint32 *rid)
325 {
326         if (sid->num_auths > 0) {
327                 sid->num_auths--;
328                 *rid = sid->sub_auths[sid->num_auths];
329                 return True;
330         }
331         return False;
332 }
333
334 /*****************************************************************
335  Return the last rid from the end of a sid
336 *****************************************************************/  
337
338 bool sid_peek_rid(const DOM_SID *sid, uint32 *rid)
339 {
340         if (!sid || !rid)
341                 return False;           
342
343         if (sid->num_auths > 0) {
344                 *rid = sid->sub_auths[sid->num_auths - 1];
345                 return True;
346         }
347         return False;
348 }
349
350 /*****************************************************************
351  Return the last rid from the end of a sid
352  and check the sid against the exp_dom_sid  
353 *****************************************************************/  
354
355 bool sid_peek_check_rid(const DOM_SID *exp_dom_sid, const DOM_SID *sid, uint32 *rid)
356 {
357         if (!exp_dom_sid || !sid || !rid)
358                 return False;
359
360         if (sid->num_auths != (exp_dom_sid->num_auths+1)) {
361                 return False;
362         }
363
364         if (sid_compare_domain(exp_dom_sid, sid)!=0){
365                 *rid=(-1);
366                 return False;
367         }
368
369         return sid_peek_rid(sid, rid);
370 }
371
372 /*****************************************************************
373  Copies a sid
374 *****************************************************************/  
375
376 void sid_copy(DOM_SID *dst, const DOM_SID *src)
377 {
378         int i;
379
380         ZERO_STRUCTP(dst);
381
382         dst->sid_rev_num = src->sid_rev_num;
383         dst->num_auths = src->num_auths;
384
385         memcpy(&dst->id_auth[0], &src->id_auth[0], sizeof(src->id_auth));
386
387         for (i = 0; i < src->num_auths; i++)
388                 dst->sub_auths[i] = src->sub_auths[i];
389 }
390
391 /*****************************************************************
392  Write a sid out into on-the-wire format.
393 *****************************************************************/  
394
395 bool sid_linearize(char *outbuf, size_t len, const DOM_SID *sid)
396 {
397         size_t i;
398
399         if (len < ndr_size_dom_sid(sid, NULL, 0))
400                 return False;
401
402         SCVAL(outbuf,0,sid->sid_rev_num);
403         SCVAL(outbuf,1,sid->num_auths);
404         memcpy(&outbuf[2], sid->id_auth, 6);
405         for(i = 0; i < sid->num_auths; i++)
406                 SIVAL(outbuf, 8 + (i*4), sid->sub_auths[i]);
407
408         return True;
409 }
410
411 /*****************************************************************
412  Parse a on-the-wire SID to a DOM_SID.
413 *****************************************************************/  
414
415 bool sid_parse(const char *inbuf, size_t len, DOM_SID *sid)
416 {
417         int i;
418         if (len < 8)
419                 return False;
420
421         ZERO_STRUCTP(sid);
422
423         sid->sid_rev_num = CVAL(inbuf, 0);
424         sid->num_auths = CVAL(inbuf, 1);
425         memcpy(sid->id_auth, inbuf+2, 6);
426         if (len < 8 + sid->num_auths*4)
427                 return False;
428         for (i=0;i<sid->num_auths;i++)
429                 sid->sub_auths[i] = IVAL(inbuf, 8+i*4);
430         return True;
431 }
432
433 /*****************************************************************
434  Compare the auth portion of two sids.
435 *****************************************************************/  
436
437 static int sid_compare_auth(const DOM_SID *sid1, const DOM_SID *sid2)
438 {
439         int i;
440
441         if (sid1 == sid2)
442                 return 0;
443         if (!sid1)
444                 return -1;
445         if (!sid2)
446                 return 1;
447
448         if (sid1->sid_rev_num != sid2->sid_rev_num)
449                 return sid1->sid_rev_num - sid2->sid_rev_num;
450
451         for (i = 0; i < 6; i++)
452                 if (sid1->id_auth[i] != sid2->id_auth[i])
453                         return sid1->id_auth[i] - sid2->id_auth[i];
454
455         return 0;
456 }
457
458 /*****************************************************************
459  Compare two sids.
460 *****************************************************************/  
461
462 int sid_compare(const DOM_SID *sid1, const DOM_SID *sid2)
463 {
464         int i;
465
466         if (sid1 == sid2)
467                 return 0;
468         if (!sid1)
469                 return -1;
470         if (!sid2)
471                 return 1;
472
473         /* Compare most likely different rids, first: i.e start at end */
474         if (sid1->num_auths != sid2->num_auths)
475                 return sid1->num_auths - sid2->num_auths;
476
477         for (i = sid1->num_auths-1; i >= 0; --i)
478                 if (sid1->sub_auths[i] != sid2->sub_auths[i])
479                         return sid1->sub_auths[i] - sid2->sub_auths[i];
480
481         return sid_compare_auth(sid1, sid2);
482 }
483
484 /*****************************************************************
485  See if 2 SIDs are in the same domain
486  this just compares the leading sub-auths
487 *****************************************************************/  
488
489 int sid_compare_domain(const DOM_SID *sid1, const DOM_SID *sid2)
490 {
491         int n, i;
492
493         n = MIN(sid1->num_auths, sid2->num_auths);
494
495         for (i = n-1; i >= 0; --i)
496                 if (sid1->sub_auths[i] != sid2->sub_auths[i])
497                         return sid1->sub_auths[i] - sid2->sub_auths[i];
498
499         return sid_compare_auth(sid1, sid2);
500 }
501
502 /*****************************************************************
503  Compare two sids.
504 *****************************************************************/  
505
506 bool sid_equal(const DOM_SID *sid1, const DOM_SID *sid2)
507 {
508         return sid_compare(sid1, sid2) == 0;
509 }
510
511 /*****************************************************************
512  Returns true if SID is internal (and non-mappable).
513 *****************************************************************/
514
515 bool non_mappable_sid(DOM_SID *sid)
516 {
517         DOM_SID dom;
518         uint32 rid;
519
520         sid_copy(&dom, sid);
521         sid_split_rid(&dom, &rid);
522
523         if (sid_equal(&dom, &global_sid_Builtin))
524                 return True;
525
526         if (sid_equal(&dom, &global_sid_NT_Authority))
527                 return True;
528
529         return False;
530 }
531
532 /*****************************************************************
533  Return the binary string representation of a DOM_SID.
534  Caller must free.
535 *****************************************************************/
536
537 char *sid_binstring(TALLOC_CTX *mem_ctx, const DOM_SID *sid)
538 {
539         uint8_t *buf;
540         char *s;
541         int len = ndr_size_dom_sid(sid, NULL, 0);
542         buf = talloc_array(mem_ctx, uint8_t, len);
543         if (!buf) {
544                 return NULL;
545         }
546         sid_linearize((char *)buf, len, sid);
547         s = binary_string_rfc2254(mem_ctx, buf, len);
548         TALLOC_FREE(buf);
549         return s;
550 }
551
552 /*****************************************************************
553  Return the binary string representation of a DOM_SID.
554  Caller must free.
555 *****************************************************************/
556
557 char *sid_binstring_hex(const DOM_SID *sid)
558 {
559         char *buf, *s;
560         int len = ndr_size_dom_sid(sid, NULL, 0);
561         buf = (char *)SMB_MALLOC(len);
562         if (!buf)
563                 return NULL;
564         sid_linearize(buf, len, sid);
565         s = binary_string(buf, len);
566         free(buf);
567         return s;
568 }
569
570 /*******************************************************************
571  Tallocs a duplicate SID. 
572 ********************************************************************/ 
573
574 struct dom_sid *sid_dup_talloc(TALLOC_CTX *ctx, const struct dom_sid *src)
575 {
576         struct dom_sid *dst;
577
578         if (src == NULL) {
579                 return NULL;
580         }
581         dst = talloc_zero(ctx, struct dom_sid);
582         if (dst == NULL) {
583                 return NULL;
584         }
585         sid_copy(dst, src);
586         return dst;
587 }
588
589 /********************************************************************
590  Add SID to an array SIDs
591 ********************************************************************/
592
593 NTSTATUS add_sid_to_array(TALLOC_CTX *mem_ctx, const DOM_SID *sid,
594                           DOM_SID **sids, size_t *num)
595 {
596         *sids = TALLOC_REALLOC_ARRAY(mem_ctx, *sids, DOM_SID,
597                                              (*num)+1);
598         if (*sids == NULL) {
599                 *num = 0;
600                 return NT_STATUS_NO_MEMORY;
601         }
602
603         sid_copy(&((*sids)[*num]), sid);
604         *num += 1;
605
606         return NT_STATUS_OK;
607 }
608
609
610 /********************************************************************
611  Add SID to an array SIDs ensuring that it is not already there
612 ********************************************************************/
613
614 NTSTATUS add_sid_to_array_unique(TALLOC_CTX *mem_ctx, const DOM_SID *sid,
615                                  DOM_SID **sids, size_t *num_sids)
616 {
617         size_t i;
618
619         for (i=0; i<(*num_sids); i++) {
620                 if (sid_compare(sid, &(*sids)[i]) == 0)
621                         return NT_STATUS_OK;
622         }
623
624         return add_sid_to_array(mem_ctx, sid, sids, num_sids);
625 }
626
627 /********************************************************************
628  Remove SID from an array
629 ********************************************************************/
630
631 void del_sid_from_array(const DOM_SID *sid, DOM_SID **sids, size_t *num)
632 {
633         DOM_SID *sid_list = *sids;
634         size_t i;
635
636         for ( i=0; i<*num; i++ ) {
637
638                 /* if we find the SID, then decrement the count
639                    and break out of the loop */
640
641                 if ( sid_equal(sid, &sid_list[i]) ) {
642                         *num -= 1;
643                         break;
644                 }
645         }
646
647         /* This loop will copy the remainder of the array 
648            if i < num of sids ni the array */
649
650         for ( ; i<*num; i++ ) 
651                 sid_copy( &sid_list[i], &sid_list[i+1] );
652
653         return;
654 }
655
656 bool add_rid_to_array_unique(TALLOC_CTX *mem_ctx,
657                                     uint32 rid, uint32 **pp_rids, size_t *p_num)
658 {
659         size_t i;
660
661         for (i=0; i<*p_num; i++) {
662                 if ((*pp_rids)[i] == rid)
663                         return True;
664         }
665
666         *pp_rids = TALLOC_REALLOC_ARRAY(mem_ctx, *pp_rids, uint32, *p_num+1);
667
668         if (*pp_rids == NULL) {
669                 *p_num = 0;
670                 return False;
671         }
672
673         (*pp_rids)[*p_num] = rid;
674         *p_num += 1;
675         return True;
676 }
677
678 bool is_null_sid(const DOM_SID *sid)
679 {
680         static const DOM_SID null_sid = {0};
681         return sid_equal(sid, &null_sid);
682 }
683
684 bool is_sid_in_token(const NT_USER_TOKEN *token, const DOM_SID *sid)
685 {
686         int i;
687
688         for (i=0; i<token->num_sids; i++) {
689                 if (sid_compare(sid, &token->user_sids[i]) == 0)
690                         return true;
691         }
692         return false;
693 }
694
695 NTSTATUS sid_array_from_info3(TALLOC_CTX *mem_ctx,
696                               const struct netr_SamInfo3 *info3,
697                               DOM_SID **user_sids,
698                               size_t *num_user_sids,
699                               bool include_user_group_rid,
700                               bool skip_ressource_groups)
701 {
702         NTSTATUS status;
703         DOM_SID sid;
704         DOM_SID *sid_array = NULL;
705         size_t num_sids = 0;
706         int i;
707
708         if (include_user_group_rid) {
709                 if (!sid_compose(&sid, info3->base.domain_sid, info3->base.rid)) {
710                         DEBUG(3, ("could not compose user SID from rid 0x%x\n",
711                                   info3->base.rid));
712                         return NT_STATUS_INVALID_PARAMETER;
713                 }
714                 status = add_sid_to_array(mem_ctx, &sid, &sid_array, &num_sids);
715                 if (!NT_STATUS_IS_OK(status)) {
716                         DEBUG(3, ("could not append user SID from rid 0x%x\n",
717                                   info3->base.rid));
718                         return status;
719                 }
720         }
721
722         if (!sid_compose(&sid, info3->base.domain_sid, info3->base.primary_gid)) {
723                 DEBUG(3, ("could not compose group SID from rid 0x%x\n",
724                           info3->base.primary_gid));
725                 return NT_STATUS_INVALID_PARAMETER;
726         }
727         status = add_sid_to_array(mem_ctx, &sid, &sid_array, &num_sids);
728         if (!NT_STATUS_IS_OK(status)) {
729                 DEBUG(3, ("could not append group SID from rid 0x%x\n",
730                           info3->base.rid));
731                 return status;
732         }
733
734         for (i = 0; i < info3->base.groups.count; i++) {
735                 /* Don't add the primary group sid twice. */
736                 if (info3->base.primary_gid == info3->base.groups.rids[i].rid) {
737                         continue;
738                 }
739                 if (!sid_compose(&sid, info3->base.domain_sid,
740                                  info3->base.groups.rids[i].rid)) {
741                         DEBUG(3, ("could not compose SID from additional group "
742                                   "rid 0x%x\n", info3->base.groups.rids[i].rid));
743                         return NT_STATUS_INVALID_PARAMETER;
744                 }
745                 status = add_sid_to_array(mem_ctx, &sid, &sid_array, &num_sids);
746                 if (!NT_STATUS_IS_OK(status)) {
747                         DEBUG(3, ("could not append SID from additional group "
748                                   "rid 0x%x\n", info3->base.groups.rids[i].rid));
749                         return status;
750                 }
751         }
752
753         /* Copy 'other' sids.  We need to do sid filtering here to
754            prevent possible elevation of privileges.  See:
755
756            http://www.microsoft.com/windows2000/techinfo/administration/security/sidfilter.asp
757          */
758
759         for (i = 0; i < info3->sidcount; i++) {
760
761                 if (skip_ressource_groups &&
762                     (info3->sids[i].attributes & SE_GROUP_RESOURCE)) {
763                         continue;
764                 }
765
766                 status = add_sid_to_array(mem_ctx, info3->sids[i].sid,
767                                       &sid_array, &num_sids);
768                 if (!NT_STATUS_IS_OK(status)) {
769                         DEBUG(3, ("could not add SID to array: %s\n",
770                                   sid_string_dbg(info3->sids[i].sid)));
771                         return status;
772                 }
773         }
774
775         *user_sids = sid_array;
776         *num_user_sids = num_sids;
777
778         return NT_STATUS_OK;
779 }