IoTHackBot

开源物联网安全测试工具包，集成Claude Code技能，用于自动化漏洞发现。

概述

IoTHackBot是一套专为物联网设备、IP摄像头和嵌入式系统安全测试设计的工具集合及Claude Code技能。它提供命令行工具和AI辅助工作流，支持全面的物联网安全评估。

包含工具

网络发现与侦察

• wsdiscovery - WS-Discovery协议扫描器，用于发现ONVIF摄像头和物联网设备
• iotnet - 物联网网络流量分析器，用于检测协议和漏洞
• netflows - 从pcap文件中提取网络流并解析DNS主机名
• nmap（技能） - 采用两阶段扫描策略的专业网络侦察工具

设备特定测试

• onvifscan - ONVIF设备安全扫描器
  • 认证绕过测试
  • 凭据暴力破解

固件与文件分析

• chipsec（技能） - UEFI/BIOS固件静态分析

  • 检测已知rootkit（LoJax、ThinkPwn、HackingTeam）
  • 生成包含哈希值的EFI可执行文件清单
  • 解码固件结构并提取NVRAM

• ffind - 高级文件查找工具，具备类型检测和文件系统提取功能

  • 识别各类文件类型
  • 提取ext2/3/4和F2FS文件系统
  • 专为固件分析设计

安卓分析

• apktool（技能） - APK反编译与资源提取

  • 解码AndroidManifest.xml
  • 提取资源、布局和字符串
  • 反汇编为smali代码

• jadx（技能） - APK反编译

  • 将DEX转换为可读的Java源代码
  • 搜索硬编码凭证
  • 分析应用逻辑

硬件与控制台访问

• picocom（技能） - 物联网UART控制台交互，用于硬件测试

  • Bootloader操作
  • Shell枚举
  • 固件提取
  • 包含用于自动化交互的Python辅助脚本

• telnetshell（技能） - 物联网Telnet shell交互

  • 未认证Shell测试
  • 设备枚举
  • BusyBox命令处理
  • 包含Python辅助脚本和预建的枚举脚本

安装

先决条件

# Python依赖
pip install colorama pyserial pexpect requests

# 系统依赖（Arch Linux）
sudo pacman -S nmap e2fsprogs f2fs-tools python python-pip inetutils

# 其他发行版请安装等效软件包

设置

1. 克隆仓库：

git clone https://github.com/BrownFineSecurity/iothackbot.git
cd iothackbot

2. 将bin目录添加到PATH：

export PATH="$PATH:$(pwd)/bin"

3. 若要永久设置，将其添加到shell配置文件中：

echo 'export PATH="$PATH:/path/to/iothackbot/bin"' >> ~/.bashrc

使用

快速入门示例

发现ONVIF设备

wsdiscovery 192.168.1.0/24

测试ONVIF设备安全性

onvifscan auth http://192.168.1.100
onvifscan brute http://192.168.1.100

分析网络流量

# 分析PCAP文件中的物联网协议
iotnet capture.pcap

# 实时捕获
sudo iotnet -i eth0 -d 60

提取网络流

# 从设备中提取网络流并解析DNS
netflows capture.pcap --source-ip 192.168.1.100

# 仅获取主机名:端口列表
netflows capture.pcap -s 192.168.1.100 --format quiet

分析固件

# 识别文件类型
ffind firmware.bin

# 提取文件系统（需要sudo权限）
sudo ffind firmware.bin -e

Claude Code插件

IoTHackBot作为Claude Code插件提供，结合专用技能实现AI辅助的安全测试。

可用技能

技能	描述
chipsec	UEFI/BIOS固件静态分析 - 恶意软件检测、EFI清单生成
apktool	安卓APK反编译与资源提取
jadx	安卓APK反编译为Java源代码
ffind	固件文件分析及文件系统提取
iotnet	物联网网络流量分析
netflows	网络流提取并解析DNS主机名
nmap	专业网络侦察
onvifscan	ONVIF设备安全测试
picocom	UART控制台交互
telnetshell	Telnet shell枚举
wsdiscovery	WS-Discovery设备发现

插件安装

选项1：开发过程中直接使用

claude --plugin-dir /path/to/iothackbot

选项2：安装为本地市场（持久化）

在~/.claude/settings.json中添加：

{
  "extraKnownMarketplaces": {
    "iothackbot-local": {
      "source": {
        "source": "directory",
        "path": "/path/to/iothackbot"
      }
    }
  },
  "enabledPlugins": {
    "iothackbot": true
  }
}

然后重启Claude Code使设置生效。

选项3：项目特定设置

对于特定项目的使用，这些技能也可通过.claude/skills/符号链接获得，以保持向后兼容性。

工具架构

所有工具遵循一致的设计模式：

• CLI层（tools/iothackbot/*.py） - 命令行界面，使用argparse
• 核心层（tools/iothackbot/core/*_core.py） - 实现ToolInterface的核心功能
• 二进制文件（bin/*） - 可执行包装脚本

这种分离设计实现了：

• 易于自动化和链式调用
• 一致的输出格式（文本、JSON、简洁）
• 标准化的错误处理
• 工具组合与管道化

配置

IoT检测规则

config/iot/detection_rules.json - 自定义IoT协议检测规则，用于iotnet

字典文件

• wordlists/onvif-usernames.txt - ONVIF设备默认用户名列表
• wordlists/onvif-passwords.txt - ONVIF设备默认密码列表

开发

添加新工具

详细信息请参阅TOOL_DEVELOPMENT_GUIDE.md，内容包括：

• 项目结构标准
• 开发模式
• 输出格式指南
• 测试与集成

关键接口

• ToolInterface - 所有工具的基础接口
• ToolConfig - 标准化配置对象
• ToolResult - 标准化结果对象，包含成功状态、数据、错误和元数据

输出格式

所有工具支持多种输出格式：

# 默认为带颜色的人类可读文本
onvifscan auth 192.168.1.100

# 机器可读的JSON格式
onvifscan auth 192.168.1.100 --format json

# 极简输出
onvifscan auth 192.168.1.100 --format quiet

安全与伦理

重要提示：这些工具仅适用于授权的安全测试。

• 仅测试您拥有或明确获得许可的设备
• 遵守测试范围限制和行为准则
• 注意对生产系统的影响
• 合理安排测试时间，避免造成服务中断
• 记录所有测试活动
• 遵循负责任的漏洞披露原则

贡献

欢迎贡献！请确保：

• 新工具遵循 TOOL_DEVELOPMENT_GUIDE.md 中的架构模式
• 所有工具支持文本、JSON 和静默输出格式
• 代码包含适当的错误处理
• 文档清晰且全面

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件

免责声明

本工具包仅用于教育和授权的安全测试目的。用户有责任在测试任何系统之前确保已获得适当授权。作者对因滥用或使用本工具包造成的任何损害不承担任何责任。

IoTHackBot 快速上手指南

IoTHackBot 是一款开源的 IoT 安全测试工具集，集成了 Claude Code 技能，专为物联网设备、IP 摄像头和嵌入式系统的自动化漏洞发现而设计。

环境准备

在开始之前，请确保您的系统已安装 Python 及必要的系统依赖。

系统要求

• 操作系统：推荐 Linux（如 Arch Linux、Ubuntu、Debian 等）
• Python 版本：Python 3.x

安装前置依赖

1. 安装 Python 依赖包

pip install colorama pyserial pexpect requests

提示：国内用户建议使用清华或阿里镜像源加速安装：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple colorama pyserial pexpect requests

2. 安装系统工具依赖 根据不同发行版执行相应命令：

Arch Linux:

sudo pacman -S nmap e2fsprogs f2fs-tools python python-pip inetutils

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y nmap e2fsprogs f2fs-tools python3 python3-pip net-tools

安装步骤

1. 克隆仓库

git clone https://github.com/BrownFineSecurity/iothackbot.git
cd iothackbot

提示：如果 GitHub 访问缓慢，可使用国内镜像（如 Gitee 镜像，若有）或通过代理加速。

2. 配置环境变量（临时生效） 将工具目录添加到 PATH 中，以便在任何位置调用命令：

export PATH="$PATH:$(pwd)/bin"

3. 配置环境变量（永久生效） 若需永久使用，请将以下命令添加到您的 Shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）：

echo 'export PATH="$PATH:/path/to/iothackbot/bin"' >> ~/.bashrc
source ~/.bashrc

(请将 /path/to/iothackbot 替换为实际的安装路径)

基本使用

以下是几个最常用的快速测试示例：

1. 发现局域网内的 ONVIF 设备

扫描指定网段内的摄像头和 IoT 设备：

wsdiscovery 192.168.1.0/24

2. 测试 ONVIF 设备安全性

对特定设备进行认证绕过测试或密码爆破：

# 测试认证机制
onvifscan auth http://192.168.1.100

# 暴力破解凭证
onvifscan brute http://192.168.1.100

3. 分析网络流量

分析 pcap 文件以检测 IoT 协议，或进行实时抓包：

# 分析现有的抓包文件
iotnet capture.pcap

# 实时抓取 eth0 接口流量 60 秒
sudo iotnet -i eth0 -d 60

4. 固件文件分析

识别固件中的文件类型并提取文件系统：

# 识别文件类型
ffind firmware.bin

# 提取文件系统（需要 sudo 权限）
sudo ffind firmware.bin -e

5. 结合 Claude Code 使用

如果您使用 Claude Code，可以通过插件模式调用内置的 AI 安全技能（如 chipsec, apktool, nmap 等）。在项目目录下运行：

claude --plugin-dir /path/to/iothackbot

---

⚠️ 安全与伦理声明：本工具仅供授权的安全测试和教育研究使用。请务必仅在您拥有所有权或获得明确许可的设备上进行测试，遵守法律法规，严禁用于非法入侵。