♧ Godown 安全知识树

GetAsyncKeyState 轮询式键盘记录:遍历虚拟键码读取 0x01 按下标志捕获击键

pentest/c2 · verified

一句话结论

GetAsyncKeyState 轮询是最简单的 Windows 用户态键盘记录:以远小于 1 秒的间隔遍历虚拟键码 1..255,把返回值低位 0x01(自上次调用以来该键被按下过)作为触发条件记录按键,无需钩子或驱动即可重建击键序列。

原理

  • Windows 在会话内维护每个键的异步按键状态,任何进程都可以对任意虚拟键码调用 GetAsyncKeyState(vKey):最低位 0x0001 表示自上次查询以来该键被按下过,最高位 0x8000 表示当前仍处于按下状态。
  • 键盘记录器循环遍历全部虚拟键码,只检查 & 0x01,命中即记录(原文示例写入 log.txt),每轮 Sleep(50) 控制轮询频率;不需要窗口、焦点或钩子,后台进程同样能读到整个会话的按键。
  • 该 API 返回的是键状态而非字符,攻击者需自行完成虚拟键码到字符的映射(处理 Shift/CapsLock 与键盘布局)。它是经典且至今仍被恶意软件使用的轮询式键盘记录方法。

触发条件

  • 恶意程序以普通用户权限运行在受害者的交互式会话中(与目标桌面同一会话即可,无需管理员权限)。
  • 目标未禁用/未监控该 API,EDR/AV 没有拦截进程。
  • 攻击者自行实现键码映射、日志落盘与外传。

利用步骤

  1. 在植入体/RAT 插件中创建轮询线程,循环 key = 1..255 调用 GetAsyncKeyState 并 Sleep(50)。
  2. 命中 & 0x01 时记录虚拟键码,可同时记录前台窗口标题、进程名与时间戳,便于还原输入上下文。
  3. 在内存中做简单映射/加密后定期落盘,或经 C2 通道外传。

PoC

原文示意代码(SaveTheKey 未实现,原文注明仅用于说明、不打算按原样执行;本卡未在本机执行):

while (true)
{
    for (int key = 1; key <= 255; key++)
    {
        if (GetAsyncKeyState(key) & 0x01)
        {
            SaveTheKey(key, "log.txt");
        }
    }
    Sleep(50);
}

变体与关联

  • 可与低级键盘钩子组合:钩子实时捕获为主,轮询作为钩子被卸载/失败后的兜底;也可与 Raw Input、DirectInput 等方式互为补充。
  • 边界:用户态键盘记录无法捕获 UAC 安全桌面/登录界面的输入;高频全键码轮询在 API 遥测中特征明显。
  • 关联:同文章拆分的 [[pentest-c2-keylogger-setwindowshookex-wh-keyboard-ll]]、[[pentest-c2-keylogger-rawinput-registerrawinputdevices]]、[[pentest-c2-keylogger-directinput-getdevicestate]];检测侧 [[defense-detection-etw-keylogger-api-behavior]];真实样本取证 [[defense-forensics-snake-keylogger-stealer-collection-exfil-channels]]。

检测与防御

  • 检测:Elastic Defend 8.12+ 通过 ETW 监控 GetAsyncKeyState 调用,可用 process.Ext.api.metadata.ms_since_last_keyevent(距上次按键事件的毫秒数,轮询循环中极小)与 background_callcount(两次成功调用之间的总调用次数,原文示例 6021)识别“短间隔遍历全部虚拟键码”的节奏;对应规则 “GetAsyncKeyState API Call from Suspicious Process”“GetAsyncKeyState API Call from Unusual Process”,再结合进程签名、路径、持久化与外传行为关联判断。
  • 防御:部署带 API 行为遥测的 EDR 并启用上述规则;应用白名单/签名强制;限制来源不明程序运行;对告警主机及时排查凭据是否已泄露并改密。