DuckLogger

DuckLogger est un enregistreur de frappe USB basé sur ESP32-S3. Il enregistre les frappes dans un fichier texte et fournit un accès sans fil pour télécharger les journaux via un point d'accès Wi-Fi intégré. La reproduction de ce projet ne nécessite pas de PCB personnalisé. Le matériel utilisé coûte moins de 10 $ au total sur des sites comme Aliexpress.

Fonctionnalités

• Journalisation des frappes : Enregistre les frappes et les sauvegarde dans un fichier journal dans la mémoire flash interne.
• Double mode Wi-Fi : Prend en charge le mode Station Wi-Fi (connexion à un réseau existant) et le mode Point d'accès (Hotspot).
• Centre de commande et de contrôle Web : Accédez à une interface Web intégrée pour gérer votre appareil. Le centre de contrôle vous permet de :
  • Télécharger les journaux : Téléchargez facilement le fichier journal des frappes enregistrées.
  • Clavier distant en direct : Attachez un clavier virtuel en direct et envoyez des frappes via WebSocket en temps réel avec pratiquement aucune latence.
  • Injection DuckyScript : Injectez et exécutez des payloads DuckyScript à distance.
  • Paramètres de l'appareil : Mettez à jour les configurations pour les modes AP/Station directement depuis l'interface Web.

Accédez à l'interface Web à :

http://192.168.4.1/

(En mode Point d'accès)

Composants utilisés

• ESP32-S3 SuperMini
• Module HID CH9350
• 4 fils de connexion femelle

Pour commencer

1. Schémas

Le CH9350 prend en charge plusieurs modes de fonctionnement, configurés à l'aide des interrupteurs DIP intégrés.

Réglez S0 sur la position GND (0) et maintenez tous les autres interrupteurs en position opposée (1). Cela active le mode hôte USB, qui convertit les entrées du clavier USB en données série envoyées via UART à un débit en bauds par défaut de 115200.

2. Flasher MicroPython

DuckLogger est écrit en MicroPython. Flashez votre carte avec le firmware MicroPython. Trouvez les instructions de flashage ici.

Après le flashage, déconnectez et reconnectez la carte via USB.

3. Cloner le dépôt

git clone https://github.com/Itsmmdoha/duckLogger.git
cd duckLogger

4. Installer DuckLogger sur la carte

Assurez-vous que votre carte est connectée via USB, puis exécutez :

python flasher.py

Le flasher va automatiquement :

• Installer mpremote et les paquets MicroPython requis sur la carte
• Compresser index.html et copier tous les fichiers sur la carte
• Redémarrer la carte

Utilisation

1. Branchez le clavier USB sur le module HID CH9350.

2. Connectez l'ESP32-S3 SuperMini au PC cible à l'aide d'un câble USB-C vers USB-A.

3. L'appareil va automatiquement :

   • Commencer à journaliser les frappes
   • Se connecter au Wi-Fi ou créer un point d'accès Wi-Fi selon vos paramètres
   • Démarrer un serveur HTTP

En mode Point d'accès (par défaut), connectez-vous au point d'accès Wi-Fi (mot de passe par défaut : duckPass1234) et ouvrez :

http://192.168.4.1/

Pour accéder au centre de commande et de contrôle.

Syntaxe DuckyScript prise en charge

DuckLogger prend actuellement en charge un ensemble de base de commandes DuckyScript pour l'injection de payload :

Structure du dépôt

.
├── flasher.py
├── index.html
├── lib
│   ├── access_point.py
│   ├── api.py
│   ├── duckyscript.py
│   ├── keyboard.py
│   ├── key_led.py
│   ├── logger.py
│   ├── mapper.py
│   ├── microdot
│   │   ├── helpers.py
│   │   ├── __init__.py
│   │   ├── microdot.py
│   │   └── websocket.py
│   ├── queue.py
│   ├── settings.py
│   ├── uart_buffer.py
│   ├── wifi.py
│   └── wifi_radio.py
├── LICENSE
├── main.py
├── README.md
├── resources.md
└── settings.json

Bibliothèques tierces

Ce projet inclut Microdot par Miguel Grinberg (licence MIT) :
https://github.com/miguelgrinberg/microdot