
Современная библиотека для аудита WiFi на ESP32, использующая продвинутые техники 802.11. Захватывает рукопожатия WPA/WPA2/WPA3 через извлечение PMKID и инъекцию CSA (в обход PMF). Собирает корпоративные учётные данные, поддерживает двухдиапазонный режим (2.4 ГГц/5 ГГц на ESP32-C6), экспортирует в PCAPNG/Hashcat. Чистый C++ API с 9 примерами.
Изысканная библиотека для аудита WiFi для микроконтроллеров ESP32
Politician — это встраиваемая библиотека C++, предназначенная для аудита безопасности WiFi на платформах ESP32. Она предоставляет чистый, современный API для перехвата рукопожатий WPA/WPA2/WPA3 и сбора корпоративных учётных данных с использованием продвинутых техник протокола 802.11.
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 flood, probe flood, beacon flood) |
PoliticianProbe.h | Опциональный словарь в PROGMEM для зондирования скрытых SSID |
PoliticianWPS.h | Опциональные вспомогательные функции вывода WPS M1 и константы битовых масок |
PoliticianSense.h | Опциональное пассивное обнаружение движения и присутствия на основе RSSI |
| Режим | Бит | Описание |
|---|---|---|
ATTACK_PMKID | 0x01 | Ловля PMKID через поддельную ассоциацию |
ATTACK_CSA | 0x02 | Инъекция Channel Switch Announcement |
ATTACK_PASSIVE | 0x04 | Только прослушивание — нулевая передача |
ATTACK_DEAUTH | 0x08 | Классическая деаутентификация с кодом причины 7 |
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 возвращает все типы callback-функций от std::function<> к необработанным указателям на функции — экономия ~2 КБ flash и возможность использования в средах без <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 и выдаёт#errorпод ESP-IDF. Используйте напрямую VFS и APInvs_flashиз ESP-IDF.
#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 в режиме promiscuous. Должен быть вызван перед любым другим методом. Ограничивает и предупреждает о недопустимых значениях Config при запуске. Используйте validateConfig() заранее, чтобы выявить ошибки конфигурации до развёртывания в полевых условиях: