Spoof Toolkit v2.1

प्रोफेशनल-ग्रेड async Python नेटवर्क स्पूफिंग सूट इंटरैक्टिव मेनू-चालित UI · पूर्ण IPv4/IPv6 कवरेज · Responder-शैली पॉइज़निंग केवल अधिकृत सुरक्षा परीक्षण के लिए — by amibhai

अस्वीकरण: यह टूल केवल शैक्षिक उद्देश्यों और अधिकृत सुरक्षा ऑडिटिंग के लिए है। लेखक कोई दायित्व नहीं स्वीकार करते और इस प्रोग्राम के किसी भी दुरुपयोग या क्षति के लिए ज़िम्मेदार नहीं हैं। इस टूल का उपयोग उन नेटवर्क पर न करें जो आपके स्वामित्व में नहीं हैं या जिनके परीक्षण के लिए आपके पास स्पष्ट, लिखित अनुमति नहीं है।

v2.1 में नया क्या है

मॉड्यूल	विवरण
`attacks/deauth.py`	802.11 डीऑथेंटिकेशन — क्लाइंट्स को किक करें, WPA हैंडशेक कैप्चर करें
`attacks/beacon_flood.py`	802.11 बीकन फ्लड — नकली SSID स्टॉर्म
`attacks/llmnr_nbt.py`	LLMNR + NBT-NS + mDNS पॉइज़निंग (Responder-शैली हैश कैप्चर)
`attacks/icmpv6_ra.py`	ICMPv6 राउटर एडवर्टाइज़मेंट स्पूफ — IPv6 गेटवे हाईजैक
`attacks/ndp_spoof.py`	IPv6 NDP नेबर एडवर्टाइज़मेंट पॉइज़न — IPv6 ARP स्पूफ
`attacks/captive_portal.py`	कैप्टिव पोर्टल (होटल/कॉर्पोरेट/कैफ़े/ISP टेम्पलेट्स)
`attacks/wpad.py`	WPAD प्रॉक्सी ऑटो-कॉन्फ़िग इंजेक्शन
`core/platform_compat.py`	macOS pf + Linux iptables + Windows netsh एब्स्ट्रैक्शन
टाइमिंग जिटर	IDS से बचने के लिए हर पैकेट बर्स्ट पर ±N-सेकंड रैंडम देरी
GitHub Actions CI	Python 3.10–3.12 में pytest + mypy + कवरेज गेट (≥80%)
Docker	पोर्टेबल डिप्लॉयमेंट के लिए `docker build` + `docker-compose up`
pyproject.toml	आधुनिक पैकेजिंग, mypy स्ट्रिक्ट कॉन्फ़िग, ruff लिंट, कवरेज कॉन्फ़िग

एक नज़र में विशेषताएँ

विशेषता	विवरण
प्राधिकरण	Rules-of-engagement स्कोप फ़ाइल — किसी भी स्कोप-से-बाहर या विंडो-से-बाहर लक्ष्य के लिए लाइव फ़ायर अस्वीकार कर दिया जाता है; स्कोप नहीं ⇒ केवल ड्राई-रन
आर्किटेक्चर	100% async Python 3.10+ — शून्य `threading.Thread`
UI	एनिमेटेड 256-रंग बैनर + क्रमांकित मेनू + ब्रेडक्रम्ब्स
डैशबोर्ड	PRISM लाइव 3-पैनल TUI (अटैक लॉग / पैकेट आँकड़े / क्रेडेंशियल्स)
लॉगिंग	HMAC-SHA256-चेन्ड structlog ऑडिट ट्रेल (छेड़छाड़-स्पष्ट)
रिपोर्ट	हर सत्र के बाद स्वतः-जनित JSON + Markdown + HTML
भाषाएँ	`LANG` से ऑटो-डिटेक्ट + मैन्युअल स्विच (en, hi, ar, zh, fr, es)
प्रीफ़्लाइट	17-जाँच प्रणाली (स्कोप, root, Python, डिपेंडेंसी, इंटरफ़ेस, टर्मिनल)
क्लीनअप	`finally` में हमेशा ARP/NDP टेबल, iptables/pf नियम बहाल करता है
प्लेटफ़ॉर्म	Linux (पूर्ण) · macOS (pf बैकएंड) · Windows (Npcap, सीमित)

Rules of Engagement (प्राधिकरण और स्कोप नियंत्रण)

वास्तविक एंगेजमेंट एक हस्ताक्षरित स्कोप द्वारा परिभाषित होते हैं। यह टूलकिट कोड में इसे लागू करता है: यह किसी भी ऐसे लक्ष्य पर एक भी पैकेट प्रसारित नहीं करेगा जो स्पष्ट रूप से अधिकृत नहीं है, किसी खुली एंगेजमेंट विंडो के भीतर। यही एक प्रोफेशनल रेड-टीम उपकरण और एक अंधाधुंध स्क्रिप्ट के बीच का अंतर है।

यह कैसे काम करता है

एंगेजमेंट को एक बार JSON (या YAML) स्कोप फ़ाइल में घोषित करें — देखें rules/engagement.example.json।
SPOOF_TOOLKIT_SCOPE एनवायरनमेंट वेरिएबल के माध्यम से टूलकिट को उस पर इंगित करें।
हर अटैक मॉड्यूल किसी लक्ष्य को छूने से पहले Session.guard(...) को कॉल करता है। अधिकृत रेंज के बाहर का लक्ष्य — या बंद हो चुकी एंगेजमेंट विंडो — AuthorizationError उठाता है और हमला अस्वीकार कर दिया जाता है।
कोई स्कोप लोड नहीं ⇒ केवल ड्राई-रन। पैकेट अभी भी तैयार और सत्यापित किए जाते हैं (प्रशिक्षण, डेमो और CI के लिए बेहतरीन) लेकिन कभी वायर पर नहीं डाले जाते।
लागू प्राधिकरण — जिसमें SHA-256 fingerprint भी शामिल है — HMAC-चेन्ड ऑडिट लॉग और हर सत्र रिपोर्ट में लिखा जाता है, ताकि रिपोर्ट साबित करे कि वास्तव में क्या अधिकृत था।

# 1. Copy and edit the template with your engagement details + authorized targets
cp rules/engagement.example.json rules/my-engagement.json

# 2. Point the toolkit at it (enables live fire for in-scope targets only)
export SPOOF_TOOLKIT_SCOPE=rules/my-engagement.json

# 3. Verify it loaded and the window is open
sudo -E python3 spoof_toolkit.py --preflight

स्कोप फ़ाइल फ़ील्ड

फ़ील्ड	अर्थ
`engagement_id`	आवश्यक — अद्वितीय एंगेजमेंट पहचानकर्ता
`authorized_by`	आवश्यक — परीक्षण को अधिकृत करने वाला नामित पक्ष (SOW / टिकट)
`client`, `operator`, `contact`, `notes`	ऑडिट ट्रेल के लिए एंगेजमेंट मेटाडेटा
`start`, `end`	ISO-8601 विंडो (यदि कोई ऑफ़सेट नहीं है तो UTC माना जाता है); ओपन-एंडेड के लिए कोई भी सीमा छोड़ी जा सकती है
`authorized_networks`	IPv4/IPv6 CIDR या बेयर होस्ट जिन्हें लक्षित किया जा सकता है
`authorized_macs` / `authorized_ssids` / `authorized_bssids`	L2 / वायरलेस लक्ष्यीकरण के लिए अनुमति-सूचियाँ
`denied_networks` / `denied_macs`	नो-स्ट्राइक सूचियाँ — हमेशा अनुमति-सूचियों को ओवरराइड करती हैं

डिज़ाइन से फ़ेल-क्लोज़्ड: एक खाली अनुमति-सूची किसी भी चीज़ को अधिकृत नहीं करती, और denied_networks प्रविष्टि पर सीमा-के-भीतर का होस्ट (जैसे किसी अन्यथा-अधिकृत /24 के भीतर एक डोमेन कंट्रोलर) अस्वीकार कर दिया जाता है।

सेफ़ मोड। session.safe_mode = True एक वैध स्कोप लोड होने पर भी ड्राई-रन को बाध्य करता है — इसका उपयोग किसी एंगेजमेंट को बिना ट्रांसमिट किए एंड-टू-एंड रिहर्सल करने के लिए करें।

अटैक मॉड्यूल

लेयर 2 / 3 (ईथरनेट · IP)

मॉड्यूल	फ़ाइल	विवरण
ARP स्पूफ़िंग	`attacks/arp_spoof.py`	कैश पॉइज़न — MitM, DoS, वन-वे, गेटवे-ओनली
DNS स्पूफ़िंग	`attacks/dns_spoof.py`	रिस्पॉन्स इंजेक्शन — सेलेक्टिव, स्पूफ़-ऑल, रूल्स फ़ाइल, NXDOMAIN
संयुक्त MitM	`attacks/combined_mitm.py`	पूर्ण ARP + DNS + क्रेडेंशियल कैप्चर (asyncio.TaskGroup)
SSL स्ट्रिप	`attacks/ssl_strip.py`	पारदर्शी HTTPS डाउनग्रेड प्रॉक्सी (Linux/macOS)
रोग DHCP	`attacks/rogue_dhcp.py`	नकली DHCP सर्वर के माध्यम से डिफ़ॉल्ट गेटवे हाईजैक (स्टेल्थी)
LLMNR/NBT-NS	`attacks/llmnr_nbt.py`	नया — LLMNR + NBT-NS + mDNS पॉइज़निंग, NTLMv2 हैश कैप्चर
WPAD	`attacks/wpad.py`	नया — ब्राउज़र प्रॉक्सी ऑटो-कॉन्फ़िग इंजेक्शन
कैप्टिव पोर्टल	`attacks/captive_portal.py`	नया — 4 टेम्पलेट्स के साथ नकली लॉगिन पेज

802.11 वायरलेस

मॉड्यूल	फ़ाइल	विवरण
डीऑथ	`attacks/deauth.py`	नया — 802.11 डीऑथेंटिकेशन (लक्षित + ब्रॉडकास्ट), WPA हैंडशेक कैप्चर
बीकन फ़्लड	`attacks/beacon_flood.py`	नया — सैकड़ों नकली SSID के साथ एयरवेव्स को फ़्लड करें
AP स्कैनर	`attacks/deauth.py`	नया — पैसिव 802.11 बीकन स्कैनर
क्लाइंट स्कैनर	`attacks/deauth.py`	नया — किसी AP से जुड़े क्लाइंट्स का पता लगाएँ

IPv6

मॉड्यूल	फ़ाइल	विवरण
RA स्पूफ़	`attacks/icmpv6_ra.py`	नया — ICMPv6 राउटर एडवर्टाइज़मेंट (डिफ़ॉल्ट गेटवे हाईजैक)
NDP स्पूफ़	`attacks/ndp_spoof.py`	नया — नेबर एडवर्टाइज़मेंट पॉइज़न (IPv6 ARP समकक्ष)
पूर्ण IPv6 MitM	(कॉम्बो)	नया — पूर्ण IPv6 इंटरसेप्ट के लिए RA + NDP + IPv6 फ़ॉरवर्डिंग

त्वरित शुरुआत

# 1. Install
sudo bash install.sh

# 1b. Authorize an engagement (required for live fire — otherwise dry-run only)
cp rules/engagement.example.json rules/my-engagement.json   # then edit it
export SPOOF_TOOLKIT_SCOPE=rules/my-engagement.json

# 2. Run (interactive menu)
sudo -E spoof-toolkit

# 3. Or run directly
sudo python3 spoof_toolkit.py

# 4. Preflight check
sudo python3 spoof_toolkit.py --preflight

# 5. Launch PRISM dashboard directly
sudo python3 spoof_toolkit.py --prism

spoofed

सबसे लोकप्रिय