496 lines
16 KiB
C++
496 lines
16 KiB
C++
/* security.h: security declarations
|
|
|
|
Copyright 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
|
|
2011, 2012, 2013, 2014 Red Hat, Inc.
|
|
|
|
This file is part of Cygwin.
|
|
|
|
This software is a copyrighted work licensed under the terms of the
|
|
Cygwin license. Please consult the file "CYGWIN_LICENSE" for
|
|
details. */
|
|
|
|
#pragma once
|
|
|
|
#include <accctrl.h>
|
|
|
|
/* Special file attribute set, for instance, in open() and mkdir() to
|
|
flag that a file has just been created. Used in alloc_sd, see there. */
|
|
#define S_JUSTCREATED 0x80000000
|
|
|
|
#define DEFAULT_UID DOMAIN_USER_RID_ADMIN
|
|
#define UNKNOWN_UID 400 /* Non conflicting number */
|
|
#define UNKNOWN_GID 401
|
|
|
|
#define MAX_SID_LEN 40
|
|
#define MAX_DACL_LEN(n) (sizeof (ACL) \
|
|
+ (n) * (sizeof (ACCESS_ALLOWED_ACE) - sizeof (DWORD) + MAX_SID_LEN))
|
|
#define SD_MIN_SIZE (sizeof (SECURITY_DESCRIPTOR) + MAX_DACL_LEN (1))
|
|
#define ACL_MAXIMUM_SIZE 65532 /* Yeah, right. 64K - sizeof (DWORD). */
|
|
#define SD_MAXIMUM_SIZE 65536
|
|
#define NO_SID ((PSID)NULL)
|
|
|
|
#ifndef SE_CREATE_TOKEN_PRIVILEGE
|
|
#define SE_CREATE_TOKEN_PRIVILEGE 2U
|
|
#define SE_ASSIGNPRIMARYTOKEN_PRIVILEGE 3U
|
|
#define SE_LOCK_MEMORY_PRIVILEGE 4U
|
|
#define SE_INCREASE_QUOTA_PRIVILEGE 5U
|
|
#define SE_MACHINE_ACCOUNT_PRIVILEGE 6U
|
|
#define SE_TCB_PRIVILEGE 7U
|
|
#define SE_SECURITY_PRIVILEGE 8U
|
|
#define SE_TAKE_OWNERSHIP_PRIVILEGE 9U
|
|
#define SE_LOAD_DRIVER_PRIVILEGE 10U
|
|
#define SE_SYSTEM_PROFILE_PRIVILEGE 11U
|
|
#define SE_SYSTEMTIME_PRIVILEGE 12U
|
|
#define SE_PROF_SINGLE_PROCESS_PRIVILEGE 13U
|
|
#define SE_INC_BASE_PRIORITY_PRIVILEGE 14U
|
|
#define SE_CREATE_PAGEFILE_PRIVILEGE 15U
|
|
#define SE_CREATE_PERMANENT_PRIVILEGE 16U
|
|
#define SE_BACKUP_PRIVILEGE 17U
|
|
#define SE_RESTORE_PRIVILEGE 18U
|
|
#define SE_SHUTDOWN_PRIVILEGE 19U
|
|
#define SE_DEBUG_PRIVILEGE 20U
|
|
#define SE_AUDIT_PRIVILEGE 21U
|
|
#define SE_SYSTEM_ENVIRONMENT_PRIVILEGE 22U
|
|
#define SE_CHANGE_NOTIFY_PRIVILEGE 23U
|
|
#define SE_REMOTE_SHUTDOWN_PRIVILEGE 24U
|
|
#define SE_UNDOCK_PRIVILEGE 25U
|
|
#define SE_SYNC_AGENT_PRIVILEGE 26U
|
|
#define SE_ENABLE_DELEGATION_PRIVILEGE 27U
|
|
#define SE_MANAGE_VOLUME_PRIVILEGE 28U
|
|
#define SE_IMPERSONATE_PRIVILEGE 29U
|
|
#define SE_CREATE_GLOBAL_PRIVILEGE 30U
|
|
/* Starting with Vista */
|
|
#define SE_TRUSTED_CREDMAN_ACCESS_PRIVILEGE 31U
|
|
#define SE_RELABEL_PRIVILEGE 32U
|
|
#define SE_INCREASE_WORKING_SET_PRIVILEGE 33U
|
|
#define SE_TIME_ZONE_PRIVILEGE 34U
|
|
#define SE_CREATE_SYMBOLIC_LINK_PRIVILEGE 35U
|
|
|
|
#define SE_MAX_WELL_KNOWN_PRIVILEGE SE_CREATE_SYMBOLIC_LINK_PRIVILEGE
|
|
|
|
#endif /* ! SE_CREATE_TOKEN_PRIVILEGE */
|
|
|
|
/* Added for debugging purposes. */
|
|
typedef struct {
|
|
BYTE Revision;
|
|
BYTE SubAuthorityCount;
|
|
SID_IDENTIFIER_AUTHORITY IdentifierAuthority;
|
|
DWORD SubAuthority[8];
|
|
} DBGSID, *PDBGSID;
|
|
|
|
/* Macro to define variable length SID structures */
|
|
#define MKSID(name, comment, authority, count, rid...) \
|
|
static NO_COPY struct { \
|
|
BYTE Revision; \
|
|
BYTE SubAuthorityCount; \
|
|
SID_IDENTIFIER_AUTHORITY IdentifierAuthority; \
|
|
DWORD SubAuthority[count]; \
|
|
} name##_struct = { SID_REVISION, count, {authority}, {rid}}; \
|
|
cygpsid NO_COPY name = (PSID) &name##_struct;
|
|
|
|
#define FILE_READ_BITS (FILE_READ_DATA | GENERIC_READ | GENERIC_ALL)
|
|
#define FILE_WRITE_BITS (FILE_WRITE_DATA | GENERIC_WRITE | GENERIC_ALL)
|
|
#define FILE_EXEC_BITS (FILE_EXECUTE | GENERIC_EXECUTE | GENERIC_ALL)
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
/* We need these declarations, otherwise g++ complains that the below
|
|
inline methods use an undefined function, if ntdll.h isn't included. */
|
|
BOOLEAN NTAPI RtlEqualSid (PSID, PSID);
|
|
NTSTATUS NTAPI RtlCopySid (ULONG, PSID, PSID);
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
class cygpsid {
|
|
protected:
|
|
PSID psid;
|
|
public:
|
|
cygpsid () {}
|
|
cygpsid (PSID nsid) { psid = nsid; }
|
|
operator PSID () const { return psid; }
|
|
const PSID operator= (PSID nsid) { return psid = nsid;}
|
|
uid_t get_id (BOOL search_grp, int *type = NULL);
|
|
int get_uid () { return get_id (FALSE); }
|
|
int get_gid () { return get_id (TRUE); }
|
|
|
|
PWCHAR string (PWCHAR nsidstr) const;
|
|
char *string (char *nsidstr) const;
|
|
|
|
bool operator== (const PSID nsid) const
|
|
{
|
|
if (!psid || !nsid)
|
|
return nsid == psid;
|
|
return RtlEqualSid (psid, nsid);
|
|
}
|
|
bool operator!= (const PSID nsid) const
|
|
{ return !(*this == nsid); }
|
|
bool operator== (const char *nsidstr) const;
|
|
bool operator!= (const char *nsidstr) const
|
|
{ return !(*this == nsidstr); }
|
|
|
|
void debug_print (const char *prefix = NULL) const
|
|
{
|
|
char buf[256] __attribute__ ((unused));
|
|
debug_printf ("%s %s", prefix ?: "", string (buf) ?: "NULL");
|
|
}
|
|
};
|
|
|
|
class cygsid : public cygpsid {
|
|
char sbuf[MAX_SID_LEN];
|
|
bool well_known_sid;
|
|
|
|
const PSID getfromstr (const char *nsidstr, bool well_known);
|
|
PSID get_sid (DWORD s, DWORD cnt, DWORD *r, bool well_known);
|
|
|
|
inline const PSID assign (const PSID nsid, bool well_known)
|
|
{
|
|
if (!nsid)
|
|
psid = NO_SID;
|
|
else
|
|
{
|
|
psid = (PSID) sbuf;
|
|
RtlCopySid (MAX_SID_LEN, psid, nsid);
|
|
well_known_sid = well_known;
|
|
}
|
|
return psid;
|
|
}
|
|
|
|
public:
|
|
inline operator const PSID () { return psid; }
|
|
inline bool is_well_known_sid () { return well_known_sid; }
|
|
|
|
/* Both, = and *= are assignment operators. = creates a "normal" SID,
|
|
*= marks the SID as being a well-known SID. This difference is
|
|
important when creating a SID list for LSA authentication. */
|
|
inline const PSID operator= (cygsid &nsid)
|
|
{ return assign (nsid, nsid.well_known_sid); }
|
|
inline const PSID operator= (const PSID nsid)
|
|
{ return assign (nsid, false); }
|
|
inline const PSID operator= (const char *nsidstr)
|
|
{ return getfromstr (nsidstr, false); }
|
|
inline const PSID operator*= (cygsid &nsid)
|
|
{ return assign (nsid, true); }
|
|
inline const PSID operator*= (const PSID nsid)
|
|
{ return assign (nsid, true); }
|
|
inline const PSID operator*= (const char *nsidstr)
|
|
{ return getfromstr (nsidstr, true); }
|
|
|
|
inline cygsid () : cygpsid ((PSID) sbuf), well_known_sid (false) {}
|
|
inline cygsid (const PSID nsid) { *this = nsid; }
|
|
inline cygsid (const char *nstrsid) { *this = nstrsid; }
|
|
|
|
inline PSID set () { return psid = (PSID) sbuf; }
|
|
|
|
BOOL getfrompw (const struct passwd *pw);
|
|
BOOL getfromgr (const struct group *gr);
|
|
|
|
void debug_print (const char *prefix = NULL) const
|
|
{
|
|
char buf[256] __attribute__ ((unused));
|
|
debug_printf ("%s %s%s", prefix ?: "", string (buf) ?: "NULL", well_known_sid ? " (*)" : " (+)");
|
|
}
|
|
};
|
|
|
|
typedef enum { cygsidlist_empty, cygsidlist_alloc, cygsidlist_auto } cygsidlist_type;
|
|
class cygsidlist {
|
|
int maxcnt;
|
|
int cnt;
|
|
|
|
BOOL add (const PSID nsi, bool well_known); /* Only with auto for now */
|
|
|
|
public:
|
|
cygsid *sids;
|
|
cygsidlist_type type;
|
|
|
|
cygsidlist (cygsidlist_type t, int m)
|
|
: maxcnt (m), cnt (0), type (t)
|
|
{
|
|
if (t == cygsidlist_alloc)
|
|
sids = alloc_sids (m);
|
|
else
|
|
sids = new cygsid [m];
|
|
}
|
|
~cygsidlist () { if (type == cygsidlist_auto) delete [] sids; }
|
|
|
|
BOOL addfromgr (struct group *gr) /* Only with alloc */
|
|
{ return sids[cnt].getfromgr (gr) && ++cnt; }
|
|
|
|
/* += adds a "normal" SID, *= adds a well-known SID. See comment in class
|
|
cygsid above. */
|
|
BOOL operator+= (cygsid &si) { return add ((PSID) si,
|
|
si.is_well_known_sid ()); }
|
|
BOOL operator+= (const char *sidstr) { cygsid nsi (sidstr);
|
|
return add ((PSID) nsi,
|
|
nsi.is_well_known_sid ());
|
|
}
|
|
BOOL operator+= (const PSID psid) { return add (psid, false); }
|
|
BOOL operator*= (cygsid &si) { return add ((PSID) si, true); }
|
|
BOOL operator*= (const char *sidstr) { cygsid nsi (sidstr);
|
|
return add ((PSID) nsi, true); }
|
|
BOOL operator*= (const PSID psid) { return add (psid, true); }
|
|
|
|
void count (int ncnt)
|
|
{ cnt = ncnt; }
|
|
int count () const { return cnt; }
|
|
int non_well_known_count () const
|
|
{
|
|
int wcnt = 0;
|
|
for (int i = 0; i < cnt; ++i)
|
|
if (!sids[i].is_well_known_sid ())
|
|
++wcnt;
|
|
return wcnt;
|
|
}
|
|
|
|
int position (const PSID sid) const
|
|
{
|
|
for (int i = 0; i < cnt; ++i)
|
|
if (sids[i] == sid)
|
|
return i;
|
|
return -1;
|
|
}
|
|
|
|
int next_non_well_known_sid (int idx)
|
|
{
|
|
while (++idx < cnt)
|
|
if (!sids[idx].is_well_known_sid ())
|
|
return idx;
|
|
return -1;
|
|
}
|
|
BOOL contains (const PSID sid) const { return position (sid) >= 0; }
|
|
cygsid *alloc_sids (int n);
|
|
void free_sids ();
|
|
void debug_print (const char *prefix = NULL) const
|
|
{
|
|
debug_printf ("-- begin sidlist ---");
|
|
if (!cnt)
|
|
debug_printf ("No elements");
|
|
for (int i = 0; i < cnt; ++i)
|
|
sids[i].debug_print (prefix);
|
|
debug_printf ("-- ende sidlist ---");
|
|
}
|
|
};
|
|
|
|
/* Wrapper class to allow simple deleting of buffer space allocated
|
|
by read_sd() */
|
|
class security_descriptor {
|
|
protected:
|
|
PSECURITY_DESCRIPTOR psd;
|
|
DWORD sd_size;
|
|
public:
|
|
security_descriptor () : psd (NULL), sd_size (0) {}
|
|
~security_descriptor () { free (); }
|
|
|
|
PSECURITY_DESCRIPTOR malloc (size_t nsize);
|
|
PSECURITY_DESCRIPTOR realloc (size_t nsize);
|
|
void free ();
|
|
|
|
inline DWORD size () const { return sd_size; }
|
|
inline DWORD copy (void *buf, DWORD buf_size) const {
|
|
if (buf_size < size ())
|
|
return sd_size;
|
|
memcpy (buf, psd, sd_size);
|
|
return 0;
|
|
}
|
|
inline operator const PSECURITY_DESCRIPTOR () { return psd; }
|
|
inline operator PSECURITY_DESCRIPTOR *() { return &psd; }
|
|
inline void operator =(PSECURITY_DESCRIPTOR nsd) { psd = nsd; }
|
|
};
|
|
|
|
class user_groups {
|
|
public:
|
|
cygsid pgsid;
|
|
cygsidlist sgsids;
|
|
BOOL ischanged;
|
|
|
|
BOOL issetgroups () const { return (sgsids.type == cygsidlist_alloc); }
|
|
void update_supp (const cygsidlist &newsids)
|
|
{
|
|
sgsids.free_sids ();
|
|
sgsids = newsids;
|
|
ischanged = TRUE;
|
|
}
|
|
void clear_supp ()
|
|
{
|
|
if (issetgroups ())
|
|
{
|
|
sgsids.free_sids ();
|
|
ischanged = TRUE;
|
|
}
|
|
}
|
|
void update_pgrp (const PSID sid)
|
|
{
|
|
pgsid = sid;
|
|
ischanged = TRUE;
|
|
}
|
|
};
|
|
|
|
extern cygpsid well_known_null_sid;
|
|
extern cygpsid well_known_world_sid;
|
|
extern cygpsid well_known_local_sid;
|
|
extern cygpsid well_known_console_logon_sid;
|
|
extern cygpsid well_known_creator_owner_sid;
|
|
extern cygpsid well_known_creator_group_sid;
|
|
extern cygpsid well_known_dialup_sid;
|
|
extern cygpsid well_known_network_sid;
|
|
extern cygpsid well_known_batch_sid;
|
|
extern cygpsid well_known_interactive_sid;
|
|
extern cygpsid well_known_service_sid;
|
|
extern cygpsid well_known_authenticated_users_sid;
|
|
extern cygpsid well_known_this_org_sid;
|
|
extern cygpsid well_known_system_sid;
|
|
extern cygpsid well_known_builtin_sid;
|
|
extern cygpsid well_known_admins_sid;
|
|
extern cygpsid well_known_users_sid;
|
|
extern cygpsid mandatory_medium_integrity_sid;
|
|
extern cygpsid mandatory_high_integrity_sid;
|
|
extern cygpsid mandatory_system_integrity_sid;
|
|
extern cygpsid well_known_samba_unix_user_fake_sid;
|
|
|
|
bool privilege_luid (const PWCHAR pname, LUID &luid, bool &high_integrity);
|
|
|
|
extern inline BOOL
|
|
well_known_sid_type (SID_NAME_USE type)
|
|
{
|
|
return type == SidTypeAlias || type == SidTypeWellKnownGroup;
|
|
}
|
|
|
|
extern inline BOOL
|
|
legal_sid_type (SID_NAME_USE type)
|
|
{
|
|
return type == SidTypeUser || type == SidTypeGroup
|
|
|| type == SidTypeAlias || type == SidTypeWellKnownGroup;
|
|
}
|
|
|
|
class path_conv;
|
|
/* File manipulation */
|
|
int __reg3 get_file_attribute (HANDLE, path_conv &, mode_t *,
|
|
uid_t *, gid_t *);
|
|
int __reg3 set_file_attribute (HANDLE, path_conv &,
|
|
uid_t, gid_t, mode_t);
|
|
int __reg2 get_object_sd (HANDLE, security_descriptor &);
|
|
int __reg3 get_object_attribute (HANDLE, uid_t *, gid_t *, mode_t *);
|
|
int __reg3 set_object_attribute (HANDLE, uid_t, gid_t, mode_t);
|
|
int __reg3 create_object_sd_from_attribute (HANDLE, uid_t, gid_t,
|
|
mode_t, security_descriptor &);
|
|
int __reg3 set_object_sd (HANDLE, security_descriptor &, bool);
|
|
|
|
int __reg3 get_reg_attribute (HKEY hkey, mode_t *, uid_t *, gid_t *);
|
|
LONG __reg3 get_file_sd (HANDLE fh, path_conv &, security_descriptor &, bool);
|
|
LONG __reg3 set_file_sd (HANDLE fh, path_conv &, security_descriptor &, bool);
|
|
bool __reg3 add_access_allowed_ace (PACL, int, DWORD, PSID, size_t &, DWORD);
|
|
bool __reg3 add_access_denied_ace (PACL, int, DWORD, PSID, size_t &, DWORD);
|
|
int __reg3 check_file_access (path_conv &, int, bool);
|
|
int __reg3 check_registry_access (HANDLE, int, bool);
|
|
|
|
void set_security_attribute (path_conv &pc, int attribute,
|
|
PSECURITY_ATTRIBUTES psa,
|
|
security_descriptor &sd_buf);
|
|
|
|
bool get_sids_info (cygpsid, cygpsid, uid_t * , gid_t *);
|
|
|
|
/* sec_acl.cc */
|
|
struct acl;
|
|
extern "C" int aclsort32 (int, int, struct acl *);
|
|
extern "C" int acl32 (const char *, int, int, struct acl *);
|
|
int getacl (HANDLE, path_conv &, int, struct acl *);
|
|
int setacl (HANDLE, path_conv &, int, struct acl *, bool &);
|
|
|
|
/* Set impersonation or restricted token. */
|
|
void set_imp_token (HANDLE token, int type);
|
|
/* Function creating a token by calling NtCreateToken. */
|
|
HANDLE create_token (cygsid &usersid, user_groups &groups, struct passwd * pw);
|
|
/* LSA authentication function. */
|
|
HANDLE lsaauth (cygsid &, user_groups &, struct passwd *);
|
|
/* LSA private key storage authentication, same as when using service logons. */
|
|
HANDLE lsaprivkeyauth (struct passwd *pw);
|
|
/* Verify an existing token */
|
|
bool verify_token (HANDLE token, cygsid &usersid, user_groups &groups, bool *pintern = NULL);
|
|
/* Get groups of a user */
|
|
bool get_server_groups (cygsidlist &grp_list, PSID usersid, struct passwd *pw);
|
|
|
|
/* Extract U-domain\user field from passwd entry. */
|
|
void extract_nt_dom_user (const struct passwd *pw, PWCHAR domain, PWCHAR user);
|
|
/* Get default logonserver for a domain. */
|
|
bool get_logon_server (PWCHAR domain, PWCHAR wserver, bool rediscovery);
|
|
|
|
HANDLE lsa_open_policy (PWCHAR server, ACCESS_MASK access);
|
|
void lsa_close_policy (HANDLE lsa);
|
|
|
|
/* sec_helper.cc: Security helper functions. */
|
|
int set_privilege (HANDLE token, DWORD privilege, bool enable);
|
|
void set_cygwin_privileges (HANDLE token);
|
|
|
|
#define _push_thread_privilege(_priv, _val, _check) { \
|
|
HANDLE _dup_token = NULL; \
|
|
HANDLE _token = (cygheap->user.issetuid () && (_check)) \
|
|
? cygheap->user.primary_token () : hProcToken; \
|
|
if (!DuplicateTokenEx (_token, MAXIMUM_ALLOWED, NULL, \
|
|
SecurityImpersonation, TokenImpersonation, \
|
|
&_dup_token)) \
|
|
debug_printf ("DuplicateTokenEx: %E"); \
|
|
else if (!ImpersonateLoggedOnUser (_dup_token)) \
|
|
debug_printf ("ImpersonateLoggedOnUser: %E"); \
|
|
else \
|
|
set_privilege (_dup_token, (_priv), (_val));
|
|
|
|
#define push_thread_privilege(_priv, _val) _push_thread_privilege(_priv,_val,1)
|
|
#define push_self_privilege(_priv, _val) _push_thread_privilege(_priv,_val,0)
|
|
|
|
#define pop_thread_privilege() \
|
|
if (_dup_token) \
|
|
{ \
|
|
if (!cygheap->user.issetuid ()) \
|
|
RevertToSelf (); \
|
|
else \
|
|
cygheap->user.reimpersonate (); \
|
|
CloseHandle (_dup_token); \
|
|
} \
|
|
}
|
|
|
|
#define pop_self_privilege() pop_thread_privilege()
|
|
|
|
/* shared.cc: */
|
|
|
|
/* Various types of security attributes for use in Create* functions. */
|
|
extern SECURITY_ATTRIBUTES sec_none, sec_none_nih, sec_all, sec_all_nih;
|
|
extern SECURITY_ATTRIBUTES *__reg3 __sec_user (PVOID, PSID, PSID,
|
|
DWORD, BOOL);
|
|
|
|
extern PSECURITY_DESCRIPTOR _recycler_sd (void *buf, bool users, bool dir);
|
|
#define recycler_sd(users,dir) \
|
|
(_recycler_sd (alloca (sizeof (SECURITY_DESCRIPTOR) + MAX_DACL_LEN (3)), \
|
|
(users), \
|
|
(dir)))
|
|
|
|
extern PSECURITY_DESCRIPTOR _everyone_sd (void *buf, ACCESS_MASK access);
|
|
#define everyone_sd(access) (_everyone_sd (alloca (SD_MIN_SIZE), (access)))
|
|
|
|
#define sec_none_cloexec(f) (((f) & O_CLOEXEC ? &sec_none_nih : &sec_none))
|
|
|
|
extern bool sec_acl (PACL acl, bool original, bool admins, PSID sid1 = NO_SID,
|
|
PSID sid2 = NO_SID, DWORD access2 = 0);
|
|
|
|
ssize_t __reg3 read_ea (HANDLE, path_conv &, const char *,
|
|
char *, size_t);
|
|
int __reg3 write_ea (HANDLE, path_conv &, const char *, const char *,
|
|
size_t, int);
|
|
|
|
/* Note: sid1 is usually (read: currently always) the current user's
|
|
effective sid (cygheap->user.sid ()). */
|
|
extern inline SECURITY_ATTRIBUTES *
|
|
sec_user_nih (SECURITY_ATTRIBUTES *sa_buf, PSID sid1, PSID sid2 = NULL,
|
|
DWORD access2 = 0)
|
|
{
|
|
return __sec_user (sa_buf, sid1, sid2, access2, FALSE);
|
|
}
|
|
|
|
extern inline SECURITY_ATTRIBUTES *
|
|
sec_user (SECURITY_ATTRIBUTES *sa_buf, PSID sid1, PSID sid2 = NULL,
|
|
DWORD access2 = 0)
|
|
{
|
|
return __sec_user (sa_buf, sid1, sid2, access2, TRUE);
|
|
}
|