D.A.N.G.D.U.T.

Deauthentication Attack Notification & Guard Detection Utility Toolkit

Ihr drahtloser Wächter für die Hosentasche.

Autor: XsanLahci

Was das ist

D.A.N.G.D.U.T. ist ein passives Wireless Intrusion Detection System (WIDS), das entwickelt wurde, um Wi-Fi-Deauthentifizierungs- und Disassoziierungsangriffe in Echtzeit zu erkennen. Es arbeitet vollständig passiv – es sendet, injiziert oder steuert das Wi-Fi-Funkgerät nicht, wodurch es ein reines Überwachungswerkzeug bleibt.

Ursprünglich als externes Modul für den Flipper Zero konzipiert, unterstützt das Projekt inzwischen auch eigenständige Hardware und bringt das WIDS-Erlebnis auf dedizierte, hosentaschengroße Geräte mit eigenen Bildschirmen und Oberflächen.

Unterstützte Plattformen:

1. M5 Cardputer ADV Stamp S3a (Eigenständig)

2. ESP32-S3 Mini OLED (Eigenständig)

3. Flipper Zero (über ESP32-S2 WiFi Devboard)

1. M5 Cardputer & ESP32-S3 Mini OLED (Eigenständige Versionen)

Diese Versionen sind vollständig eigenständig und benötigen keinen Flipper Zero zum Betrieb. Sie nutzen den leistungsstarken ESP32-S3-Chip, um Angriffe zu überwachen und die Benutzeroberfläche direkt auf ihren integrierten Bildschirmen darzustellen.

🌟 Exklusive Funktionen

• Lade-Bootvorgang: Benutzerdefinierte Ladesequenz für einen reibungsloseren und optisch ansprechenderen Start.

• Interaktive Steuerung (Cardputer): Starten und stoppen Sie die Überwachung von Wi-Fi-Deauth-Angriffen nahtlos direkt über die Tastatur/Oberfläche des Cardputers.

• Über den Autor: Ein eigener Bereich zum Anzeigen von Projekt- und Autoreninformationen.

• Live-Anzeige: Echtzeit-Angriffswarnungen mit Ziel-MAC, Absender-MAC und RSSI direkt auf dem OLED-/Cardputer-Bildschirm.

🛠️ Installation

1. Laden Sie die vorkompilierte Firmware für Ihr spezifisches Gerät aus dem Bereich Releases/Assets herunter (z. B. dangdut_esp32s3_cardputer.bin).

2. Verbinden Sie Ihren M5 Cardputer oder ESP32-S3 Mini OLED über USB mit Ihrem Computer.

3. Öffnen Sie den Dangdut Web Flasher in Ihrem Chrome- oder Edge-Browser, um die .bin-Datei einfach zu flashen. (Alternativ können Sie Ihr bevorzugtes ESP32-Flash-Tool wie esptool.py oder M5Burner verwenden).

4. Starten Sie das Gerät neu. Sie sehen den neuen Ladebildschirm und können sofort mit der Überwachung beginnen.

2. Flipper Zero Version (.fap)

Diese Version funktioniert als Flipper-Zero-Anwendung (.fap), die den Live-Status der Angriffserkennung auf dem Bildschirm des Flippers anzeigt, indem sie UART-Statuszeilen von einem angeschlossenen DANGDUT WiFi Devboard (ESP32-S2) liest.

Ordnerstruktur

dangdut_flipper_app/
  application.fam      - app manifest (name, entry point, category)
  dangdut_app.c        - main app source (UART read + screen rendering)
  images/              - icon assets folder (add dangdut.png, 10x10 px, 1-bit)
  README.md            - this file

Voraussetzungen

• Flipper Zero mit offizieller Firmware (oder kompatibler Custom-Firmware, die FAP-Extern-Apps und furi_hal_serial unterstützt).

• ufbt (micro Flipper Build Tool) auf deinem Computer installiert (pip install ufbt).

• DANGDUT WiFi Devboard (ESP32-S2), geflasht mit dangdut_esp32s2_flipper.ino.

Build- & Installationsschritte

1. Lege diesen Ordner an einer beliebigen Stelle auf deinem Computer ab (z. B. ~/flipper-apps/dangdut_flipper_app/).

2. Öffne ein Terminal in diesem Ordner und führe aus: ufbt. Dies kompiliert dangdut_app.c zu einer .fap-Datei im Ordner dist/.

3. Verbinde deinen Flipper Zero per USB und führe dann aus: ufbt launch. Dies installiert und startet die App direkt. (Alternativ kannst du die .fap mit qFlipper nach SD Card / apps / Tools / kopieren).

4. Stecke das geflashte DANGDUT WiFi Devboard (ESP32-S2) auf den GPIO-Header des Flipper Zero.

5. Starte die App. Du solltest sehen:

   • "Waiting for devboard...", bis die erste UART-Zeile eintrifft.

   • "SYSTEM SECURE" im Normalzustand.

   • "ATTACK DETECTED" (blinkendes rotes Banner + rote LED, plus MAC/RSSI-Info) während eines Angriffs.

Steuerung

• BACK-Taste -> beendet die App und kehrt zum Flipper-Menü zurück.

Protokollreferenz (ESP32-S2 zu Flipper UART)

Muss mit der Ausgabe der ESP32-S2-Firmware übereinstimmen. Die Zeilen sind mit Zeilenumbruch abgeschlossen und werden einmal pro Sekunde mit 115200 Baud gesendet.

• SAFE|<total_packets>|<packets_per_sec>|<channel>

• ATTACK|<total_packets>|<packets_per_sec>|<channel>|<target_mac>|<sender_mac>|<rssi>

Viel Spaß beim Scannen!