access token
access token
訪問令牌(Access Tokens)是Windows操作系統安全性的一個概念。當用戶登陸時，系統創建一個訪問令牌，裡面包含登錄進程返回的SID和由本地安全策略分配給用戶和用戶的安全組的特權列表。以該用戶身份運行的的所有進程都擁有該令牌的一個拷貝。系統使用令牌控制用戶可以訪問哪些安全對象，並控制用戶執行相關係統操作的能力。
進程擁有某種令牌就表示它擁有某種特權。什麼是特權呢？特權是指用戶進程進行各種系統操作的權利。如：關機，載入設備驅動程序，改變系統時間也是一種特權。可以對用戶或用戶所在的組授予特權。見圖。
WinNT定義的特權
在WinNT.h頭文件中定義了這些特權的名稱：
#define SE_CREATE_TOKEN_NAME TEXT("SeCreateTokenPrivilege")
#define SE_ASSIGNPRIMARYTOKEN_NAME TEXT("SeAssignPrimaryTokenPrivilege")
#define SE_LOCK_MEMORY_NAME TEXT("SeLockMemoryPrivilege")
#define SE_INCREASE_QUOTA_NAME TEXT("SeIncreaseQuotaPrivilege")
#define SE_UNSOLICITED_INPUT_NAME TEXT("SeUnsolicitedInputPrivilege")
#define SE_MACHINE_ACCOUNT_NAME TEXT("SeMachineAccountPrivilege")
#define SE_TCB_NAME TEXT("SeTcbPrivilege")
#define SE_SECURITY_NAME TEXT("SeSecurityPrivilege")
#define SE_TAKE_OWNERSHIP_NAME TEXT("SeTakeOwnershipPrivilege")
#define SE_LOAD_DRIVER_NAME TEXT("SeLoadDriverPrivilege")
#define SE_SYSTEM_PROFILE_NAME TEXT("SeSystemProfilePrivilege")
#define SE_SYSTEMTIME_NAME TEXT("SeSystemtimePrivilege")
#define SE_PROF_SINGLE_PROCESS_NAME TEXT("SeProfileSingleProcessPrivilege")
#define SE_INC_BASE_PRIORITY_NAME TEXT("SeIncreaseBasePriorityPrivilege")
#define SE_CREATE_PAGEFILE_NAME TEXT("SeCreatePagefilePrivilege")
#define SE_CREATE_PERMANENT_NAME TEXT("SeCreatePermanentPrivilege")
#define SE_BACKUP_NAME TEXT("SeBackupPrivilege")
#define SE_RESTORE_NAME TEXT("SeRestorePrivilege")
#define SE_SHUTDOWN_NAME TEXT("SeShutdownPrivilege")
#define SE_DEBUG_NAME TEXT("SeDebugPrivilege")
#define SE_AUDIT_NAME TEXT("SeAuditPrivilege")
#define SE_SYSTEM_ENVIRONMENT_NAME TEXT("SeSystemEnvironmentPrivilege")
#define SE_CHANGE_NOTIFY_NAME TEXT("SeChangeNotifyPrivilege")
#define SE_REMOTE_SHUTDOWN_NAME TEXT("SeRemoteShutdownPrivilege")
#define SE_UNDOCK_NAME TEXT("SeUndockPrivilege")
#define SE_SYNC_AGENT_NAME TEXT("SeSyncAgentPrivilege")
#define SE_ENABLE_DELEGATION_NAME TEXT("SeEnableDelegationPrivilege")
#define SE_MANAGE_VOLUME_NAME TEXT("SeManageVolumePrivilege")
#define SE_IMPERSONATE_NAME TEXT("SeImpersonatePrivilege")
#define SE_CREATE_GLOBAL_NAME TEXT("SeCreateGlobalPrivilege")
#define SE_TRUSTED_CREDMAN_ACCESS_NAME TEXT("SeTrustedCredManAccessPrivilege")
#define SE_RELABEL_NAME TEXT("SeRelabelPrivilege")
#define SE_INC_WORKING_SET_NAME TEXT("SeIncreaseWorkingSetPrivilege")
#define SE_TIME_ZONE_NAME TEXT("SeTimeZonePrivilege")
#define SE_CREATE_SYMBOLIC_LINK_NAME TEXT("SeCreateSymbolicLinkPrivilege")
通過API函數OpenProcessToken 取得進程令牌。其定義如下：
BOOL WINAPIOpenProcessToken(
__in HANDLEProcessHandle, //進程句柄。通過GetCurrentProcess函數取得當前進程句柄
__in DWORDDesiredAccess, //要對令牌進行何種操作。如TOKEN_ADJUST_PRIVILEGES用於調整許可權
__out PHANDLETokenHandle //進程令牌句柄
);
如下代碼取得進程的令牌，並告訴系統我們想調整令牌的許可權
HANDLE hToken;
if (OpenProcessToken(GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES,
&hToken)) {
......
}
| Value | Meaning |
| TOKEN_ADJUST_DEFAULT | 改變令牌所有者、主組或訪問控制列表DACL |
| TOKEN_ADJUST_GROUPS | 改變令牌的組屬性 |
| TOKEN_ADJUST_PRIVILEGES | enable or disable 令牌的特權 |
| TOKEN_ADJUST_SESSIONID | 調整令牌的Session ID。進程需要 SE_TCB_NAME 特權. |
| TOKEN_ASSIGN_PRIMARY | 為進程分配主令牌。需要 SE_ASSIGNPRIMARYTOKEN_NAME 特權 |
| TOKEN_DUPLICATE | 複製令牌 |
| TOKEN_EXECUTE | 合併 STANDARD_RIGHTS_EXECUTE 和 TOKEN_IMPERSONATE. |
| TOKEN_IMPERSONATE | 附加一個模擬令牌到進程 |
| TOKEN_QUERY | 查詢令牌 |
| TOKEN_QUERY_SOURCE | 查詢令牌源 |
| TOKEN_READ | 合併 STANDARD_RIGHTS_READ 和TOKEN_QUERY. |
| TOKEN_WRITE | 合併 STANDARD_RIGHTS_WRITE, TOKEN_ADJUST_PRIVILEGES, TOKEN_ADJUST_GROUPS, 和 TOKEN_ADJUST_DEFAULT. |
| TOKEN_ALL_ACCESS | 合併所有可能的操作 |
TOKEN_PRIVILEGES令牌特權結構體，該結構體定義了訪問令牌所擁有的一系列特權。其原型定義如下：
typedef struct_TOKEN_PRIVILEGES {
DWORDPrivilegeCount; //特權數量（數組的長度)
LUID_AND_ATTRIBUTESPrivileges[ANYSIZE_ARRAY]; //特權數組
}TOKEN_PRIVILEGES, *PTOKEN_PRIVILEGES;
其中，Privileges數組類型為LUID_AND_ATTRIBUTES結構體，其原型定義如下：
typedef struct _LUID_AND_ATTRIBUTES {
LUID Luid; //局部唯一標識符，代表某種特權的Value
DWORD Attributes; //Luid的屬性，代表特權的屬性（Enabled or Disabled）
}LUID_AND_ATTRIBUTES, *PLUID_AND_ATTRIBUTES;
其特權屬性Attributes可以是如下常量：
| 值 | 含義 |
| SE_PRIVILEGE_ENABLED | 使特權有效 |
| SE_PRIVILEGE_ENABLED_BY_DEFAULT | 使特權默認有效 |
| SE_PRIVILEGE_REMOVED | 移除該特權 |
| SE_PRIVILEGE_USED_FOR_ACCESS | 取得對象或服務的訪問權 |
取得特權的LUID值
首先通過LookupPrivilegeValue函數取得某種特權的LUID，通過特權的名稱查找特權的LUID。
BOOL WINAPILookupPrivilegeValue(
__in_opt LPCTSTR lpSystemName, //特權所在的系統名稱，NULL表示本地系統
__in LPCTSTR lpName, //特權名稱，在WInNT.h 中定義的特權名稱
__out PLUID lpLuid //取得的特權的LUID
);
如下代碼取得SE_DEBUG_NAME特權的LUID，並將特權屬性設為SE_PRIVILEGE_ENABLED
TOKEN_PRIVILEGES tp;
tp.PrivilegeCount = 1;
LookupPrivilegeValue(NULL, SE_DEBUG_NAME, &tp.Privileges[0].Luid);
tp.Privileges[0].Attributes =SE_PRIVILEGE_ENABLED;
調整令牌特權
AdjustTokenPrivileges函數可以調整令牌的特權。函數定義如下：
BOOL WINAPI AdjustTokenPrivileges(
__in HANDLE TokenHandle, //令牌句柄
__in BOOL DisableAllPrivileges, //是否禁用所有特權，如為TRUE，則忽略NewState參數
__in_opt PTOKEN_PRIVILEGES NewState,//調整為NewState結構定義的特權
__in DWORD BufferLength, //PreviousState 參數的位元組大小
__out_opt PTOKEN_PRIVILEGES PreviousState, 可選，調整之前的TOKEN_PRIVILEGES結構體指針
__out_opt PDWORD ReturnLength //可選，返回的結構體的長度
);
//調用
AdjustTokenPrivileges(hToken, FALSE, &tp, sizeof(tp), NULL, NULL);
主令牌是由windows內核創建並分配給進程的默認訪問令牌。