source3/lib/privileges_basic.c

   1 /*
   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
   8
   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.
  13
  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.
  18
  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/>.
  21 */
  22
  23 /*
  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.
  27  *
  28  * generally SID- and LUID-related code is left in lib/privileges.c
  29  *
  30  * some extra functions to hide privs array from lib/privileges.c
  31  */
  32
  33 #include "includes.h"
  34
  35 const SE_PRIV se_priv_all         = SE_ALL_PRIVS;
  36 static const SE_PRIV se_priv_end  = SE_END;
  37
  38 /* Define variables for all privileges so we can use the
  39    SE_PRIV* in the various se_priv_XXX() functions */
  40
  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;
  50
  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
  54  across reboots):
  55
  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 )
  85
  86  ********************************************************************/
  87
  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 */
  91
  92 PRIVS privs[] = {
  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 */
  95
  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 }},
 100 #endif
 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 }},
 107
 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 }},
 111
 112
 113         {SE_END, "", "", { 0x0, 0x0 }}
 114 };
 115
 116 /***************************************************************************
 117  copy an SE_PRIV structure
 118 ****************************************************************************/
 119
 120 bool se_priv_copy( SE_PRIV *dst, const SE_PRIV *src )
 121 {
 122         if ( !dst || !src )
 123                 return False;
 124
 125         memcpy( dst, src, sizeof(SE_PRIV) );
 126
 127         return True;
 128 }
 129
 130 /***************************************************************************
 131  put all privileges into a mask
 132 ****************************************************************************/
 133
 134 bool se_priv_put_all_privileges(SE_PRIV *mask)
 135 {
 136         int i;
 137         uint32 num_privs = count_all_privileges();
 138
 139         if (!se_priv_copy(mask, &se_priv_none)) {
 140                 return False;
 141         }
 142         for ( i=0; i<num_privs; i++ ) {
 143                 se_priv_add(mask, &privs[i].se_priv);
 144         }
 145         return True;
 146 }
 147
 148 /***************************************************************************
 149  combine 2 SE_PRIV structures and store the resulting set in mew_mask
 150 ****************************************************************************/
 151
 152 void se_priv_add( SE_PRIV *mask, const SE_PRIV *addpriv )
 153 {
 154         int i;
 155
 156         for ( i=0; i<SE_PRIV_MASKSIZE; i++ ) {
 157                 mask->mask[i] |= addpriv->mask[i];
 158         }
 159 }
 160
 161 /***************************************************************************
 162  remove one SE_PRIV sytucture from another and store the resulting set
 163  in mew_mask
 164 ****************************************************************************/
 165
 166 void se_priv_remove( SE_PRIV *mask, const SE_PRIV *removepriv )
 167 {
 168         int i;
 169
 170         for ( i=0; i<SE_PRIV_MASKSIZE; i++ ) {
 171                 mask->mask[i] &= ~removepriv->mask[i];
 172         }
 173 }
 174
 175 /***************************************************************************
 176  invert a given SE_PRIV and store the set in new_mask
 177 ****************************************************************************/
 178
 179 static void se_priv_invert( SE_PRIV *new_mask, const SE_PRIV *mask )
 180 {
 181         SE_PRIV allprivs;
 182
 183         se_priv_copy( &allprivs, &se_priv_all );
 184         se_priv_remove( &allprivs, mask );
 185         se_priv_copy( new_mask, &allprivs );
 186 }
 187
 188 /***************************************************************************
 189  check if 2 SE_PRIV structure are equal
 190 ****************************************************************************/
 191
 192 bool se_priv_equal( const SE_PRIV *mask1, const SE_PRIV *mask2 )
 193 {
 194         return ( memcmp(mask1, mask2, sizeof(SE_PRIV)) == 0 );
 195 }
 196
 197 /***************************************************************************
 198  check if 2 LUID's are equal.
 199 ****************************************************************************/
 200
 201 static bool luid_equal( const LUID *luid1, const LUID *luid2 )
 202 {
 203         return ( luid1->low == luid2->low && luid1->high == luid2->high);
 204 }
 205
 206 /***************************************************************************
 207  check if a SE_PRIV has any assigned privileges
 208 ****************************************************************************/
 209
 210 static bool se_priv_empty( const SE_PRIV *mask )
 211 {
 212         SE_PRIV p1;
 213         int i;
 214
 215         se_priv_copy( &p1, mask );
 216
 217         for ( i=0; i<SE_PRIV_MASKSIZE; i++ ) {
 218                 p1.mask[i] &= se_priv_all.mask[i];
 219         }
 220
 221         return se_priv_equal( &p1, &se_priv_none );
 222 }
 223
 224 /*********************************************************************
 225  Lookup the SE_PRIV value for a privilege name
 226 *********************************************************************/
 227
 228 bool se_priv_from_name( const char *name, SE_PRIV *mask )
 229 {
 230         int i;
 231
 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 );
 235                         return True;
 236                 }
 237         }
 238
 239         return False;
 240 }
 241
 242 /***************************************************************************
 243  dump an SE_PRIV structure to the log files
 244 ****************************************************************************/
 245
 246 void dump_se_priv( int dbg_cl, int dbg_lvl, const SE_PRIV *mask )
 247 {
 248         int i;
 249
 250         DEBUGADDC( dbg_cl, dbg_lvl,("SE_PRIV "));
 251
 252         for ( i=0; i<SE_PRIV_MASKSIZE; i++ ) {
 253                 DEBUGADDC( dbg_cl, dbg_lvl,(" 0x%x", mask->mask[i] ));
 254         }
 255
 256         DEBUGADDC( dbg_cl, dbg_lvl, ("\n"));
 257 }
 258
 259 /****************************************************************************
 260  check if the privilege is in the privilege list
 261 ****************************************************************************/
 262
 263 bool is_privilege_assigned(const SE_PRIV *privileges,
 264                            const SE_PRIV *check)
 265 {
 266         SE_PRIV p1, p2;
 267
 268         if ( !privileges || !check )
 269                 return False;
 270
 271         /* everyone has privileges if you aren't checking for any */
 272
 273         if ( se_priv_empty( check ) ) {
 274                 DEBUG(1,("is_privilege_assigned: no privileges in check_mask!\n"));
 275                 return True;
 276         }
 277
 278         se_priv_copy( &p1, check );
 279
 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 */
 283
 284         se_priv_invert( &p1, check );
 285         se_priv_copy( &p2, privileges );
 286         se_priv_remove( &p2, &p1 );
 287
 288         return se_priv_equal( &p2, check );
 289 }
 290
 291 /****************************************************************************
 292  check if the privilege is in the privilege list
 293 ****************************************************************************/
 294
 295 static bool is_any_privilege_assigned( SE_PRIV *privileges, const SE_PRIV *check )
 296 {
 297         SE_PRIV p1, p2;
 298
 299         if ( !privileges || !check )
 300                 return False;
 301
 302         /* everyone has privileges if you aren't checking for any */
 303
 304         if ( se_priv_empty( check ) ) {
 305                 DEBUG(1,("is_any_privilege_assigned: no privileges in check_mask!\n"));
 306                 return True;
 307         }
 308
 309         se_priv_copy( &p1, check );
 310
 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 */
 314
 315         se_priv_invert( &p1, check );
 316         se_priv_copy( &p2, privileges );
 317         se_priv_remove( &p2, &p1 );
 318
 319         /* see if we have any bits left */
 320
 321         return !se_priv_empty( &p2 );
 322 }
 323
 324 /*********************************************************************
 325  Generate the LUID_ATTR structure based on a bitmask
 326 *********************************************************************/
 327
 328 const char* get_privilege_dispname( const char *name )
 329 {
 330         int i;
 331
 332         if (!name) {
 333                 return NULL;
 334         }
 335
 336         for ( i=0; !se_priv_equal(&privs[i].se_priv, &se_priv_end); i++ ) {
 337
 338                 if ( strequal( privs[i].name, name ) ) {
 339                         return privs[i].description;
 340                 }
 341         }
 342
 343         return NULL;
 344 }
 345
 346 /****************************************************************************
 347  initialise a privilege list and set the talloc context
 348  ****************************************************************************/
 349
 350 /****************************************************************************
 351  Does the user have the specified privilege ?  We only deal with one privilege
 352  at a time here.
 353 *****************************************************************************/
 354
 355 bool user_has_privileges(const NT_USER_TOKEN *token, const SE_PRIV *privilege)
 356 {
 357         if ( !token )
 358                 return False;
 359
 360         return is_privilege_assigned( &token->privileges, privilege );
 361 }
 362
 363 /****************************************************************************
 364  Does the user have any of the specified privileges ?  We only deal with one privilege
 365  at a time here.
 366 *****************************************************************************/
 367
 368 bool user_has_any_privilege(NT_USER_TOKEN *token, const SE_PRIV *privilege)
 369 {
 370         if ( !token )
 371                 return False;
 372
 373         return is_any_privilege_assigned( &token->privileges, privilege );
 374 }
 375
 376 /*******************************************************************
 377  return the number of elements in the privlege array
 378 *******************************************************************/
 379
 380 int count_all_privileges( void )
 381 {
 382         /*
 383          * The -1 is due to the weird SE_END record...
 384          */
 385         return (sizeof(privs) / sizeof(privs[0])) - 1;
 386 }
 387
 388
 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 *********************************************************************/
 394
 395 LUID_ATTR get_privilege_luid( SE_PRIV *mask )
 396 {
 397         LUID_ATTR priv_luid;
 398         int i;
 399
 400         ZERO_STRUCT( priv_luid );
 401
 402         for ( i=0; !se_priv_equal(&privs[i].se_priv, &se_priv_end); i++ ) {
 403
 404                 if ( se_priv_equal( &privs[i].se_priv, mask ) ) {
 405                         priv_luid.luid = privs[i].luid;
 406                         break;
 407                 }
 408         }
 409
 410         return priv_luid;
 411 }
 412
 413 /****************************************************************************
 414  Convert a LUID to a named string
 415 ****************************************************************************/
 416
 417 const char *luid_to_privilege_name(const LUID *set)
 418 {
 419         int i;
 420
 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;
 424                 }
 425         }
 426
 427         return NULL;
 428 }
 429
 430
 431 /****************************************************************************
 432  add a privilege to a privilege array
 433  ****************************************************************************/
 434
 435 static bool privilege_set_add(PRIVILEGE_SET *priv_set, LUID_ATTR set)
 436 {
 437         LUID_ATTR *new_set;
 438
 439         /* we can allocate memory to add the new privilege */
 440
 441         new_set = TALLOC_REALLOC_ARRAY(priv_set->mem_ctx, priv_set->set, LUID_ATTR, priv_set->count + 1);
 442         if ( !new_set ) {
 443                 DEBUG(0,("privilege_set_add: failed to allocate memory!\n"));
 444                 return False;
 445         }
 446
 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;
 450
 451         priv_set->count++;
 452         priv_set->set = new_set;
 453
 454         return True;
 455 }
 456
 457 /*******************************************************************
 458 *******************************************************************/
 459
 460 bool se_priv_to_privilege_set( PRIVILEGE_SET *set, SE_PRIV *mask )
 461 {
 462         int i;
 463         uint32 num_privs = count_all_privileges();
 464         LUID_ATTR luid;
 465
 466         luid.attr = 0;
 467         luid.luid.high = 0;
 468
 469         for ( i=0; i<num_privs; i++ ) {
 470                 if ( !is_privilege_assigned(mask, &privs[i].se_priv) )
 471                         continue;
 472
 473                 luid.luid = privs[i].luid;
 474
 475                 if ( !privilege_set_add( set, luid ) )
 476                         return False;
 477         }
 478
 479         return True;
 480 }
 481
 482 /*******************************************************************
 483 *******************************************************************/
 484
 485 static bool luid_to_se_priv( struct lsa_LUID *luid, SE_PRIV *mask )
 486 {
 487         int i;
 488         uint32 num_privs = count_all_privileges();
 489         LUID local_luid;
 490
 491         local_luid.low = luid->low;
 492         local_luid.high = luid->high;
 493
 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 );
 497                         return True;
 498                 }
 499         }
 500
 501         return False;
 502 }
 503
 504 /*******************************************************************
 505 *******************************************************************/
 506
 507 bool privilege_set_to_se_priv( SE_PRIV *mask, struct lsa_PrivilegeSet *privset )
 508 {
 509         int i;
 510
 511         ZERO_STRUCTP( mask );
 512
 513         for ( i=0; i<privset->count; i++ ) {
 514                 SE_PRIV r;
 515
 516                 if ( luid_to_se_priv( &privset->set[i].luid, &r ) )
 517                         se_priv_add( mask, &r );
 518         }
 519
 520         return True;
 521 }
 522