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 2005
7 Copyright (C) Michael Adam 2007
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * Basic privileges functions (mask-operations and conversion
25 * functions between the different formats (se_priv, privset, luid)
26 * moved here * from lib/privileges.c to minimize linker deps.
28 * generally SID- and LUID-related code is left in lib/privileges.c
30 * some extra functions to hide privs array from lib/privileges.c
35 const SE_PRIV se_priv_all = SE_ALL_PRIVS;
36 static const SE_PRIV se_priv_end = SE_END;
38 /* Define variables for all privileges so we can use the
39 SE_PRIV* in the various se_priv_XXX() functions */
41 const SE_PRIV se_priv_none = SE_NONE;
42 const SE_PRIV se_machine_account = SE_MACHINE_ACCOUNT;
43 const SE_PRIV se_print_operator = SE_PRINT_OPERATOR;
44 const SE_PRIV se_add_users = SE_ADD_USERS;
45 const SE_PRIV se_disk_operators = SE_DISK_OPERATOR;
46 const SE_PRIV se_remote_shutdown = SE_REMOTE_SHUTDOWN;
47 const SE_PRIV se_restore = SE_RESTORE;
48 const SE_PRIV se_take_ownership = SE_TAKE_OWNERSHIP;
50 /********************************************************************
51 This is a list of privileges reported by a WIndows 2000 SP4 AD DC
52 just for reference purposes (and I know the LUID is not guaranteed
55 SeCreateTokenPrivilege Create a token object ( 0x0, 0x2 )
56 SeAssignPrimaryTokenPrivilege Replace a process level token ( 0x0, 0x3 )
57 SeLockMemoryPrivilege Lock pages in memory ( 0x0, 0x4 )
58 SeIncreaseQuotaPrivilege Increase quotas ( 0x0, 0x5 )
59 SeMachineAccountPrivilege Add workstations to domain ( 0x0, 0x6 )
60 SeTcbPrivilege Act as part of the operating system ( 0x0, 0x7 )
61 SeSecurityPrivilege Manage auditing and security log ( 0x0, 0x8 )
62 SeTakeOwnershipPrivilege Take ownership of files or other objects ( 0x0, 0x9 )
63 SeLoadDriverPrivilege Load and unload device drivers ( 0x0, 0xa )
64 SeSystemProfilePrivilege Profile system performance ( 0x0, 0xb )
65 SeSystemtimePrivilege Change the system time ( 0x0, 0xc )
66 SeProfileSingleProcessPrivilege Profile single process ( 0x0, 0xd )
67 SeIncreaseBasePriorityPrivilege Increase scheduling priority ( 0x0, 0xe )
68 SeCreatePagefilePrivilege Create a pagefile ( 0x0, 0xf )
69 SeCreatePermanentPrivilege Create permanent shared objects ( 0x0, 0x10 )
70 SeBackupPrivilege Back up files and directories ( 0x0, 0x11 )
71 SeRestorePrivilege Restore files and directories ( 0x0, 0x12 )
72 SeShutdownPrivilege Shut down the system ( 0x0, 0x13 )
73 SeDebugPrivilege Debug programs ( 0x0, 0x14 )
74 SeAuditPrivilege Generate security audits ( 0x0, 0x15 )
75 SeSystemEnvironmentPrivilege Modify firmware environment values ( 0x0, 0x16 )
76 SeChangeNotifyPrivilege Bypass traverse checking ( 0x0, 0x17 )
77 SeRemoteShutdownPrivilege Force shutdown from a remote system ( 0x0, 0x18 )
78 SeUndockPrivilege Remove computer from docking station ( 0x0, 0x19 )
79 SeSyncAgentPrivilege Synchronize directory service data ( 0x0, 0x1a )
80 SeEnableDelegationPrivilege Enable computer and user accounts to be trusted for delegation ( 0x0, 0x1b )
81 SeManageVolumePrivilege Perform volume maintenance tasks ( 0x0, 0x1c )
82 SeImpersonatePrivilege Impersonate a client after authentication ( 0x0, 0x1d )
83 SeCreateGlobalPrivilege Create global objects ( 0x0, 0x1e )
85 ********************************************************************/
87 /* we have to define the LUID here due to a horrible check by printmig.exe
88 that requires the SeBackupPrivilege match what is in Windows. So match
89 those that we implement and start Samba privileges at 0x1001 */
92 #if 0 /* usrmgr will display these twice if you include them. We don't
93 use them but we'll keep the bitmasks reserved in privileges.h anyways */
95 {SE_NETWORK_LOGON, "SeNetworkLogonRight", "Access this computer from network", { 0x0, 0x0 }},
96 {SE_INTERACTIVE_LOGON, "SeInteractiveLogonRight", "Log on locally", { 0x0, 0x0 }},
97 {SE_BATCH_LOGON, "SeBatchLogonRight", "Log on as a batch job", { 0x0, 0x0 }},
98 {SE_SERVICE_LOGON, "SeServiceLogonRight", "Log on as a service", { 0x0, 0x0 }},
100 {SE_MACHINE_ACCOUNT, "SeMachineAccountPrivilege", "Add machines to domain", { 0x0006, 0x0 }},
101 {SE_TAKE_OWNERSHIP, "SeTakeOwnershipPrivilege", "Take ownership of files or other objects",{ 0x0009, 0x0 }},
102 {SE_BACKUP, "SeBackupPrivilege", "Back up files and directories", { 0x0011, 0x0 }},
103 {SE_RESTORE, "SeRestorePrivilege", "Restore files and directories", { 0x0012, 0x0 }},
104 {SE_REMOTE_SHUTDOWN, "SeRemoteShutdownPrivilege", "Force shutdown from a remote system", { 0x0018, 0x0 }},
106 {SE_PRINT_OPERATOR, "SePrintOperatorPrivilege", "Manage printers", { 0x1001, 0x0 }},
107 {SE_ADD_USERS, "SeAddUsersPrivilege", "Add users and groups to the domain", { 0x1002, 0x0 }},
108 {SE_DISK_OPERATOR, "SeDiskOperatorPrivilege", "Manage disk shares", { 0x1003, 0x0 }},
110 {SE_END, "", "", { 0x0, 0x0 }}
113 /***************************************************************************
114 copy an SE_PRIV structure
115 ****************************************************************************/
117 bool se_priv_copy( SE_PRIV *dst, const SE_PRIV *src )
122 memcpy( dst, src, sizeof(SE_PRIV) );
127 /***************************************************************************
128 put all privileges into a mask
129 ****************************************************************************/
131 bool se_priv_put_all_privileges(SE_PRIV *mask)
134 uint32 num_privs = count_all_privileges();
136 if (!se_priv_copy(mask, &se_priv_none)) {
139 for ( i=0; i<num_privs; i++ ) {
140 se_priv_add(mask, &privs[i].se_priv);
145 /***************************************************************************
146 combine 2 SE_PRIV structures and store the resulting set in mew_mask
147 ****************************************************************************/
149 void se_priv_add( SE_PRIV *mask, const SE_PRIV *addpriv )
154 /***************************************************************************
155 remove one SE_PRIV sytucture from another and store the resulting set
157 ****************************************************************************/
159 void se_priv_remove( SE_PRIV *mask, const SE_PRIV *removepriv )
161 *mask &= ~*removepriv;
164 /***************************************************************************
165 invert a given SE_PRIV and store the set in new_mask
166 ****************************************************************************/
168 static void se_priv_invert( SE_PRIV *new_mask, const SE_PRIV *mask )
172 se_priv_copy( &allprivs, &se_priv_all );
173 se_priv_remove( &allprivs, mask );
174 se_priv_copy( new_mask, &allprivs );
177 /***************************************************************************
178 check if 2 SE_PRIV structure are equal
179 ****************************************************************************/
181 bool se_priv_equal( const SE_PRIV *mask1, const SE_PRIV *mask2 )
183 return *mask1 == *mask2;
186 /***************************************************************************
187 check if a SE_PRIV has any assigned privileges
188 ****************************************************************************/
190 static bool se_priv_empty( const SE_PRIV *mask )
194 se_priv_copy( &p1, mask );
198 return se_priv_equal( &p1, &se_priv_none );
201 /*********************************************************************
202 Lookup the SE_PRIV value for a privilege name
203 *********************************************************************/
205 bool se_priv_from_name( const char *name, SE_PRIV *mask )
209 for ( i=0; !se_priv_equal(&privs[i].se_priv, &se_priv_end); i++ ) {
210 if ( strequal( privs[i].name, name ) ) {
211 se_priv_copy( mask, &privs[i].se_priv );
219 /***************************************************************************
220 dump an SE_PRIV structure to the log files
221 ****************************************************************************/
223 void dump_se_priv( int dbg_cl, int dbg_lvl, const SE_PRIV *mask )
225 DEBUGADDC( dbg_cl, dbg_lvl,("SE_PRIV 0x%llx\n", (unsigned long long)*mask));
228 /****************************************************************************
229 check if the privilege is in the privilege list
230 ****************************************************************************/
232 bool is_privilege_assigned(const SE_PRIV *privileges,
233 const SE_PRIV *check)
237 if ( !privileges || !check )
240 /* everyone has privileges if you aren't checking for any */
242 if ( se_priv_empty( check ) ) {
243 DEBUG(1,("is_privilege_assigned: no privileges in check_mask!\n"));
247 se_priv_copy( &p1, check );
249 /* invert the SE_PRIV we want to check for and remove that from the
250 original set. If we are left with the SE_PRIV we are checking
251 for then return True */
253 se_priv_invert( &p1, check );
254 se_priv_copy( &p2, privileges );
255 se_priv_remove( &p2, &p1 );
257 return se_priv_equal( &p2, check );
260 /****************************************************************************
261 check if the privilege is in the privilege list
262 ****************************************************************************/
264 static bool is_any_privilege_assigned( SE_PRIV *privileges, const SE_PRIV *check )
268 if ( !privileges || !check )
271 /* everyone has privileges if you aren't checking for any */
273 if ( se_priv_empty( check ) ) {
274 DEBUG(1,("is_any_privilege_assigned: no privileges in check_mask!\n"));
278 se_priv_copy( &p1, check );
280 /* invert the SE_PRIV we want to check for and remove that from the
281 original set. If we are left with the SE_PRIV we are checking
282 for then return True */
284 se_priv_invert( &p1, check );
285 se_priv_copy( &p2, privileges );
286 se_priv_remove( &p2, &p1 );
288 /* see if we have any bits left */
290 return !se_priv_empty( &p2 );
293 /*********************************************************************
294 Generate the struct lsa_LUIDAttribute structure based on a bitmask
295 *********************************************************************/
297 const char* get_privilege_dispname( const char *name )
305 for ( i=0; !se_priv_equal(&privs[i].se_priv, &se_priv_end); i++ ) {
307 if ( strequal( privs[i].name, name ) ) {
308 return privs[i].description;
315 /****************************************************************************
316 initialise a privilege list and set the talloc context
317 ****************************************************************************/
319 /****************************************************************************
320 Does the user have the specified privilege ? We only deal with one privilege
322 *****************************************************************************/
324 bool user_has_privileges(const NT_USER_TOKEN *token, const SE_PRIV *privilege)
329 return is_privilege_assigned( &token->privilege_mask, privilege );
332 /****************************************************************************
333 Does the user have any of the specified privileges ? We only deal with one privilege
335 *****************************************************************************/
337 bool user_has_any_privilege(NT_USER_TOKEN *token, const SE_PRIV *privilege)
342 return is_any_privilege_assigned( &token->privilege_mask, privilege );
345 /*******************************************************************
346 return the number of elements in the privlege array
347 *******************************************************************/
349 int count_all_privileges( void )
352 * The -1 is due to the weird SE_END record...
354 return (sizeof(privs) / sizeof(privs[0])) - 1;
358 /*********************************************************************
359 Generate the struct lsa_LUIDAttribute structure based on a bitmask
360 The assumption here is that the privilege has already been validated
361 so we are guaranteed to find it in the list.
362 *********************************************************************/
364 struct lsa_LUIDAttribute get_privilege_luid( SE_PRIV *mask )
366 struct lsa_LUIDAttribute priv_luid;
369 ZERO_STRUCT( priv_luid );
371 for ( i=0; !se_priv_equal(&privs[i].se_priv, &se_priv_end); i++ ) {
373 if ( se_priv_equal( &privs[i].se_priv, mask ) ) {
374 priv_luid.luid = privs[i].luid;
382 /****************************************************************************
383 Convert a LUID to a named string
384 ****************************************************************************/
386 const char *luid_to_privilege_name(const struct lsa_LUID *set)
393 for ( i=0; !se_priv_equal(&privs[i].se_priv, &se_priv_end); i++ ) {
394 if ( set->low == privs[i].luid.low ) {
395 return privs[i].name;
403 /****************************************************************************
404 add a privilege to a privilege array
405 ****************************************************************************/
407 static bool privilege_set_add(PRIVILEGE_SET *priv_set, struct lsa_LUIDAttribute set)
409 struct lsa_LUIDAttribute *new_set;
411 /* we can allocate memory to add the new privilege */
413 new_set = TALLOC_REALLOC_ARRAY(priv_set->mem_ctx, priv_set->set, struct lsa_LUIDAttribute, priv_set->count + 1);
415 DEBUG(0,("privilege_set_add: failed to allocate memory!\n"));
419 new_set[priv_set->count].luid.high = set.luid.high;
420 new_set[priv_set->count].luid.low = set.luid.low;
421 new_set[priv_set->count].attribute = set.attribute;
424 priv_set->set = new_set;
429 /*******************************************************************
430 *******************************************************************/
432 bool se_priv_to_privilege_set( PRIVILEGE_SET *set, SE_PRIV *mask )
435 uint32 num_privs = count_all_privileges();
436 struct lsa_LUIDAttribute luid;
441 for ( i=0; i<num_privs; i++ ) {
442 if ( !is_privilege_assigned(mask, &privs[i].se_priv) )
445 luid.luid = privs[i].luid;
447 if ( !privilege_set_add( set, luid ) )
454 /*******************************************************************
455 *******************************************************************/
457 static bool luid_to_se_priv( struct lsa_LUID *luid, SE_PRIV *mask )
460 uint32 num_privs = count_all_privileges();
462 for ( i=0; i<num_privs; i++ ) {
463 if ( luid->low == privs[i].luid.low ) {
464 se_priv_copy( mask, &privs[i].se_priv );
472 /*******************************************************************
473 *******************************************************************/
475 bool privilege_set_to_se_priv( SE_PRIV *mask, struct lsa_PrivilegeSet *privset )
479 ZERO_STRUCTP( mask );
481 for ( i=0; i<privset->count; i++ ) {
484 /* sanity check for invalid privilege. we really
485 only care about the low 32 bits */
487 if ( privset->set[i].luid.high != 0 )
490 if ( luid_to_se_priv( &privset->set[i].luid, &r ) )
491 se_priv_add( mask, &r );