DuckLogger

DuckLogger ist ein USB-Tastenlogger auf Basis des ESP32-S3. Es zeichnet Tastatureingaben in einer Textdatei auf und bietet drahtlosen Zugriff zum Herunterladen der Protokolle über einen integrierten Wi-Fi-Access-Point. Für die Nachbildung dieses Projekts ist keine benutzerdefinierte Platine erforderlich. Die verwendete Hardware kostet insgesamt weniger als 10 $ auf Plattformen wie Aliexpress.

Funktionen

• Tastenprotokollierung: Zeichnet Tastatureingaben auf und speichert sie in einer Protokolldatei im internen Flash-Speicher.
• Dual-Wi-Fi-Modi: Unterstützt sowohl den Wi-Fi-Station-Modus (Verbindung mit einem vorhandenen Netzwerk) als auch den Access-Point-(Hotspot)-Modus.
• Web-Befehls- und Kontrollzentrum: Greifen Sie auf eine integrierte Weboberfläche zu, um Ihr Gerät zu verwalten. Das Kontrollzentrum ermöglicht Ihnen:
  • Protokolle herunterladen: Laden Sie die gespeicherte Tastenprotokolldatei einfach herunter.
  • Fernbedienung Live-Tastatur: Schließen Sie eine Live-Virtual-Tastatur an und senden Sie Tastatureingaben in Echtzeit nahezu ohne Latenz per WebSocket.
  • DuckyScript-Injektion: Injizieren und führen Sie DuckyScript-Nutzlasten aus der Ferne aus.
  • Geräteeinstellungen: Aktualisieren Sie Konfigurationen für den AP-/Station-Modus direkt über die Web-UI.

Greifen Sie auf die Web-UI unter folgender Adresse zu:

http://192.168.4.1/

(Im Access-Point-Modus)

Verwendete Komponenten

• ESP32-S3 SuperMini
• CH9350 HID-Modul
• 4 weibliche Jumper-Kabel

Erste Schritte

1. Schaltplan

Das CH9350 unterstützt mehrere Betriebsmodi, die über die integrierten DIP-Schalter konfiguriert werden.

Setzen Sie S0 auf die GND-Position (0) und belassen Sie alle anderen Schalter in der entgegengesetzten Position (1). Dies aktiviert den USB-Host-Modus, der USB-Tastatureingaben in serielle Daten umwandelt, die über UART mit einer Standardbaudrate von 115200 gesendet werden.

2. MicroPython flashen

DuckLogger ist in MicroPython geschrieben. Flashen Sie Ihr Board mit der MicroPython-Firmware. Eine Anleitung zum Flashen finden Sie hier.

Nach dem Flashen trennen Sie das Board vom USB und schließen es wieder an.

3. Repository klonen

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

4. DuckLogger auf dem Board installieren

Stellen Sie sicher, dass Ihr Board per USB angeschlossen ist, und führen Sie dann Folgendes aus:

python flasher.py

Der Flasher wird automatisch:

• mpremote und die erforderlichen MicroPython-Pakete auf dem Board installieren.
• index.html komprimieren und alle Dateien auf das Board kopieren.
• Das Board neu starten.

Verwendung

1. Schließen Sie die USB-Tastatur an das CH9350-HID-Modul an.
2. Verbinden Sie den ESP32-S3 SuperMini über ein USB-C- auf USB-A-Kabel mit dem Ziel-PC.
3. Das Gerät wird automatisch:
   • mit der Tastenprotokollierung beginnen.
   • eine Verbindung zu einem Wi-Fi herstellen oder einen Wi-Fi-Access-Point einrichten (abhängig von Ihren Einstellungen).
   • einen HTTP-Server starten.

Wenn Sie sich im Access-Point-Modus (Standard) befinden, verbinden Sie sich mit dem Wi-Fi-Access-Point (Standard-Passwort: duckPass1234) und öffnen Sie:

http://192.168.4.1/

um auf das Befehls- und Kontrollzentrum zuzugreifen.

Unterstützte DuckyScript-Syntax

DuckLogger unterstützt derzeit einen Basissatz von DuckyScript-Befehlen für die Nutzlastinjektion:

Repository-Struktur

.
├── 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

Bibliotheken von Drittanbietern

Dieses Projekt enthält Microdot von Miguel Grinberg (MIT-Lizenz):
https://github.com/miguelgrinberg/microdot