
ESP32용 최신 WiFi 감사 라이브러리로, 고급 802.11 기술을 사용합니다. PMKID 추출 및 CSA 인젝션(PMF 우회)을 통해 WPA/WPA2/WPA3 핸드셰이크를 캡처합니다. 엔터프라이즈 자격 증명을 수집하고, 듀얼 밴드(ESP32-C6에서 2.4GHz/5GHz)를 지원하며, PCAPNG/Hashcat으로 내보냅니다. 9개의 예제가 포함된 깔끔한 C++ API를 제공합니다.
ESP32 마이크로컨트롤러를 위한 정교한 WiFi 감사 라이브러리
Politician은 ESP32 플랫폼에서 WiFi 보안 감사를 위해 설계된 임베디드 C++ 라이브러리입니다. 고급 802.11 프로토콜 기법을 사용하여 WPA/WPA2/WPA3 핸드셰이크를 캡처하고 엔터프라이즈 자격 증명을 수집하기 위한 깔끔하고 현대적인 API를 제공합니다.
ClientFoundCb가 (const uint8_t *bssid, const uint8_t *sta, int8_t rssi)에서 (const ClientRecord &rec)로 변경되었습니다. 기존 콜백을 업데이트하세요:
// Before
engine.setClientFoundCallback([](const uint8_t *bssid, const uint8_t *sta, int8_t rssi) { … });
// After
engine.setClientFoundCallback([](const ClientRecord &rec) {
// rec.bssid, rec.sta, rec.rssi — same data plus rand_mac, vendor, timestamps
});
이 라이브러리는 채널 호핑, 대상 선택, 공격 실행 및 캡처 처리를 관리하는 비차단 상태 머신을 중심으로 구축되었습니다. 모든 작업은 politician 네임스페이스 내에 포함됩니다.
| 헤더 | 설명 |
|---|---|
Politician.h | 메인 엔진 클래스 — 모든 프로젝트에 포함 |
PoliticianTypes.h | 공개 구조체, 열거형 및 컴파일 타임 기능 게이트 |
PoliticianStorage.h | SD 카드 로거 및 NVS 영속성 (Arduino 전용) |
PoliticianFormat.h | PCAPNG 및 HC22000 직렬화 기본 요소 |
PoliticianStress.h | 선택적 DoS 페이로드 (SAE 플러드, 프로브 플러드, 비콘 플러드) |
PoliticianProbe.h | 숨겨진 SSID 프로빙을 위한 선택적 PROGMEM 워드리스트 |
PoliticianWPS.h | 선택적 WPS M1 출력 헬퍼 및 비트마스크 상수 |
PoliticianSense.h | 선택적 수동 RSSI 기반 모션 및 존재 감지 |
| 모드 | 비트 | 설명 |
|---|---|---|
ATTACK_PMKID | 0x01 | 가짜 연결을 통한 PMKID 피싱 |
ATTACK_CSA | 0x02 | Channel Switch Announcement 주입 |
ATTACK_PASSIVE | 0x04 | 수신 전용 — 전송 없음 |
ATTACK_DEAUTH | 0x08 | 클래식 Reason-7 deauthentication |
ATTACK_STIMULATE | 0x10 | QoS Null Data 클라이언트 자극 |
ATTACK_BTM | 0x20 | 802.11v BSS Transition Management Request |
ATTACK_ALL | 0x3F | 모든 활성 공격 벡터 |
Politician.h를 포함하기 전에 또는 빌드 시스템(-DNAME)을 통해 다음 중 하나를 정의하십시오:
; platformio.ini
build_flags =
-DPOLITICIAN_NO_DB ; Strip 14KB OUI database (no vendor lookups)
-DPOLITICIAN_NO_PCAPNG ; Strip PCAPNG serialization
-DPOLITICIAN_NO_HC22000 ; Strip Hashcat HC22000 formatter
-DPOLITICIAN_NO_LOGGING ; Strip all internal Serial log output
-DPOLITICIAN_NO_STD_FUNCTION ; Use raw fn pointers instead of std::function
-DPOLITICIAN_NO_MSCHAPV2 ; Strip bare EAP-MSCHAPv2 capture
-DPOLITICIAN_NO_KARMA ; Strip KARMA rogue AP responder
-DPOLITICIAN_MAX_INSTANCES=1 ; Limit to one instance (saves a pointer array slot)
POLITICIAN_NO_STD_FUNCTION은 모든 콜백 유형을 std::function<>에서 원시 함수 포인터로 되돌려 약 2KB의 플래시를 절약하고 <functional>이 없는 환경에서 사용할 수 있게 합니다. 이 플래그가 설정되면 람다 캡처를 사용할 수 없습니다.
POLITICIAN_MAX_INSTANCES(기본값 2)는 프로미스큐어스 ISR 디스패처에서 사용하는 정적 인스턴스 레지스트리의 크기를 제어합니다. 단일 인스턴스 배포에서는 1로 설정하여 ISR의 루프 오버헤드를 제거하십시오.
[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
Politician
프로젝트의 lib/ 디렉터리에 직접 클론하거나:
cd lib/
git clone https://github.com/0ldev/Politician.git
프로젝트의 components/ 디렉터리에 클론하고 CMakeLists.txt를 생성합니다:
idf_component_register(
SRCS "src/Politician.cpp" "src/PoliticianFormat.cpp" "src/PoliticianStress.cpp"
INCLUDE_DIRS "src"
)
PoliticianStorage.h는 Arduino 전용이며 ESP-IDF에서#error를 발생시킵니다. ESP-IDF의 VFS와nvs_flashAPI를 직접 사용하세요.
#include <Arduino.h>
#include <SD.h>
#include <Politician.h>
#include <PoliticianStorage.h>
using namespace politician;
using namespace politician::storage;
Politician engine;
PcapngFileLogger pcap; // Streaming logger — one open(), many write() calls
void onHandshake(const HandshakeRecord &rec) {
Serial.printf("[✓] %s ch%d rssi=%d type=%d\n",
rec.ssid, rec.channel, rec.rssi, rec.type);
pcap.write(rec);
}
void setup() {
Serial.begin(115200);
SD.begin();
pcap.open(SD, "/captures.pcapng", 4 * 1024 * 1024); // optional auto-rotation at 4MB
engine.setEapolCallback(onHandshake);
engine.begin();
engine.setAttackMask(ATTACK_ALL);
}
void loop() {
engine.tick();
}
#include <nvs_flash.h>
#include <esp_event.h>
#include <Politician.h>
using namespace politician;
static Politician engine;
static void audit_task(void *) {
engine.setEapolCallback([](const HandshakeRecord &rec) {
printf("[+] %s ch%d\n", rec.ssid, rec.channel);
});
engine.begin();
engine.setAttackMask(ATTACK_ALL);
for (;;) { engine.tick(); vTaskDelay(pdMS_TO_TICKS(1)); }
}
extern "C" void app_main(void) {
nvs_flash_init();
esp_event_loop_create_default();
xTaskCreate(audit_task, "politician", 8192, nullptr, 5, nullptr);
}
Error begin(const Config &cfg = Config());
WiFi 드라이버를 프로미스큐어스 모드로 초기화합니다. 다른 메서드보다 먼저 호출해야 합니다. 시작 시 유효하지 않은 Config 값을 제한하고 경고합니다. 현장에 배포하기 전에 validateConfig()를 미리 사용하여 잘못된 구성을 확인하세요:
Config cfg;
cfg.hop_min_dwell_ms = 400;
cfg.hop_max_dwell_ms = 200; // wrong — min > max
const char *warnings[8];
int n = politician::validateConfig(cfg, warnings, 8);
for (int i = 0; i < n; i++) Serial.println(warnings[i]);
// → "hop_min_dwell_ms >= hop_max_dwell_ms — max will be clamped to min+50ms"
engine.begin(cfg); // begins normally; begin() clamps automatically
validateConfig()는 politician 네임스페이스의 무료 인라인 함수입니다 — 할당 없음, 의존성 없음.
begin()은 min + 50 ms 보정 후 최소 체류 시간을 표현할 수 없는 스마트 호핑 구성을 거부합니다. 이미 초기화된 엔진에서 begin()을 호출하면 이전 런타임이 먼저 중지되므로 재시작이 결정적입니다. stop()은 여러 번 호출해도 안전합니다. 캡처를 비활성화하고, 인스턴스를 등록 해제하며, 워커 리소스를 해제합니다. 소멸자도 활성 엔진을 중지합니다. WiFi 드라이버 소유권은 프로세스 전역으로 유지되며 이후 인스턴스에서 재사용됩니다.
struct Config {
// ── Channel Hopping ──────────────────────────────────────────────────────
uint16_t hop_dwell_ms = 200; // Static dwell time per channel (ms)
bool smart_hopping = true; // Dynamic dwell based on traffic activity
uint16_t hop_min_dwell_ms = 50; // Minimum dwell (smart hopping floor)
uint16_t hop_max_dwell_ms = 400; // Maximum dwell (smart hopping ceiling)
uint32_t m1_lock_ms = 800; // Stay on channel after seeing M1 (ms)
// ── PMKID Fishing ────────────────────────────────────────────────────────
uint32_t fish_timeout_ms = 2000; // Timeout per PMKID association attempt
uint8_t fish_max_retries = 2; // PMKID retries before pivoting to CSA