♧ Godown 安全知识树

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 获取按键状态时,RegisterRawInputDevices API 在后台被调用,因此它本质上是 Raw Input 的另一种使用路径,检测时同样会落到输入 API 遥测上。

触发条件

  • 需要窗口句柄 hwndMain;DISCL_FOREGROUND 使采集仅在该窗口处于前台时有效。
  • 以普通用户权限运行在同一交互式会话;目标系统具备 DirectInput(dinput8)运行环境。
  • 前台切换/失焦会导致 GetDeviceState 失败,需要 Acquire 重试;EDR 未拦截。

利用步骤

  1. 创建窗口并保存 hwndMain,按上述顺序初始化 IDirectInput8 与键盘设备、设置数据格式和协作级别。
  2. 启动采集循环:GetDeviceState(sizeof(key), key),失败则 Acquire() 后重读;按扫描码映射记录按键,Sleep(50)。
  3. 日志加密后落盘或经 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 相关规则;应用白名单与签名强制;对游戏/输入类合法软件建立白名单;告警后按凭据泄露处置。