♧ Godown 安全知识树

SetWindowsHookEx(WH_KEYBOARD_LL) 低级键盘钩子键盘记录:按键在投递目标应用前被截获

pentest/c2 · verified

一句话结论

SetWindowsHookEx(WH_KEYBOARD_LL, hookProc, hMod, 0) 安装全局低级键盘钩子,系统在每条键盘消息派发到目标线程前调用钩子过程,因此可在按键到达应用前实时记录击键,是比轮询更直接的经典用户态键盘记录方式。

原理

  • 钩子是 Windows 允许程序把自定义处理插入到特定事件处理链的机制;WH_KEYBOARD_LL 是低级键盘钩子,监视进入线程输入队列的键盘消息,dwThreadId 传 0 表示钩住整个桌面的所有线程。
  • 低级钩子的回调在安装钩子的进程上下文中被调用,所以钩子过程可以只是进程内的一个函数;原文用 LoadLibraryW(L"hook.dll") 加载包含钩子过程的 DLL、GetProcAddress 取 SaveTheKey 地址强转为 HOOKPROC,再把模块句柄 hHookLibrary 作为 hMod 传入。
  • 由于回调发生在按键投递给目标应用之前,记录者能在输入进入目标窗口前拿到每一次按键(含组合键)。

触发条件

  • 以受害用户身份运行在与目标相同的交互式会话中;安装全局钩子需要桌面访问权限(普通用户权限即可)。
  • 需要一个可加载模块(DLL)及导出函数提供钩子过程;安装线程必须保持消息循环,钩子回调才会被分发。
  • EDR/AV 未拦截 SetWindowsHookEx 的 WH_KEYBOARD_LL 调用。

利用步骤

  1. 准备包含钩子过程(如 SaveTheKey)的 DLL,或把钩子过程放进将被加载的模块。
  2. LoadLibraryW + GetProcAddress 取得钩子过程地址,调用 SetWindowsHookEx(WH_KEYBOARD_LL, hookProc, hModule, 0) 安装全局钩子。
  3. 在钩子过程中记录按键并保持消息循环;日志加密后落盘或经 C2 通道外传。

PoC

原文示意代码(未在本机执行):

HMODULE hHookLibrary = LoadLibraryW(L"hook.dll");
FARPROC hookFunc = GetProcAddress(hHookLibrary, "SaveTheKey");

HHOOK keyboardHook = NULL;

keyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL,
                (HOOKPROC)hookFunc,
                hHookLibrary,
                0);

变体与关联

  • 钩子类型可换:WH_KEYBOARD 需要在 DLL 中实现钩子过程并让其被目标线程加载,WH_KEYBOARD_LL 无需注入目标进程、在安装者上下文回调,是恶意软件更常用的选择;WH_GETMESSAGE 等钩子还可被滥用于本地代码执行([[pentest-c2-local-shellcode-exec-callback-fiber-hook]]),与击键采集目的不同。
  • 边界:用户态钩子无法捕获 UAC 安全桌面/登录界面的输入;hook_type=WH_KEYBOARD_LL、钩子模块未签名或位于用户可写目录是强检测特征。
  • 关联:同文章拆分的 [[pentest-c2-keylogger-getasynckeystate-polling]]、[[pentest-c2-keylogger-rawinput-registerrawinputdevices]]、[[pentest-c2-keylogger-directinput-getdevicestate]];检测卡 [[defense-detection-etw-keylogger-api-behavior]];真实 Snake Keylogger 用钩子采集并外传的取证见 [[defense-forensics-snake-keylogger-stealer-collection-exfil-channels]]。

检测与防御

  • 检测:Elastic Defend 8.12+ 的 ETW 遥测记录 SetWindowsHookEx 的 process.Ext.api.parameters.hook_type(如 WH_KEYBOARD_LL)、parameters.hook_module(钩子 DLL 路径)、parameters.procedure(钩子过程地址)与 metadata.procedure_symbol;规则 “Keystroke Messages Hooking via SetWindowsHookEx”“Keystrokes Input Capture via SetWindowsHookEx” 及其 from Managed Application/Unsigned DLL/Suspicious CallStack 衍生规则覆盖未签名、托管、可疑调用栈变体,可结合模块签名与路径排查。
  • 防御:启用 API 行为遥测与上述规则;强制模块签名、禁止未签名 DLL 加载;对远程支持/输入法等合法钩子建立白名单并审计;发现告警后按凭据泄露处置(改密、吊销会话)。