
Bibliothèque moderne d'audit WiFi pour ESP32 utilisant des techniques 802.11 avancées. Capture les handshakes WPA/WPA2/WPA3 via l'extraction PMKID et l'injection CSA (contourne la PMF). Collecte les identifiants d'entreprise, prend en charge la bi-bande (2.4GHz/5GHz sur ESP32-C6), exporte vers PCAPNG/Hashcat. API C++ propre avec 9 exemples.
Une bibliothèque d'audit WiFi sophistiquée pour les microcontrôleurs ESP32
Politician est une bibliothèque C++ embarquée conçue pour l'audit de sécurité WiFi sur les plateformes ESP32. Elle fournit une API propre et moderne pour capturer les handshakes WPA/WPA2/WPA3 et récolter des identifiants d'entreprise à l'aide de techniques avancées du protocole 802.11.
ClientFoundCb a été modifié de (const uint8_t *bssid, const uint8_t *sta, int8_t rssi) en (const ClientRecord &rec). Mettez à jour les callbacks existants :
// 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 bibliothèque est construite autour d'une machine à états non bloquante gérant le saut de canal, la sélection de cible, l'exécution des attaques et le traitement des captures. Toutes les opérations sont contenues dans l'espace de noms politician.
| En-tête | Description |
|---|---|
Politician.h | Classe du moteur principal — à inclure dans chaque projet |
PoliticianTypes.h | Structures publiques, énumérations et portes de fonctionnalités à la compilation |
PoliticianStorage.h | Journalisation sur carte SD et persistance NVS (Arduino uniquement) |
PoliticianFormat.h | Primitives de sérialisation PCAPNG et HC22000 |
PoliticianStress.h | Charges utiles DoS optionnelles (SAE flood, probe flood, beacon flood) |
PoliticianProbe.h | Liste de mots PROGMEM optionnelle pour le sondage de SSID cachés |
PoliticianWPS.h | Aides d'impression WPS M1 optionnelles et constantes de masque de bits |
PoliticianSense.h | Détection passive de mouvement et de présence basée sur le RSSI, optionnelle |
| Mode | Bit | Description |
|---|---|---|
ATTACK_PMKID | 0x01 | Pêche au PMKID via fausse association |
ATTACK_CSA | 0x02 | Injection de Channel Switch Announcement |
ATTACK_PASSIVE | 0x04 | Écoute seule — zéro transmission |
ATTACK_DEAUTH | 0x08 | Déauthentification Reason-7 classique |
ATTACK_STIMULATE | 0x10 | Stimulation de clients par QoS Null Data |
ATTACK_BTM | 0x20 | BSS Transition Management Request 802.11v |
ATTACK_ALL | 0x3F | Tous les vecteurs d'attaque actifs |
Définissez l'une de ces options avant d'inclure Politician.h ou via votre système 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 fait revenir tous les types de callback de std::function<> vers des pointeurs de fonction bruts — économisant ~2KB de flash et permettant l'utilisation dans des environnements sans <functional>. Les captures lambda ne sont pas disponibles lorsque cet indicateur est défini.
POLITICIAN_MAX_INSTANCES (par défaut 2) contrôle la taille du registre d'instances statique utilisé par le répartiteur ISR promiscuous. Définissez-le à 1 pour les déploiements mono-instance afin d'éliminer la surcharge de boucle dans l'ISR.
[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
Politician
Ou clonez directement dans le répertoire lib/ de votre projet :
cd lib/
git clone https://github.com/0ldev/Politician.git
Clonez dans le répertoire components/ de votre projet et créez un fichier CMakeLists.txt :
idf_component_register(
SRCS "src/Politician.cpp" "src/PoliticianFormat.cpp" "src/PoliticianStress.cpp"
INCLUDE_DIRS "src"
)
PoliticianStorage.hest réservé à Arduino et émet une#errorsous ESP-IDF. Utilisez directement les API VFS etnvs_flashd'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());