DuckLogger

DuckLogger è un Key Logger USB basato su ESP32-S3. Registra le sequenze di tasti in un file di testo e fornisce accesso wireless per scaricare i log tramite un punto di accesso Wi-Fi integrato. Ricreare questo progetto non richiede alcun PCB personalizzato. L'hardware utilizzato costa in totale meno di 10 $ su siti come Aliexpress.

Caratteristiche

• Registrazione delle pressioni dei tasti: Registra le sequenze di tasti e le salva in un file di log nella memoria flash interna.
• Doppia modalità Wi-Fi: Supporta sia la modalità Stazione Wi-Fi (connessione a una rete esistente) che la modalità Punto di accesso (Hotspot).
• Centro di Comando e Controllo Web: Accedi a un'interfaccia web integrata per gestire il tuo dispositivo. Il centro di controllo ti permette di:
  • Scaricare i Log: Scarica facilmente il file di log delle sequenze di tasti salvate.
  • Tastiera Live Remota: Collega una tastiera virtuale live e invia sequenze di tasti tramite WebSocket in tempo reale con quasi nessuna latenza.
  • Iniezione DuckyScript: Inietta ed esegui payload DuckyScript da remoto.
  • Impostazioni del Dispositivo: Aggiorna le configurazioni per la modalità AP/Stazione direttamente dall'interfaccia web.

Accedi all'interfaccia web all'indirizzo:

http://192.168.4.1/

(In modalità Punto di accesso)

Componenti Utilizzati

• ESP32-S3 SuperMini
• CH9350 HID Module
• 4 cavi jumper femmina

Per Iniziare

1. Schemi Elettrici

Il CH9350 supporta diverse modalità operative, configurate tramite i dip switch integrati.

Imposta S0 sulla posizione GND (0) e mantieni tutti gli altri interruttori nella posizione opposta (1). Questo abilita la modalità Host USB, che converte gli input della tastiera USB in dati seriali inviati tramite UART a una velocità di default di 115200 baud.

2. Flashing di MicroPython

DuckLogger è scritto in MicroPython. Esegui il flashing della tua scheda con il firmware MicroPython. Trova le istruzioni per il flashing qui.

Dopo il flashing, scollega e ricollega la scheda tramite USB.

3. Clona il Repository

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

4. Installa DuckLogger sulla Scheda

Assicurati che la scheda sia collegata tramite USB, poi esegui:

python flasher.py

Il flasher automaticamente:

• Installerà mpremote e i pacchetti MicroPython richiesti sulla scheda
• Comprimerà index.html e copierà tutti i file sulla scheda
• Riavvierà la scheda

Utilizzo

1. Collega la tastiera USB al modulo HID CH9350.

2. Collega l'ESP32-S3 SuperMini al PC target usando un cavo USB-C verso USB-A.

3. Il dispositivo automaticamente:

   • Inizierà a registrare le sequenze di tasti
   • Si connetterà al Wi-Fi o creerà un punto di accesso Wi-Fi in base alle tue impostazioni
   • Avvierà un server HTTP

Se in modalità Punto di accesso (predefinita), connettiti al punto di accesso Wi-Fi (Password predefinita: duckPass1234) e apri:

http://192.168.4.1/

Per accedere al centro di comando e controllo.

Sintassi DuckyScript Supportata

DuckLogger supporta attualmente un insieme base di comandi DuckyScript per l'iniezione di payload:

Struttura del Repository

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

Librerie di Terze Parti

Questo progetto include Microdot di Miguel Grinberg (Licenza MIT):
https://github.com/miguelgrinberg/microdot