toha3ee

إطار عمل لتقييم الأمن المحلي والشبكي مكتوب بلغة Go. إنه أداة بحث واختبار اختراق مُصرَّح به تغطي مسار تقييم الشبكة — اكتشاف المضيفين والخدمات، والاستقصاء، وتدقيق بيانات الاعتماد، وتحديد الثغرات، والاستغلال المُصرَّح به. تمتد فئاته العشر للوحدات عبر الاستطلاع، والاستقصاء، وOSINT، وMITM (تسميم ARP/DHCP/DNS/IPv6 واعتراض HTTP/HTTPS المباشر)، واللاسلكي، وطبقة المحوّل، والويب، والمصادقة، والتجسس، وما بعد الاستغلال — وكلها تُدار من جلسة تفاعلية، أو معالج موجَّه، أو تسلسلات أوامر لمرة واحدة.

MITM هي قدرة واحدة ضمن هذا النطاق الأوسع: TOHA3EE ليست محدودة بسيناريوهات رجل في المنتصف.

تحذير: يقوم toha3ee بإعادة توجيه حركة مرور الشبكة وتسميمها وفك تشفيرها واعتراضها بشكل نشط. استخدمه فقط على الشبكات التي تملكها أو المُصرَّح لك صراحةً باختبارها. تشغيل هذه الوحدات ضد أطراف ثالثة غير قانوني في معظم الولايات القضائية. اقرأ docs/Security.md أولاً.

التوثيق

• المستخدم — البدء · دليل المستخدم · البرمجة النصية · الإعدادات · الأسئلة الشائعة
• المرجع — مرجع الوحدات (جميع الوحدات السبعين) · إعداد التقارير
• المطوّر — البنية · المساهمة · سجل التغييرات
• الحوكمة — الأمان · مدونة السلوك · الترخيص

التثبيت

تقوم أدوات التثبيت ذات السطر الواحد بجلب الملف التنفيذي المُجمَّع مسبقاً لمنصتك من أحدث إصدار، والتحقق من تجزئة 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

أو من نسخة مستخرجة:

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

خيارات التثبيت (Unix): --prefix <dir> (الافتراضي: /usr/local/bin كـ root، وإلا ~/.local/bin)، و--no-path لتخطي تعديل shell rc، و--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 وينشئ اختصاراً في قائمة ابدأ. تحتوي حزمة الإصدار المضغوطة tar/zip على الأيقونة حتى يتمكن المثبّت من تسجيلها من نفس الملف المُتحقَّق منه.

إلغاء التثبيت: احذف الملف التنفيذي وسطر PATH الذي أضافه المثبّت إلى shell rc (أو %LOCALAPPDATA%\Programs\toha3ee على Windows).

التحديث

بعد التثبيت، حدّث باستخدام:

toha3ee updates        # `toha3ee update` works as an alias

يتحقق من الإصدار المثبَّت مقابل أحدث إصدار رسمي على GitHub من QYVORA، ويتحقق من SHA-256 للتنزيل مقابل المجموع الاختباري المنشور، ويستبدل الملف التنفيذي بشكل ذرّي. يُرفض التخفيض، وأي فشل يترك ملفك التنفيذي الحالي دون مساس — دون الحاجة إلى سلسلة أدوات Go أو Git. راجع docs/Update.md للتفاصيل.

البناء

يتطلب Go 1.26+ وlibpcap.

# Debian/Ubuntu
sudo apt install libpcap-dev

# then
go build ./cmd/toha3ee

تحتاج عمليات بناء Linux إلى ترويسات libpcap (يتحقق خيار البناء من المصدر الاحتياطي في المثبّت منها ويطبع أمر apt/dnf الصحيح إذا كانت مفقودة). يأتي macOS مع libpcap ضمن Xcode Command Line Tools.

البدء السريع

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

# Interactive session (explicit subcommand)
sudo ./toha3ee tui --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

# One-shot: procedural deep recon (synscan -> fingerprint -> service enum)
sudo ./toha3ee --eval "net.recon; net.profile" --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() — المعرّف، الفئة، المخاطر، الأهداف، الوصف، القيود
• Preflight(ctx) — التحقق من الشروط المسبقة قبل التشغيل
• Run(ctx, opts) — حلقة الهجوم (يجب أن تحترم ctx.Done)
• Verify(ctx) — الإبلاغ عمّا حدث
• Cleanup(ctx) — التراجع عن كل شيء، واستعادة الشبكة

تتبع دورة حياة safety مركزية (internal/safety) عمليات التنظيف ونبضات القلب المسجّلة بحيث يتم تفكيك كل هجوم حتى عند حدوث panic أو SIGINT، ويحتفظ store مشترك بجرد المضيفين، وبيانات الاعتماد الملتقطة، والجلسات، وسجل الأحداث الذي يغذّي مولّد التقارير.

الطبقات

المسار	الغرض
cmd/toha3ee	CLI: console, wizard, --eval, caplet runner, script/build
internal/ui	console rendering: banner, palette, sections, tables, status glyphs, HUD
internal/script	the .toha3ee scripting language: lexer, parser, engine
internal/attacks/	all attack modules by category
internal/netx/	protocol primitives (ARP, DHCP, DNS, NDP, 802.11, SMB/NTLM, proxy, …)
internal/hijack	HTTP/HTTPS MITM proxy and credential/session interception
internal/phish	captive-portal phishing and login-page clones
internal/store	shared data store and event bus
internal/safety	cleanup/heartbeat lifecycle
internal/config	JSON config loading
internal/oui	MAC vendor database
pkg/certutil	framework CA and per-host TLS certificates

الوحدات

شغّل toha3ee modules للحصول على الكتالوج الكامل الحالي. أبرزها: