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
;
49 const SE_PRIV se_security
= SE_SECURITY
;
51 /********************************************************************
52 This is a list of privileges reported by a WIndows 2000 SP4 AD DC
53 just for reference purposes (and I know the LUID is not guaranteed
56 SeCreateTokenPrivilege Create a token object ( 0x0, 0x2 )
57 SeAssignPrimaryTokenPrivilege Replace a process level token ( 0x0, 0x3 )
58 SeLockMemoryPrivilege Lock pages in memory ( 0x0, 0x4 )
59 SeIncreaseQuotaPrivilege Increase quotas ( 0x0, 0x5 )
60 SeMachineAccountPrivilege Add workstations to domain ( 0x0, 0x6 )
61 SeTcbPrivilege Act as part of the operating system ( 0x0, 0x7 )
62 SeSecurityPrivilege Manage auditing and security log ( 0x0, 0x8 )
63 SeTakeOwnershipPrivilege Take ownership of files or other objects ( 0x0, 0x9 )
64 SeLoadDriverPrivilege Load and unload device drivers ( 0x0, 0xa )
65 SeSystemProfilePrivilege Profile system performance ( 0x0, 0xb )
66 SeSystemtimePrivilege Change the system time ( 0x0, 0xc )
67 SeProfileSingleProcessPrivilege Profile single process ( 0x0, 0xd )
68 SeIncreaseBasePriorityPrivilege Increase scheduling priority ( 0x0, 0xe )
69 SeCreatePagefilePrivilege Create a pagefile ( 0x0, 0xf )
70 SeCreatePermanentPrivilege Create permanent shared objects ( 0x0, 0x10 )
71 SeBackupPrivilege Back up files and directories ( 0x0, 0x11 )
72 SeRestorePrivilege Restore files and directories ( 0x0, 0x12 )
73 SeShutdownPrivilege Shut down the system ( 0x0, 0x13 )
74 SeDebugPrivilege Debug programs ( 0x0, 0x14 )
75 SeAuditPrivilege Generate security audits ( 0x0, 0x15 )
76 SeSystemEnvironmentPrivilege Modify firmware environment values ( 0x0, 0x16 )
77 SeChangeNotifyPrivilege Bypass traverse checking ( 0x0, 0x17 )
78 SeRemoteShutdownPrivilege Force shutdown from a remote system ( 0x0, 0x18 )
79 SeUndockPrivilege Remove computer from docking station ( 0x0, 0x19 )
80 SeSyncAgentPrivilege Synchronize directory service data ( 0x0, 0x1a )
81 SeEnableDelegationPrivilege Enable computer and user accounts to be trusted for delegation ( 0x0, 0x1b )
82 SeManageVolumePrivilege Perform volume maintenance tasks ( 0x0, 0x1c )
83 SeImpersonatePrivilege Impersonate a client after authentication ( 0x0, 0x1d )
84 SeCreateGlobalPrivilege Create global objects ( 0x0, 0x1e )
86 ********************************************************************/
88 /* we have to define the LUID here due to a horrible check by printmig.exe
89 that requires the SeBackupPrivilege match what is in Windows. So match
90 those that we implement and start Samba privileges at 0x1001 */
93 #if 0 /* usrmgr will display these twice if you include them. We don't
94 use them but we'll keep the bitmasks reserved in privileges.h anyways */
96 {SE_NETWORK_LOGON
, "SeNetworkLogonRight", "Access this computer from network", { 0x0, 0x0 }},
97 {SE_INTERACTIVE_LOGON
, "SeInteractiveLogonRight", "Log on locally", { 0x0, 0x0 }},
98 {SE_BATCH_LOGON
, "SeBatchLogonRight", "Log on as a batch job", { 0x0, 0x0 }},
99 {SE_SERVICE_LOGON
, "SeServiceLogonRight", "Log on as a service", { 0x0, 0x0 }},
101 {SE_MACHINE_ACCOUNT
, "SeMachineAccountPrivilege", "Add machines to domain", { 0x0, 0x0006 }},
102 {SE_SECURITY
, "SeSecurityPrivilege", "Manage auditing and security log", { 0x0, 0x0008 }},
103 {SE_TAKE_OWNERSHIP
, "SeTakeOwnershipPrivilege", "Take ownership of files or other objects",{ 0x0, 0x0009 }},
104 {SE_BACKUP
, "SeBackupPrivilege", "Back up files and directories", { 0x0, 0x0011 }},
105 {SE_RESTORE
, "SeRestorePrivilege", "Restore files and directories", { 0x0, 0x0012 }},
106 {SE_REMOTE_SHUTDOWN
, "SeRemoteShutdownPrivilege", "Force shutdown from a remote system", { 0x0, 0x0018 }},
108 {SE_PRINT_OPERATOR
, "SePrintOperatorPrivilege", "Manage printers", { 0x0, 0x1001 }},
109 {SE_ADD_USERS
, "SeAddUsersPrivilege", "Add users and groups to the domain", { 0x0, 0x1002 }},
110 {SE_DISK_OPERATOR
, "SeDiskOperatorPrivilege", "Manage disk shares", { 0x0, 0x1003 }},
113 {SE_END
, "", "", { 0x0, 0x0 }}
116 /***************************************************************************
117 copy an SE_PRIV structure
118 ****************************************************************************/
120 bool se_priv_copy( SE_PRIV
*dst
, const SE_PRIV
*src
)
125 memcpy( dst
, src
, sizeof(SE_PRIV
) );
130 /***************************************************************************
131 put all privileges into a mask
132 ****************************************************************************/
134 bool se_priv_put_all_privileges(SE_PRIV
*mask
)
137 uint32 num_privs
= count_all_privileges();
139 if (!se_priv_copy(mask
, &se_priv_none
)) {
142 for ( i
=0; i
<num_privs
; i
++ ) {
143 se_priv_add(mask
, &privs
[i
].se_priv
);
148 /***************************************************************************
149 combine 2 SE_PRIV structures and store the resulting set in mew_mask
150 ****************************************************************************/
152 void se_priv_add( SE_PRIV
*mask
, const SE_PRIV
*addpriv
)
156 for ( i
=0; i
<SE_PRIV_MASKSIZE
; i
++ ) {
157 mask
->mask
[i
] |= addpriv
->mask
[i
];
161 /***************************************************************************
162 remove one SE_PRIV sytucture from another and store the resulting set
164 ****************************************************************************/
166 void se_priv_remove( SE_PRIV
*mask
, const SE_PRIV
*removepriv
)
170 for ( i
=0; i
<SE_PRIV_MASKSIZE
; i
++ ) {
171 mask
->mask
[i
] &= ~removepriv
->mask
[i
];
175 /***************************************************************************
176 invert a given SE_PRIV and store the set in new_mask
177 ****************************************************************************/
179 static void se_priv_invert( SE_PRIV
*new_mask
, const SE_PRIV
*mask
)
183 se_priv_copy( &allprivs
, &se_priv_all
);
184 se_priv_remove( &allprivs
, mask
);
185 se_priv_copy( new_mask
, &allprivs
);
188 /***************************************************************************
189 check if 2 SE_PRIV structure are equal
190 ****************************************************************************/
192 bool se_priv_equal( const SE_PRIV
*mask1
, const SE_PRIV
*mask2
)
194 return ( memcmp(mask1
, mask2
, sizeof(SE_PRIV
)) == 0 );
197 /***************************************************************************
198 check if 2 LUID's are equal.
199 ****************************************************************************/
201 static bool luid_equal( const LUID
*luid1
, const LUID
*luid2
)
203 return ( luid1
->low
== luid2
->low
&& luid1
->high
== luid2
->high
);
206 /***************************************************************************
207 check if a SE_PRIV has any assigned privileges
208 ****************************************************************************/
210 static bool se_priv_empty( const SE_PRIV
*mask
)
215 se_priv_copy( &p1
, mask
);
217 for ( i
=0; i
<SE_PRIV_MASKSIZE
; i
++ ) {
218 p1
.mask
[i
] &= se_priv_all
.mask
[i
];
221 return se_priv_equal( &p1
, &se_priv_none
);
224 /*********************************************************************
225 Lookup the SE_PRIV value for a privilege name
226 *********************************************************************/
228 bool se_priv_from_name( const char *name
, SE_PRIV
*mask
)
232 for ( i
=0; !se_priv_equal(&privs
[i
].se_priv
, &se_priv_end
); i
++ ) {
233 if ( strequal( privs
[i
].name
, name
) ) {
234 se_priv_copy( mask
, &privs
[i
].se_priv
);
242 /***************************************************************************
243 dump an SE_PRIV structure to the log files
244 ****************************************************************************/
246 void dump_se_priv( int dbg_cl
, int dbg_lvl
, const SE_PRIV
*mask
)
250 DEBUGADDC( dbg_cl
, dbg_lvl
,("SE_PRIV "));
252 for ( i
=0; i
<SE_PRIV_MASKSIZE
; i
++ ) {
253 DEBUGADDC( dbg_cl
, dbg_lvl
,(" 0x%x", mask
->mask
[i
] ));
256 DEBUGADDC( dbg_cl
, dbg_lvl
, ("\n"));
259 /****************************************************************************
260 check if the privilege is in the privilege list
261 ****************************************************************************/
263 bool is_privilege_assigned(const SE_PRIV
*privileges
,
264 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_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 return se_priv_equal( &p2
, check
);
291 /****************************************************************************
292 check if the privilege is in the privilege list
293 ****************************************************************************/
295 static bool is_any_privilege_assigned( SE_PRIV
*privileges
, const SE_PRIV
*check
)
299 if ( !privileges
|| !check
)
302 /* everyone has privileges if you aren't checking for any */
304 if ( se_priv_empty( check
) ) {
305 DEBUG(1,("is_any_privilege_assigned: no privileges in check_mask!\n"));
309 se_priv_copy( &p1
, check
);
311 /* invert the SE_PRIV we want to check for and remove that from the
312 original set. If we are left with the SE_PRIV we are checking
313 for then return True */
315 se_priv_invert( &p1
, check
);
316 se_priv_copy( &p2
, privileges
);
317 se_priv_remove( &p2
, &p1
);
319 /* see if we have any bits left */
321 return !se_priv_empty( &p2
);
324 /*********************************************************************
325 Generate the LUID_ATTR structure based on a bitmask
326 *********************************************************************/
328 const char* get_privilege_dispname( const char *name
)
336 for ( i
=0; !se_priv_equal(&privs
[i
].se_priv
, &se_priv_end
); i
++ ) {
338 if ( strequal( privs
[i
].name
, name
) ) {
339 return privs
[i
].description
;
346 /****************************************************************************
347 initialise a privilege list and set the talloc context
348 ****************************************************************************/
350 /****************************************************************************
351 Does the user have the specified privilege ? We only deal with one privilege
353 *****************************************************************************/
355 bool user_has_privileges(const NT_USER_TOKEN
*token
, const SE_PRIV
*privilege
)
360 return is_privilege_assigned( &token
->privileges
, privilege
);
363 /****************************************************************************
364 Does the user have any of the specified privileges ? We only deal with one privilege
366 *****************************************************************************/
368 bool user_has_any_privilege(NT_USER_TOKEN
*token
, const SE_PRIV
*privilege
)
373 return is_any_privilege_assigned( &token
->privileges
, privilege
);
376 /*******************************************************************
377 return the number of elements in the privlege array
378 *******************************************************************/
380 int count_all_privileges( void )
383 * The -1 is due to the weird SE_END record...
385 return (sizeof(privs
) / sizeof(privs
[0])) - 1;
389 /*********************************************************************
390 Generate the LUID_ATTR structure based on a bitmask
391 The assumption here is that the privilege has already been validated
392 so we are guaranteed to find it in the list.
393 *********************************************************************/
395 LUID_ATTR
get_privilege_luid( SE_PRIV
*mask
)
400 ZERO_STRUCT( priv_luid
);
402 for ( i
=0; !se_priv_equal(&privs
[i
].se_priv
, &se_priv_end
); i
++ ) {
404 if ( se_priv_equal( &privs
[i
].se_priv
, mask
) ) {
405 priv_luid
.luid
= privs
[i
].luid
;
413 /****************************************************************************
414 Convert a LUID to a named string
415 ****************************************************************************/
417 const char *luid_to_privilege_name(const LUID
*set
)
421 for ( i
=0; !se_priv_equal(&privs
[i
].se_priv
, &se_priv_end
); i
++ ) {
422 if (luid_equal(set
, &privs
[i
].luid
)) {
423 return privs
[i
].name
;
431 /****************************************************************************
432 add a privilege to a privilege array
433 ****************************************************************************/
435 static bool privilege_set_add(PRIVILEGE_SET
*priv_set
, LUID_ATTR set
)
439 /* we can allocate memory to add the new privilege */
441 new_set
= TALLOC_REALLOC_ARRAY(priv_set
->mem_ctx
, priv_set
->set
, LUID_ATTR
, priv_set
->count
+ 1);
443 DEBUG(0,("privilege_set_add: failed to allocate memory!\n"));
447 new_set
[priv_set
->count
].luid
.high
= set
.luid
.high
;
448 new_set
[priv_set
->count
].luid
.low
= set
.luid
.low
;
449 new_set
[priv_set
->count
].attr
= set
.attr
;
452 priv_set
->set
= new_set
;
457 /*******************************************************************
458 *******************************************************************/
460 bool se_priv_to_privilege_set( PRIVILEGE_SET
*set
, SE_PRIV
*mask
)
463 uint32 num_privs
= count_all_privileges();
469 for ( i
=0; i
<num_privs
; i
++ ) {
470 if ( !is_privilege_assigned(mask
, &privs
[i
].se_priv
) )
473 luid
.luid
= privs
[i
].luid
;
475 if ( !privilege_set_add( set
, luid
) )
482 /*******************************************************************
483 *******************************************************************/
485 static bool luid_to_se_priv( struct lsa_LUID
*luid
, SE_PRIV
*mask
)
488 uint32 num_privs
= count_all_privileges();
491 local_luid
.low
= luid
->low
;
492 local_luid
.high
= luid
->high
;
494 for ( i
=0; i
<num_privs
; i
++ ) {
495 if (luid_equal(&local_luid
, &privs
[i
].luid
)) {
496 se_priv_copy( mask
, &privs
[i
].se_priv
);
504 /*******************************************************************
505 *******************************************************************/
507 bool privilege_set_to_se_priv( SE_PRIV
*mask
, struct lsa_PrivilegeSet
*privset
)
511 ZERO_STRUCTP( mask
);
513 for ( i
=0; i
<privset
->count
; i
++ ) {
516 if ( luid_to_se_priv( &privset
->set
[i
].luid
, &r
) )
517 se_priv_add( mask
, &r
);