Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
도구/GitHubGitHub/0ldev/politician
Embedded Systems SecurityPassword CrackingWi-Fi AuditingIoT SecurityInformation GatheringFuzzingWireless SecurityPenetration TestingHardware Security
GitHub0ldev/politician

Politician

ESP32용 최신 WiFi 감사 라이브러리로, 고급 802.11 기술을 사용합니다. PMKID 추출 및 CSA 인젝션(PMF 우회)을 통해 WPA/WPA2/WPA3 핸드셰이크를 캡처합니다. 엔터프라이즈 자격 증명을 수집하고, 듀얼 밴드(ESP32-C6에서 2.4GHz/5GHz)를 지원하며, PCAPNG/Hashcat으로 내보냅니다. 9개의 예제가 포함된 깔끔한 C++ API를 제공합니다.

9361805일 전Kitploit 검토 완료
공유
저장소 보기웹사이트

Politician

ESP32 마이크로컨트롤러를 위한 정교한 WiFi 감사 라이브러리

License: MIT PlatformIO

Politician은 ESP32 플랫폼에서 WiFi 보안 감사를 위해 설계된 임베디드 C++ 라이브러리입니다. 고급 802.11 프로토콜 기법을 사용하여 WPA/WPA2/WPA3 핸드셰이크를 캡처하고 엔터프라이즈 자격 증명을 수집하기 위한 깔끔하고 현대적인 API를 제공합니다.

마이그레이션 참고 사항

ClientFoundCb 시그니처 변경 (develop)

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
});

주요 기능

  • PMKID 캡처 — 클라이언트 연결을 끊지 않고 가짜 연결을 통해 PMKID 추출
  • CSA 주입 — Channel Switch Announcement; PMF를 우회하는 현대적인 deauth 대안
  • 802.11v BTM 주입 — BSS Transition Management Request; 클라이언트가 재연결하도록 정중하게 유도
  • 클래식 Deauth — PMF가 없는 레거시 네트워크를 위한 Reason-7 deauthentication
  • 클라이언트 자극 — QoS Null Data 프레임으로 절전 중인 기기 깨우기
  • 엔터프라이즈 자격 증명 수집 — EAP-Identity 및 순수 EAP-MSCHAPv2 교환을 수동적으로 캡처
  • WPS M1 캡처 — 암호화되지 않은 WPS Enrollee M1 메시지에서 기기 지문 속성 수집
  • 숨겨진 네트워크 탐색 — 지향성 프로브 요청을 통한 SSID 노출 해제; 선택적 워드리스트 순환
  • VHT/HE 감지 — 802.11ac/ax IE를 파싱하여 AP별 채널 폭 및 Wi-Fi 세대 노출
  • 기기 지문 인식 — MAC OUI 및 IE 시그니처를 통해 150개 이상의 IoT/소비자 브랜드 식별
  • 내보내기 형식 — 스트리밍 PCAPNG (Wireshark 호환); Hashcat용 보조 HC22000; Wigle CSV
  • 수동 모션 감지 — RSSI 분산 분석으로 고정 앵커 AP를 통해 사람의 존재와 움직임 감지; 기기 불필요, 모드 전환 없음, 감사 엔진과 함께 실행

아키텍처

이 라이브러리는 채널 호핑, 대상 선택, 공격 실행 및 캡처 처리를 관리하는 비차단 상태 머신을 중심으로 구축되었습니다. 모든 작업은 politician 네임스페이스 내에 포함됩니다.

핵심 헤더

헤더설명
Politician.h메인 엔진 클래스 — 모든 프로젝트에 포함
PoliticianTypes.h공개 구조체, 열거형 및 컴파일 타임 기능 게이트
PoliticianStorage.hSD 카드 로거 및 NVS 영속성 (Arduino 전용)
PoliticianFormat.hPCAPNG 및 HC22000 직렬화 기본 요소
PoliticianStress.h선택적 DoS 페이로드 (SAE 플러드, 프로브 플러드, 비콘 플러드)
PoliticianProbe.h숨겨진 SSID 프로빙을 위한 선택적 PROGMEM 워드리스트
PoliticianWPS.h선택적 WPS M1 출력 헬퍼 및 비트마스크 상수
PoliticianSense.h선택적 수동 RSSI 기반 모션 및 존재 감지

공격 모드

모드비트설명
ATTACK_PMKID0x01가짜 연결을 통한 PMKID 피싱
ATTACK_CSA0x02Channel Switch Announcement 주입
ATTACK_PASSIVE0x04수신 전용 — 전송 없음
ATTACK_DEAUTH0x08클래식 Reason-7 deauthentication
ATTACK_STIMULATE0x10QoS Null Data 클라이언트 자극
ATTACK_BTM0x20802.11v BSS Transition Management Request
ATTACK_ALL0x3F모든 활성 공격 벡터

컴파일 타임 기능 게이트

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의 루프 오버헤드를 제거하십시오.

설치

PlatformIO

[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
    Politician

프로젝트의 lib/ 디렉터리에 직접 클론하거나:

cd lib/
git clone https://github.com/0ldev/Politician.git

Arduino IDE

  1. 라이브러리를 ZIP 파일로 다운로드합니다
  2. Sketch → Include Library → Add .ZIP Library

ESP-IDF

프로젝트의 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_flash API를 직접 사용하세요.

빠른 시작

기본 핸드셰이크 캡처

#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();
}

Bare ESP-IDF 빠른 시작

#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);
}

API 레퍼런스

초기화

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
도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →