ESP32 Wi-Fi 침투 도구

이 프로젝트는 다양한 Wi-Fi 공격을 구현하기 위한 ESP32 플랫폼용 범용 도구를 소개합니다. Wi-Fi 공격에서 일반적으로 사용되는 몇 가지 공통 기능을 제공하며, 새로운 공격을 구현하는 것을 조금 더 간단하게 만듭니다. 또한 핸드셰이크에서 PMKID를 캡처하거나, 복제된 AP를 시작하거나 직접 인증 해제 프레임을 보내는 등의 다양한 방법으로 핸드셰이크 자체를 캡처하는 Wi-Fi 공격 자체를 포함합니다.

물론 크래킹은 이 프로젝트의 일부가 아닙니다. ESP32는 해시를 효과적인 방식으로 크랙하기에 충분하지 않기 때문입니다. 나머지는 이 작고 저렴하며 저전력의 SoC에서 수행할 수 있습니다.

Logo

기능

PMKID 캡처
WPA/WPA2 핸드셰이크 캡처 및 파싱
다양한 방법을 사용한 인증 해제 공격
서비스 거부 공격
캡처된 트래픽을 PCAP 형식으로 포맷
캡처된 핸드셰이크를 Hashcat으로 크랙 가능한 HCCAPX 파일로 파싱
수동 핸드셰이크 스니핑
새로운 공격 구현을 위한 쉽게 확장 가능한 프레임워크
스마트폰 등을 사용하여 이동 중에도 쉽게 구성할 수 있는 관리 AP
그 외에도...

데모 비디오

사용 방법

빌드 및 플래시 프로젝트를 ESP32(DevKit 또는 모듈)에
ESP32 전원 공급
부팅 후 관리 AP가 자동으로 시작됩니다.
이 AP에 연결합니다.
기본값: SSID: ManagementAP 및 암호: mgmtadmin
브라우저에서 192.168.4.1을 열면 다음과 같은 도구를 구성하고 제어할 수 있는 웹 클라이언트가 표시됩니다.

빌드

이 프로젝트는 현재 ESP-IDF 4.1(커밋 5ef1b390026270503634ac3ec9f1ec2e364e23b2)을 사용하여 개발되었습니다. 최신 버전에서는 작동하지 않을 수 있습니다.

프로젝트는 일반적인 ESP-IDF 방식으로 빌드할 수 있습니다:

idf.py build

make를 사용하는 레거시 방법은 이 프로젝트에서 지원되지 않습니다.

플래시

ESP-IDF를 설정한 경우 가장 쉬운 방법은 idf.py flash를 사용하는 것입니다.

전체 ESP-IDF를 설정하고 싶지 않은 경우 build/에 포함된 사전 빌드된 바이너리를 사용하여 esptool.py로 플래시할 수 있습니다(Python 필요).

예제 명령어(esptool 저장소의 지침을 따르세요):

esptool.py -p /dev/ttyS5 -b 115200 --after hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size detect 0x8000 build/partition_table/partition-table.bin 0x1000 build/bootloader/bootloader.bin 0x10000 build/esp32-wifi-penetration-tool.bin

Windows에서는 공식 Flash Download Tool을 사용할 수 있습니다.

문서

Wi-Fi 공격

이 프로젝트의 공격 구현은 메인 컴포넌트 README에 설명되어 있습니다. 이러한 공격의 이론은 doc/ATTACKS_THEORY.md에 있습니다.

API 참조

이 프로젝트는 컴포넌트 API 및 구현을 문서화하기 위해 Doxygen 표기법을 사용합니다. Doxyfile이 포함되어 있으므로 API 참조를 생성하려면 루트 디렉토리에서 doxygen을 실행하기만 하면 됩니다. HTML API 참조가 doc/api/html에 생성됩니다.

컴포넌트

이 프로젝트는 다른 프로젝트에서 재사용할 수 있는 여러 컴포넌트로 구성됩니다. 각 컴포넌트에는 자체 README에 자세한 설명이 포함되어 있습니다. 다음은 컴포넌트에 대한 간략한 설명입니다:

메인 컴포넌트는 이 프로젝트의 진입점입니다. 필요한 모든 초기화 단계가 여기에서 수행됩니다. 관리 AP가 시작되고 제어가 웹서버로 넘어갑니다.
Wifi 컨트롤러 컴포넌트는 모든 Wi-Fi 관련 작업을 래핑합니다. AP 시작, STA로 연결, 주변 AP 스캔 등에 사용됩니다.
웹서버 컴포넌트는 공격을 구성할 수 있는 웹 UI를 제공합니다. AP가 시작되어 있고 SSL 암호화와 같은 추가 보안 기능이 활성화되지 않은 것으로 가정합니다.
Wi-Fi 스택 라이브러리 바이패서 컴포넌트는 일부 유형의 임의 802.11 프레임을 보내기 위해 Wi-Fi 스택 라이브러리 제한을 우회합니다.
프레임 분석기 컴포넌트는 캡처된 프레임을 처리하고 다른 컴포넌트에 파싱 기능을 제공합니다.
PCAP 직렬화기 컴포넌트는 캡처된 프레임을 PCAP 바이너리 형식으로 직렬화하고 다른 컴포넌트(주로 웹서버/UI용)에 제공합니다.
HCCAPX 직렬화기 컴포넌트는 캡처된 프레임을 HCCAPX 바이너리 형식으로 직렬화하고 다른 컴포넌트(주로 웹서버/UI용)에 제공합니다.

추가 자료

이 프로젝트에 관한 학술 논문(PDF)

하드웨어

이 프로젝트는 주로 ESP32-DEVKITC-32E에서 빌드 및 테스트되었지만 ESP32-WROOM-32 모듈과의 차이는 없어야 합니다.

Hw components

다음 사진에서는 다음과 같은 하드웨어를 사용하는 배터리(Li-Pol 축전지)로 구동되는 ESP32 DevKitC를 볼 수 있습니다:

ESP32-DEVKITC-32E (비용 213 CZK/8.2 EUR/9.6 USD)
220mAh Li-Pol 3.7V 축전지 (무게 ±5g, 비용 77 CZK/3 EUR/3.5 USD)
MCP1702-3302ET 강압 3.3V 전압 조정기 (비용 11 CZK/0.42 EUR/0.50 USD)
크기 비교용 체코 5코루나 동전 (무게 4.8g, 지름 23mm, 비용 0.19 EUR/0.23 USD)

Hw components

전체적으로(동전 제외) 이 설정의 무게는 약 17g입니다. 더 작은 Li-Pol 축전지를 사용하고 전체 개발 보드 대신 ESP32-WROOM-32 모듈을 직접 사용하면 더 작게 만들 수 있습니다.

이 설정의 비용은 약 300 CZK(± 11.50 EUR/13.50 USD)입니다. 모듈을 직접 사용하면 비용이 약 80 CZK(± 3 EUR/3.5 USD)이므로 총 160 CZK(± 6.5 EUR/7.5 USD)까지 낮출 수 있어 이 도구를 정말 저렴하게 만들고 거의 모든 사람이 사용할 수 있게 합니다.

전력 소비

실험 측정에 따르면 ESP32는 공격 실행 중 약 100mA를 소비합니다.

유사 프로젝트

기여

자유롭게 기여해 주세요. 현재 코드 베이스를 리팩토링하는 것을 주저하지 마세요. 새로운 함수와 파일을 주석 처리할 때는 Doxygen 표기법을 지켜 주세요. 이 프로젝트는 주로 교육 및 데모 목적으로 구축되었으므로 자세한 문서화를 환영합니다.

면책 조항

이 프로젝트는 Wi-Fi 네트워크와 그 기반 802.11 표준의 취약점 및 ESP32 플랫폼을 사용하여 이러한 취약점을 공격하는 방법을 보여줍니다. 공격할 권한이 있는 네트워크에 대해서만 책임감 있게 사용하십시오.

라이선스

이 프로젝트는 MIT 라이선스(자세한 내용은 LICENSE 파일 참조)에 따라 라이선스가 부여되었지만, 부끄러워하거나 인색하게 굴지 말고 여러분의 작업을 공유하세요.

esp32-wifi-penetration-tool

인기