
Biblioteca moderna de auditoria WiFi para ESP32 usando técnicas avançadas de 802.11. Captura handshakes WPA/WPA2/WPA3 via extração de PMKID e injeção de CSA (contorna PMF). Colhe credenciais corporativas, suporta banda dupla (2.4GHz/5GHz no ESP32-C6), exporta para PCAPNG/Hashcat. API C++ limpa com 9 exemplos.
Uma biblioteca sofisticada de auditoria WiFi para microcontroladores ESP32
Politician é uma biblioteca C++ embarcada projetada para auditoria de segurança WiFi em plataformas ESP32. Ela fornece uma API limpa e moderna para capturar handshakes WPA/WPA2/WPA3 e coletar credenciais corporativas usando técnicas avançadas de protocolo 802.11.
ClientFoundCb foi alterado de (const uint8_t *bssid, const uint8_t *sta, int8_t rssi) para (const ClientRecord &rec). Atualize os callbacks existentes:
// 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
});
A biblioteca é construída em torno de uma máquina de estados não bloqueante que gerencia o salto de canais, a seleção de alvos, a execução de ataques e o processamento de capturas. Todas as operações estão contidas no namespace politician.
| Header | Descrição |
|---|---|
Politician.h | Classe principal do motor — inclua em todos os projetos |
PoliticianTypes.h | Structs públicos, enums e gates de recursos em tempo de compilação |
PoliticianStorage.h | Loggers em cartão SD e persistência NVS (somente Arduino) |
PoliticianFormat.h | Primitivas de serialização PCAPNG e HC22000 |
PoliticianStress.h | Payloads DoS opcionais (SAE flood, probe flood, beacon flood) |
PoliticianProbe.h | Wordlist PROGMEM opcional para sondagem de SSID oculto |
PoliticianWPS.h | Helpers de impressão WPS M1 opcionais e constantes de bitmask |
PoliticianSense.h | Sensoriamento passivo de movimento e presença baseado em RSSI, opcional |
| Modo | Bit | Descrição |
|---|---|---|
ATTACK_PMKID | 0x01 | Pesca de PMKID via associação falsa |
ATTACK_CSA | 0x02 | Injeção de Channel Switch Announcement |
ATTACK_PASSIVE | 0x04 | Somente escuta — zero transmissão |
ATTACK_DEAUTH | 0x08 | Desautenticação Reason-7 clássica |
ATTACK_STIMULATE | 0x10 | Estimulação de clientes com QoS Null Data |
ATTACK_BTM | 0x20 | BSS Transition Management Request 802.11v |
ATTACK_ALL | 0x3F | Todos os vetores de ataque ativos |
Defina qualquer um destes antes de incluir Politician.h ou via seu sistema de build (-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 reverte todos os tipos de callback de std::function<> para ponteiros de função brutos — economizando ~2KB de flash e permitindo o uso em ambientes sem <functional>. Capturas de lambda não estão disponíveis quando esta flag está definida.
POLITICIAN_MAX_INSTANCES (padrão 2) controla o tamanho do registro estático de instâncias usado pelo despachante ISR promíscuo. Defina como 1 para implantações de instância única para eliminar a sobrecarga do loop no ISR.
[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
Politician
Ou clone diretamente no diretório lib/ do seu projeto:
cd lib/
git clone https://github.com/0ldev/Politician.git
Clone no diretório components/ do seu projeto e crie um CMakeLists.txt:
idf_component_register(
SRCS "src/Politician.cpp" "src/PoliticianFormat.cpp" "src/PoliticianStress.cpp"
INCLUDE_DIRS "src"
)
PoliticianStorage.hé exclusivo do Arduino e emite um#errorsob ESP-IDF. Use as APIs VFS envs_flashdo ESP-IDF diretamente.
#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());
Inicializa o driver WiFi em modo promíscuo. Deve ser chamado antes de qualquer outro método. Restringe e emite avisos sobre valores de Config inválidos na inicialização. Use validateConfig() previamente para expor configurações incorretas antes de implantar em campo:
Config cfg;
cfg.hop_min_dwell_ms = 400;
cfg.hop_max_dwell_ms = 200; // wrong — min > max