
Libreria moderna per il WiFi auditing su ESP32 che utilizza tecniche avanzate 802.11. Cattura handshake WPA/WPA2/WPA3 tramite estrazione PMKID e iniezione CSA (bypassa PMF). Raccoglie credenziali enterprise, supporta dual-band (2.4GHz/5GHz su ESP32-C6), esporta in PCAPNG/Hashcat. API C++ pulita con 9 esempi.
Una libreria sofisticata per l'auditing WiFi per microcontroller ESP32
Politician è una libreria C++ embedded progettata per l'auditing della sicurezza WiFi su piattaforme ESP32. Fornisce un'API pulita e moderna per catturare handshake WPA/WPA2/WPA3 e raccogliere credenziali enterprise utilizzando tecniche avanzate del protocollo 802.11.
ClientFoundCb è stato modificato da (const uint8_t *bssid, const uint8_t *sta, int8_t rssi) a (const ClientRecord &rec). Aggiorna i callback esistenti:
// 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 libreria è costruita attorno a una macchina a stati non bloccante che gestisce il channel hopping, la selezione dei target, l'esecuzione degli attacchi e l'elaborazione delle catture. Tutte le operazioni sono contenute nel namespace politician.
| Header | Descrizione |
|---|---|
Politician.h | Classe principale del motore — includerla in ogni progetto |
PoliticianTypes.h | Struct pubbliche, enum e feature gate a tempo di compilazione |
PoliticianStorage.h | Logger su scheda SD e persistenza NVS (solo Arduino) |
PoliticianFormat.h | Primitive di serializzazione PCAPNG e HC22000 |
PoliticianStress.h | Payload DoS opt-in (SAE flood, probe flood, beacon flood) |
PoliticianProbe.h | Wordlist PROGMEM opt-in per il probing di SSID nascosti |
PoliticianWPS.h | Helper opt-in per la stampa WPS M1 e costanti bitmask |
PoliticianSense.h | Rilevamento passivo opt-in di movimento e presenza basato su RSSI |
| Modalità | Bit | Descrizione |
|---|---|---|
ATTACK_PMKID | 0x01 | Pesca dei PMKID tramite associazione falsa |
ATTACK_CSA | 0x02 | Iniezione Channel Switch Announcement |
ATTACK_PASSIVE | 0x04 | Solo ascolto — nessuna trasmissione |
ATTACK_DEAUTH | 0x08 | Deautenticazione classica Reason-7 |
ATTACK_STIMULATE | 0x10 | Stimolazione dei client con QoS Null Data |
ATTACK_BTM | 0x20 | 802.11v BSS Transition Management Request |
ATTACK_ALL | 0x3F | Tutti i vettori di attacco attivi |
Definire uno qualsiasi di questi prima di includere Politician.h o tramite il proprio sistema di 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 riporta tutti i tipi di callback da std::function<> a puntatori a funzione grezzi — risparmiando ~2KB di flash e consentendo l'uso in ambienti privi di <functional>. Le catture lambda non sono disponibili quando questo flag è impostato.
POLITICIAN_MAX_INSTANCES (predefinito 2) controlla la dimensione del registro statico delle istanze utilizzato dal dispatcher ISR promiscuo. Impostare a 1 per distribuzioni a istanza singola per eliminare l'overhead del ciclo nell'ISR.
[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
Politician
Oppure clona direttamente nella directory lib/ del tuo progetto:
cd lib/
git clone https://github.com/0ldev/Politician.git
Clona nella directory components/ del tuo progetto e crea un file CMakeLists.txt:
idf_component_register(
SRCS "src/Politician.cpp" "src/PoliticianFormat.cpp" "src/PoliticianStress.cpp"
INCLUDE_DIRS "src"
)
PoliticianStorage.hè solo per Arduino ed emette un#errorsotto ESP-IDF. Usa direttamente le API VFS envs_flashdi 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());
Inizializza il driver WiFi in modalità promiscua. Deve essere chiamato prima di qualsiasi altro metodo. Limita e avvisa in caso di valori Config non validi all'avvio. Utilizzare validateConfig() in anticipo per far emergere errori di configurazione prima della distribuzione sul campo: