DuckLogger

DuckLogger é um registrador de teclas USB baseado em ESP32-S3. Ele registra as teclas digitadas em um arquivo de texto e fornece acesso sem fio para baixar os logs através de um ponto de acesso Wi-Fi integrado. Recriar este projeto não requer nenhuma PCB personalizada. O hardware usado aqui custa menos de US$ 10 no total em lugares como Aliexpress.

Recursos

• Registro de Teclas: Grava as teclas digitadas e as salva em um arquivo de log no armazenamento flash interno.
• Modos Wi-Fi Duplo: Suporta tanto o modo Estação Wi-Fi (conectar a uma rede existente) quanto o modo Ponto de Acesso (Hotspot).
• Centro de Comando e Controle Web: Acesse uma interface web integrada para gerenciar seu dispositivo. O centro de controle permite que você:
  • Baixar Logs: Baixe facilmente o arquivo de log das teclas gravadas.
  • Teclado ao Vivo Remoto: Conecte um teclado virtual e envie teclas via WebSocket em tempo real com latência quase zero.
  • Injeção DuckyScript: Injete e execute payloads DuckyScript remotamente.
  • Configurações do Dispositivo: Atualize as configurações dos modos AP/Estação diretamente da interface web.

Acesse a interface web em:

http://192.168.4.1/

(Quando no modo Ponto de Acesso)

Componentes Utilizados

• ESP32-S3 SuperMini
• CH9350 Módulo HID
• 4 Fios Jumper Fêmea

Primeiros Passos

1. Esquema de Ligações

O CH9350 suporta vários modos de operação, que são configurados usando os interruptores DIP onboard.

Coloque S0 na posição GND (0) e mantenha todos os outros interruptores na posição oposta (1). Isso ativa o Modo Host USB, que converte as entradas do teclado USB em dados seriais enviados via UART a uma taxa de transmissão padrão de 115200.

2. Grave o MicroPython

O DuckLogger é escrito em MicroPython. Grave seu dispositivo com o firmware MicroPython. Encontre instruções de gravação aqui.

Após a gravação, desconecte e reconecte o dispositivo via USB.

3. Clone o Repositório

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

4. Instale o DuckLogger no Dispositivo

Certifique-se de que seu dispositivo está conectado via USB e então execute:

python flasher.py

O flasher automaticamente:

• Instala mpremote e os pacotes MicroPython necessários no dispositivo
• Comprime index.html e copia todos os arquivos para o dispositivo
• Reinicia o dispositivo

Uso

1. Conecte o teclado USB ao módulo CH9350 HID.

2. Conecte o ESP32-S3 SuperMini ao PC alvo usando um cabo USB-C para USB-A.

3. O dispositivo automaticamente:

   • Inicia o registro das teclas
   • Conecta-se ao Wi-Fi ou cria um Ponto de Acesso Wi-Fi dependendo das suas configurações
   • Inicia um servidor HTTP

Se estiver no modo Ponto de Acesso (padrão), conecte-se ao Ponto de Acesso Wi-Fi (Senha Padrão: duckPass1234) e abra:

http://192.168.4.1/

Para acessar o centro de comando e controle.

Sintaxe DuckyScript Suportada

O DuckLogger atualmente suporta um conjunto principal de comandos DuckyScript para injeção de payloads:

Estrutura do Repositório

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

Bibliotecas de Terceiros

Este projeto inclui Microdot por Miguel Grinberg (Licença MIT):
https://github.com/miguelgrinberg/microdot