mcpField
I
iotnet

iotnet

github.com/brownfinesecurity安全87546 次安装21 周前更新
代码仓库

关于 iotnet

iotnet 是用于分析物联网网络流量的工具,可处理 PCAP 文件或实时抓包。它识别协议并检查未加密通信、弱认证等安全问题。

主要功能

  1. 01分析 PCAP 文件和实时流量
  2. 02识别物联网协议
  3. 03检测加密与认证问题
  4. 04按 IP 和过滤器筛选流量
  5. 05输出漏洞等级与修复建议

适用场景

  1. 01检查设备通信中的明文凭据
  2. 02排查物联网协议的安全风险
  3. 03分析实时网络流量
  4. 04使用自定义规则检查流量

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/brownfinesecurity/iothackbot --skill iotnet

安装后在 Claude Code 中输入/iotnet确认已加载。

详细介绍

IoTNet - IoT 网络流量分析器

你正在帮助用户使用 iotnet 工具分析网络流量,以检测 IoT 协议并识别安全漏洞。

工具概述

IoTNet 可分析网络数据包捕获文件(PCAP),也可实时捕获流量,以便:

  • 检测 IoT 专用协议(MQTT、CoAP、Zigbee 等)
  • 识别网络流量中的安全漏洞
  • 分析协议分布
  • 查找未加密的通信
  • 检测薄弱的身份验证机制
  • 识别 IoT 设备的不安全行为

说明

当用户要求分析网络流量、捕获 IoT 流量或评估网络安全时:

  1. 确定输入类型:

    • PCAP 文件分析(离线)
    • 实时网络捕获(需要指定接口)
  2. 收集需求:

    • 对于 PCAP:获取文件路径
    • 对于实时捕获:获取网络接口名称和持续时间
    • 询问是否需要筛选(特定 IP、协议)
    • 确认是否需要自定义检测规则
  3. 执行分析:

    • 使用 iothackbot bin 目录中的 iotnet 命令

使用模式

PCAP 分析(离线)

分析一个或多个现有数据包捕获文件:

iotnet capture1.pcap capture2.pcap
实时捕获

实时捕获并分析流量:

sudo iotnet -i eth0 -d 30

参数

输入选项:

  • pcap_files:要分析的一个或多个 PCAP 文件
  • -i, --interface:用于实时捕获的网络接口

筛选选项:

  • --ip:按 IP 地址筛选流量
  • -c, --capture-filter:用于实时捕获的 BPF 语法筛选器
  • --display-filter:用于 PCAP 分析的 Wireshark 显示筛选器

实时捕获选项:

  • -d, --duration:捕获持续时间,单位为秒(默认值:30)

分析选项:

  • --config:自定义 IoT 检测规则配置文件
    • 默认值:iothackbot 目录中的 config/iot/detection_rules.json

输出选项:

  • --format text|json|quiet:输出格式(默认值:text)
  • -v, --verbose:详细输出

示例

分析数据包捕获文件:

iotnet /path/to/capture.pcap

在 wifi 接口上实时捕获 60 秒:

sudo iotnet -i wlan0 -d 60

分析特定 IP 的流量:

iotnet capture.pcap --ip 192.168.1.100

使用 BPF 筛选器进行实时捕获:

sudo iotnet -i eth0 -c "port 1883 or port 5683" -d 45

使用自定义配置分析多个 PCAP 文件:

iotnet file1.pcap file2.pcap --config custom-rules.json

使用显示筛选器进行筛选(Wireshark 语法):

iotnet capture.pcap --display-filter "mqtt or coap"

可检测的 IoT 协议

该工具可以识别:

  • MQTT:消息队列遥测传输
  • CoAP:受限应用协议
  • Zigbee:低功耗网状网络
  • Z-Wave:家庭自动化协议
  • ONVIF:IP 摄像头协议
  • UPnP/SSDP:通用即插即用
  • Modbus:工业控制协议
  • 以及更多协议(可配置)

安全检查

IoTNet 可识别以下漏洞:

  • 未加密的 MQTT 流量
  • 缺少 TLS/加密
  • 身份验证薄弱或缺失
  • 明文凭据
  • 不安全的协议版本
  • 已知存在漏洞的实现

输出信息

结果包括:

  • 分析的数据包总数
  • 协议分布及其百分比
  • IoT 发现项,包含协议详情和数据包信息
  • 漏洞及其严重级别(高/中/低)
  • 修复建议

重要说明

  • 实时捕获需要 root/sudo 权限
  • 需要访问指定的网络接口
  • PCAP 分析不需要提升权限
  • 可在配置文件中自定义检测规则
  • 支持 tcpdump、Wireshark 等工具生成的标准 PCAP 格式

评论

支持 Markdown