ESP-IDF v5+/v6+ पर एक-कमांड objcopy --weaken-symbol पैच के माध्यम से रॉ 802.11 फ़्रेम इंजेक्शन। esp_wifi_80211_tx() के माध्यम से Authentication (SAE Commit), Deauth, Reassoc, Disassoc, और Control फ़्रेम (RTS/CTS/ACK) सक्षम करता है
ESP-IDF v5.x / v6.x पर रॉ 802.11 फ़्रेम इंजेक्शन। एक-कमांड, प्रतिवर्ती पैच जो esp_wifi_80211_tx() के माध्यम से प्रसारण के लिए 802.11 फ़्रेम प्रकारों के पूर्ण सेट (Authentication, Deauth, Assoc, Reassoc, Disassoc, RTS/CTS/ACK, …) को पुनः सक्षम करता है, जिसे Espressif की शिप की गई libnet80211.a एक छोटी व्हाइटलिस्ट (Beacon, Probe Req/Resp, Action, non-QoS Data) तक सीमित करती है।
इसमें शामिल हैं:
patch/patch_libnet80211.sh) — एक सिंबल पर objcopy --weaken-symbol, बैकअप और --revert के साथ।example/) जो पाँच फ़्रेम वेरिएंट इंजेक्ट करता है और सीरियल पर परिणाम रिपोर्ट करता है।docs/esp32_raw_tx_report.pdf)।पहले के सामुदायिक प्रोजेक्ट (wsl_bypasser, esp32-wifi-penetration-tool, Atomic-SAQuery, …) ब्लॉब फ़ंक्शन ieee80211_raw_frame_sanity_check के strong-C-symbol ओवरराइड पर निर्भर थे। वह तकनीक ESP-IDF v5 के आसपास चुपचाप काम करना बंद कर दी: ब्लॉब सिंबल की बाइंडिंग WEAK से STRONG में बदल गई, इसलिए ओवरराइड अब लिंक समय पर multiple-definition त्रुटि के साथ विफल हो जाता है।
स्पष्ट फ़ॉलबैक (-Wl,--wrap=ieee80211_raw_frame_sanity_check) भी चुपचाप विफल होता है: GNU ld --wrap केवल अपरिभाषित, अंतर-ऑब्जेक्ट संदर्भों को फिर से लिखता है, लेकिन जो कॉल मायने रखती है — esp_wifi_80211_tx → sanity_check — वह ieee80211_output.o के भीतर अंतर-ऑब्जेक्ट है, जो --wrap के लिए अदृश्य है।
यह रेपो ब्रेकिंग परिवर्तन का दस्तावेज़ीकरण करता है और एक कार्यशील विकल्प प्रदान करता है: objcopy --weaken-symbol के साथ ब्लॉब सिंबल को वापस WEAK में बदलें, फिर ऐप कोड में ओवरराइड प्रदान करें। ग्लोबल strong-beats-weak रिज़ॉल्यूशन हर संदर्भ को फिर से बाइंड करता है, जिसमें अंतर-ऑब्जेक्ट वाला भी शामिल है।
फ़्रेम-प्रकार व्हाइटलिस्ट के डिसअसेम्बली, तीन विफल प्रयासों, और एंड-टू-एंड सत्यापन साक्ष्य सहित पूर्ण इंजीनियरिंग ट्रेस के लिए docs/esp32_raw_tx_report.pdf देखें।
# Assumes IDF is at $IDF_PATH. Override with LIBNET80211=... if needed.
bash patch/patch_libnet80211.sh
# Verify (should print "W" after; "T" means not patched)
xtensa-esp32-elf-nm $IDF_PATH/components/esp_wifi/lib/esp32/libnet80211.a \
| grep ieee80211_raw_frame_sanity_check
# 0000005c W ieee80211_raw_frame_sanity_check ← correct
पैच इडेम्पोटेंट है; इसे दोबारा चलाना एक नो-ऑप है। वापस लाने के लिए:
bash patch/patch_libnet80211.sh --revert
मूल संग्रह का एक बैकअप पहली बार चलाने पर libnet80211.a.bak के रूप में सहेजा जाता है।
cd example
idf.py set-target esp32
idf.py build flash monitor
सीरियल आउटपुट को हर 4 सेकंड में पाँच वेरिएंट्स के माध्यम से चक्रित होना चाहिए, प्रत्येक
esp_wifi_80211_tx() -> ESP_OK की रिपोर्ट करता है:
I (xxxxx) INJ-DEMO: >>> Sending V0 Deauth (control) esp_wifi_80211_tx() -> ESP_OK
I (xxxxx) INJ-DEMO: >>> Sending V1 Open-Auth (baseline) esp_wifi_80211_tx() -> ESP_OK
I (xxxxx) INJ-DEMO: >>> Sending V2 SAE-Commit bare esp_wifi_80211_tx() -> ESP_OK
I (xxxxx) INJ-DEMO: >>> Sending V3 SAE-Commit full (malformed) esp_wifi_80211_tx() -> ESP_OK
I (xxxxx) INJ-DEMO: >>> Sending V4 SAE-Commit valid (scalar=2,E=G)
esp_wifi_80211_tx() -> ESP_OK
यदि इसके बजाय आपको हर चक्र में E (xxxxx) wifi:unsupport frame type: 0b0 दिखाई देता है, तो पैच लागू नहीं हुआ; patch_libnet80211.sh और idf.py fullclean build flash को फिर से चलाएँ।
उसी चैनल पर मॉनिटर मोड में एक और Wi-Fi एडाप्टर इंगित करें और tcpdump / Wireshark चलाएँ। उदाहरण कैप्चर के लिए evidence/ देखें।
शोध पत्र से तालिका (तालिका 1):
| फ़्रेम प्रकार | सबटाइप स्टॉक में अनुमत | सबटाइप स्टॉक में अस्वीकृत, इस पैच द्वारा सक्षम |
|---|---|---|
| MGMT (0) | 4 (ProbeReq), 5 (ProbeResp), 6 (TimingAd), 7, 8 (Beacon), 13 (Action) | 0 Assoc, 1 AssocResp, 2 Reassoc, 3 ReassocResp, 9 ATIM, 10 Disassoc, 11 Auth, 12 Deauth |
| CTRL (1) | (कोई नहीं) | सभी (RTS, CTS, ACK, BlockAck, …) |
| DATA (2) | 0–7 (गैर-QoS) | 8–15 (QoS वेरिएंट) |
sanity_check गेट को हटाता है। MAC हार्डवेयर, MLME स्टेट मशीन, और TX शेड्यूलर अभी भी अपने स्वयं के प्रतिबंध लागू करते हैं। व्यवहार में इसका अर्थ है कि mgmt फ़्रेम विश्वसनीय रूप से इंजेक्ट होते हैं; कंट्रोल फ़्रेम (RTS/CTS/ACK) भेजे जाते हैं लेकिन उचित IEEE 802.11 टाइमिंग (SIFS समय-सीमा) के लिए उपयोगकर्ता-स्थान से बहुत देर से हो सकते हैं। कंटेंट फ़ज़िंग के लिए, टाइमिंग मायने नहीं रखती; प्रोटोकॉल-अनुरूप इंटरैक्शन के लिए, यह मायने रखती है।patch_libnet80211.sh --revert बैकअप से स्टॉक फ़ाइल को पुनर्स्थापित करता है।T है तो v5.x और अन्य लक्ष्यों (ESP32-S2/S3/C-सीरीज़) पर काम करना चाहिए — पहले nm से जाँचें, ऊपर "सत्यापित करें" चरण देखें।यहाँ की तकनीकें कच्चे 802.11 फ़्रेम ट्रांसमिशन को सक्षम करती हैं, जिसके दोनों अनुसंधान/रक्षात्मक उपयोग (फ़ज़िंग, PMF परीक्षण, साइड-चैनल मापन — प्रेरक उपयोग मामला) और विरोधी उपयोग (उन नेटवर्कों के विरुद्ध डीऑथ तूफ़ान जो आपके नहीं हैं) हैं। केवल उन Wi-Fi नेटवर्कों और उपकरणों के विरुद्ध संचालन करें जो आपके स्वयं के हैं या जिनके परीक्षण के लिए आपके पास स्पष्ट लिखित प्राधिकरण है। तृतीय-पक्ष अवसंरचना के विरुद्ध अनधिकृत संचालन अधिकांश क्षेत्राधिकारों में अवैध है।
लेखक इस पैच का उपयोग NHSM, अल्जीयर्स में एक पृथक प्रयोगशाला वातावरण में, WPA3-SAE साइड-चैनल विश्लेषण पर एक मास्टर थीसिस के लिए करता है।
.
├── README.md — this file
├── LICENSE — MIT
├── patch/
│ └── patch_libnet80211.sh — the patch script
├── example/ — minimal demo IDF project
│ ├── CMakeLists.txt
│ └── main/
│ ├── CMakeLists.txt
│ └── main.c
├── docs/
│ └── esp32_raw_tx_report.pdf — full engineering writeup
└── evidence/
├── README.md — what each file proves
├── sae_injection_first_capture.pcap — monitor-mode OTA capture
├── tshark_injected_frames.txt — decoded frame list
├── hostapd_v4_roundtrip.log — Hostapd parse + response
└── serial_log_post_bypass.txt — ESP32 serial, no reject log
risinek/wsl_bypasser — मूल समान-नाम-ओवरराइड दृष्टिकोण।
IDF ≤ v4.x पर काम करता है; v5+ पर चुपचाप टूट जाता है जैसा कि यहाँ प्रलेखित है।risinek/esp32-wifi-penetration-tool — wsl_bypasser पर निर्भर करता है;
वही सीमा।Matheus-Garbelini/esp32_esp8266_attacks — अकादमिक CVE PoC,
केवल बीकन-आधारित इंजेक्शन तक सीमित।यदि आप इस पैच या राइटअप का उपयोग अकादमिक कार्य में करते हैं, तो कृपया उद्धृत करें:
Mehdi Mansour. "Enabling Raw 802.11 Management Frame Injection on
ESP-IDF v6: A Linker-Level Analysis of ieee80211_raw_frame_sanity_check
and a Reproducible Bypass." Technical report, École Nationale
Supérieure de Mathématiques (NHSM), Algiers, October 2026.
Mehdi Mansour — क्रिप्टोग्राफी, कोडिंग और सुरक्षा विभाग, NHSM अल्जीयर्स। संपर्क: [email protected] · LinkedIn
MIT। देखें LICENSE।