使用指定IoT网络协议对IoT设备进行安全测试Cotopaxi

cotopaxi是用于IoT设备安全测试的工具集。你可以指定IoT网络协议（如CoAP，DTLS，HTCPCP，mDNS，MQTT，SSDP）进行测试。

安装
只需从git克隆代码即可：https://github.com/Samsung/cotopaxi

要求
目前Cotopaxi仅适用于Python 2.7.x，但未来版本也将适用于Python 3。

如果你之前安装了scapy没有scapy-ssl_tls，请将其删除或使用venv。

安装主库：

scapy-ssl_tls（这也将在2.4.2中安装scapy）

pip install git+https://github.com/tintinweb/scapy-ssl_tls@ec5714d560c63ea2e0cce713cec54edc2bfa0833

常见问题：

如果遇到错误：error: [Errno 2] No such file or directory: ‘LICENSE’，请尝试重复命令。

如果遇到错误：NameError: name ‘os’ is not defined – 将缺少的import os添加到scapy/layers/ssl_tls.py。

你也可以使用requirements.txt文件安装所有其他依赖包：

pip install -r cotopaxi/requirements.txt
手动安装其他所需的包：

pip install dnslib IPy hexdump pyyaml psutil enum34 configparser
声明
Cotopaxi工具包仅用于授权的安全测试！

某些工具（尤其是漏洞测试程序和协议fuzzer）可能会导致某些设备或服务器停止工作 – 例如导致测试实体崩溃或挂起等。

在运行这些工具之前，请确保你已获得测试设备或服务器的所有者的许可！

在运行这些工具之前，请务必查看当地法律！

其中包含的工具有：

service_ping

server_fingerprinter

resource_listing

server_fingerprinter

protocol_fuzzer (用于fuzzing服务器)

client_proto_fuzzer (用于fuzzing客户端)

vulnerability_tester (用于测试服务)

client_vuln_tester (用于测试客户端)

amplifier_detector

不同工具所支持的协议：

Tool CoAP DTLS HTCPCP mDNS MQTT SSDP
service_ping ☑ ☑ ☑ ☑ ☑ ☑
server_fingerprinter ☑ ☑
resource_listing ☑ ☑ ☑
protocol_fuzzer ☑ ☑ ☑ ☑ ☑ ☑
client_proto_fuzzer ☑ ☑ ☑ ☑ ☑ ☑
vulnerability_tester ☑ ☑ ☑ ☑ ☑ ☑
client_vuln_tester ☑ ☑ ☑ ☑ ☑ ☑
amplifier_detector ☑ ☑ ☑ ☑
cotopaxi.service_ping
用于检查给定IP和端口范围的网络服务可用性的工具

usage: sudo python -m cotopaxi.service_ping [-h] [-v] [--protocol {
   UDP,TCP,CoAP,MQTT,DTLS,ALL}]
                       [--src-port SRC_PORT]
                       dest_ip dest_port

positional arguments:
  dest_ip               destination IP address or multiple IPs separated by
                        coma (e.g. '1.1.1.1,2.2.2.2') or given by CIDR netmask
                        (e.g. '10.0.0.0/22') or both
  dest_port             destination port or multiple ports given by list
                        separated by coma (e.g. '8080,9090') or port range
                        (e.g. '1000-2000') or both

optional arguments:
  -h, --help            show this help message and exit
  --retries RETRIES, -R RETRIES
                        number of retries
  --timeout TIMEOUT, -T TIMEOUT
                        timeout in seconds
  --verbose, -V, --debug, -D
                        Turn on verbose/debug mode (more messages)
  --protocol {
   UDP,TCP,CoAP,mDNS,SSDP,MQTT,DTLS,ALL,HTCPCP}, -P {
   UDP,TCP,CoAP,mDNS,SSDP,MQTT,DTLS,ALL,HTCPCP}
                        protocol to be tested (UDP includes CoAP, DTLS, mDNS,
                        and SSDP, TCP includes CoAP, HTCPCP, and MQTT, ALL
                        includes all supported protocols)
  --src-port SRC_PORT, -SP SRC_PORT
                        source port (if not specified random port will be
                        used)

cotopaxi.server_fingerprinter
用于在给定IP和端口范围内对网络服务器进行软件指纹识别的工具

目前支持的服务器：

CoAP：

aiocoap,

CoAPthon,

FreeCoAP,

libcoap,

MicroCoAP,

Mongoose

Wakaama (formerly liblwm2m)

DTLS：

GnuTLS,

Goldy,

LibreSSL,

MatrixSSL,

mbed TLS,

OpenSSL,

TinyDTLS

usage: sudo python -m cotopaxi.server_fingerprinter [-h] [--retries RETRIES] [--timeout TIMEOUT]
                               [--verbose]
                               [--protocol {
   CoAP,DTLS}]
                               [--src-port SRC_PORT]
                               dest_ip dest_port

positional arguments:
  dest_ip               destination IP address or multiple IPs separated by
                        coma (e.g. '1.1.1.1,2.2.2.2') or given by CIDR netmask
                        (e.g. '10.0.0.0/22') or both
  dest_port             destination port or multiple ports given by list
                        separated by coma (e.g. '8080,9090') or port range
                        (