server/security.h

   1 /*
   2  * Security Management
   3  *
   4  * Copyright (C) 2005 Robert Shearman
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #ifndef __WINE_SERVER_SECURITY_H
  22 #define __WINE_SERVER_SECURITY_H
  23
  24 extern const LUID SeIncreaseQuotaPrivilege;
  25 extern const LUID SeSecurityPrivilege;
  26 extern const LUID SeTakeOwnershipPrivilege;
  27 extern const LUID SeLoadDriverPrivilege;
  28 extern const LUID SeSystemProfilePrivilege;
  29 extern const LUID SeSystemtimePrivilege;
  30 extern const LUID SeProfileSingleProcessPrivilege;
  31 extern const LUID SeIncreaseBasePriorityPrivilege;
  32 extern const LUID SeCreatePagefilePrivilege;
  33 extern const LUID SeBackupPrivilege;
  34 extern const LUID SeRestorePrivilege;
  35 extern const LUID SeShutdownPrivilege;
  36 extern const LUID SeDebugPrivilege;
  37 extern const LUID SeSystemEnvironmentPrivilege;
  38 extern const LUID SeChangeNotifyPrivilege;
  39 extern const LUID SeRemoteShutdownPrivilege;
  40 extern const LUID SeUndockPrivilege;
  41 extern const LUID SeManageVolumePrivilege;
  42 extern const LUID SeImpersonatePrivilege;
  43 extern const LUID SeCreateGlobalPrivilege;
  44
  45 extern const PSID security_world_sid;
  46 extern const PSID security_local_user_sid;
  47 extern const PSID security_local_system_sid;
  48 extern const PSID security_builtin_users_sid;
  49 extern const PSID security_builtin_admins_sid;
  50 extern const PSID security_domain_users_sid;
  51 extern const PSID security_high_label_sid;
  52
  53
  54 /* token functions */
  55
  56 extern struct token *get_token_obj( struct process *process, obj_handle_t handle, unsigned int access );
  57 extern struct token *token_create_admin( unsigned primary, int impersonation_level, int elevation, unsigned int session_id );
  58 extern int token_assign_label( struct token *token, PSID label );
  59 extern struct token *token_duplicate( struct token *src_token, unsigned primary,
  60                                       int impersonation_level, const struct security_descriptor *sd,
  61                                       const LUID_AND_ATTRIBUTES *remove_privs, unsigned int remove_priv_count,
  62                                       const SID *remove_groups, unsigned int remove_group_count );
  63 extern int token_check_privileges( struct token *token, int all_required,
  64                                    const LUID_AND_ATTRIBUTES *reqprivs,
  65                                    unsigned int count, LUID_AND_ATTRIBUTES *usedprivs);
  66 extern const ACL *token_get_default_dacl( struct token *token );
  67 extern const SID *token_get_user( struct token *token );
  68 extern const SID *token_get_primary_group( struct token *token );
  69 extern unsigned int token_get_session_id( struct token *token );
  70 extern int token_sid_present( struct token *token, const SID *sid, int deny);
  71
  72 static inline const ACE_HEADER *ace_next( const ACE_HEADER *ace )
  73 {
  74     return (const ACE_HEADER *)((const char *)ace + ace->AceSize);
  75 }
  76
  77 static inline size_t security_sid_len( const SID *sid )
  78 {
  79     return offsetof( SID, SubAuthority[sid->SubAuthorityCount] );
  80 }
  81
  82 static inline int security_equal_sid( const SID *sid1, const SID *sid2 )
  83 {
  84     return ((sid1->SubAuthorityCount == sid2->SubAuthorityCount) &&
  85             !memcmp( sid1, sid2, security_sid_len( sid1 )));
  86 }
  87
  88 extern void security_set_thread_token( struct thread *thread, obj_handle_t handle );
  89 extern const SID *security_unix_uid_to_sid( uid_t uid );
  90 extern int check_object_access( struct token *token, struct object *obj, unsigned int *access );
  91
  92 static inline int thread_single_check_privilege( struct thread *thread, const LUID *priv)
  93 {
  94     struct token *token = thread_get_impersonation_token( thread );
  95     const LUID_AND_ATTRIBUTES privs = { *priv, 0 };
  96
  97     if (!token) return FALSE;
  98
  99     return token_check_privileges( token, TRUE, &privs, 1, NULL );
 100 }
 101
 102
 103 /* security descriptor helper functions */
 104
 105 extern int sd_is_valid( const struct security_descriptor *sd, data_size_t size );
 106 extern ACL *extract_security_labels( const ACL *sacl );
 107 extern ACL *replace_security_labels( const ACL *old_sacl, const ACL *new_sacl );
 108
 109 /* gets the discretionary access control list from a security descriptor */
 110 static inline const ACL *sd_get_dacl( const struct security_descriptor *sd, int *present )
 111 {
 112     *present = (sd->control & SE_DACL_PRESENT) != 0;
 113
 114     if (sd->dacl_len)
 115         return (const ACL *)((const char *)(sd + 1) +
 116             sd->owner_len + sd->group_len + sd->sacl_len);
 117     else
 118         return NULL;
 119 }
 120
 121 /* gets the system access control list from a security descriptor */
 122 static inline const ACL *sd_get_sacl( const struct security_descriptor *sd, int *present )
 123 {
 124     *present = (sd->control & SE_SACL_PRESENT) != 0;
 125
 126     if (sd->sacl_len)
 127         return (const ACL *)((const char *)(sd + 1) +
 128             sd->owner_len + sd->group_len);
 129     else
 130         return NULL;
 131 }
 132
 133 /* gets the owner from a security descriptor */
 134 static inline const SID *sd_get_owner( const struct security_descriptor *sd )
 135 {
 136     if (sd->owner_len)
 137         return (const SID *)(sd + 1);
 138     else
 139         return NULL;
 140 }
 141
 142 /* gets the primary group from a security descriptor */
 143 static inline const SID *sd_get_group( const struct security_descriptor *sd )
 144 {
 145     if (sd->group_len)
 146         return (const SID *)((const char *)(sd + 1) + sd->owner_len);
 147     else
 148         return NULL;
 149 }
 150
 151 #endif  /* __WINE_SERVER_SECURITY_H */