Skip to content
KitploitKITPLOIT
工具漏洞利用博客
Log in
提交
工具漏洞利用博客
提交

黑客、渗透测试和网络安全工具,武装您的安全武器库!

Kitploit 是一个黑客、网络安全和渗透测试工具的目录。发现最新的项目更新,查找漏洞、分析系统、自动化测试并加强你的安全。

订阅源联系隐私© 2026 Kitploit

工具目录

分类

查看所有分类
Loading categories
Politician — 用于ESP32的现代WiFi审计库,使用先进的802.11技术。通过PMKID提取和CSA注入(绕过PMF)捕获WPA/WPA2/WPA3握手。收集企业凭据,支持双频(ESP32-C6上的2.4GHz/5GHz),导出到PCAPNG/Hashcat。干净的C++ API,包含9个示例。 | Kitploit
工具/GitHubGitHub/0ldev/politician
嵌入式系统安全密码破解Wi-Fi审计物联网安全信息收集模糊测试无线安全渗透测试硬件安全
GitHub0ldev/politician

Politician

用于ESP32的现代WiFi审计库,使用先进的802.11技术。通过PMKID提取和CSA注入(绕过PMF)捕获WPA/WPA2/WPA3握手。收集企业凭据,支持双频(ESP32-C6上的2.4GHz/5GHz),导出到PCAPNG/Hashcat。干净的C++ API,包含9个示例。

9361805天前Kitploit 审核通过
分享
查看仓库网站

Politician

一个面向 ESP32 微控制器的精密 WiFi 审计库

License: MIT PlatformIO

Politician 是一个嵌入式 C++ 库,专为 ESP32 平台上的 WiFi 安全审计而设计。它提供简洁、现代的 API,用于利用先进的 802.11 协议技术捕获 WPA/WPA2/WPA3 握手包并收集企业凭据。

迁移说明

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 注入 — 信道切换通告;绕过 PMF 的现代替代方案,取代 deauth
  • 802.11v BTM 注入 — BSS 过渡管理请求;礼貌地引导客户端重新连接
  • 经典 Deauth — 针对无 PMF 的旧式网络使用 Reason-7 解除认证
  • 客户端刺激 — 使用 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_CSA0x02信道切换通告注入
ATTACK_PASSIVE0x04仅监听 — 零传输
ATTACK_DEAUTH0x08经典 Reason-7 解除认证
ATTACK_STIMULATE0x10QoS Null Data 客户端刺激
ATTACK_BTM0x20802.11v BSS 过渡管理请求
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 flash,并使其可在没有 <functional> 的环境中使用。设置此标志时,Lambda 捕获不可用。

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

裸 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

    // ── CSA / Deauth ─────────────────────────────────────────────────────────
    uint32_t csa_wait_ms              = 4000;   // Wait window after CSA/Deauth burst (ms)
    uint8_t  csa_beacon_count         = 8;      // CSA beacon frames per burst
    uint8_t  csa_deauth_count         = 15;     // Deauth frames appended to CSA burst
    uint8_t  deauth_burst_count       = 16;     // Frames per standalone deauth burst
    uint8_t  deauth_reason            = 7;      // 802.11 reason code in deauth frames
    bool     deauth_reason_cycling    = true;   // Cycle reason codes during burst (fuzzing)

    // ── 802.11v BTM ──────────────────────────────────────────────────────────
    uint8_t  btm_burst_count          = 8;      // BTM Request frames per client per trigger
    uint16_t btm_disassoc_timer       = 3;      // Disassociation Timer in TBTTs (~300ms)
下载工具

最受欢迎

查看全部 →

发现我们社区最常用的工具。

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 终极 OSINT 工具包:调查图谱、置信度评分、别名家族、地图、时间线和报告。49 个模块、400+ 个站点,无需 API 密钥。

    516
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock 一键执行应用(CVE-2026-43499)

    476
  • 3

    ARTEX

    baarai/artex

    基于LLM的多智能体自主渗透测试平台,具备规划器/执行器智能体、资产与探索图谱、MITM流量记录以及漏洞复测功能。

    355
  • 4

    redforge

    cybersecurity91/redforge

    浏览器端红队工具包,包含 102 个离线工具,用于侦察、载荷生成、凭据攻击、加密、编码和交战报告。

    315
  • 5

    estorides

    grisuno/estorides

    并行聚合 99+ 个免费 OSINT 来源,将实体解析为知识图谱,并借助 LLM 辅助分析导出 STIX 2.1、MISP 或 GraphML。

    303
  • 6

    opencti

    opencti-platform/opencti

    开放式网络威胁情报平台

    285

探索所有工具

浏览我们的工具集合

查看所有工具 →