toha3ee

Go में लिखा गया एक स्थानीय एवं नेटवर्क सुरक्षा मूल्यांकन फ्रेमवर्क। यह एक शोध और अधिकृत पैठ-परीक्षण (penetration testing) उपकरण है जो नेटवर्क मूल्यांकन पाइपलाइन — होस्ट एवं सेवा खोज, enumeration, क्रेडेंशियल ऑडिटिंग, कमज़ोरी पहचान और अधिकृत शोषण — को कवर करता है। इसकी दस मॉड्यूल श्रेणियाँ recon, enumeration, OSINT, MITM (ARP/DHCP/DNS/IPv6 poisoning और inline HTTP/HTTPS interception), wireless, switch-layer, web, auth, espionage और post-exploitation तक फैली हैं — सभी एक इंटरैक्टिव REPL, एक निर्देशित विज़ार्ड, या एक-शॉट कमांड अनुक्रमों से संचालित होती हैं।

MITM इस व्यापक डोमेन के भीतर एक क्षमता है: TOHA3EE केवल man-in-the-middle परिदृश्यों तक सीमित नहीं है।

चेतावनी: toha3ee सक्रिय रूप से नेटवर्क ट्रैफ़िक को पुनर्निर्देशित, विषाक्त (poison), डिक्रिप्ट और इंटरसेप्ट करता है। इसका उपयोग केवल उन नेटवर्कों पर करें जिनके आप स्वामी हैं या जिनके परीक्षण के लिए आप स्पष्ट रूप से अधिकृत हैं। इन मॉड्यूलों को तीसरे पक्षों के विरुद्ध चलाना अधिकांश न्यायक्षेत्रों में अवैध है। पहले docs/security.md पढ़ें।

दस्तावेज़ीकरण

• उपयोगकर्ता — आरंभ करना · उपयोगकर्ता मार्गदर्शिका · स्क्रिप्टिंग · कॉन्फ़िगरेशन · FAQ
• संदर्भ — मॉड्यूल संदर्भ (सभी 73 मॉड्यूल) · रिपोर्टिंग
• डेवलपर — आर्किटेक्चर · योगदान · Changelog
• शासन — सुरक्षा · आचार संहिता · लाइसेंस

इंस्टॉल

वन-लाइनर इंस्टॉलर आपके प्लेटफ़ॉर्म के लिए नवीनतम रिलीज़ से पहले से निर्मित (prebuilt) बाइनरी प्राप्त करते हैं, उसका SHA-256 चेकसम सत्यापित करते हैं और उसे आपके PATH में जोड़ देते हैं। यदि पहले से निर्मित बाइनरी मौजूद नहीं है, तो वे इसके बजाय स्रोत से निर्माण करते हैं।

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.ps1 | iex

या किसी checkout से:

make install   # installs ~/.local/bin/toha3ee and adds it to PATH

इंस्टॉल विकल्प (Unix): --prefix <dir> (डिफ़ॉल्ट: रूट के रूप में /usr/local/bin, अन्यथा ~/.local/bin), शेल rc को संपादित करना छोड़ने के लिए --no-path, डाउनलोड करने के बजाय निर्माण करने के लिए --from-source, और किसी रिलीज़ को पिन करने के लिए TOHA3EE_VERSION=<tag>। सिस्टम-व्यापी इंस्टॉल के लिए sudo sh ... के साथ चलाएँ। Windows इंस्टॉलर बाइनरी को %LOCALAPPDATA%\Programs\toha3ee\bin में रखता है और आपके उपयोगकर्ता PATH को अपडेट करता है; Windows-on-ARM64 x64 बिल्ड चलाता है।

Linux पर इंस्टॉलर ऐप को डेस्कटॉप वातावरण के साथ भी पंजीकृत करता है: यह लोगो को hicolor आइकन थीम में इंस्टॉल करता है और इंस्टॉल प्रीफ़िक्स के पास एक .desktop प्रविष्टि डालता है (जैसे /usr/local/share या ~/.local/share), ताकि toha3ee GNOME की खोज में अपने आइकन के साथ दिखाई दे। Windows पर यह .ico की प्रतिलिपि बनाता है और एक स्टार्ट मेनू शॉर्टकट बनाता है। रिलीज़ tarball/zip आइकन अपने साथ रखते हैं, ताकि इंस्टॉलर उसे उसी सत्यापित आर्टिफ़ैक्ट से पंजीकृत कर सके।

अनइंस्टॉल: बाइनरी और वह PATH पंक्ति हटा दें जो इंस्टॉलर ने आपके शेल rc में जोड़ी थी (या Windows पर %LOCALAPPDATA%\Programs\toha3ee)।

बिल्ड

इसके लिए Go 1.26+ और libpcap आवश्यक है।

# Debian/Ubuntu
sudo apt install libpcap-dev

# then
go build ./cmd/toha3ee

Linux बिल्ड के लिए libpcap हेडर चाहिए (इंस्टॉलर का from-source फ़ॉलबैक उनकी जाँच करता है और यदि वे गायब हैं तो सही apt/dnf कमांड प्रिंट करता है)। macOS Xcode Command Line Tools के साथ libpcap शामिल करता है।

त्वरित आरंभ

# Interactive console (bare command drops straight in)
sudo ./toha3ee --iface eth0

# Interactive console (explicit subcommand)
sudo ./toha3ee interactive --iface eth0

# Guided wizard
sudo ./toha3ee wizard --iface eth0

# One-shot: scan the subnet, then show what was found
sudo ./toha3ee --eval "net.scan; net.show" --iface eth0

# Non-interactive caplet script
sudo ./toha3ee run --iface eth0 caplets/basic.cap

# Dry-run a .toha3ee script (validates it, prints the plan, sends no packets)
./toha3ee --no-sudo build scripts/full-pipeline.toha3ee

# Execute a .toha3ee script non-interactively
sudo ./toha3ee script --iface eth0 scripts/full-pipeline.toha3ee

अधिकांश आक्रमण मॉड्यूलों को root की आवश्यकता होती है (रॉ सॉकेट, पैकेट कैप्चर और IP फ़ॉरवर्डिंग)। root के रूप में या संभव होने पर CAP_NET_ADMIN/CAP_NET_RAW के साथ चलाएँ। रंगीन आउटपुट अक्षम करने के लिए --no-color जोड़ें, विस्तृत लॉगिंग के लिए -v जोड़ें।

यह उपकरण डिफ़ॉल्ट रूप से एडमिन विशेषाधिकारों के साथ चलता है: Linux/macOS पर यह स्वयं को sudo के अंतर्गत पुनः निष्पादित करता है और हर आह्वान पर एडमिन (root) पासवर्ड माँगता है। बिना विशेषाधिकार के चलाने के लिए --no-sudo (या TOHA3EE_NO_SUDO=1 सेट करें) पारित करें, जैसे कि त्वरित toha3ee --no-sudo version के लिए।

आर्किटेक्चर

सब कुछ एक मॉड्यूल है। मॉड्यूल अपने पैकेज init() में स्व-पंजीकरण करते हैं और रजिस्ट्री द्वारा स्वचालित रूप से सामने आते हैं; एक आक्रमण जोड़ने का अर्थ है internal/attacks/ के अंतर्गत एक पैकेज जोड़ना जो attacks.Module अनुबंध को लागू करता है (देखें internal/attacks/attacks.go):

• Meta() — ID, श्रेणी, जोखिम, लक्ष्य, विवरण, सीमाएँ
• Preflight(ctx) — चलाने से पहले पूर्व-शर्तें जाँचें
• Run(ctx, opts) — आक्रमण लूप (ctx.Done का सम्मान करना अनिवार्य है)
• Verify(ctx) — जो हुआ उसकी रिपोर्ट करें
• Cleanup(ctx) — सब कुछ पूर्ववत करें, नेटवर्क को पुनर्स्थापित करें

एक केंद्रीय safety जीवनचक्र (internal/safety) पंजीकृत cleanup और heartbeat को ट्रैक करता है, ताकि panic या SIGINT पर भी हर आक्रमण को समाप्त किया जा सके, और एक साझा store होस्ट इन्वेंट्री, कैप्चर किए गए क्रेडेंशियल, सत्र और इवेंट लॉग रखता है जो रिपोर्ट जनरेटर को फ़ीड करता है।

परतें

मॉड्यूल

पूर्ण, वर्तमान सूची के लिए toha3ee modules चलाएँ। मुख्य आकर्षण:

कंसोल

सादा toha3ee (या toha3ee interactive) एक bettercap/metasploit-शैली कंसोल खोलता है: @@@ बैनर, टैब-पूर्णता वाला लाल-उच्चारित toha3eeλ > प्रॉम्प्ट, और प्रॉम्प्ट के ऊपर एक स्थायी एक-पंक्ति स्थिति HUD जो इंटरफ़ेस, चल रहे मॉड्यूल और लाइव होस्ट/पोर्ट/क्रेडेंशियल/इवेंट गणनाएँ दिखाता है। आउटपुट हरे/एम्बर/सफ़ेद पैलेट में समूहीकृत और संरेखित होता है — लाल रंग जानबूझकर उपयोग किया जाता है, प्रॉम्प्ट उच्चारण, गंभीर त्रुटियों ([x]), HUD किनारे के चिह्न और क्रिटिकल-जोखिम मॉड्यूलों के लिए (उच्च जोखिम एम्बर है)। हर कमांड का आउटपुट अनुभागों में विभाजित होता है (─── modules ───), तालिकाएँ कॉलम-संरेखित होती हैं (संरेखण की गणना करते समय रंगों को अनदेखा किया जाता है), और मॉड्यूल संदेश केंद्रीय रूप से रंगीन किए जाते हैं, जिससे हर मॉड्यूल को बिना किसी प्रति-मॉड्यूल कार्य के लगातार स्थिति ग्लिफ़ मिलते हैं। पाइप किए जाने पर आउटपुट स्वचालित रूप से सादे पाठ में बदल जाता है, और किसी भी मॉड्यूल के चलने के दौरान प्रॉम्प्ट दृश्यमान और सक्रिय रहता है, bettercap की तरह।

$ sudo ./toha3ee --iface eth0
@@@@@@@@
    @@@@@@@@@@@@@
    @@@@@@@@     @@@@@@@
  @@@@@@@@           @@@@@@@@
  @@@@@@@@                 @@@@@@@@
 @@@@@@@         @               @@@@@@@
 @@@@@@@@        @@@@@@@@@              @@@@@@@
 @@@@@@@@         @@@   @                     @@@@@@@
  @@@@@@@            @@       @@@@@@@@@@              @@@@@@@
  @@@@@@    @@        @     @@@@@@@@@@@@@@@@@@             @@@@@@
  @@@        @@@   @@@@@@@  @@@@@@@@@@@@@@@@@@@@@@            @@@
  @@@         @@@@@   @    @@@@@@@@@@@@@@@@@@@@@@@            @@@
  @@@          @@@@@@  @   @@@@@@@@@@@@@@@@@@ @@@             @@@
  @@@          @@@@@@   @ @@@@@@@@@@@@@@@@@   @@@             @@@
  @@@           @@@@@@    @@@@@@@@@@@@@@@@@@@@@@              @@@
  @@@              @@@@@  @@@@@@@@@@@@@@@    @@@              @@@
  @@@               @@@@@  @@@@@@@@@@@@@@   @@@               @@@
  @@@                 @@@    @@@@@@@@@@@@@ @@@@               @@@
  @@@               @@  @@@@  @@@@@   @@@@@@@@@               @@@
  @@@            @@@@@@@@@@@@@  @@@@@@    @@@                 @@@
  @@@        @@@@@@@@@@@@@@@@@@@  @@@@@@@   @@@               @@@
  @@@       @@@@@@@@@@@@@@@@@@@@@@@     @@@ @@@@@@            @@@
  @@@      @@@@@@@@@@@@@@@@@@@@@@   @@@   @@@@@@@@@@          @@@
  @@@      @@@@@@@@@@@@@@@@@@@@@@@@@@@@@   @@@@@@@@@          @@@
  @@@     @@@@@@@@@@@@@@@@@@   @@@@@@@@@@@@ @@@@@@@@@         @@@
  @@@    @@@@@@@@@@@@@@@    @@@@@@@@@@@@@  @@@@@@@@@@@        @@@
  @@@@@    @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@  @@@@@@@@@@@    @@@@@
   @@@@@@@    @@@@@@@@@@@@@@@@@@@@@@@@  @@@@  @@@@@@@   @@@@@@@@
     @@@@@@    @@@@@@@@@@@@@@@@@@@@@@@@@@@@@  @@   @@@@@@@
      @@@@@@@   @@@@@@@@@@@@@@@@@@@@@@@@@@@   @@@@@@@
       @@@@@@@    @@@@@@@@@@@@@@@@@@@    @@@@@@@
         @@@@@@@    @@@@@@@@@@@@@    @@@@@@@
           @@@@@@@    @@@@@@@    @@@@@@
               @@@@@@        @@@@@@@
                 @@@@@@@@ @@@@@@@
                     @@@@@@@@
                        @@@

local & network security assessment framework
  [>] iface wlan0 (10.135.199.31, 8c:c8:4b:30:bf:91)
  [>] v 0.1.0
type 'help' for commands, 'modules' for the catalogue, 'quit' to exit

[*] session ready. type 'help' for commands.
toha3eeλ> help

स्थिति ग्लिफ़ bettercap की परिपाटी का पालन करते हैं:

HUD के बाएँ किनारे पर लाल ब्लॉक ▮ स्थिति पट्टी को चिह्नित करता है; हर कमांड के बाद HUD पुनः मुद्रित होता है, ताकि बिना अतिरिक्त टाइपिंग के गणनाएँ अद्यतन बनी रहें।

उदाहरण सत्र:

toha3eeλ> modules recon        # module catalogue filtered by category
toha3eeλ> on net.scan          # run a module (preflight checks shown first)
toha3eeλ> net.show             # discovered hosts
toha3eeλ> net.profile          # profile + ranked attack vectors
toha3eeλ> help                 # grouped command reference
toha3eeλ> quit

set <module.key> <value> प्रति-मॉड्यूल सेटिंग्स संग्रहीत करता है (मॉड्यूल IDs बिंदु-युक्त होती हैं, इसलिए विभाजन अंतिम बिंदु पर होता है: set arp.spoof.targets 10.0.0.5); config अब तक सेट की गई हर चीज़ प्रदर्शित करता है। सत्र मॉड्यूल चलाने के दौरान कैप्चर किए गए डेटा को बनाए रखते हैं; report.generate इन-मेमोरी स्टोर से एक Markdown मूल्यांकन प्रस्तुत करता है।

स्क्रिप्टिंग

.toha3ee फ़ाइलें एक Python-जैसी भाषा के साथ पूरी recon → exploit → report पाइपलाइन चलाती हैं जो अंग्रेज़ी की तरह पठनीय है। इसे toha3ee script <file> के साथ, या REPL से script <file> के साथ निष्पादित करें, या किसी भी .toha3ee फ़ाइल को run <file> के साथ चलाएँ। toha3ee build <file> (या REPL build <file>) फ़ाइल को सत्यापित करता है और नेटवर्क को छुए बिना एक ड्राई-रन योजना प्रिंट करता है। scripts/full-pipeline.toha3ee एक कार्यशील end-to-end उदाहरण है।

# comment (or //)
set net.scan.targets -> "192.168.8.0/24"     # configure a module
on net.scan                                   # start a module (run/start)
wait for net.scan                             # block until it finishes
_hosts -> [$(net.hosts)]                      # capture a list (or =, >>)
echo -> "found $(_hosts.size) hosts"          # print (say/print)

if $(hosts.count) > 1                         # conditions
    on arp.spoof targets "192.168.8.0/24"
    sleep -> 30
    off arp.spoof
end

for each _h in $(_hosts)                      # loops
    repeat 3 times
        exec -> net.show                      # run any REPL command once
        break
    end
end

get net.scan.timeout -> _t                    # read a config value
report -> "assessment.md"                     # write the session report

भाषा नोट:

• कथन (Statements) — set, get, on/start/run, off/stop, wait for <module> [max <secs>], sleep <secs>, echo/say/print, show <module>, report <file>, exec <command>, if/else/end, , , , , , और एक अकेला स्क्रिप्ट को रोक देता है।

कॉन्फ़िगरेशन

कॉन्फ़िगरेशन डिफ़ॉल्ट रूप से toha3ee.json होता है (बदलने के लिए --config)। प्रति-मॉड्यूल सेटिंग्स प्रत्येक मॉड्यूल द्वारा अपने स्वयं के नेमस्पेस से पढ़ी जाती हैं, जैसे report.generate.out, switch.portsteal.victim_mac, http.harvest.pcap।

स्टील्थ

स्टील्थ हमेशा चालू रहता है, हर चरण में, व्यक्तिगत पैकेट तक। हर पैकेट-भेजने वाला मॉड्यूल डिफ़ॉल्ट रूप से एक यादृच्छिक, जिटरित प्रोफ़ाइल के साथ आता है; सक्षम करने के लिए कुछ भी नहीं है, और इसे अक्षम करना (set <module>.stealth false) डिज़ाइन आशय द्वारा स्पष्ट रूप से समर्थित नहीं है।

• क्रम (Ordering) — प्रोब लक्ष्य फेरबदल किए जाते हैं (stealth_shuffle), ताकि स्वीप सबनेट को उस पूर्वानुमानित आरोही क्रम में न चलें जिसके द्वारा स्कैनर की पहचान की जाती है।
• गति (Pacing) — प्रोब प्रति-प्रोब जिटर के साथ बर्स्ट में भेजे जाते हैं (stealth_jitter, stealth_burst, stealth_pause), ताकि ट्रैफ़िक न तो एक समतल एकसमान धारा हो और न ही एक एकल समकालिक बाढ़।
• ARP — who-has अनुरोध अधिकांश स्कैनरों द्वारा उत्सर्जित शून्य-पैडेड फ्रेम के बजाय यादृच्छिक ईथरनेट पैडिंग (stealth_pad) का उपयोग करते हैं, और सक्रिय net.scan स्वीप एक एकल कैप्चर लूप द्वारा एकत्र किया जाता है जबकि निष्क्रिय श्रोता ट्रैफ़िक को ग्रहण करता रहता है।
• SYN स्कैन — हर प्रोब अपने स्रोत पोर्ट (stealth_ports), IP TTL और पहचान (stealth_ttl, stealth_id), TCP अनुक्रम संख्या और विंडो को बदलता है, और कभी-कभी DF बिट को साफ़ करता है, ताकि प्रोब धारा एक एकल उपकरण हस्ताक्षर तक सीमित न हो।
• फ़िंगरप्रिंटिंग — HTTP प्रोबिंग यथार्थवादी ब्राउज़र यूज़र एजेंट घुमाता है और बैनर ग्रैब जिटरित होते हैं, इसलिए सेवा पहचान फ्रेमवर्क का विज्ञापन नहीं करती।

ट्यून करने योग्य मान प्रति मॉड्यूल पढ़े जाते हैं, जैसे set net.scan.stealth_jitter 5ms, set service.synscan.stealth_burst 128। किसी भी मॉड्यूल के चलने के दौरान REPL प्रॉम्प्ट दृश्यमान और सक्रिय रहता है, bettercap की तरह।

परीक्षण

go test ./...

यह सूट फ्रेम क्राफ्टर्स (DHCP, NDP, 802.11, STP/CDP/LLDP), स्टोर और रिपोर्ट रेंडरर, और एक रजिस्ट्री अनुबंध परीक्षण को कवर करता है जो पूरी मॉड्यूल सूची को स्थिर करता है।

CI (.github/workflows/ci.yml) हर push/PR के लिए Linux पर gofmt, go vet, go build और go test -race चलाता है, साथ ही Windows और macOS पर परीक्षण भी; CodeQL स्थिर सुरक्षा विश्लेषण चलाता है। निर्भरता अद्यतन Dependabot द्वारा संभाले जाते हैं।

योगदान

देखें CONTRIBUTING.md, docs/contributing.md और CODE_OF_CONDUCT.md। सुरक्षा समस्याओं की रिपोर्ट SECURITY.md के माध्यम से करें — सार्वजनिक issues के रूप में नहीं।