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

Deauthentication Attack Notification & Guard Detection Utility Toolkit

Votre gardien sans fil de poche.

Auteur : XsanLahci

De quoi s'agit-il

D.A.N.G.D.U.T. est un système passif de détection d'intrusion sans fil (WIDS) conçu pour détecter les attaques de désauthentification et de dissociation Wi-Fi en temps réel. Il fonctionne entièrement en mode passif — il n'émet, n'injecte ni ne contrôle la radio Wi-Fi, ce qui garantit qu'il reste un pur outil de surveillance.

Conçu à l'origine comme module externe pour le Flipper Zero, le projet a désormais évolué pour prendre en charge du matériel autonome, apportant l'expérience WIDS à des appareils de poche dédiés dotés de leurs propres écrans et interfaces.

Plateformes prises en charge :

1. M5 Cardputer ADV Stamp S3a (autonome)

2. ESP32-S3 Mini OLED (autonome)

3. Flipper Zero (via ESP32-S2 WiFi Devboard)

1. M5 Cardputer & ESP32-S3 Mini OLED (versions autonomes)

Ces versions sont entièrement autonomes et ne nécessitent pas de Flipper Zero pour fonctionner. Elles exploitent la puissante puce ESP32-S3 pour surveiller les attaques et afficher l'interface directement sur leurs écrans intégrés.

🌟 Fonctionnalités exclusives

• Écran de démarrage : séquence de démarrage personnalisée pour une expérience de lancement plus fluide et visuellement agréable.

• Contrôle interactif (Cardputer) : démarrez et arrêtez sans effort la surveillance des attaques de désauthentification Wi-Fi directement via le clavier/l'interface du Cardputer.

• À propos de l'auteur : une section dédiée pour consulter les informations sur le projet et l'auteur.

• Affichage en direct : alertes d'attaque en temps réel affichant la MAC cible, la MAC de l'expéditeur et le RSSI directement sur l'écran OLED/Cardputer.

🛠️ Installation

1. Téléchargez le firmware précompilé pour votre appareil spécifique depuis la section Releases/Assets (par exemple, dangdut_esp32s3_cardputer.bin).

2. Connectez votre M5 Cardputer ou ESP32-S3 Mini OLED à votre ordinateur via USB.

3. Ouvrez le Dangdut Web Flasher dans votre navigateur Chrome ou Edge pour flasher facilement le fichier .bin. (Vous pouvez également utiliser votre outil de flashage ESP32 préféré comme esptool.py ou M5Burner).

4. Redémarrez l'appareil. Vous verrez le nouvel écran de démarrage et pourrez commencer la surveillance immédiatement.

2. Version Flipper Zero (.fap)

Cette version fonctionne comme une application Flipper Zero (.fap) qui affiche l'état de détection des attaques en direct sur l'écran du Flipper en lisant les lignes d'état UART envoyées par un DANGDUT WiFi Devboard connecté (ESP32-S2).

Structure des dossiers

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

Prérequis

• Flipper Zero avec firmware officiel (ou firmware personnalisé compatible prenant en charge les applications externes FAP et furi_hal_serial).

• ufbt (micro Flipper Build Tool) installé sur votre ordinateur (pip install ufbt).

• DANGDUT WiFi Devboard (ESP32-S2) flashée avec dangdut_esp32s2_flipper.ino.

Étapes de compilation et d'installation

1. Placez ce dossier n'importe où sur votre ordinateur (par ex., ~/flipper-apps/dangdut_flipper_app/).

2. Ouvrez un terminal dans ce dossier et exécutez : ufbt. Cela compile dangdut_app.c en un fichier .fap dans le dossier dist/.

3. Connectez votre Flipper Zero via USB, puis exécutez : ufbt launch. Cela installe et lance l'application directement. (Alternativement, copiez le .fap vers SD Card / apps / Tools / à l'aide de qFlipper).

4. Branchez la DANGDUT WiFi Devboard (ESP32-S2) flashée sur le connecteur GPIO du Flipper Zero.

5. Lancez l'application. Vous devriez voir :

   • "Waiting for devboard..." jusqu'à l'arrivée de la première ligne UART.

   • "SYSTEM SECURE" en état normal.

   • "ATTACK DETECTED" (bannière rouge clignotante + LED rouge, ainsi que les informations MAC/RSSI) pendant une attaque.

Commandes

• Bouton BACK -> quitte l'application et revient au menu du Flipper.

Référence du protocole (ESP32-S2 vers UART du Flipper)

Doit correspondre à la sortie du firmware ESP32-S2. Les lignes sont terminées par un saut de ligne, envoyées une fois par seconde à 115200 bauds.

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

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

Bonne analyse !