DuckLogger

DuckLogger은 ESP32-S3 기반 USB 키 로거입니다. 키 입력을 텍스트 파일에 기록하며, 내장 Wi-Fi 액세스 포인트를 통해 무선으로 로그를 다운로드할 수 있습니다. 이 프로젝트를 재현하는 데 커스텀 PCB가 필요하지 않습니다. 여기에 사용된 하드웨어는 Aliexpress 등에서 총 10달러 미만입니다.

특징

• 키 입력 로깅: 키 입력을 기록하여 내부 플래시 저장소의 로그 파일에 저장합니다.
• 듀얼 Wi-Fi 모드: Wi-Fi 스테이션 모드(기존 네트워크에 연결)와 액세스 포인트(핫스팟) 모드를 모두 지원합니다.
• 웹 명령 및 제어 센터: 내장 웹 인터페이스에 접속하여 장치를 관리할 수 있습니다. 제어 센터에서는 다음을 수행할 수 있습니다:
  • 로그 다운로드: 저장된 키 입력 로그 파일을 쉽게 다운로드할 수 있습니다.
  • 원격 라이브 키보드: 가상 키보드를 연결하고 WebSocket을 통해 거의 지연 없이 실시간으로 키 입력을 전송할 수 있습니다.
  • DuckyScript 주입: DuckyScript 페이로드를 원격으로 주입 및 실행할 수 있습니다.
  • 장치 설정: 웹 UI에서 직접 AP/스테이션 모드 구성을 업데이트할 수 있습니다.

웹 UI에 접속하려면:

http://192.168.4.1/

(액세스 포인트 모드일 때)

사용된 부품

• ESP32-S3 SuperMini
• CH9350 HID 모듈
• 암놈 점퍼 와이어 4개

시작하기

1. 회로도

CH9350은 여러 작동 모드를 지원하며, 온보드 DIP 스위치를 사용하여 설정합니다.

S0를 GND 위치(0)로 설정하고 다른 모든 스위치는 반대 위치(1)로 유지합니다. 이렇게 하면 USB 호스트 모드가 활성화되어 USB 키보드 입력이 기본 전송 속도 115200의 UART를 통해 직렬 데이터로 변환됩니다.

2. MicroPython 플래싱

DuckLogger는 MicroPython으로 작성되었습니다. 보드에 MicroPython 펌웨어를 플래싱하세요. 플래싱 지침은 여기에서 확인할 수 있습니다.

플래싱 후 보드를 USB에서 분리했다가 다시 연결하세요.

3. 저장소 클론

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

4. 보드에 DuckLogger 설치

보드가 USB로 연결되어 있는지 확인한 후 다음을 실행하세요:

python flasher.py

플래셔가 자동으로 다음을 수행합니다:

• 보드에 mpremote 및 필요한 MicroPython 패키지 설치
• index.html 압축 및 모든 파일을 보드에 복사
• 보드 재부팅

사용법

1. USB 키보드를 CH9350 HID 모듈에 연결합니다.

2. ESP32-S3 SuperMini를 USB-C to USB-A 케이블을 사용하여 대상 PC에 연결합니다.

3. 장치가 자동으로 다음을 수행합니다:

   • 키 입력 로깅 시작
   • 설정에 따라 Wi-Fi에 연결하거나 Wi-Fi 액세스 포인트 생성
   • HTTP 서버 시작

액세스 포인트 모드(기본값)인 경우 Wi-Fi 액세스 포인트(기본 비밀번호: duckPass1234)에 연결하고 다음을 엽니다:

http://192.168.4.1/

명령 및 제어 센터에 접속합니다.

지원되는 DuckyScript 구문

DuckLogger는 현재 페이로드 주입을 위해 핵심 DuckyScript 명령 세트를 지원합니다:

저장소 구조

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

서드파티 라이브러리

이 프로젝트는 Miguel Grinberg의 Microdot(MIT 라이선스)을 포함합니다:
https://github.com/miguelgrinberg/microdot