اكشف الخفي قبل أن يكتشفه العالم

إطار عمل ذكاء اصطناعي مستقل يربط الاستطلاع والاستغلال وما بعد الاستغلال في مسار واحد متكامل، ثم يذهب أبعد من ذلك عبر فرز كل اكتشاف، وتنفيذ إصلاحات للكود، وفتح طلبات سحب على مستودعك. من أول حزمة بيانات إلى التصحيح المدمج، مع إشراف بشري في كل خطوة حاسمة.

إخلاء مسؤولية قانوني: هذه الأداة مخصصة لاختبار الاختراق المصرح به والأغراض التعليمية والبحث فقط. لا تستخدم هذا النظام أبدًا لفحص أو استكشاف أو مهاجمة أي نظام لا تملكه أو ليس لديك إذن كتابي صريح لاختباره. الوصول غير المصرح به غير قانوني ويعاقب عليه القانون. باستخدامك لهذه الأداة، فإنك تتحمل المسؤولية الكاملة عن أفعالك. اقرأ الإخلاء الكامل

ثلاثة وكلاء ذكاء اصطناعي يختبرون بالتوازي: أحدهم يتحقق من سياسات بيانات الاعتماد عبر Hydra، وآخر يتحقق من مسار استغلال CVE عبر تصعيد الامتيازات، وثالث يحدد ثغرات XSS عبر الواجهة الأمامية.

مسار الاستطلاع المتوازي متعدد الأدوات

يطلق RedAmon أدوات استطلاع متعددة بالتوازي، وكل منها يغذي النتائج في رسم بياني معرفي مشترك في الوقت الفعلي. تنطلق الأدوات، وتكيّف نطاقها بناءً على الاكتشافات الحية، وتتناسق دون تدخل يدوي. يتشكل سطح الهجوم بالكامل — النطاقات الفرعية، والمنافذ، ونقاط النهاية، والمعاملات — في دقائق وليس ساعات.

الاستطلاع كرسم بياني معرفي حي

ماسحات ضوئية بمستوى الصناعة مترابطة بحيث تغذي مخرجات كل أداة الأداة التالية، ثم تُدمج في رسم بياني معرفي واحد على Neo4j. يتم إزالة التكرار من النتائج، وتكون العلاقات صريحة، ويرث الوكيل سطح هجوم منظمًا ومترابطًا بالكامل جاهزًا للاستعلام باللغة الطبيعية.

الهجوم يلتقي الدفاع. مسار واحد، رؤية كاملة.

الاستطلاع ➜ الاستغلال ➜ ما بعد الاستغلال ➜ الفرز بالذكاء الاصطناعي ➜ وكيل CodeFix ➜ GitHub PR

لا يتوقف RedAmon عند اكتشاف الثغرات، بل يقوم بإصلاحها. يبدأ المسار بمحرك استطلاع من 6 مراحل يرسم خريطة سطح الهجوم الكامل لهدفك، ثم يسلم التحكم إلى وكيل ذكاء اصطناعي مستقل يتحقق من قابلية استغلال CVE، ويختبر سياسات بيانات الاعتماد، ويرسم مسارات الحركة الجانبية. يتم تسجيل كل اكتشاف في رسم بياني معرفي على Neo4j. وعند اكتمال المرحلة الهجومية، يتولى CypherFix المهمة: وكيل فرز ذكاء اصطناعي يربط مئات النتائج، ويزيل التكرار، ويرتبها حسب قابلية الاستغلال. ثم يقوم وكيل CodeFix باستنساخ مستودعك، ويتنقل في قاعدة الكود باستخدام 11 أداة مدركة للكود، وينفذ إصلاحات مستهدفة، ويفتح طلب سحب على GitHub، جاهزًا للمراجعة والدمج.

خارطة الطريق ومساهمات المجتمع

نحافظ على لوحة المشروع العامة التي تتضمن ميزات قادمة مفتوحة لمساهمات المجتمع. اختر مهمة وقدّم PR!

تريد المساهمة؟ راجع CONTRIBUTING.md لمعرفة كيفية البدء.

المشرفون

Samuele Giampieri: المؤسس والمشرف ومهندس منصة الذكاء الاصطناعي مهندس منصة ذكاء اصطناعي وقائد Full-Stack بخبرة تزيد عن 15 عامًا في العمل الحر وأكثر من 30 مشروعًا تم إطلاقها للإنتاج، بما في ذلك أنظمة وكلاء ذكاء اصطناعي على مستوى المؤسسات. حاصل على شهادات AWS (DevOps Engineer، ML Specialty) وشهادة IBM كمهندس ذكاء اصطناعي. يصمم حلول تعلم آلي شاملة تغطي التعلم العميق، ومعالجة اللغة الطبيعية، ورؤية الكمبيوتر، وأنظمة وكلاء الذكاء الاصطناعي باستخدام LangChain/LangGraph. LinkedIn · GitHub · Devergo Labs

Ritesh Gohil: المشرف وباحث الأمن الرئيسي مهندس أمن سيبراني في Workday بخبرة تزيد عن 7 سنوات في اختبار الاختراق للويب وAPI والجوال والشبكات والسحابة. نشر 11 CVE في MITRE، مع إشادات أمنية من Google (4×) وApple (6×). قام بتأمين أكثر من 200 تطبيق ويب وجوال وساهم في Exploit Database وGoogle Hacking Database ومجتمع AWS. يحمل شهادات AWS Security Specialty وeWPTXv2 وeCPPTv2 وCRTP وCEH، مع خبرة في الفريق الأحمر وأمن السحابة وأبحاث CVE ومراجعة البنية الأمنية. LinkedIn · GitHub

البدء السريع

المتطلبات الأساسية

• Docker & Docker Compose v2+
  • macOS: Docker Desktop مع رفع الذاكرة إلى 4 GB على الأقل (8 GB مع --gvm) في Settings ← Resources. استنسخ داخل ~/ بحيث يكون المسار ضمن قائمة File Sharing الافتراضية.
  • Windows: Docker Desktop مع خلفية WSL2، شغّل من داخل نظام ملفات WSL2 (~/)، وليس /mnt/c/.

هذا كل شيء. لا تحتاج إلى Node.js أو Python أو أدوات أمنية على جهازك المضيف.

الحد الأدنى لمتطلبات النظام

بدون OpenVAS يعمل بـ 7 حاويات: webapp وpostgres وneo4j وagent وkali-sandbox وrecon-orchestrator وdocker-broker (وكيل ترشيح لـ Docker-socket تمر عبره حاويات الفحص التي يستدعيها منسق الاستطلاع، بحيث يمكنها فقط تشغيل صور الأدوات المعروفة). مع OpenVAS يضيف 4 حاويات تشغيل إضافية (gvmd وospd-openvas وgvm-postgres وgvm-redis) بالإضافة إلى ~8 حاويات تهيئة بيانات لمرة واحدة لتغذية الثغرات (~170K+ NVT). يستغرق الإطلاق الأول ~30 دقيقة لمزامنة تغذية GVM. يتم إنشاء حاويات الاستطلاع والفحص الديناميكية عند الطلب أثناء العمليات وتتطلب موارد إضافية.

حجم القرص لنشر حقيقي. الأرقام أعلاه هي الحد الأدنى المطلق لبناء وتشغيل الحزمة (بصمة منصة ثابتة: 70 GB بدون OpenVAS، و95 GB معه — تُقاس بالحجم الفعلي على القرص بعد إزالة تكرار الطبقات الأساسية المشتركة لنظام Kali). بالنسبة لخادم يعمل دائمًا لتنفيذ مهام حقيقية، أضف ~100 GB من المساحة الحرة للبيانات التشغيلية — إذ ينمو رسم بياني هجوم Neo4j وقطع/مخرجات الفحص وPostgres وسجلات الحاويات مع الاستخدام. وهذا يعني 200 GB بدون OpenVAS و250 GB مع OpenVAS، مع ترك أكثر من 100 GB مساحة حرة للعمليات في كل حالة. راجع دليل النشر للتفصيل الكامل.

1. الاستنساخ والتثبيت```bash

git clone https://github.com/samugit83/redamon.git cd redamon

Without GVM (lighter, faster startup):

./redamon.sh install

With GVM / OpenVAS (full stack, ~30 min first run):

./redamon.sh install --gvm

يقوم السكربت ببناء جميع الصور وتشغيل الخدمات.

### 2. إنشاء حساب المشرف

في نهاية التثبيت (وفي كل مرة تشغّل فيها `./redamon.sh up` أو `./redamon.sh update` إذا لم يكن هناك حساب مشرف موجود)، سيُطلب منك في الطرفية:```
[WARN] No admin user found. Let's create one.

  Admin name: Your Name
  Admin email: [email protected]
  Admin password: ********
  Confirm password: ********

• اسم المسؤول -- اسم العرض الظاهر في الواجهة (مثل Admin أو اسمك أو أي شيء تريده).
• البريد الإلكتروني للمسؤول -- يُستخدم لتسجيل الدخول على الرابط http://localhost:3000/login.
• كلمة مرور المسؤول -- 12 حرفًا على الأقل.

بعد الإنشاء، افتح http://localhost:3000 وسجّل الدخول بالبريد الإلكتروني وكلمة المرور اللذين عيّنتهما للتو.

لم تظهر رسالة الطلب؟ عند أول تشغيل ثقيل (خاصة مع --gvm أو جهاز افتراضي صغير)، قد يستغرق تطبيق الويب بعض الوقت ليظهر، لذلك قد يتم تخطي الطلب التلقائي. يمكنك إنشاء المسؤول في أي وقت باستخدام:

root@kitploit:~

./redamon.sh create-admin

ينتظر حتى يعمل تطبيق الويب، ثم يطلب نفس التفاصيل. من الآمن إعادة تشغيله: إعادة استخدام بريد إلكتروني لمسؤول موجود يعيد تعيين كلمة المرور تلك، بينما يضيف بريد إلكتروني جديد مسؤولًا آخر.

ما يمكن للمسؤول فعله:

• التبديل بين جميع المستخدمين عبر القائمة المنسدلة في الترويسة (بما في ذلك المستخدمين الذين ليس لديهم كلمة مرور).
• إنشاء مستخدمين جدد (مع أو بدون كلمة مرور) وتعيينهم بأدوار admin أو standard.
• تعيين أو تغيير كلمة مرور أي مستخدم.
• حذف المستخدمين (باستثناء نفسه).
• الوصول إلى صفحة إدارة المستخدمين من قائمة التنقل في الترويسة.

المستخدمون العاديون يمكنهم فقط تسجيل الدخول (إذا كانت لديهم كلمة مرور معيّنة من قبل مسؤول)، وتغيير كلمة المرور الخاصة بهم، واستخدام التطبيق ضمن نطاقهم الخاص. لا يمكنهم التبديل بين المستخدمين أو إنشاء مستخدمين أو الوصول إلى إدارة المستخدمين.

إذا نسيت كلمة مرور المسؤول، يمكنك إعادة تعيينها من الطرفية:```bash ./redamon.sh reset-password # reset an EXISTING user's password ./redamon.sh create-admin # create the first admin, or reset an admin by re-entering its email

Use `create-admin` عندما لا يوجد مسؤول بعد (فهو يُنشئ أو يُحدِّث استنادًا إلى البريد الإلكتروني)؛ بينما `reset-password` يحدّث مستخدمًا موجودًا بالفعل فقط.

### 3. الإعداد

افتح **http://localhost:3000/settings** (أيقونة الترس في الترويسة) لتكوين كل شيء. لا حاجة لملف `.env`.

- **مزودو LLM** -- أضف مفاتيح API لـ OpenAI وAnthropic وOpenRouter وAWS Bedrock أو أي نقطة نهاية متوافقة مع OpenAI (Ollama، vLLM، Groq، إلخ). يمكن اختبار كل مزود قبل الحفظ. منتقي النماذج في إعدادات المشروع **يجلب ديناميكيًا** النماذج المتاحة من المزودين المكوّنين.
- **مفاتيح API** -- مفاتيح Tavily وShodan وSerpAPI وNVD وVulners وURLScan ومفاتيح استخبارات التهديدات (Censys وFOFA وOTX وNetlas وVirusTotal وZoomEye وCriminalIP) لتمكين قدرات الوكيل الموسعة (البحث على الويب، OSINT، الاستعلام عن CVE، استخبارات التهديدات السلبية). مفاتيح **Uncover للبحث متعدد المحركات** (Quake وHunter وPublicWWW وHunterHow وGoogle وOnyphe وDriftnet) توسّع اكتشاف الأهداف عبر 13 محرك بحث -- تتم إعادة استخدام المفاتيح المشتركة (Shodan وCensys وFOFA، إلخ) تلقائيًا. يدعم **تدوير المفاتيح** -- قم بتكوين عدة مفاتيح لكل أداة مع تدوير تلقائي بالتناوب لتجنب حدود المعدل.
- **الأنفاق** -- قم بتكوين ngrok أو chisel لإنشاء أنفاق للقشرة العكسية. تسري التغييرات فورًا دون إعادة تشغيل الحاويات.

تُخزَّن جميع الإعدادات لكل مستخدم في قاعدة البيانات. راجع صفحة الويكي **[AI Model Providers](https://github.com/samugit83/redamon/wiki/AI-Model-Providers)** للحصول على تعليمات الإعداد التفصيلية.

### 4. افتح تطبيق الويب

انتقل إلى **http://localhost:3000** -- أنشئ مشروعًا، واعدّ هدفك، وابدأ المسح.

> للحصول على شرح تفصيلي لكل ميزة، راجع **[الويكي](https://github.com/samugit83/redamon/wiki)**.
>
> تواجه مشكلات؟ راجع دليل **[استكشاف الأخطاء وإصلاحها](https://github.com/samugit83/redamon/blob/master/readmes/TROUBLESHOOTING.md)** أو صفحة **[استكشاف الأخطاء وإصلاحها في الويكي](https://github.com/samugit83/redamon/wiki/Troubleshooting)**.

### أوامر الإدارة

تتم إدارة دورة الحياة بالكامل عبر سكربت واحد:

| الأمر | الوصف |
|---------|-------------|
| `./redamon.sh install` | البناء + التشغيل بالوضع الخفيف (بدون GVM، بدون قاعدة المعرفة، بحث ويب عبر Tavily فقط) |
| `./redamon.sh install --kbase` | البناء + التشغيل مع قاعدة المعرفة المحلية (~4.4 جيجابايت أثقل) |
| `./redamon.sh install --gvm` | البناء + التشغيل مع GVM/OpenVAS |

> يمكن دمج الخيارات: `./redamon.sh install --gvm --kbase`

| الأمر | الوصف |
|---------|-------------|
| **`./redamon.sh update`** | **اجلب أحدث إصدار، وأعد البناء بذكاء للخدمات المتغيرة فقط (يحافظ على اختيار GVM/KB الذي اخترته أثناء التثبيت)** |
| `./redamon.sh up` | تشغيل الخدمات (يكتشف تلقائيًا وضع GVM وKB من التثبيت) |
| `./redamon.sh up dev` | التشغيل في وضع التطوير مع إعادة التحميل السريع (يكتشف تلقائيًا وضع GVM وKB) |
| `./redamon.sh down` | إيقاف الخدمات (يحافظ على البيانات) |
| `./redamon.sh status` | عرض الخدمات قيد التشغيل والإصدار ووضع GVM وحالة KB |
| `./redamon.sh clean` | إزالة الحاويات والصور، مع الاحتفاظ بالبيانات |
| `./redamon.sh create-admin` | إنشاء حساب دخول المسؤول (أو إعادة تعيينه) -- استخدمه إذا لم تظهر أي مطالبة أثناء التثبيت |
| `./redamon.sh reset-password` | إعادة تعيين كلمة مرور مستخدم موجود من الطرفية |
| `./redamon.sh purge` | إزالة كل شيء بما في ذلك جميع البيانات |


### التحديث إلى إصدار جديد

ما عليك سوى تشغيل:```bash
./redamon.sh update

يسحب السكربت أحدث كود من GitHub، ويحدد ملفات Dockerfiles وملفات المصدر التي تغيّرت، ويعيد بناء الصور المتأثرة فقط، ثم يعيد تشغيل الخدمات المحدّثة. قواعد بياناتك ونتائج الفحص والتقارير محفوظة — لا تُحذف وحدات التخزين أبدًا.

ملاحظة لمرة واحدة عندما يضيف إصدار خدمة خلفية جديدة. يعيد update تنفيذ السكربت المسحوب حديثًا بحيث تُطبَّق قواعد البناء/البدء الجديدة تلقائيًا — ولكن فقط لإصدار السكربت الذي تُحدّث منه. عند التحديث من إصدار يسبق هذا الإصلاح الذاتي (أي أول تحديث تقوم به عليه)، شغّل ./redamon.sh up مرة واحدة بعد update مباشرة حتى تبدأ أي خدمة أساسية مضافة حديثًا:

root@kitploit:~

./redamon.sh update && ./redamon.sh up

up عملية idempotent — تبدأ فقط ما هو مفقود وتترك الحاويات قيد التشغيل دون تغيير. بعد هذه الخطوة لمرة واحدة، يتولى ./redamon.sh update العادي كل شيء من تلقاء نفسه.

يتحقق تطبيق الويب أيضًا من التحديثات تلقائيًا ويعرض إشعارًا في الواجهة عند توفر إصدار جديد.

النشر على خادم (إنتاج)

يعمل "البدء السريع" أعلاه على تشغيل RedAmon محليًا على localhost. لتشغيل مثيل مشترك قابل للوصول عبر الإنترنت على خادم Linux (EC2 أو DigitalOcean أو Hetzner أو خادم مخصص)، استخدم النشر أحادي المضيف في deploy/single-host/. يقود هذا redamon.sh عبر SSH من حاسوبك المحمول ويغلّف الحزمة بطبقة الأمان الموجهة للإنترنت التي يستبعدها RedAmon افتراضيًا: nginx + TLS (Let's Encrypt)، وجدار حماية للمضيف، وتقوية SSH، وfail2ban، مع أصل HTTPS عام واحد بحيث لا يمكن الوصول إلا إلى صفحة تسجيل الدخول ويبقى كل شيء آخر مرتبطًا بـ loopback.```bash cd deploy/single-host cp .env.example .env # set HOST_IP, DOMAIN, SSH_KEY_PATH, OPERATOR_ALLOW_CIDRS, # LETSENCRYPT_EMAIL, ADMIN_* ... ./deploy.sh init # first build takes 30-60 min, then log in at https:///

شرح كامل: [الويكي: النشر على خادم](https://github.com/samugit83/redamon/wiki/Deploying-to-a-Server). مرجع كامل: [deploy/single-host/README.md](https://github.com/samugit83/redamon/blob/master/deploy/single-host/README.md).

### وضع التطوير

للمساهمين والتطوير النشط مع **Next.js fast refresh**:```bash
./redamon.sh up dev           # auto-detects GVM mode from install

تُبنى صور الأدوات تلقائيًا عند التشغيل الأول إذا لم تكن موجودة بعد. يستبدل تجاوز التطوير (dev override) صورة webapp الإنتاجية بحاوية تطوير مع تثبيت شيفرة المصدر الخاصة بك كوحدة تخزين (volume-mounted). يؤدي كل حفظ للملف إلى إعادة تحميل فورية (hot-reload) في المتصفح.

متى تُعيد البناء مقابل إعادة التشغيل

إعادة بناء خدمة واحدة:```bash docker compose build # Rebuild one image docker compose up -d --no-deps # Restart only that service

**أوامر التطوير الشائعة:**```bash
docker compose ps                                 # Check service status
docker compose logs -f <service>                  # Follow logs for a service
docker compose down                               # Stop all (preserves volumes)
docker compose --profile tools down --rmi local   # Remove built images
docker compose --profile tools down --rmi local --volumes --remove-orphans  # Full cleanup

استعادة مساحة القرص:```bash docker system df # Show Docker disk usage (add -v for per-image breakdown) docker image prune -f # Remove dangling images (auto-run by ./redamon.sh update) docker builder prune -f # Clear build cache (NOT auto-cleaned, can grow to many GB over time) docker container prune -f # Remove stopped containers

> للحصول على مرجع تطوير شامل -- قواعد إعادة التحميل السريع، والأوامر الشائعة، والقواعد المهمة، وإرشادات البرمجة بمساعدة الذكاء الاصطناعي -- راجع **[دليل المطور](https://github.com/samugit83/redamon/blob/master/readmes/README.DEV.md)**.

---

### قاعدة المعرفة (بحث ويب معزّز بتقنية RAG)

أداة `web_search` الخاصة بالوكيل تتضمن **قاعدة معرفة** محلية -- وهي خط أنابيب RAG يبحث في مجموعات بيانات أمنية منسقة (GTFOBins، LOLBAS، OWASP WSTG، NVD CVEs، ExploitDB، قوالب Nuclei، ووثائق مهارات الوكيل) قبل التراجع إلى بحث Tavily على الويب. عندما تُرجع قاعدة المعرفة تطابقًا عالي الثقة، يتم تخطي Tavily بالكامل للحصول على نتائج أسرع وقابلة للعمل دون اتصال.

**كيف تعمل:** عندما تكون قاعدة المعرفة مفعّلة، يعمل `install` / `up` / `update` على بناء فهرس خفيف لقاعدة المعرفة (~1,200 مقطع خلال 10-15 دقيقة على وحدة المعالجة المركزية). عند وقت الاستعلام، يشغّل الوكيل خط أنابيب استرجاع هجين (بحث المتجهات FAISS + النص الكامل عبر Neo4j)، ويعيد الترتيب باستخدام cross-encoder، ويتحقق من حد الثقة. إذا كان التقييم مرتفعًا بما يكفي، تأتي النتائج من قاعدة المعرفة المحلية. بخلاف ذلك، يتراجع إلى Tavily أو يدمج الاثنين.

**السلوك الافتراضي:** قاعدة المعرفة **اختيارية (opt-in)**. ينتج `./redamon.sh install` تثبيتًا خفيفًا (أخف بحوالي 4.4 جيجابايت، مع بحث ويب Tavily فقط). لتفعيل قاعدة المعرفة المحلية، مرّر `--kbase`:```bash
./redamon.sh install --kbase

عند التثبيت الأول باستخدام --kbase، يكتشف RedAmon عتادك (GPU / CPU / API) ويعرض ملف تعريف للبدء السريع. يتم حفظ الاختيار، لذا فإن أوامر update / up اللاحقة تحترمه دون الحاجة إلى تمرير العلم مرة أخرى.

سارع عملية الاستيعاب باستخدام تضمينات API: افتراضيًا، تعمل التضمينات محليًا على CPU/GPU. على الأجهزة التي تعمل بـ CPU فقط، قد تستغرق مجموعات البيانات الكبيرة (ExploitDB, NVD) ساعات. يمكنك تفريغ التضمين إلى API خارجي عن طريق إنشاء ملف .env من القالب:```bash cp .env.example .env

ثم قم بتكوين واجهة برمجة تطبيقات التضمين في `.env`:

| المتغير | الافتراضي | الوصف |
|----------|---------|-------------|
| `KB_EMBEDDING_USE_API` | `false` | اضبطها على `true` لاستخدام التضمين المبني على API بدلاً من النموذج المحلي |
| `KB_EMBEDDING_API_BASE_URL` | *(فارغ = OpenAI)* | أي نقطة نهاية متوافقة مع OpenAI (Ollama، vLLM، LiteLLM، Together AI، Azure) |
| `KB_EMBEDDING_API_KEY` | *(فارغ)* | مفتاح API لمزود التضمين |
| `KB_EMBEDDING_API_MODEL` | `text-embedding-3-small` | اسم النموذج (خاص بالمزود) |
| `NVD_API_KEY` | *(فارغ)* | مفتاح NVD API مجاني لتسريع استيعاب CVE بمقدار 10 مرات |

مثال مع Ollama (مجاني، محلي، بدون تكلفة مفتاح API):```bash
KB_EMBEDDING_USE_API=true
KB_EMBEDDING_API_BASE_URL=http://host.docker.internal:11434/v1
KB_EMBEDDING_API_KEY=ollama
KB_EMBEDDING_API_MODEL=nomic-embed-text

مهم: يجب أن يستخدم إدخال البيانات والاستعلام نفس النموذج. إذا قمت بتبديل النماذج، أعد بناء الفهرس: make -C knowledge_base kb-rebuild-lite MODE=docker

إدارة قاعدة المعرفة:```bash ./redamon.sh kb build lite # Build with lite profile (~30-60s with API) ./redamon.sh kb build standard # Add NVD CVEs ./redamon.sh kb update nvd # Incremental NVD refresh ./redamon.sh kb stats # Show index statistics ./redamon.sh kb rebuild lite # Wipe and rebuild from scratch

> للحصول على التوثيق الفني الكامل — خط أنابيب الاستعلام، مصادر البيانات، ملفات التلقيم، التقييم، نموذج الأمان — انظر **[المرجع التقني لقاعدة المعرفة](https://github.com/samugit83/redamon/blob/master/readmes/README.KBASE.md)** أو **[الويكي: قاعدة المعرفة والبحث على الويب](https://github.com/samugit83/redamon/wiki/Knowledge-Base-Web-Search)**.

---

## جدول المحتويات

- [توثيق الويكي الكامل](https://github.com/samugit83/redamon/wiki)
- [نظرة عامة](#overview)
- [مصمم للمؤسسات، آمن بالتصميم](#built-for-enterprise-secure-by-design)
- [نموذج الأمان والتهديدات](#security--threat-model)
- [أبرز الميزات](#feature-highlights)
- [بنية النظام](#system-architecture)
- [المكونات](#components)
- [التوثيق](#documentation)
- [استكشاف الأخطاء وإصلاحها](#troubleshooting)
- [مختبر RedAmon](#redamon-hacklab)
- [عرض المجتمع](#community-showcase)
- [الجانب القانوني](#legal)

---

## نظرة عامة

RedAmon هو إطار عمل اختبار اختراق معياري وقائم على الحاويات يربط الاستطلاع الآلي، والاستغلال المدعوم بالذكاء الاصطناعي، والاستخبارات القائمة على الرسوم البيانية في خط أنابيب واحد متكامل لأمن الهجوم. يعمل كل مكوّن داخل Docker (بدون تثبيت أي أدوات على جهاز المضيف) ويتواصل عبر واجهات برمجة تطبيقات محددة بوضوح بحيث يمكن لكل طبقة أن تتطور بشكل مستقل.

المنصة مبنية على ست ركائز:

| الركيزة | ما تقوم به |
|--------|-------------|
| **خط أنابيب الاستطلاع** | خط أنابيب مسح **متوازي (fan-out / fan-in)** يغطي كامل سطح الهجوم للهدف (بدءًا من نطاق **أو عناوين IP / نطاقات CIDR**) من اكتشاف النطاقات الفرعية (5 أدوات متزامنة) مرورًا بفحص المنافذ، واكتشاف الخدمات عبر Nmap، ونصوص NSE للثغرات، وفحص HTTP، وتعداد الموارد، واكتشاف الثغرات. تعمل الوحدات المستقلة بشكل متزامن عبر `ThreadPoolExecutor`، وتتم تحديثات قاعدة البيانات الرسومية في خيط خلفي، وتُخزَّن النتائج كرسوم بيانية غنية وقابلة للاستعلام. ومكملًا لذلك توجد وحدات مسح شبكة GVM المستقلة، والبحث عن الأسرار في GitHub، ووحدة TruffleHog للبحث العميق عن الأسرار. |
| **منسّق وكلاء الذكاء الاصطناعي** | وكيل مستقل يعتمد على LangGraph يفكر في الرسم البياني، ويختار أدوات الأمان عبر MCP، وينتقل بين مراحل المعلومات / الاستغلال / ما بعد الاستغلال، ويمكن توجيهه في الوقت الفعلي عبر الدردشة. |
| **رسم بياني لسطح الهجوم** | رسم بياني معرفي في Neo4j يضم 17 نوعًا من العقد وأكثر من 20 نوعًا من العلاقات، ويعمل كمصدر وحيد للحقيقة لكل نتيجة، وهو مصدر البيانات الأساسي الذي يستعلمه وكيل الذكاء الاصطناعي قبل كل قرار. |
| **EvoGraph** | رسم بياني تطوري دائم لسلسلة الهجوم في Neo4j يتتبع كل خطوة ونتيجة وقرار وفشل عبر دورة حياة الهجوم، ويربط رسم الاستطلاع البياني ويتيح تراكم الاستخبارات عبر الجلسات. |
| **CypherFix** | خط أنابيب آلي لإصلاح الثغرات: وكيل فرز ذكاء اصطناعي يربط النتائج من الرسم البياني ويرتبها حسب الأولوية، ثم يقوم وكيل CodeFix باستنساخ المستودع المستهدف، وينفذ الإصلاحات باستخدام حلقة ReAct مع 11 أداة برمجية، ويفتح طلب سحب على GitHub. |
| **محرك إعدادات المشروع** | أكثر من 500 معامل لكل مشروع (معروضة عبر واجهة الويب) تتحكم في سلوك كل أداة، بدءًا من عدد خيوط Naabu وصولًا إلى مرشحات خطورة Nuclei وبوابات موافقة الوكيل. |

---

## مصمم للمؤسسات، آمن بالتصميم

تم تصميم RedAmon ليعمل داخل مؤسسة أمنية حقيقية، وليس فقط على حاسوب باحث.

- **آمن بالتصميم، ومحلَّل بنموذج تهديدات STRIDE.** يتم تقييم المنصة بأكملها من البداية إلى النهاية تحت إطار STRIDE وتقويتها في موجات تحقق مستقلة: فصل صلاحيات على مستوى الكود، ووسيط Docker ترشيح أمام مقبس المضيف، ومصادقة تفشل بصورة مغلقة، وحراس منع SSRF، وتنقيح الأسرار، ومسارات تدقيق ملحقة فقط، وحاجز أمان لا يمكن تعطيله يمنع استهداف الجهات الحكومية والعسكرية والدولية. انظر [الوضع الأمني](https://github.com/samugit83/redamon/blob/master/readmes/README.SECURITY_POSTURE.md) و[نموذج التهديدات](https://github.com/samugit83/redamon/blob/master/readmes/README.TM.SYSTEM_OVERVIEW.md).
- **معزول تمامًا وقائم على الحاويات.** تعمل كل أداة وماسح ووكيل في حاوية خاصة به دون أي تنفيذ على مستوى المضيف. تُطلق مهام المسح كحاويات شقيقة مؤقتة بنظام ملفات وشبكة معزولين خاصين بها، ثم تُزال عند الاكتمال، مما يحافظ على نظافة المضيف ويحتوي نطاق الانفجار لأي استغلال.
- **مدار ومتعدد المستأجرين.** تعدد المستخدمين / المشاريع مع أدوار مدير ومستخدم عادي، ونطاق `user_id + project_id` على مستوى قاعدة البيانات لكل عقدة، وفرض قواعد الاشتباك، وبوابات موافقة بشرية، وأكثر من 500 إعداد لكل مشروع تمنح الفرق التحكم الذي تتطلبه عمليات المؤسسات.

**انشر على خادم بأمر واحد.** بعيدًا عن `localhost` المحلي، يوفر RedAmon [نشرًا مقوىً لمضيف واحد](https://github.com/samugit83/redamon/blob/master/deploy/single-host) يقيم مثيلًا مشتركًا متاحًا عبر الإنترنت ويغلّف المجموعة في nginx + TLS (Let's Encrypt)، وجدار حماية للمضيف، وتقوية SSH، وfail2ban، مما يعرض أصل HTTPS عام واحد:```bash
cd deploy/single-host
cp .env.example .env      # set DOMAIN, HOST_IP, SSH_KEY_PATH, ADMIN_* ...
./deploy.sh init          # builds the full stack and brings it up over SSH

شرح كامل: ويكي: النشر على خادم.

الأمان ونموذج التهديدات

RedAmon هو برنامج هجومي، لذا نُخضعه للمعيار ذاته الذي يختبر به الآخرين. إنه مصمم آمن بالتصميم وقد تم تقييمه من البداية إلى النهاية وفق منهجية STRIDE (انتحال الهوية، العبث، الإنكار، كشف المعلومات، رفض الخدمة، رفع الامتيازات)، مع معالجة النتائج في موجات متسلسلة تم التحقق منها بشكل مستقل.

هذا ليس ادعاءً تسويقيًا. إنه مرتكز على تحليل منشور قائم على الأدلة يمكنك قراءته:

• الوضع الأمني - كتالوج ضوابط الدفاع في العمق الكامل: كل طبقة منفذة، مرتبطة بالكود.
• نموذج التهديدات - الأصول وحدود الثقة وتدفقات البيانات ونقاط الدخول والسطح الشبكي الذي بُني عليه التحليل.

أبرز ما تم تنفيذه:

• فصل الامتيازات على مستوى الكود. العامل المواجه للهدف هو المكوّن الأقل ثقة ولا يحمل أي أسرار؛ ويقف وسيط docker مُرشِّح بين المنسّق ومقبس Docker الخاص بالمضيف (قائمة السماح للصور، ويرفض --privileged، وارتباطات جذر المضيف، والقدرات الخطيرة).
• وضعيتا نشر، نموذج ثقة واحد. محلي (الخلفيات مربوطة بـ loopback) ونشر مُحصَّن عبر الإنترنت العام يضيف nginx + TLS وبوابة مشغّل وتحديد معدل تسجيل الدخول وأصلًا عامًا واحدًا.
• الإغلاق عند الفشل افتراضيًا. رموز المصادقة غير المعينة تُرفض بدلاً من تقديم الخدمة، وبيانات اعتماد قاعدة البيانات الافتراضية مرفوضة ويتم تدويرها، وتتطلب WebSockets تذكرة موقعة بالإضافة إلى فحص same-origin من جانب الخادم، وكل طلب مقيد بمالكه المصادق عليه (تحكم وصول لكل مستخدم مع 404 مضاد للتعداد).
• الدفاع في العمق. حراس SSRF للاتصالات الصادرة، وتنقيح الأسرار في السجلات، ومسارات تدقيق للإلحاق فقط، وتقوية ضد الهروب من الحاويات، وسقوف لإلغاء الضغط والتزامن، وتثبيت سلسلة التوريد (sha256 + تثبيتات الالتزامات).
• حاجز حماية صلب غير قابل للتعطيل يحظر الأهداف الحكومية والعسكرية والحكومية الدولية بغض النظر عن الإعدادات.
• معالجة موثقة ومقيّدة بالإصدارات. تُطرح الإصلاحات في موجات متسلسلة، وتم التحقق من كل موجة بشكل مستقل مع إعادة إنتاج حية للاستغلال قبل التصحيح وبعده. راجع إدخالات الأمان في سجل التغييرات.

وجدت ثغرة؟ راجع سياسة الأمان للإفصاح الخاص.

أبرز الميزات

خط الاستطلاع

أداة آلية بالكامل من البداية إلى النهاية لرسم خريطة سطح الهجوم الخارجي، تعمل داخل حاوية Kali Linux. أعطها مدخلًا واحدًا (نطاقًا جذريًا، أو قائمة نطاقات فرعية، أو نطاقات IP/CIDR) ويعيد الخط صورة كاملة ومنظمة للهدف: كل نطاق فرعي، وكل مضيف نشط، وكل منفذ مفتوح، وكل خدمة HTTP مع حزمة تقنياتها، وكل نقطة نهاية تم الزحف إليها وكل معامل تم اكتشافه، وكل CVE يحتمل أن يكون الهدف معرضًا له، بالإضافة إلى ماسحات مخصصة لـ واجهات GraphQL API والاستيلاء على النطاقات الفرعية والمضيفات الافتراضية المخفية خلف الوكلاء العكسيين وتسميم وخداع ذاكرة التخزين المؤقت للويب، وطبقة سطح الذكاء الاصطناعي العدائي التي تعلّم على بيئات تشغيل الذكاء الاصطناعي / قواعد بيانات المتجهات / واجهات LLM الأمامية / الوكلاء / خوادم MCP / نقاط نهاية الدردشة والإكمال والتضمين وRAG / والمعاملات القابلة لحقن الموجهات باستخدام توقيعات الرأس / الأيقونة المفضلة / العنوان / المسار / اسم المعامل، ثم تؤكدها بنشاط عبر وحدة استطلاع سطح الذكاء الاصطناعي المخصصة (استكشافات غير ضارة ببنية الدردشة، مصافحة MCP + فحص تسميم الأدوات، قراءات قواعد بيانات المتجهات — دون استدعاءات LLM).

يعمل كل شيء على بنية fan-out / fan-in: كل مرحلة تشغّل أكبر عدد ممكن من الأدوات بالتوازي بقدر ما يسمح به العمل، ثم تتقارب قبل بدء المرحلة التالية. أكثر من 40 أداة صناعية تندمج في سير عمل واحد منسق، ويتم تصفية تسميم DNS للمطابقات البديلة تلقائيًا عبر puredns، ويُبقي الوضع الخفي الخط بأكمله يعمل على مصادر سلبية فقط عندما يكون الاستكشاف النشط محظورًا. تتدفق النتائج إلى الرسم البياني المعرفي Neo4j على خيط خلفي بحيث لا يحجب الفحص كتابات قاعدة البيانات أبدًا، ويُحفظ JSON الخام للتحميل. التفصيل الدقيق لكل أداة موجود في المصفوفة أدناه.

ويكي: تشغيل الاستطلاع | تقني: README.RECON.md

مصفوفة أدوات خط الاستطلاع

_{*يمكن أن يعمل Amass في الوضع النشط عند تكوينه. يقوم Knockpy باستكشاف DNS نشط.}

الاستطلاع الجزئي

شغّل أي أداة واحدة من الخط بشكل مستقل دون إعادة تشغيل الفحص بالكامل. يمكن تشغيل حتى 12 استطلاعًا جزئيًا بالتوازي لكل مشروع، ولكل منها سجلات مستقلة وعناصر تحكم بالإيقاف وشارات حالة مرئية في كل من شريط أدوات الرسم البياني ورأس إعدادات المشروع. يحتوي كل قسم أدوات على زر تشغيل يفتح نافذة منبثقة يمكنك من خلالها مراجعة بيانات الرسم البياني الحالية وإضافة أهداف مخصصة (نطاقات فرعية أو عناوين IP أو منافذ أو روابط URL) وتشغيل الأداة بشكل معزول. تُدمج النتائج مرة أخرى في رسم Neo4j البياني باستخدام عمليات MERGE -- يتم تحديث التكرارات، لا إعادة إنشائها. تعمل الأداة مع جميع إعدادات المشروع (المهلات، قوائم الكلمات، مفاتيح API، الوكيل) المطبقة تلقائيًا. تدعم جميع أدوات الخط الاستطلاع الجزئي.

ويكي: سير عمل خط الاستطلاع -- الاستطلاع الجزئي

الذكاء الاصطناعي في الخط

نقاط قرار اختيارية معززة بـ LLM مدمجة داخل خط الاستطلاع حيث تنحرف عمليات البحث الثابتة تاريخيًا -- Nuclei يشذّب قائمة وسماته لتقتصر على حزمة التقنيات المكتشفة، ومصنف WAF يلتقط Cloudflare/AWS WAF/Imperva المجردة من الرؤوس، وغيرها الكثير عبر FFuf وترشيح الإيجابيات الكاذبة في Nuclei وإزالة الالتباس في الاستيلاء على النطاقات الفرعية. كل خطاف هو تراجع متتالٍ بعد المسار الثابت مع تراجع آمن حتمي، بحيث لا يمكن لعطل LLM أن يكسر الفحص. مفتاح رئيسي واحد في تبويب الهدف يتحكم فيها جميعًا.

ويكي: الذكاء الاصطناعي في الخط

AI Gauntlet: الاختبار الهجومي للذكاء الاصطناعي/LLM

حيثما يجد خط الاستطلاع سطح الذكاء الاصطناعي، يهاجمه AI Gauntlet. اختر نقاط نهاية LLM المكتشفة (أو اكتب عنوان URL مخصصًا)، واختر أداة، وأكد قواعد الاشتباك، ثم شغّل: حاوية قصيرة العمر تُمرر الهدف عبر أربع أدوات فريق أحمر صناعية -- garak (ماسح واسع بمحاولة واحدة، 40 عائلة استكشاف)، PyRIT (كسور قيود متعددة الأدوار محدودة)، Giskard (فحص سلامة بمساعدة LLM)، وpromptfoo (تقييم فريق أحمر على مجموعات البيانات) -- لقياس معدل نجاح الهجوم لكل هجوم وكتابة نقاط الضعف المؤكدة على الرسم البياني كنتائج Vulnerability مربوطة بـ OWASP-LLM / MITRE-ATLAS مع نصوص الأدلة.

إنها حتمية (بذور، حدود ثابتة، إصدارات أدوات مثبتة) وتعمل بدون أي اتصال خارجي صادر: كل استدعاء حكم / مُقيِّم / تضمين يُجبر على نموذج Ollama محلي، بحيث لا يغادر أي حمولة أو سجل جهازك أبدًا. معطلة افتراضيًا ومقيّدة بـ RoE، مع تقدم مباشر مرحلة بمرحلة، وتظهر النتائج في جدول AI Gauntlet Vulnerabilities في المنطقة الحمراء وفي تقرير اختبار الاختراق.

ويكي: AI Gauntlet | تقني: AI_GAUNTLET_TECH_DOC.md

ماسح الثغرات GVM

GVM/OpenVAS يجري تقييمًا عميقًا للثغرات على مستوى الشبكة مع أكثر من 170,000 NVT، ويستكشف الخدمات في طبقة البروتوكول بحثًا عن الإعدادات الخاطئة والبرمجيات القديمة وبيانات الاعتماد الافتراضية وCVEs المعروفة. يكمل نتائج Nuclei في طبقة الويب. سبعة ملفات تعريف فحص مُعدة مسبقًا تتراوح من الاكتشاف السريع للمضيفين (~دقيقتين) إلى الفحص العميق الشامل (~8 ساعات). تُخزن النتائج كعُقد Vulnerability في Neo4j بجانب رسم الاستطلاع.

ويكي: فحص الثغرات GVM | تقني: README.GVM.md

منسق وكيل الذكاء الاصطناعي

وكيل مستقل قائم على LangGraph ينفذ نمط ReAct. يتقدم عبر ثلاث مراحل: إعلامية (جمع الاستخبارات، استعلامات الرسم البياني، Shodan، Google dorking)، استغلال (Metasploit، اختبار بيانات اعتماد Hydra، محاكاة الهندسة الاجتماعية)، وما بعد الاستغلال (التعداد، الحركة الجانبية). ينفذ الوكيل 14 أداة أمنية عبر خوادم MCP داخل صندوق رمل Kali، ويدعم التنفيذ المتوازي للأدوات عبر Wave Runner، ويوفر تفاعل دردشة في الوقت الفعلي مع إرشادات وسير عمل الإيقاف/الاستئناف والموافقة. يتيح وضع Deep Think تحليلًا استراتيجيًا منظمًا قبل التصرف.

ويكي: دليل وكيل الذكاء الاصطناعي | تقني: README.AGENTIC_SYSTEM.md

ترسانة أدوات الوكيل| الفئة | الأداة | الوصف | المراحل | خادم MCP |

|:-----:|-------|-------------|:------:|:----------:| | الاستخبارات | query_graph | استعلامات الرسوم البيانية Neo4j -- المصدر الأساسي للحقيقة لبيانات الاستطلاع | الكل | -- | | | web_search | بحث عبر الإنترنت عبر Tavily لتفاصيل CVE وإثباتات المفاهيم (PoCs) للاستغلال والنشرات الأمنية | الكل | -- | | | cve_intel | ProjectDiscovery vulnx -- استخبارات CVE منظمة تجمع NVD + CISA KEV + EPSS + HackerOne + PoCs من GitHub + توفر قوالب Nuclei. 69 حقلاً قابلاً للتصفية عبر Lucene. مفتاح PDCP اختياري (حسب المستخدم، الوضع المجهول = 10 طلبات/دقيقة) | الكل | network_recon :8000 | | | tradecraft_lookup | كتالوج منسّق من المستخدم لعناوين URL موثوقة للمعرفة الأمنية (HackTricks, PayloadsAllTheThings, مستودعات PoCs لـ CVE, مدونات البائعين) -- 6 أنواع موارد تُكتشف تلقائياً، اختيار قسم مدفوع بخريطة الموقع (sitemap)، وذاكرة تخزين مؤقت على sqlite والقرص | استغلال، ما بعد الاستغلال | -- | | | shodan | استخبارات Shodan مفتوحة المصدر (OSINT) -- تفاصيل المضيف، عكس DNS (reverse DNS)، البحث عن الأجهزة | معلومات، استغلال | -- | | | google_dork | بحث Google dorking عبر SerpAPI -- ملفات مكشوفة، لوحات إدارة، قوائم أدلة (directory listings) | معلومات | -- | | الاستطلاع وOSINT | execute_subfinder | تعداد سلبي للنطاقات الفرعية عبر OSINT (سجلات CT، مجموعات بيانات DNS). بدون أي حركة مرور نحو الهدف | معلومات، استغلال | network_recon :8000 | | | execute_gau | اكتشاف سلبي لعناوين URL من Wayback Machine وCommon Crawl وAlienVault OTX وURLScan. بدون أي حركة مرور نحو الهدف | معلومات، استغلال | network_recon :8000 | | | execute_amass | تعداد النطاقات الفرعية ورسم خرائط الشبكة عبر OWASP Amass (سلبي + نشط، استخبارات ASN) | معلومات، استغلال | network_recon :8000 | | المسح | execute_naabu | مسح سريع للمنافذ والتحقق منها | معلومات، استغلال | network_recon :8000 | | | execute_nmap | كشف عميق للخدمات (-sV)، بصمة نظام التشغيل (OS fingerprint)، سكربتات NSE | الكل | nmap :8004 | | | execute_nuclei | التحقق من ثغرات CVE واستغلالها مع أكثر من 9,000 قالب + رفع مخصص | معلومات، استغلال | nuclei :8002 | | | execute_httpx | فحص HTTP وأخذ البصمات -- رموز الحالة، العناوين، ترويسات الخادم، كشف التقنيات | معلومات، استغلال | network_recon :8000 | | | execute_wpscan | ماسح ثغرات WordPress -- يكتشف الإضافات والثيمات والمستخدمين والتكوينات الخاطئة المعرضة للخطر | معلومات، استغلال | network_recon :8000 | | الويب وHTTP | execute_curl | طلبات HTTP -- قابلية الوصول، الترويسات، رموز الحالة، اللافتات (banners) | الكل | network_recon :8000 | | | execute_katana | زحف الويب واكتشاف نقاط النهاية مع تحليل JS وتعداد الملفات المعروفة | معلومات، استغلال | network_recon :8000 | | | execute_jsluice | تحليل ثابت لـ JavaScript للكشف عن نقاط نهاية API المخفية ومسارات URL والأسرار | معلومات، استغلال | network_recon :8000 | | | execute_arjun | اكتشاف معاملات HTTP عبر تخمين عنيف (brute-force) لحوالي 25,000 اسم معامل شائع | معلومات، استغلال | network_recon :8000 | | | execute_ffuf | تخمين الويب (fuzzing) للأدلة والملفات والمضيفات الافتراضية والمعاملات المخفية | معلومات، استغلال | network_recon :8000 | | | execute_playwright | أتمتة متصفح Chromium بدون واجهة (headless) -- استخراج المحتوى المعروض عبر JS وبرمجة تفاعلية لتطبيقات SPA واختبار النماذج والتحقق من XSS | الكل | playwright :8005 | | الاستغلال | metasploit_console | جلسة msfconsole مستمرة -- تنفيذ الاستغلال، إدارة الجلسات، ما بعد الاستغلال | استغلال، ما بعد الاستغلال | metasploit :8003 | | | msf_restart | إعادة تعيين كاملة لـ Metasploit -- ينهي جميع الجلسات ويمسح حالة الوحدات | استغلال، ما بعد الاستغلال | metasploit :8003 | | | execute_hydra | تخمين عنيف عبر THC Hydra -- أكثر من 50 بروتوكولاً (SSH, FTP, RDP, SMB, HTTP, MySQL وغيرها) | استغلال، ما بعد الاستغلال | network_recon :8000 | | تنفيذ التعليمات البرمجية | kali_shell | صدفة Kali Linux كاملة -- nikto, whatweb, testssl, commix, sstimap, tplmap, ysoserial, phpggc, dnsrecon, dnsx, subzy, enum4linux-ng, netexec, kerbrute, bloodhound-python, bhgraph, certipy-ad, bloodyAD, jwt_tool, graphql-cop, graphqlmap, gitleaks, semgrep, hashcat, john, cewl, paramspider, Node.js + npm, مكتبات Python (websockets, zeep, python3-saml, boto3, msal, azure-identity, google-auth, google-cloud-storage)، أدوات ما بعد الاستغلال المجهزة مسبقاً في /opt/tools/{linux,windows}/ (linpeas, LinEnum, pspy64, deepce, winPEAS, PowerUp, PrivescCheck)، وأكثر من 70 أداة CLI | الكل | network_recon :8000 | | | execute_code | كتابة وتشغيل ملفات برمجية (Python, bash, Ruby, Perl, C, C++) -- دون الحاجة لتجاوز الصدفة (shell escaping) | استغلال، ما بعد الاستغلال | network_recon :8000 | | حركة المرور (TrafficMind) | proxy_search | سجل بنمط Burp فوق مجموعة HTTP الملتقطة -- ملخصات فقط، نفس عوامل التصفية الموجودة في الواجهة (host, method, status, tool, source, q سلسلة فرعية في URL / bodyq سلسلة فرعية في النص، reflected, only5xx) | الكل | -- (in-process) | | | proxy_get | الطلب أو الاستجابة الكاملة (ترويسات + نص) لمعاملة واحدة ملتقطة | الكل | -- (in-process) | | | proxy_sitemap | نقاط نهاية مميزة تمت ملاحظتها (host + path + method) مع أعداد الزيارات ورموز الحالة | الكل | -- (in-process) | | | proxy_params | معاملات طلب مميزة مع قيم تجريبية وإرشادية لقابلية الحقن (sequential-id / uuid / jwt / base64) | الكل | -- (in-process) | | | proxy_grep | بحث عن سلسلة فرعية غير حساس لحالة الأحرف عبر نصوص الاستجابات الملتقطة، مع مقتطف حول أول تطابق | الكل | -- (in-process) | | | proxy_diff | مقارنة هيكلية (diff) بين استجابتين (الحالة، الطول، مجموعة الترويسات، نص unified-diff) لاكتشاف SQLi الأعمى المنطقي / IDOR / تجاوز المصادقة | الكل | -- (in-process) | | | proxy_to_curl | عرض طلب ملتقط كأمر curl قابل لإعادة الإنتاج (للقراءة فقط، لا يرسل شيئاً) | الكل | -- (in-process) | | | proxy_query | منشئ استعلامات تحليلية مقيدة عبر أعمدة / تجميعات في القائمة المسموحة (مواصفة JSON فقط، بدون SQL خام) | الكل | -- (in-process) | | | proxy_replay | خطير -- إعادة إرسال طلب ملتقط مع حقول معدلة (method / path / query / params / headers / cookie / body)؛ مع تثبيت host وscheme وport على الأصل. تبديل سياق المصادقة لـ IDOR / BOLA / رفع الامتيازات (privesc). يُعاد التقاطه كمعاملة isReplay | استغلال، ما بعد الاستغلال | network_recon :8000 | | | proxy_fuzz | خطير -- بنمط Burp Intruder: إعادة تشغيل طلب ملتقط واحد مع التكرار عبر مجموعة حمولات (بسقف 50) على معامل استعلام، ويعيد ملخص الحالة / الطول لكل حمولة | استغلال، ما بعد الاستغلال | network_recon :8000 | | نظام ملفات مساحة العمل | fs_read | قراءة ملف من مساحة العمل مع أرقام الأسطر، يكتشف الملفات الثنائية تلقائياً، ويخزن لقطة لـ fs_diff vs_last_read | الكل | -- (in-process) | | | fs_read_many | قراءة مجمعة لعدة ملفات، بسقف max_total_bytes (الافتراضي 200 كيلوبايت) | الكل | -- (in-process) | | | fs_stat | بيانات وصفية فقط -- الحجم، وقت التعديل (mtime)، الوضع (mode)، النوع، SHA-256 اختياري | الكل | -- (in-process) | | | fs_write | إنشاء / استبدال / إلحاق ذري، مع إنشاء الأدلة الأصلية تلقائياً | الكل | -- (in-process) | | | fs_edit | استبدال سلسلة نصية مطابقة حرفياً مع فحص التفرّد، ويسجل إدخال تراجع (undo) | الكل | -- (in-process) | | | fs_multi_edit | تعديلات متعددة مرتبة في استدعاء واحد، معاملة كل شيء أو لا شيء (all-or-nothing) | الكل | -- (in-process) | | | fs_undo_edit | التراجع عن آخر fs_edit / fs_multi_edit، ومكدس تراجع لكل ملف بسقف 20 إدخالاً | الكل | -- (in-process) | | | fs_delete | حذف ملف أو دليل (العلامة التكرارية مطلوبة للأدلة) | الكل | -- (in-process) | | | fs_move | نقل أو إعادة تسمية مسار، مع إنشاء الأدلة الأصلية للوجهة تلقائياً | الكل | -- (in-process) | | | fs_copy | نسخ ملف أو شجرة أدلة، مع تسوية الأذونات ليتمكن مستخدم المضيف من التعديل | الكل | -- (in-process) | | | fs_mkdir | إنشاء دليل، عملية عديمة الأثر (idempotent) | الكل | -- (in-process) | | | fs_chmod | تغيير بتات الأذونات (ثماني 0o755 أو رمزي +x) | الكل | -- (in-process) | | | fs_symlink_create | إنشاء رابط رمزي (symlink)، ويرفض نقاط النهاية التي قد تخرج عن مساحة العمل | الكل | -- (in-process) | | | fs_grep | بحث Ripgrep عبر مساحة العمل بتعبير نمطي (regex)، مهلة 30 ثانية، سقف 1000 تطابق، ويعمل على سجلات المهام قيد التشغيل | الكل | -- (in-process) | | | fs_glob | بحث بنمط glob مرتب من الأحدث إلى الأقدم، بسقف 500 نتيجة | الكل | -- (in-process) | | | fs_find | بحث بالبيانات الوصفية (فلاتر الاسم + mtime + الحجم + النوع)، مهلة تجوال 30 ثانية، سقف 5000 نتيجة | الكل | -- (in-process) | | | fs_list | عرض قائمة دليل واحد مع النوع / الحجم / mtime، بسقف 200 إدخال | الكل | -- (in-process) | | | fs_tree | شجرة ASCII محدودة العمق، تتخطى .git وnode_modules و__pycache__ | الكل | -- (in-process) | | | fs_symbols | مخطط AST عبر Tree-sitter (أسماء الدوال / الفئات / الطرق + نطاقات الأسطر)، 15 لغة (py, js, ts, tsx, jsx, java, go, rs, rb, php, c, cpp, cs, kt, swift, scala) | الكل | -- (in-process) | | | fs_symlink_read | حل الرابط الرمزي إلى هدفه الخام دون اتباعه | الكل | -- (in-process) | | | fs_hash | تجزئة SHA-256 أو MD5 لملف، مع تدفق على دفعات 64 كيلوبايت | الكل | -- (in-process) | | | fs_diff | diff موحد بين ملفين، أو بين ملف وآخر لقطة fs_read له (يكتشف الكتابات المتزامنة في الفريق الناري) | الكل | -- (in-process) | | | fs_extract | استخراج آمن لأرشيفات tar / zip / gz، ويرفض مسارات zip-slip وtar-slip | الكل | -- (in-process) | | | fs_archive | تجميع مسارات مساحة العمل في tar.gz أو zip لتنزيلها بنقرة واحدة من المشغّل | الكل | -- (in-process) | | المهام الخلفية | job_spawn | فصل استدعاء الأداة كمهمة خلفية asyncio، مع توجيه المخرجات (tee) إلى jobs/<id>.log في الوقت الفعلي، وفحوصات المرحلة / قواعد الاشتباك (RoE) عند الإطلاق | الكل | -- (in-process) | | | job_status | استعلام حالة غير حاجب (non-blocking) -- الحالة الحالية، حجم السجل، آخر 40 سطراً من المخرجات، ويبقى بعد إعادة تشغيل الوكيل عبر <id>.meta.json | الكل | -- (in-process) | | | job_wait | الحظر حتى N ثانية لانتظار إنهاء المهمة، ويعيد نفس بنية job_status | الكل | -- (in-process) | | | job_cancel | إلغاء مهمة قيد التشغيل، تتحول الحالة إلى cancelled، بلا تأثير (no-op) على المهام المنتهية | الكل | -- (in-process) | | | job_list | سرد المهام الخلفية للمشروع، مع التصفية حسب active=true / false / أو حذف الفلتر لعرض الكل | الكل | -- (in-process) |

_{جميع أدوات MCP تعمل داخل حاوية عزل (sandbox) بنظام Kali Linux. أدوات نظام ملفات مساحة العمل (Workspace FS) وأدوات المهام الخلفية (Background Jobs) تعمل داخل العملية (in-process) داخل حاوية الوكيل وتعمل حصرياً على مساحة عمل المشروع في /workspace/<projectId>/ -- يرفض التحقق من المسارات كل حيل العبور (حقن project-id، الهروب عبر الروابط الرمزية، zip-slip، tar-slip). راجع صفحة wiki لمساحة عمل الوكيل للمرجع الكامل. الأدوات الموسومة بأنها خطيرة تتطلب تأكيداً يدوياً قبل التنفيذ. الوضع الخفي (Stealth mode) يقيّد الأدوات النشطة بعمليات سلبية فقط أو عمليات أحادية الهدف. ملاحظة: WPScan مرخّص بموجب رخصة WPScan العامة المصدرية (وليست MIT). مجاني لتقييمات اختبار الاختراق والاستخدام الشخصي؛ قد يتطلب الاستخدام التجاري ترخيصاً منفصلاً من wpscan.com.}

مكوّنات أدوات MCP الإضافية (لتوسيع ترسانة أدوات الوكيل)

إلى جانب خوادم MCP الخمسة المدمجة أعلاه، يمكنك توصيل أي خادم Model-Context-Protocol بالوكيل كمكوّن أداة إضافي tool plugin (Shodan، GitHub، Censys، Hugging Face، mitmproxy، أو خوادم MCP الداخلية الخاصة بك) دون تعديل الكود أو إعادة بناء الحاويات أو تشغيل الترحيلات (migrations). افتح الإعدادات العامة → مكوّنات أدوات MCP الإضافية (MCP Tool Plugins).

مساران متاحان: اختر أحد 39 إعداداً مسبقاً جاهزاً للإضافة السريعة (Quick-Add) (OSINT، استخبارات التهديدات، السحابة، ماسحات تطبيقات الويب، إعداد التقارير، الهندسة العكسية؛ الفئات موسومة على كل بطاقة)، أو انقر Add MCP لإعداد يدوي. ثلاثة أنواع نقل مدعومة: stdio وsse وstreamable_http. الزر البرتقالي اكتشاف وإضافة أدوات جديدة ينفذ list_tools() مباشرةً على المسودة، ويعيد النتيجة خلال 30 ثانية، ويستورد تلقائياً كل أداة مكتشفة مع اسمها ووصفها وargs_format المشتق من JSON-Schema (الأنواع، القوائم المعدودة (enums)، القيم الافتراضية، الحد الأدنى/الأقصى، ووصف لكل خاصية). احفظ → تظهر الأدوات تلقائياً في مصفوفة الأدوات (Tool Matrix) لكل مشروع وفي الموجه النظامي (system prompt) للوكيل خلال ~1 ثانية. لا حاجة لإعادة تشغيل الوكيل، ولا prisma db push.

دليل المشغّل الكامل (كل حقل في النموذج، جميع الإعدادات المسبقة الـ 39، تدفق المصادقة، سير عمل الاكتشاف المباشر، قواعد التحقق، استكشاف الأخطاء وإصلاحها، ونموذج التخزين / الأمان): صفحة wiki لمكوّنات أدوات MCP الإضافية.

مساحة عمل الوكيل: نظام ملفات لكل مشروع، مهام خلفية، وتفريغ تلقائي (Auto-Offload)

شاهد العرض التوضيحي: مساحة عمل وكيل RedAmon: ذكاء اصطناعي ينفذ 4 اختبارات اختراق متوازية ويكتب تقريره بنفسه (YouTube)

يحصل كل مشروع على دليل دائم /workspace/<projectId>/ يراه في الوقت نفسه كل من الوكيل وحاوية kali-sandbox وأنت (عبر درج نظام الملفات (FileSystem Drawer) في المنطقة الحمراء (Red Zone)). يتم إنشاء أربعة مجلدات مخصصة تلقائياً ومحمية من إعادة التسمية/الحذف: notes/ لمسودات أعمال وتقارير الوكيل، tool-outputs/ للمخرجات الضخمة المفرّغة تلقائياً، jobs/ لسجلات المهام الخلفية، وuploads/ للملفات التي تضعها ليقرأها الوكيل. يُتعلَّم الوكيل التخطيط في كل خطوة تفكير عبر WORKSPACE_LAYOUT_BLOCK، وعندما تضع ملفات في uploads/ تُبرز الكتلة هذه الملفات تحت توجيه CHECK THESE NOW حتى يقرأها الوكيل قبل مواصلة أي شيء آخر كان يفعله.

يحصل الوكيل على 24 أداة لنظام الملفات (fs_read, fs_write, fs_edit, fs_multi_edit, fs_undo_edit, fs_grep, fs_glob, fs_find, fs_diff, fs_symbols, fs_archive, fs_extract والمزيد) بالإضافة إلى 5 أدوات للمهام الخلفية (job_spawn, job_status, job_wait, job_cancel, job_list). تُفصل عمليات المسح الطويلة مثل nuclei أو hydra كمهام asyncio وتدفق مخرجاتها إلى jobs/<id>.log، حتى يتمكن الوكيل من البحث بـfs_grep عن النتائج أثناء التشغيل (mid-flight) دون حظر خطوة الاستدلال التالية. تُفرَّغ المخرجات الأكبر من 20 كيلوبايت تلقائياً إلى tool-outputs/<utc-iso>-<tool>.txt ويتلقى نموذج LLM مقتطف الرأس/الذيل بالإضافة إلى مسار الملف، وبذلك لا يُخرج تفريغ DOM بحجم 5 ميجابايت من Playwright نافذة السياق عن مسارها أبداً. يعرض الدرج كل هذا مع تنقل عبر مسار التنقل (breadcrumb)، ورفع بالسحب والإفلات، ومعاينة داخلية، وخصائص SHA-256، وتنزيل tar.gz لكل مجلد، وتبويب مهام (Jobs) مع شارات حالة حية وخيار إلغاء.

يرفض التحقق من المسارات كل حيل العبور (حقن project-id، الهروب عبر الروابط الرمزية، zip-slip، tar-slip، تجاوز المجلدات المحمية عبر التطبيع) وهو مفروض من جانب الخادم. تنجو المهام من إعادة تشغيل الوكيل عبر بيانات وصفية مخزنة على القرص: تتحول المهام المعزولة قيد التشغيل إلى interrupted عند الإقلاع حتى لا تعرض الواجهة صفاً يدور إلى الأبد.

دليل المشغّل الكامل (كل ميزة في الدرج، جميع أدوات مساحة العمل الـ 29، خريطة سياسة التفريغ التلقائي، المجلدات الأربعة المحمية، أنماط تنسيق الفريق الناري عبر fs_diff vs_last_read، ونموذج أمان التحقق من المسارات): صفحة wiki لمساحة عمل الوكيل.

الفريق الناري (Fireteam): وكلاء فرعيون متخصصون متوازيون

وضع التنفيذ الأقوى للوكيل. عندما يتحلل الهدف إلى زوايا تحقيق مستقلة (سطح المصادقة، خريطة المسارات، سياسة الترويسات؛ أو 5 مرشحين من CVE لفرزهم بالتوازي)، يتفرع الوكيل الجذري إلى N من الوكلاء الفرعيين المتخصصين الذين يعملون بشكل متزامن داخل نفس الخلفية، كلٌّ منهم يشغّل حلقة ReAct متعددة الخطوات بمهمة مركّزة. هذا هو تنفيذ RedAmon للنمط المعماري Scatter-Gather ReAct (SG-ReAct): وكيل جذري يقرر متى يتفرع، وفريق ناري محدود من المتخصصين يعملون بالتوازي، وخطوة جمع (fan-in) تدمج نتائجهم في رؤية موحدة متماسكة.

كل ضمان أمان ينطبق على الوكيل الجذري ينطبق أيضاً على كل عضو: الحواجز الصلبة (hard guardrails)، والحواجز اللينة (soft guardrails)، وبوابات المراحل (phase gating)، وقواعد الاشتباك (Rules of Engagement)، وتأكيدات الأدوات الخطيرة (تُدار لكل عضو، وعلى نحو متوازٍ؛ يمكن أن يكون N من الأعضاء كلٌّ منهم بانتظار موافقتك على لوحته الخاصة في الوقت نفسه دون تسلسل). التكرار محظور (لا يمكن للعضو نفسه نشر فريق ناري) ولكل موجة سقف صارم لعدد الأعضاء، وميزانية تكرارات لكل عضو، ومهلة زمنية حقيقية (wall-clock timeout). النتيجة هي توازٍ بزمن حقيقي دون فوضى تنسيق، وإنهاء قابل للتنبؤ، وسجل تدقيق يُعزى فيه كل إجراء إلى المتخصص الذي أنتجه.

Wiki: الفريق الناري (المتخصصون المتوازيون) | تقني: README.AGENTIC_SYSTEM.md

موفرو نماذج الذكاء الاصطناعي

يدعم 5 موفرين وأكثر من 400 نموذج: OpenAI (GPT-5.2, GPT-5, GPT-4.1)، Anthropic (Claude Opus 4.6, Sonnet 4.5)، OpenRouter (أكثر من 300 نموذج)، AWS Bedrock، وأي نقطة نهاية متوافقة مع OpenAI (Ollama, vLLM, LM Studio, Groq وغيرها). تُجلب النماذج ديناميكياً دون قوائم مشفّرة.

تتضمن إعدادات الموفر المتوافق مع OpenAI عنصر تحكم جهد الاستدلال (reasoning effort). فعّله لإرسال reasoning_effort بقيمة low أو medium أو high أو max؛ واتركه معطلاً لعدم إرسال أي شيء واستخدام الوضع الافتراضي للنموذج. فعّله فقط للنماذج القادرة على التفكير: فالنموذج الذي لا يملك قدرة التفكير يرفض المستوى، ويعيد الوكيل المحاولة بدونه بشفافية. مستويات الجهد المتاحة تعتمد على النموذج. موفرو OpenAI الأساسيون ونقاط النهاية المتوافقة مع OpenAI غير المرتبطة يحتفظون بسلوكهم الحالي.

Wiki: موفرو نماذج الذكاء الاصطناعي

الرسم البياني لسطح الهجوم

رسم بياني معرفي (Knowledge Graph) عبر Neo4j يضم 17 نوعاً من العقد وأكثر من 20 نوعاً من العلاقات، وهو المصدر الوحيد للحقيقة لسطح هجوم الهدف. يستعلمه الوكيل قبل كل قرار عبر ترجمة من اللغة الطبيعية → Cypher.

Wiki: الرسم البياني لسطح الهجوم | تقني: GRAPH.SCHEMA.md

EvoGraph: تطور سلسلة الهجوم

رسم بياني تطوري مستمر يتتبع كل ما يفعله وكيل الذكاء الاصطناعي: تنفيذات الأدوات، والاكتشافات، والإخفاقات، والقرارات الاستراتيجية. يحل سياق السلسلة المنظم محل آثار التنفيذ المسطحة، محسّناً كفاءة الوكيل بأكثر من 25%. الذاكرة عبر الجلسات تعني أن الوكيل لا يبدأ أبداً من الصفر.

Wiki: EvoGraph | تقني: README.AGENTIC_SYSTEM.md

سلاسل هجوم متوازية متعددة الجلسات

أطلق جلسات وكيل متعددة ومتزامنة ضد المشروع نفسه. تنشئ كل جلسة سلسلة الهجوم (AttackChain) الخاصة بها في EvoGraph. تحمّل الجلسات الجديدة تلقائياً النتائج ودروس الإخفاق من جميع الجلسات السابقة، متجنبةً العمل المكرر.

Wiki: دليل وكيل الذكاء الاصطناعي

TrafficMind: التقاط حركة مرور HTTP

سجل الوكيل المدمج في RedAmon والمحدود بنطاق المهمة: وكيل رجل في المنتصف بدون بيانات اعتماد (مدعوم بـ mitmproxy) يقف بين كل أداة هجومية وهدفها، ويسجل الطلب/الاستجابة الكاملين لكل معاملة HTTP، ويوسمها بمن أنتجها (project / user / run / tool عبر وسم سياق HMAC موقّع)، ويخزنها في Postgres عبر عامل استيعاب موثوق يقتصر على الإدراج (INSERT-only). تخيّل سجل HTTP في Burp Suite، لكنه يعمل بمفتاح تبديل، وينسب كل طلب إلى مصدره، ويمكن الاستعلام منه من قبل المشغّل ومن وكيل الذكاء الاصطناعي معاً.

الالتقاط معطل افتراضياً ومقيد عند مستويين (مفتاح رئيسي عام يشغّل الوكيل، بالإضافة إلى مفتاح توجيه لكل مشروع). ثماني أدوات استطلاع وثماني أدوات HTTP للوكيل (execute_curl, execute_httpx, execute_playwright, execute_nuclei, execute_katana, execute_ffuf, execute_arjun, execute_wpscan) موجهة عبره، بحيث يُلتقط كل من حركة زحف/تخمين/مسح خط الأنابيب والوكيل نفسه، وتكون قابلة للبحث وإعادة التشغيل. لا يحتفظ الوكيل بأي أسرار، وحارس خروج SSRF مع تثبيت IP ضد إعادة ربط DNS (DNS rebinding) يمنعه من الانعطاف نحو البنية التحتية الداخلية، وتُحجب الترويسات الحساسة، وتُحسب الإشارات السلبية (المعلمات المنعكسة، ترويسات الأمان المفقودة، مشاكل أعلام الكوكيز) مجاناً على كل استجابة. تعرض طريقة عرض TrafficMind في التنقل العلوي المجموعة كجدول بنمط Burp مقسم إلى صفحات وقابل للتصفية، مع درج تفاصيل الطلب/الاستجابة، وتصدير CSV/JSON، وتنظيف أجسام الاستجابات بعدّ مرجعي (reference-counted).يعالج الوكيل المجموعة (corpus) عبر عشرة أدوات proxy_*: ثماني أدوات تحليل للقراءة فقط (proxy_search, proxy_get, proxy_sitemap, proxy_params, proxy_grep, proxy_diff, proxy_to_curl, proxy_query) وأداتان نشطتان (proxy_replay, proxy_fuzz) تعيدان إرسال طلب ملتقط أو تفحصانه بأسلوب Intruder (fuzzing). جميع الأدوات العشر مقيدة بشكل صارم بنطاق المستأجر (tenant)؛ أما الأدوات النشطة فمثبّتة على مضيفها الأصلي، وموسومة بعلامة الخطر، ومقيّدة ببوابات المراحل، وخاضعة لقيود التخفي.

ويكي: TrafficMind | تقني: README.TRAFFIC.md

الصدف العكسية

عرض موحّد للجلسات النشطة: meterpreter، والصدف العكسية/المرتبطة (reverse/bind shells)، والمُستمِعات. يتضمن طرفية مدمجة مع Command Whisperer التي تترجم الإنجليزية المبسطة إلى أوامر شل.

ويكي: الصدف العكسية

طرفية RedAmon

وصول تفاعلي كامل إلى صدفة PTY لحاوية Kali المعزولة مباشرةً من صفحة الرسم البياني عبر xterm.js. يمكنك الوصول إلى جميع أدوات اختبار الاختراق المثبتة مسبقًا (Metasploit وNmap وNuclei وHydra وsqlmap) دون مغادرة المتصفح. تشمل المزايا: سمة طرفية داكنة، ومؤشر حالة الاتصال، وإعادة اتصال تلقائية مع تراجع أُسّي (exponential backoff)، ووضع ملء الشاشة، وآلية استمرارية الاتصال (keepalive) من جهة المتصفح.

ويكي: لوحة الرسم البياني

CypherFix: المعالجة الآلية للثغرات

خط أنابيب من عاملين: عامل الفرز (Triage Agent) يشغّل 9 استعلامات Cypher مكتوبة بشكل ثابت (hardcoded)، ثم يستخدم نموذج LLM للربط بين النتائج وإزالة التكرارات وترتيب الأولويات. أما عامل إصلاح الكود (CodeFix Agent) فيستنسخ المستودع المستهدف، ويستكشف قاعدة الكود باستخدام 11 أداة، وينفّذ الإصلاحات، ويفتح طلب سحب (PR) على GitHub، محاكيًا التصميم الوكيلي لـ Claude Code. ولأن المستودع المستنسخ غير موثوق، فإن أوامر البناء/الاختبار الخاصة به تُنفَّذ في حاوية معزولة وخالية من الأسرار (وليس داخل العامل)، كما أن رمز GitHub المميز (token) لا يدخلها أبدًا.

ويكي: CypherFix | تقني: README.CYPHERFIX_AGENTS.md

مهارات الوكيل

موجّه نوايا مدعوم بنموذج LLM يصنّف طلبات المستخدمين إلى مهارات وكيل: استغلال CVE (عبر MSF)، وحقن SQL، وXSS، وSSRF، وRCE، واجتياز المسار (Path Traversal) / LFI / RFI، واختبار بيانات الاعتماد، والهندسة الاجتماعية، واختبار التوافرية، أو مهارات مخصصة يعرّفها المستخدم ويُحمّلها كملفات Markdown. وتتوفر مهارات المجتمع الجاهزة للاستخدام لتغطية اختبار واجهات API، وXSS، وSQLi، وXXE، وBFLA، وSSTI، وIDOR / BOLA، وإلغاء التسلسل غير الآمن، والإسناد الجماعي (mass assignment)، والاستيلاء على النطاقات الفرعية، والرفع غير الآمن للملفات -- حمّل ملف .md وارفعه عبر Global Settings > Agent Skills لتفعيله لمستخدمك. كما يمكنك المساهمة بمهاراتك الخاصة بفتح PR.

ويكي: مهارات الوكيل | مهارات المجتمع

مهارات الدردشة

حقن مرجعي عند الطلب عبر أمر /skill في دردشة الوكيل. مهارات الدردشة وثائق مرجعية تكتيكية -- أدلة تشغيل الأدوات، وأدلة الثغرات، وملاحظات خاصة بأطر العمل -- تحقنها في سياق الوكيل في اللحظة التي تحتاجها فيها بالضبط. اكتب /skill ssrf لتحميل خبرة SSRF، أو انقر على زر منتقي المهارات لاستعراض قائمة قابلة للتصفح. تأتي مع RedAmon 46 مهارة مرجعية تغطي الثغرات (JWT، وOAuth/OIDC، وCSRF، وحالات السباق، والمنطق التجاري، وتلوث النماذج الأولية، وReDoS، وتجاوز المصادقة الثنائية 2FA، وحقن LDAP/XPath، وتسميم ذاكرة التخزين المؤقت للويب، وCORS، وحقن ترويسة المضيف، والنقر الخفي Clickjacking، وCRLF، والمزيد)، والأدوات (sqlmap، وnuclei، وffuf، وnmap، وhttpx، وnaabu، وkatana، وsubfinder، وsemgrep)، والبروتوكولات (GraphQL، وWebSocket، وSOAP/WS-Security، وSAML)، والتقنيات (Firebase، وSupabase)، وأطر العمل (Next.js، وFastAPI، وNestJS)، وActive Directory (سلسلة القتل، وKerberoasting/ASREPRoast، وAD-CS ESC1-15، ومسار BloodHound إلى DA)، والسحابة (AWS، وAzure، وGCP)، وما بعد الاستغلال (الهروب من Docker، ورفع الامتيازات في Linux / Windows). وعلى عكس مهارات الوكيل (التي تقود التصنيف وسير العمل المراعية للمراحل)، فإن مهارات الدردشة سياق إضافي يبقى قائمًا حتى تقوم بتغييره أو إزالته.

ويكي: مهارات الدردشة | مهارات الدردشة المجتمعية

صائد أسرار GitHub

يفحص مستودعات GitHub وgists وسجل الالتزامات (commit history) بحثًا عن الأسرار المكشوفة باستخدام أكثر من 40 نمط regex وتحليل إنتروبيا شانون (Shannon entropy).

ويكي: صيد أسرار GitHub

الماسح العميق للأسرار TruffleHog

يفحص مستودعات GitHub بحثًا عن بيانات الاعتماد المسرّبة باستخدام أكثر من 700 كاشف مع تحقق تلقائي من أن الأسرار المكتشفة ما تزال نشطة. مدعوم بمحرك TruffleHog (trufflesecurity/trufflehog)، يكتشف مفاتيح API وكلمات المرور والرموز المميزة (tokens) والشهادات والمزيد عبر كامل سجل الالتزامات. تُخزَّن النتائج كعقد TrufflehogScan → TrufflehogRepository → TrufflehogFinding في الرسم البياني Neo4j. يمكن الوصول إلى كل من GitHub Hunt وTruffleHog من نافذة "Other Scans" في شريط أدوات الرسم البياني.

إعدادات المشروع

أكثر من 500 معامل قابل للتهيئة موزعة على 16 تبويبًا تتحكم في سلوك كل أداة، من وحدات الفحص إلى بوابات موافقة الوكيل. تُدار من خلال واجهة تطبيق الويب (webapp).

ويكي: مرجع إعدادات المشروع

قواعد الاشتباك (RoE)

ارفع مستند قواعد الاشتباك (PDF أو TXT أو MD أو DOCX) لتهيئة إعدادات المشروع تلقائيًا وفرض قيود الاشتباك. يُطبَّق الفرض على مستوى خط أنابيب الاستطلاع (المضيفات المستثناة، وحدود المعدل، والنوافذ الزمنية) وعلى مستوى الوكيل الذكي (حقن التعليمات prompt injection، وسقف مرحلة الخطورة، وقيود الأدوات).

ويكي: قواعد الاشتباك

لوحة الرؤى

أكثر من 30 رسمًا بيانيًا تفاعليًا موزعة على 4 أقسام: سلاسل الهجوم والاستغلالات، وسطح الهجوم، والثغرات واستخبارات CVE، ونظرة عامة على الرسم البياني. تُسحب جميع البيانات مباشرة (live) من Neo4j وPostgreSQL.

ويكي: لوحة الرؤى

الحاجز الوقائي للاستهداف

حاجز وقائي قائم على LLM يمنع استهداف النطاقات غير المصرح بها: يحجب المواقع الحكومية وكبرى شركات التقنية والمؤسسات المالية ومنصات التواصل الاجتماعي. يعمل على مستوى إنشاء المشروع وعند تهيئة الوكيل معًا. نطاقات الحكومات والجهات العسكرية والتعليمية والمنظمات الدولية (.gov و.mil و.edu و.int) محجوبة بشكل دائم بواسطة حاجز وقائي صارم حتمي (deterministic) لا يمكن تعطيله.

ويكي: إنشاء مشروع

تأكيد الأدوات

بوابة إشراف بشري (human-in-the-loop) على مستوى كل أداة للعمليات الخطرة. عند تفعيلها، يتوقف الوكيل قبل تنفيذ الأدوات عالية التأثير (Nmap وNuclei وMetasploit وHydra وصدفة Kali وتنفيذ الأكواد) ويعرض مطالبة Allow / Deny مضمّنة في الخط الزمني للدردشة. تدعم وضعَي تأكيد: الأداة المفردة والموجة المتوازية (الخطة). يمكن للمستخدمين الموافقة على وسيطات الأدوات أو رفضها أو تعديلها قبل بدء التنفيذ. يُعطَّل عبر مفتاح التبديل Require Tool Confirmation في إعدادات المشروع.

ويكي: Pentest Agent (تأكيد الأدوات)

تقارير اختبار الاختراق

تقارير HTML احترافية جاهزة للعملاء من 11 قسمًا. عند تهيئة نموذج ذكاء اصطناعي، تتلقى 6 أقسام روايات مولّدة بواسطة LLM تشمل الملخص التنفيذي، وتحليل المخاطر، وفرز المعالجة حسب الأولوية. عرض تقرير مثال.

ويكي: تقارير اختبار الاختراق

تصدير البيانات واستيرادها

نسخ احتياطي كامل واستعادة للمشروع عبر واجهة الويب: الإعدادات، والمحادثات، وبيانات الرسم البياني، ونتائج الاستطلاع/GVM/بحث GitHub كأرشيف ZIP قابل للنقل.

ويكي: تصدير البيانات واستيرادها

بنية النظام```mermaid

flowchart TB subgraph User["👤 User Layer"] Browser[Web Browser] CLI[Terminal/CLI] end

subgraph Frontend["🖥️ Frontend Layer"]
    Webapp[Next.js Webapp<br/>:3000]
end

subgraph Backend["⚙️ Backend Layer"]
    Agent[AI Agent Orchestrator<br/>FastAPI + LangGraph<br/>:8090]
    ReconOrch[Recon Orchestrator<br/>FastAPI + Docker SDK<br/>:8010]
end

subgraph Tools["🔧 MCP Tools Layer"]
    NetworkRecon[Network Recon Server<br/>Curl + Naabu<br/>:8000]
    Nuclei[Nuclei Server<br/>:8002]
    Metasploit[Metasploit Server<br/>:8003]
    Nmap[Nmap Server<br/>:8004]
end

subgraph Scanning["🔍 Scanning Layer"]
    Recon[Recon Pipeline<br/>Docker Container]
    GVM[GVM/OpenVAS Scanner<br/>Network Vuln Assessment]
    GHHunt[GitHub Secret Hunter<br/>Credential Scanning]
    TruffleHog[TruffleHog Scanner<br/>700+ Secret Detectors]
end

subgraph Data["💾 Data Layer"]
    Neo4j[(Neo4j Graph DB<br/>:7474/:7687)]
    Postgres[(PostgreSQL<br/>Project Settings<br/>:5432)]
end

subgraph LLMProviders["🧠 LLM Providers"]
    OpenAI[OpenAI]
    Anthropic[Anthropic]
    LocalLLM[Local Models<br/>Ollama · vLLM · LM Studio]
    OpenRouter[OpenRouter<br/>300+ Models]
    Bedrock[AWS Bedrock]
end

subgraph External["🌐 External APIs"]
    GitHubAPI[GitHub API<br/>Repos & Code Search]
end

subgraph Targets["🎯 Target Layer"]
    Target[Target Systems]
    GuineaPigs[Guinea Pigs<br/>Test VMs]
end

Browser --> Webapp
CLI --> Recon
Webapp <-->|WebSocket| Agent
Webapp -->|REST + SSE| ReconOrch
Webapp --> Neo4j
Webapp --> Postgres
ReconOrch -->|Docker SDK| Recon
ReconOrch -->|Docker SDK| GVM
ReconOrch -->|Docker SDK| GHHunt
ReconOrch -->|Docker SDK| TruffleHog
Recon -->|Fetch Settings| Webapp
GHHunt -->|GitHub API| GitHubAPI
TruffleHog -->|GitHub API| GitHubAPI
TruffleHog --> Neo4j
Agent -->|API| OpenAI
Agent -->|API| Anthropic
Agent -->|API| LocalLLM
Agent -->|API| OpenRouter
Agent -->|API| Bedrock
Agent --> Neo4j
Agent -->|MCP Protocol| NetworkRecon
Agent -->|MCP Protocol| Nuclei
Agent -->|MCP Protocol| Metasploit
Agent -->|MCP Protocol| Nmap
Recon --> Neo4j
GVM -->|Reads Recon Output| Recon
GVM --> Neo4j
GVM --> Target
GVM --> GuineaPigs
NetworkRecon --> Target
Nuclei --> Target
Metasploit --> Target
Nmap --> Target
NetworkRecon --> GuineaPigs
Nuclei --> GuineaPigs
Metasploit --> GuineaPigs
Nmap --> GuineaPigs

> **مخططات العمارة الكاملة** (تدفق البيانات، حاويات Docker، خط أنابيب الاستطلاع، سير عمل الوكيل، تكامل MCP): **[ARCHITECTURE.md](https://github.com/samugit83/redamon/blob/master/readmes/ARCHITECTURE.md)**
>
> **مجموعة التقنيات** (أكثر من 70 تقنية عبر الواجهات الأمامية والخلفية والذكاء الاصطناعي وقواعد البيانات وأدوات الأمان): **[TECH_STACK.md](https://github.com/samugit83/redamon/blob/master/readmes/TECH_STACK.md)**

---

## المكوّنات

| المكوّن | الوصف | التوثيق |
|-----------|-------------|---------------|
| **خط أنابيب الاستطلاع** | خط أنابيب مسحٍ متوازٍ (fan-out/fan-in) لـ OSINT والثغرات الأمنية | [README.RECON.md](https://github.com/samugit83/redamon/blob/master/readmes/README.RECON.md) |
| **منسّق الاستطلاع** | إدارة دورة حياة الحاويات عبر Docker SDK | [README.RECON_ORCHESTRATOR.md](https://github.com/samugit83/redamon/blob/master/readmes/README.RECON_ORCHESTRATOR.md) |
| **وسيط مقبس Docker** | بروكسي عكسي مُصفِّح لمقبس Docker: تصل حاويات الفحص المُنشأة إلى البرنامج الخفي من خلاله، فلا يمكنها إنشاء سوى صور الأدوات المعروفة (مدرجة في قائمة مسموح بها، دون تثبيتات من المضيف / حاويات ممتدة الصلاحيات / صور عشوائية) | غير متاح |
| **قاعدة بيانات الرسم البياني** | رسم خريطة سطح الهجوم باستخدام Neo4j مع دعم متعدد المستأجرين | [README.GRAPH_DB.md](https://github.com/samugit83/redamon/blob/master/readmes/README.GRAPH_DB.md) · [GRAPH.SCHEMA.md](https://github.com/samugit83/redamon/blob/master/readmes/GRAPH.SCHEMA.md) |
| **خوادم أدوات MCP** | أدوات أمنية عبر بروتوكول سياق النموذج (بيئة Kali معزولة) | [README.MCP.md](https://github.com/samugit83/redamon/blob/master/readmes/README.MCP.md) |
| **منسّق وكيل الذكاء الاصطناعي** | وكيل مستقل قائم على LangGraph بنمط ReAct | [README.AGENTIC_SYSTEM.md](https://github.com/samugit83/redamon/blob/master/readmes/README.AGENTIC_SYSTEM.md) |
| **وكلاء CypherFix** | فرز تلقائي + إصلاح الكود + طلب سحب GitHub | [README.CYPHERFIX_AGENTS.md](https://github.com/samugit83/redamon/blob/master/readmes/README.CYPHERFIX_AGENTS.md) |
| **تطبيق الويب** | لوحة معلومات Next.js للتصور والتفاعل مع الذكاء الاصطناعي | [README.WEBAPP.md](https://github.com/samugit83/redamon/blob/master/readmes/README.WEBAPP.md) |
| **ماسح GVM** | ماسح ثغرات الشبكة Greenbone/OpenVAS (أكثر من 170 ألف NVT) | [README.GVM.md](https://github.com/samugit83/redamon/blob/master/readmes/README.GVM.md) |
| **ماسح TruffleHog** | فحص عميق للأسرار مع أكثر من 700 كاشف والتحقق من بيانات الاعتماد | غير متاح |
| **قاعدة بيانات PostgreSQL** | إعدادات المشروع وحسابات المستخدمين وبيانات الإعداد | [README.POSTGRES.md](https://github.com/samugit83/redamon/blob/master/readmes/README.POSTGRES.md) |
| **بيئات الاختبار** | حاويات Docker مُعرَّضة للثغرات عمدًا لاختبار آمن | [README.GPIGS.md](https://github.com/samugit83/redamon/blob/master/readmes/README.GPIGS.md) |

---

## التوثيق

| المصدر | الرابط |
|----------|------|
| **الويكي الكامل** (دليل المستخدم) | **[github.com/samugit83/redamon/wiki](https://github.com/samugit83/redamon/wiki)** |
| نشر الخادم (مضيف واحد) | **[الويكي: النشر على خادم](https://github.com/samugit83/redamon/wiki/Deploying-to-a-Server)** · [deploy/single-host/README.md](https://github.com/samugit83/redamon/blob/master/deploy/single-host/README.md) |
| **الوضع الأمني** (كتالوج الدفاع المتعمق) | **[readmes/README.SECURITY_POSTURE.md](https://github.com/samugit83/redamon/blob/master/readmes/README.SECURITY_POSTURE.md)** |
| نموذج التهديد (STRIDE) | [readmes/README.TM.SYSTEM_OVERVIEW.md](https://github.com/samugit83/redamon/blob/master/readmes/README.TM.SYSTEM_OVERVIEW.md) |
| سياسة الأمان | [SECURITY.md](https://github.com/samugit83/redamon/blob/master/SECURITY.md) |
| التطوير بمساعدة الذكاء الاصطناعي | **[الويكي: قدّم طلبات سحب مثالية مع الذكاء الاصطناعي](https://github.com/samugit83/redamon/wiki/AI-Assisted-Development)** |
| دليل المطور | [readmes/README.DEV.md](https://github.com/samugit83/redamon/blob/master/readmes/README.DEV.md) |
| مخططات العمارة | [readmes/ARCHITECTURE.md](https://github.com/samugit83/redamon/blob/master/readmes/ARCHITECTURE.md) |
| مجموعة التقنيات | [readmes/TECH_STACK.md](https://github.com/samugit83/redamon/blob/master/readmes/TECH_STACK.md) |
| استكشاف الأخطاء وإصلاحها | [readmes/TROUBLESHOOTING.md](https://github.com/samugit83/redamon/blob/master/readmes/TROUBLESHOOTING.md) |
| سجل التغييرات | [CHANGELOG.md](https://github.com/samugit83/redamon/blob/master/CHANGELOG.md) |
| إخلاء المسؤولية الكامل | [DISCLAIMER.md](https://github.com/samugit83/redamon/blob/master/DISCLAIMER.md) |
| تراخيص الطرف الثالث | [THIRD-PARTY-LICENSES.md](https://github.com/samugit83/redamon/blob/master/THIRD-PARTY-LICENSES.md) |
| الترخيص | [LICENSE](https://github.com/samugit83/redamon/blob/master/LICENSE) |

---

## استكشاف الأخطاء وإصلاحها

RedAmon مُعبّأ بالكامل في حاويات Docker ويعمل على أي نظام تشغيل يدعم Docker Compose v2+. لإصلاحات خاصة بنظام التشغيل (Linux وWindows وmacOS)، راجع **[دليل استكشاف الأخطاء وإصلاحها](https://github.com/samugit83/redamon/blob/master/readmes/TROUBLESHOOTING.md)** أو **[الويكي](https://github.com/samugit83/redamon/wiki/Troubleshooting)**.

---

## RedAmon HackLab

<table>
<tr>
<td width="280" align="center">
  <a href="https://github.com/samugit83/redamon/wiki/RedAmon-HackLab">
    <img src="https://raw.githubusercontent.com/samugit83/redamon/HEAD/assets/hacklab.png" alt="RedAmon HackLab" width="260"/>
  </a>
</td>
<td>
  <h3>هل تريد أن ترى RedAmon يفكّر مثل مختبِر اختراق حقيقي؟</h3>
  <p>استكشف جلسات هجوم حيّة في الوقت الفعلي — كل خطوة وكل منعطف وكل استغلال — عبر 15 فئة من فئات الثغرات على هدف حي. سجلات جلسات كاملة وشروحات مفصّلة وتسجيلات فيديو تُظهر الوكيل وهو يخترق خادمًا متعدد الخدمات بشكل مستقل من الصفر.</p>
  <a href="https://github.com/samugit83/redamon/wiki/RedAmon-HackLab"><b>استكشف HackLab &rarr;</b></a>
  &nbsp;&nbsp;|&nbsp;&nbsp;
  <a href="https://github.com/samugit83/redamon/wiki/RedAmon-HackLab#community-sessions"><b>قدّم جلستك الخاصة &rarr;</b></a>
  <br/><sub>هل لديك جلسة وكيل مذهلة على هدفك الخاص؟ شاركها مع المجتمع — سجل الجلسة + فيديو YouTube.</sub>
</td>
</tr>
</table>

---

## معرض المجتمع

فيديوهات وتقارير وتجارب واقعية من محترفي الأمن الذين يستخدمون RedAmon في الميدان. هل تريد أن يظهر محتواك؟ اطّلع على مسار [صانع المحتوى](https://github.com/samugit83/redamon/blob/master/CONTRIBUTING.md#content-creator) في CONTRIBUTING.md.

### فيديوهات

| العنوان | الرابط |
|-------|------|
| RedAmon v2.2.0, اختبار الهندسة الاجتماعية: من تسليم الحمولة إلى الوصول إلى الصدفة | [شاهد](https://youtu.be/kVjV9K_eks4) |
| التحقق من CVE بواسطة وكيل الذكاء الاصطناعي: أبعد من الأدوات القياسية | [شاهد](https://youtu.be/rypmP1SJon8) |
| RedAmon 2.0, من 0 إلى 1000 نجمة على GitHub في 10 أيام: هجمات متوازية متعددة الوكلاء | [شاهد](https://youtu.be/afViJUit0xE) |
| أنشئ وكيل فريق أحمر مستقل بالذكاء الاصطناعي من الصفر: البرنامج التعليمي الكامل LangGraph + Metasploit + Neo4j | [شاهد](https://youtu.be/mO5CCkYlY94) |

### دراسات حالة من الواقع

| من | ماذا | الرابط |
|-----|------|------|
| Nipun Dinudaya | نشر RedAmon على موقع شركة وحدد ثغرة حقن SQL حرجة كان من الممكن أن تتسبب في كشف كبير للبيانات | [اقرأ على LinkedIn](https://www.linkedin.com/posts/nipun-dinudaya-6159b32bb_redamon-cybersecurity-penetrationtesting-ugcPost-7431233870253166592-aLvb) |
| Venkata Bhargav CH S | استخدم RedAmon خلال تدريب داخلي في Ascent e-Digit Solutions: استطلاع عملي وتحليل DNS ورسم خريطة سطح الهجوم | [اقرأ على LinkedIn](https://www.linkedin.com/posts/venkata-bhargav-cybersecurity_cybersecurity-ethicalhacking-redteam-share-7434940660803182592-e9En) |

### أدلة المجتمع

| من | ماذا | الرابط |
|-----|------|------|
| MrGood | إتقان Redamon: دليل شامل للتثبيت على Kali Linux، يتناول تحديات Docker الخاصة بـ Kali والوضع الأمني | [اقرأ على Medium](https://cyberaccoon.medium.com/mastering-redamon-a-comprehensive-guide-to-installation-on-kali-linux-ea544e6f5b9f) |
| Bogdan Caraman | كيفية تثبيت RedAmon على Debian 13 (Trixie) مع OpenRouter، دليل خطوة بخطوة مع إعداد Docker وعنوان IP ثابت وأتمتة systemd | [اقرأ على المدونة](https://blog.bogdancaraman.com/install-redamon-debian-13-openrouter/) |

---

## المساهمة

المساهمات مرحّب بها! يرجى قراءة [CONTRIBUTING.md](https://github.com/samugit83/redamon/blob/master/CONTRIBUTING.md) للاطلاع على إرشادات البدء واصطلاحات نمط الكود وعملية طلبات السحب.

---

## المشرفون

**Samuele Giampieri**: المنشئ والمشرف ومهندس منصة الذكاء الاصطناعي · [LinkedIn](https://www.linkedin.com/in/samuele-giampieri-b1b67597/) · [GitHub](https://github.com/samugit83) · [Devergo Labs](https://www.devergolabs.com/)

**Ritesh Gohil**: المشرف وكبير باحثي الأمن · [LinkedIn](https://www.linkedin.com/in/riteshgohil25/) · [GitHub](https://github.com/L4stPL4Y3R)

---

## التواصل

للاستفسارات أو الملاحظات أو طلبات التعاون: **[email protected]**

---

## الشؤون القانونية

> **محلي افتراضيًا؛ النشر على الخادم له مسار محصّن مدعوم.** صُمم RedAmon في وضعه الافتراضي ليعمل على **جهاز محلي** ولا يتضمن ضوابط أمان مواجهة للإنترنت بحد ذاته. لتشغيله على خادم عام يمكن الوصول إليه عبر الإنترنت، استخدم **نشر المضيف الواحد المحصّن** في [`deploy/single-host/`](https://github.com/samugit83/redamon/blob/master/deploy/single-host) الذي يضع المجموعة الكاملة خلف nginx + TLS وجدار نار للمضيف وتحصين SSH ومنشأ HTTPS عام واحد، مع ربط كل خدمة داخلية بـ loopback. تشغيل المجموعة **الخام** (بدون ذلك النشر) على عنوان IP عام سيعرّض الخدمات الداخلية غير المصادَق عليها، لذا فإن أي شيء خارج شبكة محلية موثوقة دون النشر المحصّن يكون على مسؤوليتك الشخصية بالكامل.

هذا المشروع مُصدَر بموجب [رخصة MIT](https://github.com/samugit83/redamon/blob/master/LICENSE).

يدمج RedAmon عدة أدوات من جهات خارجية بموجب تراخيصها الخاصة (MIT وApache-2.0 وBSD وGPL-2.0/3.0 وAGPL-3.0 وLGPL ورخصة WPScan العامة للمصدر). الكود المصدري لجميع المكونات المرخصة بموجب AGPL متاح في مستودعاتها الأصلية. الجرد الكامل والالتزامات المتعلقة بالتراخيص موثقة في [THIRD-PARTY-LICENSES.md](https://github.com/samugit83/redamon/blob/master/THIRD-PARTY-LICENSES.md).

> **ملاحظة الاستخدام التجاري**: صورة بيئة Kali المعزولة تتضمّن **WPScan**، الخاضع لرخصة WPScan العامة للمصدر. تقيّد WPScan الاستخدام التجاري (SaaS وعروض المنتجات المدفوعة والخدمات ذات القيمة المضافة) دون ترخيص منفصل من فريق WPScan. اختبارات الاختراق والاستخدام الشخصي مسموحان. إذا كنت تنوي استخدام RedAmon في منتج أو خدمة تجارية، راجع [THIRD-PARTY-LICENSES.md](https://github.com/samugit83/redamon/blob/master/THIRD-PARTY-LICENSES.md) قبل التوزيع.

راجع [DISCLAIMER.md](https://github.com/samugit83/redamon/blob/master/DISCLAIMER.md) للاطلاع على شروط الاستخدام الكاملة وسياسة الاستخدام المقبول ومتطلبات الامتثال القانوني.

---

<p align="center">
  <strong>استخدم بمسؤولية. اختبر بأخلاق. دافع بشكل أفضل.</strong>
</p>