PowerSploit 提权侦察利器:Get-ProcessTokenGroup 进程令牌组成员枚举实战指南
PowerSploit 提权侦察利器:Get-ProcessTokenGroup 进程令牌组成员枚举实战指南
导读
Get-ProcessTokenGroup 是 PowerSploit 框架 Privesc 模块(PowerUp)中用于枚举 Windows 进程访问令牌(Access Token)组信息的核心函数,它能够返回当前进程或指定进程令牌上下文所属的全部 SID(安全标识符),无论这些组处于启用还是禁用状态。本文以 docs/Privesc/Get-ProcessTokenGroup.md 为骨架,结合 Privesc/PowerUp.ps1 源码实现与 Tests/Privesc.tests.ps1 测试用例,完整讲解其语法、参数、输出对象、底层 Win32 API 调用链以及属性标志位语义,帮助你在本地提权(Privilege Escalation)侦察中快速判断当前令牌是否具备管理员组、完整性级别等关键信息。
功能定位:Token 上下文侦察在提权中的价值
在 Windows 权限提升场景中,攻击者首先需要回答一个问题:当前进程令牌到底属于哪些组? 尤其是在 UAC(用户账户控制)环境下,进程令牌可能存在"过滤后的管理员令牌"(filtered admin token)与完整管理员令牌之分;SE_GROUP_USE_FOR_DENY_ONLY 属性的组虽然出现在令牌中,却仅用于拒绝访问判断。因此,仅仅知道"我是谁"是不够的,还需要知道"我的令牌携带了哪些 SID、哪些被禁用"。
Get-ProcessTokenGroup 正是为此设计:它枚举令牌上下文中的全部 SID(无论禁用与否),并附带每个组的属性标志位,为后续判断服务 ACL、注册表 ACL、文件权限等是否可被当前令牌访问提供依据。在 Privesc/README.md 中,它与 Get-ProcessTokenPrivilege、Enable-Privilege 一起被归类为 "Token/Privilege Enumeration/Abuse" 侦察工具族。
函数语法与参数详解
函数声明位于 Privesc/PowerUp.ps1#L1116-L1193,其命令语法为:
Get-ProcessTokenGroup [[-Id] <UInt32>]
-Id 参数
| 属性 | 值 |
|---|---|
| 类型 | UInt32 |
| 参数集 | (All) |
| 别名 | ProcessID |
| 是否必填 | 否 |
| 位置 | 1 |
| 默认值 | 0(即当前进程) |
| 接受管道输入 | 是(ByPropertyName, ByValue) |
| 接受通配符 | 否 |
- 指定进程 ID:函数会通过
OpenProcess()打开该进程;若打开失败(句柄为 0),会通过Write-Warning输出Win32Exception错误信息。 - 未指定(默认):通过
GetCurrentProcess()获取当前进程的伪句柄(pseudohandle),并以$PID作为进程标识。源码注释明确指出伪句柄"无需担心关闭"(见 Privesc/PowerUp.ps1#L1205-L1209)。 - 句柄管理:仅当通过
OpenProcess()打开外部进程时,函数才会在结束时调用CloseHandle()关闭句柄(Privesc/PowerUp.ps1#L1227-L1230),避免句柄泄漏。
参数上声明了 [ValidateNotNullOrEmpty()] 校验,并且支持通过管道按属性名(ProcessID)或按值传递,因此可以与 Get-Process 无缝衔接。
使用示例与输出解读
示例 1:枚举当前进程令牌组
Get-ProcessTokenGroup
输出(节选,列宽已折叠):
SID Attributes ProcessId
--- ---------- ---------
S-1-5-21-890171859-3433809... ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-1-0 ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-5-32-544 SE_GROUP_USE_FOR_DENY_ONLY 1372
S-1-5-32-545 ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-5-4 ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-2-1 ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-5-11 ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-5-15 ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-5-5-0-419601 ...SE_GROUP_INTEGRITY_ENABLED 1372
S-1-2-0 ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-18-1 ..._DEFAULT, SE_GROUP_ENABLED 1372
S-1-16-8192 1372
示例 2:通过管道传入进程对象
Get-Process notepad | Get-ProcessTokenGroup
输出(节选,ProcessId 变为 notepad 的 PID,如 2640):
SID Attributes ProcessId
--- ---------- ---------
S-1-5-21-890171859-3433809... ..._DEFAULT, SE_GROUP_ENABLED 2640
S-1-5-32-544 SE_GROUP_USE_FOR_DENY_ONLY 2640
S-1-16-8192 2640
如何读懂输出
- SID 列:
S-1-5-32-544是本地 Administrators 组,S-1-5-32-545是 Users 组,S-1-1-0是 Everyone,S-1-5-11是 Authenticated Users,S-1-16-8192(0x2000)是 Medium 完整性级别,S-1-16-12288(0x3000)是 High 完整性级别(见源码示例 Privesc/PowerUp.ps1#L1154-L1155)。 - Attributes 列:以逗号分隔的属性标志位,参见下文枚举表。
- ProcessId 列:由
Get-ProcessTokenGroup在枚举结果上通过Add-Member动态追加的备注属性(Privesc/PowerUp.ps1#L1218-L1221),便于多进程管道输出时追溯来源。
输出对象:PowerUp.TokenGroup
函数声明 <a href="https://link.gitcode.com/i/4b95e7a9701c47a6997deebe9c157207" target="_blank">OutputType('PowerUp.TokenGroup')],每个枚举出的组都是一个自定义 PSObject,通过 $GroupSid.PSObject.TypeNames.Insert(0, 'PowerUp.TokenGroup') 注入类型名([Privesc/PowerUp.ps1#L1032),包含以下属性:
| 属性 | 含义 |
|---|---|
| SID | 转换后的 SID 字符串(如 S-1-5-32-544) |
| Attributes | 组的属性标志位,以 PowerUp.SidAttributes 枚举呈现 |
| TokenHandle | 查询所用令牌句柄(IntPtr) |
| ProcessId | 来源进程 ID(由 Get-ProcessTokenGroup 附加) |
配套的 Get-ProcessTokenPrivilege 与 Get-ProcessTokenType 则分别输出 PowerUp.TokenPrivilege(特权名/属性)与 PowerUp.TokenType(令牌类型与模拟级别),三者共用同一套底层实现。
底层原理:完整的 Win32 API 调用链
Get-ProcessTokenGroup 本身是一个薄封装,真正的数据查询工作由内部辅助函数 Get-TokenInformation(Privesc/PowerUp.ps1#L936-L1113)完成。完整调用链如下:
- 打开进程:有
-Id时调用Kernel32::OpenProcess(0x400 /* PROCESS_QUERY_INFORMATION */, $False, $Id);否则调用Kernel32::GetCurrentProcess()。 - 打开进程令牌:调用
Advapi32::OpenProcessToken($ProcessHandle, 0x0008 /* TOKEN_QUERY */, <a href="https://link.gitcode.com/i/4478c18566ab4edb53509fca22110e87" target="_blank">ref]$hProcToken),以最小权限TOKEN_QUERY获取令牌句柄([Privesc/PowerUp.ps1#L1212-L1214)。 - 两段式查询缓冲:
Get-TokenInformation先将TOKEN_INFORMATION_CLASS = 2(即TokenGroups)传给Advapi32::GetTokenInformation,第一次调用以长度 0 查询所需缓冲区大小,再用Marshal::AllocHGlobal分配内存后第二次调用获取完整TOKEN_GROUPS结构(Privesc/PowerUp.ps1#L1008-L1013)。 - 逐组转换 SID:遍历
TokenGroups.GroupCount个组,对每个组的SID字段调用Advapi32::ConvertSidToStringSid()转换为可读字符串;转换失败仅输出 Verbose 信息(Privesc/PowerUp.ps1#L1020-L1025)。 - 内存释放:查询结束后调用
Marshal::FreeHGlobal释放缓冲区(Privesc/PowerUp.ps1#L1041)。
支撑数据结构与枚举(PSReflect 内联定义)
PowerUp.ps1 内嵌了 PSReflect 的内存模块定义(Privesc/PowerUp.ps1#L16-L22 标注其来源为 @mattifestation 的 PSReflect),本文涉及的关键定义位于文件末尾:
SID_AND_ATTRIBUTES结构:Sid(IntPtr)与Attributes(UInt32),见 Privesc/PowerUp.ps1#L4938-L4941;TOKEN_GROUPS结构:GroupCount(UInt32)与定长 32 的Groups数组,见 Privesc/PowerUp.ps1#L4963-L4966;PowerUp.SidAttributes位标志枚举,见 Privesc/PowerUp.ps1#L4881-L4890。
Attributes 属性标志位(SidAttributes 枚举)
| 标志位 | 值 | 含义 |
|---|---|---|
| SE_GROUP_MANDATORY | 0x00000001 | 该组为强制组,无法从令牌中移除 |
| SE_GROUP_ENABLED_BY_DEFAULT | 0x00000002 | 组默认处于启用状态 |
| SE_GROUP_ENABLED | 0x00000004 | 组当前处于启用状态,可用于访问检查 |
| SE_GROUP_OWNER | 0x00000008 | 该 SID 是令牌的所有者 |
| SE_GROUP_USE_FOR_DENY_ONLY | 0x00000010 | 组仅用于拒绝访问(Deny-Only),典型如 UAC 过滤后的管理员组 |
| SE_GROUP_INTEGRITY | 0x00000020 | 组用于完整性级别(Integrity Level) |
| SE_GROUP_RESOURCE | 0x20000000 | 组用于域本地组的本地化 |
| SE_GROUP_INTEGRITY_ENABLED | 0xC0000000 | 完整性级别组已启用 |
提权侦察要点:当输出中出现
S-1-5-32-544(本地管理员)但 Attributes 为SE_GROUP_USE_FOR_DENY_ONLY时,说明当前进程运行在 UAC 过滤后的受限管理员令牌下,直接进行管理员权限操作前往往需要配合 UAC 绕过手段(PowerUp 中的Invoke-WScriptUACBypass即属此类场景)。
测试用例验证
Tests/Privesc.tests.ps1#L130-L175 为该函数提供了 Pester 测试覆盖,从侧面印证了其行为契约:
- 运行前提:测试脚本要求本地管理员权限,否则直接
Throw; - 不抛异常:
{Get-ProcessTokenGroup} | Should Not Throw; - 字段完整性:返回对象必须包含
SID、Attributes、ProcessID三个属性; - 管道支持:
Get-Process -Id $PID | Get-ProcessTokenGroup应返回非空结果; - 多对象管道:连续传入两个相同进程对象,应能返回两条以上包含
S-1-5-32-544的结果; - 语义正确性:当前用户的 SID 列表必须包含本地管理员组
S-1-5-32-544。
安装、导入与命令发现
Get-ProcessTokenGroup 随 Privesc 模块分发,该模块的加载逻辑非常简洁——Privesc/Privesc.psm1 仅一行:遍历同目录下所有 .ps1 文件并逐个点源(dot-source),因此 PowerUp.ps1 中的函数会直接暴露到会话中。
按 Privesc/README.md 的说明:
- 将整个
Privesc目录放入$Env:PSModulePath中的任一模块目录(默认用户级路径为$Env:HomeDrive$Env:HOMEPATH\Documents\WindowsPowerShell\Modules,计算机级为$Env:windir\System32\WindowsPowerShell\v1.0\Modules); - 执行
Import-Module Privesc; - 用
Get-Command -Module Privesc查看已导入的命令; - 也可按文档提示通过
Get-Help Get-ProcessTokenGroup获取内联帮助(该帮助以注释形式完整存在于 Privesc/PowerUp.ps1#L1117-L1182)。
此外,所有 PowerUp 工具都被设计为可单独运行(dot-source 单个 .ps1 文件即可),便于在内存中直接加载而不落地文件。
实战建议与注意事项
- 权限要求:查询外部进程令牌需要
PROCESS_QUERY_INFORMATION权限(源码使用 0x400 访问标志);查询当前进程则无需额外权限。对高权限进程执行时可能因访问被拒而收到 Win32 错误警告。 - 与兄弟命令配合:将
Get-ProcessTokenGroup(组成员)与Get-ProcessTokenPrivilege(权限,如 SeDebugPrivilege 等管理员级特权)、Get-ProcessTokenType(令牌类型/模拟级别)三者组合,即可对当前令牌形成完整画像;若发现特权被禁用,可进一步使用Enable-Privilege(docs/Privesc/Enable-Privilege.md)尝试启用。 - 输出过滤:管道输出为流式对象,可直接用
Where-Object {$_.SID -eq 'S-1-5-32-544'}或Select-Object -ExpandProperty SID提取关键 SID,便于编写自动化判定逻辑。 - 仅限 Windows 环境:该命令依赖 Win32 API 与 PowerShell,仅在 Windows 主机上可用,是 PowerSploit 提权侦察(Privesc)模块的组成部分,使用前请确保已获得合法授权。