2 Unix SMB/CIFS implementation.
3 Privileges handling functions
4 Copyright (C) Jean François Micouleau 1998-2001
5 Copyright (C) Simo Sorce 2002-2003
6 Copyright (C) Gerald (Jerry) Carter 2004
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 #define PRIVPREFIX "PRIV_"
28 #define GENERATE_LUID_LOW(x) (x)+1;
30 static SE_PRIV se_priv_all
= SE_ALL_PRIVS
;
31 static SE_PRIV se_priv_end
= SE_END
;
33 /* Define variables for all privileges so we can use the
34 SE_PRIV* in the various se_priv_XXX() functions */
36 const SE_PRIV se_priv_none
= SE_NONE
;
37 const SE_PRIV se_machine_account
= SE_MACHINE_ACCOUNT
;
38 const SE_PRIV se_print_operator
= SE_PRINT_OPERATOR
;
39 const SE_PRIV se_add_users
= SE_ADD_USERS
;
40 const SE_PRIV se_disk_operators
= SE_DISK_OPERATOR
;
41 const SE_PRIV se_remote_shutdown
= SE_REMOTE_SHUTDOWN
;
44 #if 0 /* usrmgr will display these twice if you include them. We don't
45 use them but we'll keep the bitmasks reserved in privileges.h anyways */
47 {SE_NETWORK_LOGON
, "SeNetworkLogonRight", "Access this computer from network"},
48 {SE_INTERACTIVE_LOGON
, "SeInteractiveLogonRight", "Log on locally"},
49 {SE_BATCH_LOGON
, "SeBatchLogonRight", "Log on as a batch job"},
50 {SE_SERVICE_LOGON
, "SeServiceLogonRight", "Log on as a service"},
52 {SE_MACHINE_ACCOUNT
, "SeMachineAccountPrivilege", "Add machines to domain"},
53 {SE_PRINT_OPERATOR
, "SePrintOperatorPrivilege", "Manage printers"},
54 {SE_ADD_USERS
, "SeAddUsersPrivilege", "Add users and groups to the domain"},
55 {SE_REMOTE_SHUTDOWN
, "SeRemoteShutdownPrivilege", "Force shutdown from a remote system"},
56 {SE_DISK_OPERATOR
, "SeDiskOperatorPrivilege", "Manage disk shares"},
61 #if 0 /* not needed currently */
63 {SE_ASSIGN_PRIMARY_TOKEN
, "SeAssignPrimaryTokenPrivilege", "Assign Primary Token"},
64 {SE_CREATE_TOKEN
, "SeCreateTokenPrivilege", "Create Token"},
65 {SE_LOCK_MEMORY
, "SeLockMemoryPrivilege", "Lock Memory"},
66 {SE_INCREASE_QUOTA
, "SeIncreaseQuotaPrivilege", "Increase Quota"},
67 {SE_UNSOLICITED_INPUT
, "SeUnsolicitedInputPrivilege", "Unsolicited Input"},
68 {SE_TCB
, "SeTcbPrivilege", "Act as part of the operating system"},
69 {SE_SECURITY
, "SeSecurityPrivilege", "Security Privilege"},
70 {SE_TAKE_OWNERSHIP
, "SeTakeOwnershipPrivilege", "Take Ownership Privilege"},
71 {SE_LOAD_DRIVER
, "SeLocalDriverPrivilege", "Local Driver Privilege"},
72 {SE_SYSTEM_PROFILE
, "SeSystemProfilePrivilege", "System Profile Privilege"},
73 {SE_SYSTEM_TIME
, "SeSystemtimePrivilege", "System Time"},
74 {SE_PROF_SINGLE_PROCESS
, "SeProfileSingleProcessPrivilege", "Profile Single Process Privilege"},
75 {SE_INC_BASE_PRIORITY
, "SeIncreaseBasePriorityPrivilege", "Increase Base Priority Privilege"},
76 {SE_CREATE_PAGEFILE
, "SeCreatePagefilePrivilege", "Create Pagefile Privilege"},
77 {SE_CREATE_PERMANENT
, "SeCreatePermanentPrivilege", "Create Permanent"},
78 {SE_BACKUP
, "SeBackupPrivilege", "Backup Privilege"},
79 {SE_RESTORE
, "SeRestorePrivilege", "Restore Privilege"},
80 {SE_SHUTDOWN
, "SeShutdownPrivilege", "Shutdown Privilege"},
81 {SE_DEBUG
, "SeDebugPrivilege", "Debug Privilege"},
82 {SE_AUDIT
, "SeAuditPrivilege", "Audit"},
83 {SE_SYSTEM_ENVIRONMENT
, "SeSystemEnvironmentPrivilege", "System Environment Privilege"},
84 {SE_CHANGE_NOTIFY
, "SeChangeNotifyPrivilege", "Change Notify"},
85 {SE_UNDOCK
, "SeUndockPrivilege", "Undock"},
86 {SE_SYNC_AGENT
, "SeSynchronizationAgentPrivilege", "Synchronization Agent"},
87 {SE_ENABLE_DELEGATION
, "SeEnableDelegationPrivilege", "Enable Delegation"},
88 {SE_ALL_PRIVS
, "SeAllPrivileges", "All Privileges"}
93 typedef struct priv_sid_list
{
99 /***************************************************************************
100 copy an SE_PRIV structure
101 ****************************************************************************/
103 BOOL
se_priv_copy( SE_PRIV
*dst
, const SE_PRIV
*src
)
108 memcpy( dst
, src
, sizeof(SE_PRIV
) );
113 /***************************************************************************
114 combine 2 SE_PRIV structures and store the resulting set in mew_mask
115 ****************************************************************************/
117 void se_priv_add( SE_PRIV
*mask
, const SE_PRIV
*addpriv
)
121 for ( i
=0; i
<SE_PRIV_MASKSIZE
; i
++ ) {
122 mask
->mask
[i
] |= addpriv
->mask
[i
];
126 /***************************************************************************
127 remove one SE_PRIV sytucture from another and store the resulting set
129 ****************************************************************************/
131 void se_priv_remove( SE_PRIV
*mask
, const SE_PRIV
*removepriv
)
135 for ( i
=0; i
<SE_PRIV_MASKSIZE
; i
++ ) {
136 mask
->mask
[i
] &= ~removepriv
->mask
[i
];
140 /***************************************************************************
141 invert a given SE_PRIV and store the set in new_mask
142 ****************************************************************************/
144 static void se_priv_invert( SE_PRIV
*new_mask
, const SE_PRIV
*mask
)
148 se_priv_copy( &allprivs
, &se_priv_all
);
149 se_priv_remove( &allprivs
, mask
);
150 se_priv_copy( new_mask
, &allprivs
);
153 /***************************************************************************
154 check if 2 SE_PRIV structure are equal
155 ****************************************************************************/
157 static BOOL
se_priv_equal( const SE_PRIV
*mask1
, const SE_PRIV
*mask2
)
159 return ( memcmp(mask1
, mask2
, sizeof(SE_PRIV
)) == 0 );
162 /***************************************************************************
163 check if a SE_PRIV has any assigned privileges
164 ****************************************************************************/
166 static BOOL
se_priv_empty( const SE_PRIV
*mask
)
171 se_priv_copy( &p1
, mask
);
173 for ( i
=0; i
<SE_PRIV_MASKSIZE
; i
++ ) {
174 p1
.mask
[i
] &= se_priv_all
.mask
[i
];
177 return se_priv_equal( &p1
, &se_priv_none
);
180 /***************************************************************************
181 dump an SE_PRIV structure to the log files
182 ****************************************************************************/
184 void dump_se_priv( int dbg_cl
, int dbg_lvl
, const SE_PRIV
*mask
)
188 DEBUGADDC( dbg_cl
, dbg_lvl
,("SE_PRIV "));
190 for ( i
=0; i
<SE_PRIV_MASKSIZE
; i
++ ) {
191 DEBUGADDC( dbg_cl
, dbg_lvl
,(" 0x%x", mask
->mask
[i
] ));
194 DEBUGADDC( dbg_cl
, dbg_lvl
, ("\n"));
197 /***************************************************************************
198 Retrieve the privilege mask (set) for a given SID
199 ****************************************************************************/
201 static BOOL
get_privileges( const DOM_SID
*sid
, SE_PRIV
*mask
)
203 TDB_CONTEXT
*tdb
= get_account_pol_tdb();
207 /* Fail if the admin has not enable privileges */
209 if ( !lp_enable_privileges() ) {
216 /* PRIV_<SID> (NULL terminated) as the key */
218 fstr_sprintf( keystr
, "%s%s", PRIVPREFIX
, sid_string_static(sid
) );
220 key
.dsize
= strlen(keystr
) + 1;
222 data
= tdb_fetch( tdb
, key
);
225 DEBUG(3,("get_privileges: No privileges assigned to SID [%s]\n",
226 sid_string_static(sid
)));
230 SMB_ASSERT( data
.dsize
== sizeof( SE_PRIV
) );
232 se_priv_copy( mask
, (SE_PRIV
*)data
.dptr
);
238 /***************************************************************************
239 Store the privilege mask (set) for a given SID
240 ****************************************************************************/
242 static BOOL
set_privileges( const DOM_SID
*sid
, SE_PRIV
*mask
)
244 TDB_CONTEXT
*tdb
= get_account_pol_tdb();
248 if ( !lp_enable_privileges() )
254 /* PRIV_<SID> (NULL terminated) as the key */
256 fstr_sprintf( keystr
, "%s%s", PRIVPREFIX
, sid_string_static(sid
) );
258 key
.dsize
= strlen(keystr
) + 1;
260 /* no packing. static size structure, just write it out */
262 data
.dptr
= (char*)mask
;
263 data
.dsize
= sizeof(SE_PRIV
);
265 return ( tdb_store(tdb
, key
, data
, TDB_REPLACE
) != -1 );
268 /****************************************************************************
269 check if the privilege is in the privilege list
270 ****************************************************************************/
272 static BOOL
is_privilege_assigned( SE_PRIV
*privileges
, const SE_PRIV
*check
)
276 if ( !privileges
|| !check
)
279 /* everyone has privileges if you aren't checking for any */
281 if ( se_priv_empty( check
) ) {
282 DEBUG(1,("is_privilege_assigned: no privileges in check_mask!\n"));
286 se_priv_copy( &p1
, check
);
288 /* invert the SE_PRIV we want to check for and remove that from the
289 original set. If we are left with the SE_PRIV we are checking
290 for then return True */
292 se_priv_invert( &p1
, check
);
293 se_priv_copy( &p2
, privileges
);
294 se_priv_remove( &p2
, &p1
);
296 return se_priv_equal( &p2
, check
);
299 /****************************************************************************
300 check if the privilege is in the privilege list
301 ****************************************************************************/
303 static BOOL
is_any_privilege_assigned( SE_PRIV
*privileges
, const SE_PRIV
*check
)
307 if ( !privileges
|| !check
)
310 /* everyone has privileges if you aren't checking for any */
312 if ( se_priv_empty( check
) ) {
313 DEBUG(1,("is_any_privilege_assigned: no privileges in check_mask!\n"));
317 se_priv_copy( &p1
, check
);
319 /* invert the SE_PRIV we want to check for and remove that from the
320 original set. If we are left with the SE_PRIV we are checking
321 for then return True */
323 se_priv_invert( &p1
, check
);
324 se_priv_copy( &p2
, privileges
);
325 se_priv_remove( &p2
, &p1
);
327 /* see if we have any bits left */
329 return !se_priv_empty( &p2
);
332 /****************************************************************************
333 add a privilege to a privilege array
334 ****************************************************************************/
336 static BOOL
privilege_set_add(PRIVILEGE_SET
*priv_set
, LUID_ATTR set
)
340 /* we can allocate memory to add the new privilege */
342 new_set
= TALLOC_REALLOC_ARRAY(priv_set
->mem_ctx
, priv_set
->set
, LUID_ATTR
, priv_set
->count
+ 1);
344 DEBUG(0,("privilege_set_add: failed to allocate memory!\n"));
348 new_set
[priv_set
->count
].luid
.high
= set
.luid
.high
;
349 new_set
[priv_set
->count
].luid
.low
= set
.luid
.low
;
350 new_set
[priv_set
->count
].attr
= set
.attr
;
353 priv_set
->set
= new_set
;
358 /*********************************************************************
359 Generate the LUID_ATTR structure based on a bitmask
360 *********************************************************************/
362 LUID_ATTR
get_privilege_luid( SE_PRIV
*mask
)
368 priv_luid
.luid
.high
= 0;
370 for ( i
=0; !se_priv_equal(&privs
[i
].se_priv
, &se_priv_end
); i
++ ) {
372 /* just use the index+1 (so its non-zero) into the
373 array as the lower portion of the LUID */
375 if ( se_priv_equal( &privs
[i
].se_priv
, mask
) ) {
376 priv_luid
.luid
.low
= GENERATE_LUID_LOW(i
);
383 /*********************************************************************
384 Generate the LUID_ATTR structure based on a bitmask
385 *********************************************************************/
387 const char* get_privilege_dispname( const char *name
)
391 for ( i
=0; !se_priv_equal(&privs
[i
].se_priv
, &se_priv_end
); i
++ ) {
393 if ( strequal( privs
[i
].name
, name
) ) {
394 return privs
[i
].description
;
401 /*********************************************************************
402 get a list of all privleges for all sids the in list
403 *********************************************************************/
405 BOOL
get_privileges_for_sids(SE_PRIV
*privileges
, DOM_SID
*slist
, int scount
)
411 se_priv_copy( privileges
, &se_priv_none
);
413 for ( i
=0; i
<scount
; i
++ ) {
414 /* don't add unless we actually have a privilege assigned */
416 if ( !get_privileges( &slist
[i
], &mask
) )
419 DEBUG(5,("get_privileges_for_sids: sid = %s\nPrivilege set:\n",
420 sid_string_static(&slist
[i
])));
421 dump_se_priv( DBGC_ALL
, 5, &mask
);
423 se_priv_add( privileges
, &mask
);
431 /*********************************************************************
432 travseral functions for privilege_enumerate_accounts
433 *********************************************************************/
435 static int priv_traverse_fn(TDB_CONTEXT
*t
, TDB_DATA key
, TDB_DATA data
, void *state
)
437 PRIV_SID_LIST
*priv
= state
;
438 int prefixlen
= strlen(PRIVPREFIX
);
442 /* easy check first */
444 if ( data
.dsize
!= sizeof(SE_PRIV
) )
447 /* check we have a PRIV_+SID entry */
449 if ( strncmp(key
.dptr
, PRIVPREFIX
, prefixlen
) != 0)
452 /* check to see if we are looking for a particular privilege */
454 if ( !se_priv_equal(&priv
->privilege
, &se_priv_none
) ) {
457 se_priv_copy( &mask
, (SE_PRIV
*)data
.dptr
);
459 /* if the SID does not have the specified privilege
462 if ( !is_privilege_assigned( &mask
, &priv
->privilege
) )
466 fstrcpy( sid_string
, &key
.dptr
[strlen(PRIVPREFIX
)] );
468 if ( !string_to_sid(&sid
, sid_string
) ) {
469 DEBUG(0,("travsersal_fn_enum__acct: Could not convert SID [%s]\n",
474 add_sid_to_array( &sid
, &priv
->sids
.list
, &priv
->sids
.count
);
479 /*********************************************************************
480 Retreive list of privileged SIDs (for _lsa_enumerate_accounts()
481 *********************************************************************/
483 NTSTATUS
privilege_enumerate_accounts(DOM_SID
**sids
, int *num_sids
)
485 TDB_CONTEXT
*tdb
= get_account_pol_tdb();
490 se_priv_copy( &priv
.privilege
, &se_priv_none
);
492 tdb_traverse( tdb
, priv_traverse_fn
, &priv
);
494 /* give the memory away; caller will free */
496 *sids
= priv
.sids
.list
;
497 *num_sids
= priv
.sids
.count
;
502 /***************************************************************************
504 ****************************************************************************/
506 BOOL
grant_privilege(const DOM_SID
*sid
, SE_PRIV
*priv_mask
)
508 SE_PRIV old_mask
, new_mask
;
510 if ( get_privileges( sid
, &old_mask
) )
511 se_priv_copy( &new_mask
, &old_mask
);
513 se_priv_copy( &new_mask
, &se_priv_none
);
515 se_priv_add( &new_mask
, priv_mask
);
517 DEBUG(10,("grant_privilege: %s\n", sid_string_static(sid
)));
519 DEBUGADD( 10, ("original privilege mask:\n"));
520 dump_se_priv( DBGC_ALL
, 10, &old_mask
);
522 DEBUGADD( 10, ("new privilege mask:\n"));
523 dump_se_priv( DBGC_ALL
, 10, &new_mask
);
525 return set_privileges( sid
, &new_mask
);
528 /*********************************************************************
529 Add a privilege based on its name
530 *********************************************************************/
532 BOOL
grant_privilege_by_name(DOM_SID
*sid
, const char *name
)
536 for ( i
=0; !se_priv_equal(&privs
[i
].se_priv
, &se_priv_end
); i
++ ) {
537 if ( strequal(privs
[i
].name
, name
) ) {
538 return grant_privilege( sid
, &privs
[i
].se_priv
);
542 DEBUG(3, ("grant_privilege_by_name: No Such Privilege Found (%s)\n", name
));
547 /***************************************************************************
548 Remove privilege from sid
549 ****************************************************************************/
551 BOOL
revoke_privilege(const DOM_SID
*sid
, SE_PRIV
*priv_mask
)
555 /* if the user has no privileges, then we can't revoke any */
557 if ( !get_privileges( sid
, &mask
) )
560 DEBUG(10,("revoke_privilege: %s\n", sid_string_static(sid
)));
562 DEBUGADD( 10, ("original privilege mask:\n"));
563 dump_se_priv( DBGC_ALL
, 10, &mask
);
565 se_priv_remove( &mask
, priv_mask
);
567 DEBUGADD( 10, ("new privilege mask:\n"));
568 dump_se_priv( DBGC_ALL
, 10, &mask
);
570 return set_privileges( sid
, &mask
);
573 /*********************************************************************
574 Revoke all privileges
575 *********************************************************************/
577 BOOL
revoke_all_privileges( DOM_SID
*sid
)
579 return revoke_privilege( sid
, &se_priv_all
);
582 /*********************************************************************
583 Add a privilege based on its name
584 *********************************************************************/
586 BOOL
revoke_privilege_by_name(DOM_SID
*sid
, const char *name
)
590 for ( i
=0; !se_priv_equal(&privs
[i
].se_priv
, &se_priv_end
); i
++ ) {
591 if ( strequal(privs
[i
].name
, name
) ) {
592 return revoke_privilege( sid
, &privs
[i
].se_priv
);
596 DEBUG(3, ("revoke_privilege_by_name: No Such Privilege Found (%s)\n", name
));
601 /***************************************************************************
602 Retrieve the SIDs assigned to a given privilege
603 ****************************************************************************/
605 NTSTATUS
privilege_create_account(const DOM_SID
*sid
)
607 return ( grant_privilege(sid
, &se_priv_none
) ? NT_STATUS_OK
: NT_STATUS_UNSUCCESSFUL
);
610 /****************************************************************************
611 initialise a privilege list and set the talloc context
612 ****************************************************************************/
613 NTSTATUS
privilege_set_init(PRIVILEGE_SET
*priv_set
)
617 ZERO_STRUCTP( priv_set
);
619 mem_ctx
= talloc_init("privilege set");
621 DEBUG(0,("privilege_set_init: failed to initialize talloc ctx!\n"));
622 return NT_STATUS_NO_MEMORY
;
625 priv_set
->mem_ctx
= mem_ctx
;
630 /****************************************************************************
631 initialise a privilege list and with someone else's talloc context
632 ****************************************************************************/
634 NTSTATUS
privilege_set_init_by_ctx(TALLOC_CTX
*mem_ctx
, PRIVILEGE_SET
*priv_set
)
636 ZERO_STRUCTP( priv_set
);
638 priv_set
->mem_ctx
= mem_ctx
;
639 priv_set
->ext_ctx
= True
;
644 /****************************************************************************
645 Free all memory used by a PRIVILEGE_SET
646 ****************************************************************************/
648 void privilege_set_free(PRIVILEGE_SET
*priv_set
)
653 if ( !( priv_set
->ext_ctx
) )
654 talloc_destroy( priv_set
->mem_ctx
);
656 ZERO_STRUCTP( priv_set
);
659 /****************************************************************************
660 duplicate alloc luid_attr
661 ****************************************************************************/
663 NTSTATUS
dup_luid_attr(TALLOC_CTX
*mem_ctx
, LUID_ATTR
**new_la
, LUID_ATTR
*old_la
, int count
)
667 /* don't crash if the source pointer is NULL (since we don't
668 do priviledges now anyways) */
673 *new_la
= TALLOC_ARRAY(mem_ctx
, LUID_ATTR
, count
);
675 DEBUG(0,("dup_luid_attr: failed to alloc new LUID_ATTR array [%d]\n", count
));
676 return NT_STATUS_NO_MEMORY
;
679 for (i
=0; i
<count
; i
++) {
680 (*new_la
)[i
].luid
.high
= old_la
[i
].luid
.high
;
681 (*new_la
)[i
].luid
.low
= old_la
[i
].luid
.low
;
682 (*new_la
)[i
].attr
= old_la
[i
].attr
;
688 /****************************************************************************
689 Does the user have the specified privilege ? We only deal with one privilege
691 *****************************************************************************/
693 BOOL
user_has_privileges(NT_USER_TOKEN
*token
, const SE_PRIV
*privilege
)
698 return is_privilege_assigned( &token
->privileges
, privilege
);
701 /****************************************************************************
702 Does the user have any of the specified privileges ? We only deal with one privilege
704 *****************************************************************************/
706 BOOL
user_has_any_privilege(NT_USER_TOKEN
*token
, const SE_PRIV
*privilege
)
711 return is_any_privilege_assigned( &token
->privileges
, privilege
);
714 /****************************************************************************
715 Convert a LUID to a named string
716 ****************************************************************************/
718 char* luid_to_privilege_name(const LUID
*set
)
721 int max
= count_all_privileges();
726 if ( set
->low
> max
)
729 fstrcpy( name
, privs
[set
->low
- 1].name
);
734 /****************************************************************************
735 Convert an LUID to a 32-bit mask
736 ****************************************************************************/
738 SE_PRIV
* luid_to_privilege_mask(const LUID
*set
)
741 int max
= count_all_privileges();
746 if ( set
->low
> max
)
749 se_priv_copy( &mask
, &privs
[set
->low
- 1].se_priv
);
754 /*******************************************************************
755 return the number of elements in the privlege array
756 *******************************************************************/
758 int count_all_privileges( void )
765 /* loop over the array and count it */
766 for ( count
=0; !se_priv_equal(&privs
[count
].se_priv
, &se_priv_end
); count
++ ) ;
771 /*******************************************************************
772 *******************************************************************/
774 BOOL
se_priv_to_privilege_set( PRIVILEGE_SET
*set
, SE_PRIV
*mask
)
777 uint32 num_privs
= count_all_privileges();
783 for ( i
=0; i
<num_privs
; i
++ ) {
784 if ( !is_privilege_assigned(mask
, &privs
[i
].se_priv
) )
787 luid
.luid
.low
= GENERATE_LUID_LOW(i
);
789 if ( !privilege_set_add( set
, luid
) )
796 /*******************************************************************
797 *******************************************************************/
799 BOOL
privilege_set_to_se_priv( SE_PRIV
*mask
, PRIVILEGE_SET
*privset
)
802 uint32 num_privs
= count_all_privileges();
804 ZERO_STRUCTP( mask
);
806 for ( i
=0; i
<privset
->count
; i
++ ) {
809 /* sanity check for invalid privilege. we really
810 only care about the low 32 bits */
812 if ( privset
->set
[i
].luid
.high
!= 0 )
815 /* make sure :LUID.low is in range */
816 if ( privset
->set
[i
].luid
.low
== 0 || privset
->set
[i
].luid
.low
> num_privs
)
819 r
= privs
[privset
->set
[i
].luid
.low
- 1].se_priv
;
820 se_priv_add( mask
, &r
);
826 /*******************************************************************
827 *******************************************************************/
829 BOOL
is_privileged_sid( DOM_SID
*sid
)
833 return get_privileges( sid
, &mask
);