cotopaxi

Sammlung von Werkzeugen für Sicherheitstests von Internet-of-Things-Geräten unter Verwendung der Protokolle: AMQP, CoAP, DTLS, HTCPCP, HTTP, HTTP/2, gRPC, KNX, mDNS, MQTT, MQTT-SN, QUIC, RTSP, SSDP.

Lizenz:

Cotopaxi verwendet die GNU General Public License, Version 2: https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html

Haftungsausschluss

Das Cotopaxi-Toolkit ist nur für autorisierte Sicherheitstests bestimmt!

Einige Werkzeuge (insbesondere der Schwachstellentester und der Protokoll-Fuzzer) können dazu führen, dass Geräte oder Server nicht mehr wie vorgesehen funktionieren – z. B. durch Absturz oder Hängen der getesteten Entitäten oder durch Überflutung des Netzwerks mit anderem Datenverkehr.

Stellen Sie sicher, dass Sie die Erlaubnis der Eigentümer der getesteten Geräte oder Server haben, bevor Sie diese Werkzeuge ausführen!

Stellen Sie sicher, dass Sie die örtlichen Gesetze prüfen, bevor Sie diese Werkzeuge ausführen!

Installation

So installieren Sie die minimale Cotopaxi-Version (ohne maschinelles Lernen und Entwicklungswerkzeuge):

Fast vollständige Installation (ohne scapy-ssl_tls, das für DTLS-Unterstützung benötigt wird):

Eine ausführlichere Dokumentation zur Installation finden Sie unter: Installationsanleitung

Integration mit Metasploit

Wenn Sie Cotopaxi-Werkzeuge aus Metasploit verwenden möchten, siehe: Metasploit-Integration

Danksagungen

Der im Werkzeug device_identification verwendete Klassifikator für maschinelles Lernen wurde mit dem Korpus „IMC 2019 payload dataset“ trainiert, der von den Autoren der folgenden Arbeit bereitgestellt wurde:

Titel: Information Exposure for Consumer IoT Devices: A Multidimensional, Network-Informed Measurement Approach Autoren: Jingjing Ren, Daniel J. Dubois, David Choffnes, Anna Maria Mandalari, Roman Kolcun, Hamed Haddadi Veröffentlichungsort: Internet Measurement Conference (IMC) 2019 URL: https://moniotrlab.ccis.neu.edu/imc19dataset/

Wir danken den oben genannten Autoren für die Bereitstellung dieses Korpus!

Werkzeuge in diesem Paket:

• service_ping
• server_fingerprinter
• device_identification
• traffic_analyzer
• resource_listing
• protocol_fuzzer (zum Fuzzen von Servern)
• client_proto_fuzzer (zum Fuzzen von Clients)
• vulnerability_tester (zum Testen von Servern)
• client_vuln_tester (zum Testen von Clients)
• amplifier_detector
• active_scanner

Von verschiedenen Werkzeugen unterstützte Protokolle (linkes Kästchen beschreibt funktionierende Implementierung in Python 2, rechtes in Python 3):

Eine ausführlichere Dokumentation jedes Werkzeugs finden Sie unter: Werkzeuge

Unterstützte Schwachstellen

Schwachstellen, die vom Cotopaxi-Team identifiziert wurden und mit Cotopaxi getestet werden können:

• BOTAN_000
• COAPTHON_000 (CVE-2018-12679)
• COAPTHON3_000 (CVE-2018-12679)
• CONTIKI_000 (CVE-2018-19417)
• FLUENTBIT_000 (CVE-2019-9749)
• IOTIVITY_000 (CVE-2019-9750)
• MADMAZE-HTCPCP_000
• MATRIXSSL_000
• MATRIXSSL_001 (CVE-2019-14431)
• MATRIXSSL_002
• MATRIXSSL_003
• SSDP-RESPONDER_000 (CVE-2019-14323)
• TINYDTLS_001
• TINYDTLS_002
• TINYDTLS_003
• TINYSVCMDNS_002 (CVE-2019-9747)
• WAKAAMA_000 (CVE-2019-9004)
• ZYXEL_000

Weitere von Cotopaxi unterstützte Schwachstellen:

• ER_COAP_000
• ER_COAP_001
• ER_COAP_002
• TINYDTLS_000 (CVE-2017-7243)
• TINYSVCMDNS_000 (CVE-2017-12087)
• TINYSVCMDNS_001 (CVE-2017-12130)
• TP-LINK_000 (CVE-2018-18428
• TP-LINK_001
• FLIR_000
• FOSCAM_000 (CVE-2018-19077)
• FOSCAM_001 (CVE-2018-19067)
• HIKVISION_000 (CVE-2014-4878)
• HIKVISION_001 (CVE-2014-4879)
• HIKVISION_002 (CVE-2014-4880)
• UBIQUITTI_000 (CVE-2019-12727)
• GSTREAMER_000 (CVE-2019-9928)
• NETFLIX_000 (CVE-2019-10028)
• BEWARD_000
• FALCON_000

Neue Schwachstellen können einfach zur Datenbank in vulnerabilities.yaml und Payloads in cotopaxi/vulnerabilities//<payload.raw> hinzugefügt werden.

Bekannte Probleme / Einschränkungen

Es gibt einige bekannte Probleme oder Einschränkungen, die durch die Verwendung von scapy als Netzwerkbibliothek verursacht werden:

• Das Testen von Diensten, die auf demselben Rechner laufen, kann zu Problemen führen, da einige Pakete möglicherweise nicht zugestellt werden.
• Das gleichzeitige Ausführen mehrerer Werkzeuge gegen dasselbe Ziel kann zu Interferenzen führen (Pakete könnten als Antwort auf eine andere Anfrage erscheinen).

Weitere Informationen unter: https://scapy.readthedocs.io/en/latest/troubleshooting.html#

Entwicklung

Ausführlichere Informationen zur Entwicklung von Cotopaxi finden Sie unter: Entwicklungsanleitung