mafifrizi/aresمنصة ممارسة الفريق الأحمر المستقلة مع تنسيق وحدة MITRE ATT&CK، وحل مسار الهجوم DAG، وضوابط OPSEC، وخزنة بيانات اعتماد مشفرة، وتقارير متعددة التنسيقات.
المنصة مفتوحة النواة التي تُمكّن الفرق الحمراء في المؤسسات ومزودي خدمات الأمن المُدار ومراكز العمليات الأمنية من تنفيذ تفاعلات هجومية موجّهة، واكتشاف مسارات الهجوم الحتمية، والتحقق المستمر من الوضع الدفاعي دون أي مخاطر جانبية.
عرض المنصة • لماذا ARES؟ • المصفوفة التنافسية • البنية المعمارية • مصفوفة MITRE • البدء السريع • الأمان بثقة صفرية • التوثيق
اختبار الاختراق التقليدي معيب جوهريًا: فهو مكلف، ومتقطع، ومرتبط بلحظة زمنية محددة، ويترك المؤسسات عمياء عن حالات الضبط الخاطئ المُستحدثة وأساليب المهاجمين الناشئة. وفي الوقت نفسه، تُغرق ماسحات الثغرات الآلية فرق مركز العمليات الأمنية بآلاف الثغرات الافتراضية دون إثبات قابلية الاستغلال أو مسارات الهجوم الجانبي متعددة المراحل.
ARES يسد هذه الفجوة. بُني من الأساس للبنية التحتية المؤسسية الحديثة، ويقدّم ARES منصة تفاعل هجومي أحمر مستقلة وموجّهة بالأهداف تُحاكي الجهات الفاعلة الحقيقية للتهديدات. من خلال الجمع بين جدران حماية النطاق على مستوى النواة، وتوصيف ضوضاء OPSEC التكيفي، ومُحلّل هجوم تفاعلي للرسم البياني الموجّه غير الدوري (DAG)، وأكثر من 60 تقنية مُسلّحة مرتبطة بـ MITRE ATT&CK، يُمكّن ARES فرق الأمن من إثبات قابلية استغلال الثغرات، وتحديد أقصر مسارات الاختراق إلى الجواهر التاجية في Active Directory، وإنشاء مخرجات جاهزة للإدارة التنفيذية دون أي توقف تشغيلي.
THE ARES ADVANTAGE
┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐ │ STRICT SCOPE ENCLAVE │ │ AUTONOMOUS DAG ENGINE │ │ ZERO-TRUST ARCHITECTURE │ │ Hard kernel CIDR egress │ │ Computes shortest paths │ │ Memory-only JWT tokens, │ │ whitelisting prevents │───│ to Domain Admins & Crown│───│ AES-256 encrypted vault,│ │ any collateral impact. │ │ Jewels deterministically│ │ strict HMAC-CSRF checks.│ └─────────────────────────┘ └─────────────────────────┘ └─────────────────────────┘ │ ▼ ┌─────────────────────────┐ │ INSTANT EXECUTIVE SUITE │ │ Branded PDF, HTML, JSON │ │ deliverables with zero │ │ native GTK dependencies │ └─────────────────────────┘
### ركائز القيمة الأساسية
1. **🛡️ حوكمة النطاق بدون أضرار جانبية**: تعمل كل حملة داخل حدود تشفيرية معزولة. تضمن عمليات التحقق الصارمة من عناوين IP و CIDR المستهدفة على مستوى مقبس الشبكة عدم لمس أي حزمة للبنية التحتية خارج النطاق.
2. **🧠 تخطيط مستقل موجه بالأهداف**: يحدد المشغلون أهدافًا عالية المستوى (مثل `domain_admin`، `full_compromise`، `cloud_audit`)، ويقوم محرك قرار ARES بشكل مستقل بتوليف مسارات تنفيذ متعددة المراحل باستخدام استدلالات الرسم البياني ووكلاء LLM الاختياريين (Claude / OpenAI / Ollama المحلي).
3. **🕸️ رسم بياني للهجوم متعدد المتجهات (DAG)**: استيعاب مجموعات BloodHound أو رسم جلسات النطاق النشطة في الوقت الفعلي. يحسب محرك الرسم البياني المدمج أقصر مسارات الهجوم، ويسلط الضوء على نقاط الاختناق، ويحاكي جدوى المحاور الجانبية.
4. **🔐 نموذج أمني دفاعي متعدد الطبقات**: مصمم لبيئات الثقة الصفرية. تحمي الجلسات المعتمدة على قاعدة البيانات، ورموز الوصول JWT قصيرة العمر في الذاكرة فقط، وبيانات اعتماد التحديث الدوارة HttpOnly، والخزائن المحلية المشفرة AES-256-GCM، التجزئات المحصودة والأدلة الحساسة للعميل.
5. **📑 خط أنابيب المخرجات الآلي**: إنشاء بنقرة واحدة لمخرجات الامتثال الجاهزة للتدقيق والعلامات التجارية بصيغ PDF و HTML و Markdown و JSON. يتميز بعرض PDF الآلي عبر متصفح بلا واجهة على Windows/Linux دون تبعيات GTK خارجية.
---
## 📊 مصفوفة مقارنة السوق
| القدرة التشغيلية | اختبار اختراق يدوي تقليدي | ماسحات الثغرات القديمة | منصة ARES المستقلة |
| :--- | :---: | :---: | :---: |
| **تكرار الاختبار** | سنوي / نصف سنوي | مجدول يوميًا / أسبوعيًا | **مستمر / عند الطلب** |
| **التحقق من قابلية الاستغلال** | يدوي وكثيف العمالة | ❌ مطابقة CVE النظرية | **إثبات حتمي متعدد المراحل** |
| **مسارات الهجوم متعددة القفزات** | رسم يدوي | ❌ لا شيء | **DAG تفاعلي في الوقت الفعلي** |
| **جيب النطاق وجدار الحماية الصادر** | انضباط المشغل فقط | جدران حماية الشبكة فقط | **فرض صارم لـ CIDR على مستوى المقبس** |
| **مسارات Active Directory الجانبية** | تنفيذ برنامج نصي بطيء | ❌ لا مسارات نشطة | **مجموعة BloodHound و Kerberos الأصلية** |
| **أمن وتخزين بيانات الاعتماد** | ملفات مسطحة فضفاضة / نص صريح | سجلات الثغرات | **خزنة مشفرة AES-256-GCM** |
| **خفض OPSEC والقياس عن بعد** | برامج نصية يدوية للتذبذب | ضوضاء شبكة عالية | **ملفات تعريف ضوضاء تكيفية وحاكم** |
| **وقت تسليم التقارير** | 1-2 أسبوع بعد المشاركة | تفريغ البيانات الخام | **مخرجات فورية متعددة الصيغ** |
| **بصمة النشر** | مستشارون خارجيون | وكلاء سحابة ضخمة | **محلي معزول جويًا / مستضاف ذاتيًا** |
---
## 🖥️ عرض المنصة وأسطح التحكم
تتميز منصة ARES بلوحة تحكم عالية الأداء ومتجاوبة للمشغل، مصممة بجماليات التقنية الداكنة، وحمل معرفي منخفض، وتحكم تشغيلي مدقق.```powershell
# Launch local development environment
.\.venv\Scripts\ares.exe dashboard dev --no-reload
حاجز دخول ذاتي مصمم خصيصًا للمشغّلين الهجوميين المصرّح لهم وأفراد الأمن.
حصن مشغّل ARES — ينفجر زر تسجيل الدخول بنيران بلازما قرمزية عند التمرير والنقر ومفتاح Enter. لوحة HTML5 Canvas للشبكة المعمارية الديناميكية، ومواصفات بيئة النظام، وتميمة ARES Cyber Dragon في اللوحة اليمنى.
requestAnimationFrame.InResponseTo/nonce)، وتعيين الأدوار في الوقت المناسب (JIT)، وقفل كلمة المرور المحلية الصارم للهويات الاتحادية. (انظر دليل إعداد SSO).X-ARES-CSRF).وحدة تحكم عملياتية في الوقت الفعلي توفر رؤية فورية للوضع عبر الحملات النشطة.
مركز القيادة التنفيذي يعرض القياس عن بُعد في الوقت الفعلي، والنتائج المؤكدة حسب الخطورة، والصحة العملياتية.
نظرة عامة تكتيكية للحالة الصفرية — واجهة ترحيب نظيفة مع شريط جاهزية فوري وإجراءات تهيئة عند التشغيل بدون حملات نشطة.
panel-subtle)، ومؤشرات صحة تفاعلية ديناميكية في الشريط العلوي، ومسارات تقدّم متقطعة مميزة لخطوط الأساس المترية غير المهيأة.Staged أو Executing أو Standby) يميّز الأهداف المحددة النطاق عن الحملات قيد التنفيذ.حوكمة أهداف بدون أضرار جانبية تفرض حدود قائمة CIDR البيضاء الصارمة وعزل الأدلة المشفرة.
واجهة إدارة الحملات تعرض نطاقات الأهداف، وحدود CIDR، وعناصر التحكم في الضوضاء، وخزنة بيانات الاعتماد المشفرة.
<label> مستمرة عبر جميع منتقيات الحملات ومدخلات المعاملات، مما يمنع غموض المشغّل أثناء المشاركات السريعة.Stealth أو Normal أو Aggressive) مع توزيعات تأخير عشوائية.كتالوج واسع من تقنيات الخصم المسلّحة المتوافقة مع مصفوفة MITRE ATT&CK للمؤسسات.
كتالوج الوحدات مع تصنيف MITRE ATT&CK، وتوليد المعاملات الديناميكي، وأوضاع السلامة للتشغيل التجريبي.
ad.kerberoast، ad.adcs، ad.enum_users)، وWindows (windows.uac_bypass)، وLinux، والسحابة (AWS و Azure و GCP)، والبنية التحتية للشبكة.حلّال رسم بياني موجّه لا دوري (DAG) تفاعلي يتصور مسارات الهجوم على المؤسسات وسلاسل تصعيد الامتيازات.
رسم بياني متعدد المتجهات للهجوم مع كابلات توصيل بيضاء مضيئة آلية، وتسلسل هرمي من اليسار إلى اليمين (وحدة تحكم المجال ← النتائج ← المضيفون)، وفحص آمن للبيانات الوصفية في الوقت الفعلي.
#ffffff) تربط وحدات تحكم المجال والنتائج الأمنية والمضيفين المكتشفين دون سحب يدوي.DC01) على اليسار، عبر النتائج الأمنية النشطة، إلى المضيفين الأعضاء المستهدفين.توليد فوري للمخرجات ينتج تقارير امتثال جاهزة للتدقيق ذات علامة تجارية عبر تنسيقات مؤسسية متعددة (PDF تنفيذي، Markdown تقني، CSV للعيوب).
محرك التقارير ومكتبة القطع الأثرية يدعم التصدير متعدد التنسيقات مع إدارة دورة حياة متزامنة في الوقت الفعلي.
<label> مستمرة (Target Campaign، Export Format) وتغذية راجعة نظيفة لأخطاء التحقق المضمّنة.محرك ذاتي موجّه بالأهداف يخطط ويرتب أولويات وينفّذ سلاسل هجوم معقدة مع احترام حدود OPSEC.
وحدة تحكم الاستراتيجية الذاتية لتخطيط الحملات القائم على الأهداف وحوكمة الاحتواء التكيفي.
GET /api/tags) مع مهل دون الثانية وتخزين مؤقت TTL، مقترنة بالتحقق الديناميكي من مفاتيح السحابة من جانب الخادم (Claude، OpenAI).Target Campaign، Strategic Objective، AI Planning Engine، Explicit Authorizations)، وأوصاف أهداف مقروءة للبشر، وإلغاء كامل لتسريب متغيرات بيئة الخادم في تسميات واجهة المستخدم.قياس كيانات Active Directory المتعمق، وفحص العلاقات، وتدقيق التفاصيل الآمن في الوقت الفعلي مباشرة داخل اللوحة.
درج تفاصيل آمن تفاعلي يعرض قياس وحدة تحكم المجال (DC01 10.10.10.2)، ومستويات الاختراق النشطة، ومنافذ سطح الهجوم المفتوحة (53، 88، 135، 139، 389، 445، 636، 3268، 3389)، وحالات ملكية الأصول.
is_dc) عند تحديد أي عقدة في الرسم البياني.53، Kerberos 88، RPC 135، NetBIOS 139، LDAP 389، SMB 445، LDAPS 636، Global Catalog 3268، RDP 3389).سلاسل قتل حتمية متعددة الخطوات تنسّق الاستطلاع وحصاد بيانات الاعتماد والحركة الجانبية بالتسلسل.
سلاسل تنفيذ آلية تشمل سلسلة تعرّض AD Kerberos وسلسلة تعداد نطاق AD.
asreproast -> kerberoast -> hashcat)، وتعداد النطاق، وتصعيد الامتيازات السحابية.تتبع تجريبي لفعالية التجنّب عبر منصات الكشف والاستجابة لنقاط النهاية (EDR) المؤسسية.
قاعدة معارف التخطي تتبع معدلات نجاح التقنيات عبر CrowdStrike Falcon و SentinelOne و Microsoft Defender.
تحكم موثّق في الوصول متعدد الأدوار، ودورة حياة مفاتيح API التشفيرية، والتحقق المستمر من سلامة المنصة.
إدارة ملف تعريف المشغّل، وتوفير مفاتيح API محددة النطاق، وتدقيقات أمن النظام الآلية.
Team Lead، Operator، Recon، Reporter) تحكم تنفيذ الوحدات وعرض الأدلة.ناقل أحداث WebSocket عالي التردد يبث القياس العملياتي ومخرجات الوحدات وحالة خط الأنابيب.
وحدة تحكم أحداث عملياتية مباشرة مع قياس مخزّن مؤقتًا وبث WebSocket عالي الإنتاجية.
معماريات مشاركة موحّدة لتمارين الفريق الأحمر المتكررة، وتدقيقات الامتثال، وتدريبات الفريق البنفسجي.
قوالب مشاركة مدمجة تشمل اختبار الاختراق الداخلي، والاختراق الكامل لـ AD، وتقييم السحابة، والاختراق المفترض.
سطح REST API تفاعلي وموثّق بالكامل للأدوات المخصصة، وتنسيق SOC، وتكامل خط أنابيب CI/CD.
توثيق Swagger UI التفاعلي الذي يعرض أكثر من 70 نقطة نهاية عملياتية للأتمتة المؤسسية.
| :--- | :--- | :--- | :--- |
| نظرة عامة | الصحة التنفيذية، عدادات القياس عن بُعد، مقاييس خطورة النتائج. | لوحة واحدة | جميع أصحاب المصلحة |
| الحملات | القائمة البيضاء للنطاق، ملفات تعريف الضوضاء، خزنة بيانات الاعتماد المشفرة. | List، Scope، Findings | قائد الفريق، المشغل |
| الوحدات | كتالوج يضم أكثر من 60 وحدة، نماذج إدخال المعاملات، وحدة تحكم التنفيذ. | Catalog، Run Panel، Results | المشغل |
| التقارير | منشئ المخرجات، حزم الأدلة، دورة حياة مكتبة التقارير. | Generate، Library | المشغل، معدّ التقارير |
| الرسم البياني | استكشاف كيانات DAG، أقصر مسارات الهجوم، استيعاب BloodHound. | Entities، Attack Paths، Ingest | المشغل، الاستطلاع |
| القوالب | كتب لعب المهام القابلة للتكرار وخطط سير العمل متعددة المراحل. | Templates، | قائد الفريق، المشغل |
| | محرك مستقل موجه نحو الأهداف، تكامل مخطط الذكاء الاصطناعي. | ، ، | قائد الفريق، المشغل |
| | بيانات اعتماد المشغل، دورة حياة مفاتيح API، فحوصات تدقيق التبعيات. | ، ، | قائد الفريق |
| | القياس الدفاعي عن بُعد، تتبع التجاوز، قواعد التهرب من الكشف. | ، | المشغل |
| | تدفقات أحداث WebSocket في الوقت الفعلي وسجلات القياس عن بُعد المخزنة مؤقتًا. | ، | المشغل |
يتبع ARES بنية دفاع في العمق صارمة تفصل بين العرض، وتنسيق التنفيذ، وحوكمة الأمان، والتخزين التشفيري الدائم:```mermaid
flowchart TB
subgraph Client["Presentation Layer (Operator Enclave)"]
UI["React 19 Dashboard
(Vite + TypeScript)"]
Mesh["Dynamic Architectural Grid
(Canvas 2D Engine)"]
WSClient["WebSocket Client
(Real-Time Telemetry Stream)"]
end
subgraph Gateway["Zero-Trust Security Gateway"]
FastAPI["FastAPI Async Engine<br>(Uvicorn Backend)"]
AuthGuard["Auth & Session Guard<br>(Memory-Only JWT + HttpOnly Refresh)"]
CSRF["HMAC Double-Submit CSRF<br>(X-ARES-CSRF Validation)"]
RateLimit["Rate Limiting & Brute-Force Shield"]
end
subgraph Core["ARES Core Engine & Governance"]
ScopeFirewall["Scope Egress Firewall<br>(Strict CIDR & IP Whitelist)"]
Governor["OPSEC Noise Governor<br>(Adaptive Jitter & Throttling)"]
Orchestrator["Module Execution Orchestrator<br>(Worker Thread Pool)"]
AutoPlanner["Autonomous Strategy Engine<br>(DAG Heuristics / AI Planner)"]
end
subgraph Storage["Cryptographic Persistence Layer"]
DB[(SQLite / PostgreSQL<br>Alembic Versioned)]
Vault[(AES-256-GCM Vault<br>Encrypted Credentials & Hashes)]
GraphEngine["Attack Graph DAG Engine<br>(BloodHound Ingest & Shortest Path)"]
end
subgraph Deliverables["Reporting Pipeline"]
PDFGen["Headless Chromium / Edge Engine<br>(Automated PDF Generation)"]
Artifacts["Evidence Library<br>(HTML, Markdown, JSON)"]
end
UI -->|HTTPS / REST| AuthGuard
WSClient -->|WSS / Ticket Barrier| AuthGuard
AuthGuard --> CSRF --> RateLimit --> FastAPI
FastAPI --> ScopeFirewall
ScopeFirewall --> Orchestrator
Orchestrator --> Governor
Orchestrator --> AutoPlanner
Orchestrator --> Storage
Storage --> GraphEngine
FastAPI --> Deliverables
---
## ⚔️ تقنيات الخصوم ومصفوفة MITRE ATT&CK
يطبّق ARES أكثر من 60 تقنية معيارية للخصوم مرتبطة أصلاً بإطار MITRE ATT&CK Enterprise:```
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ MITRE ATT&CK MATRIX COVERAGE │
├─────────────────────┬─────────────────────┬─────────────────────┬─────────────────────┬──────────────────────────┤
│ DISCOVERY │ CREDENTIAL ACCESS │ LATERAL MOVEMENT │ PRIVILEGE ESCALATION│ DEFENSE EVASION / CLOUD │
├─────────────────────┼─────────────────────┼─────────────────────┼─────────────────────┼──────────────────────────┤
│ • T1087 User Enum │ • T1558.003 Kerberoast│ • T1021.002 SMB/RPC │ • T1548.002 UAC Byps│ • T1070 Indicator Removal│
│ • T1069 Group Enum │ • T1558.004 AS-REP │ • T1021.006 WinRM │ • T1068 Token Privs │ • T1562 Impair Defenses │
│ • T1046 Port/Net │ • T1003 LSASS Dump │ • T1550 Use Ticket │ • T1053 Scheduled │ • T1078 Cloud IAM Enum │
│ • T1018 Host Disc │ • T1649 ADCS ESC1-8 │ • T1071 App Layer │ • T1055 Injection │ • T1580 Cloud Discovery │
│ • T1082 System Info │ • T1110 Pass Spray │ • T1021.001 RDP │ • T1134 Access Token│ • T1526 Cloud Hierarchy │
└─────────────────────┴─────────────────────┴─────────────────────┴─────────────────────┴──────────────────────────┘
ad.kerberoast)، وAS-REP Roasting، وإساءة استخدام قوالب شهادات ADCS (ESC1 حتى ESC8)، وتكرار حسابات DCSync، وتوليد بيانات BloodHound.git clone https://github.com/Mafifrizi/ARES.git Set-Location .\ARES
py -3.12 -m venv .venv ..venv\Scripts\python.exe -m pip install -U pip ..venv\Scripts\python.exe -m pip install -e ".[dev,pdf]"
Set-Location frontend & "C:\Program Files\nodejs\npm.cmd" ci Set-Location ..
$env:ARES_PDF_BROWSER = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" ..venv\Scripts\ares.exe doctor --pdf-smoke
..venv\Scripts\ares.exe dashboard dev --no-reload
افتح متصفحك على **`http://127.0.0.1:5173/dashboard/`**.
- **المشغّل الأولي**: `admin`
- **كلمة المرور الأولية**: تُضبط عبر `ARES_DEFAULT_ADMIN_PASSWORD` في `.env` (الافتراضي: `Admin123456!`)
---
## 🔐 نموذج الأمان المؤسسي والامتثال
صُمّم ARES للبيئات ذات متطلبات الامتثال والسرية الأكثر صرامة:
### المصادقة متعددة الطبقات (Defense-in-Depth)
- **رموز وصول في الذاكرة فقط**: رموز JWT قصيرة العمر (15 دقيقة) توجد حصريًا داخل حالة React في الذاكرة ولا تُكتب أبدًا في `localStorage` أو `sessionStorage`.
- **عائلة تحديث دوّارة**: بيانات اعتماد التحديث طويلة العمر مرتبطة بكوكيز صارمة، للمضيف فقط، من نوع HttpOnly (`ares_refresh`) مع تدوير لمرة واحدة وإلغاء تلقائي عند إعادة الاستخدام.
- **حاجز HMAC CSRF**: نقاط النهاية التي تغيّر الحالة تفرض رؤوس `X-ARES-CSRF` صالحة مطابقة لرموز كوكيز آمنة تشفيريًا.
### التحكم في الوصول القائم على الأدوار (RBAC)
يفرض ARES أذونات RBAC صارمة عبر جميع نقاط نهاية API والمهام الخلفية وواجهات المستخدم:
| الدور | قيمة API | النطاق التشغيلي | الصلاحية الإدارية |
| :--- | :---: | :--- | :--- |
| **قائد الفريق** | `team_lead` | صلاحية كاملة على المنصة: إنشاء/حذف الحملات، تزويد المستخدمين، التدقيق الأمني، تجاوز الوحدات عالية الضجيج. | مسؤول نظام كامل |
| **المشغّل** | `operator` | العمليات اليومية: تنفيذ الوحدات المصرّح بها، مراجعة النتائج، استكشاف مخطط الهجوم، إنشاء التقارير. لا يمكنه تسجيل المستخدمين. | الطبقة التشغيلية |
| **الاستطلاع** | `recon` | استطلاع قائم على القراءة: تنفيذ وحدات الاستكشاف الآمن وبصمة الشبكة. يُحظر تنفيذ الوحدات التخريبية. | قراءة مكثفة |
| **المُبلّغ** | `reporter` | مراجعة أصحاب المصلحة: وصول للقراءة فقط إلى تحليلات الحملات والنتائج ومخططات الهجوم والمخرجات المُنشأة. لا حقوق تنفيذ. | تدقيق للقراءة فقط |
#### ضمانات تزويد الأدوار ومنع تصعيد الصلاحيات
- **هوية قاعدة البيانات المرجعية**: على عكس الأنظمة التي تثق عمياء بمزاعم أدوار JWT من جانب العميل، يحلّ ARES هوية المستخدم ودوره مباشرة من قاعدة البيانات الحية في كل طلب (`row = await db.resolve_access_token_principal(...)`). تُهمَل مزاعم JWT المُتلاعب بها رياضيًا.
- **بوابة أدوار صارمة عند إنشاء الحساب**: تُعيَّن أدوار المستخدمين الجدد حصريًا بواسطة `team_lead` عبر `POST /auth/register` (المحمي بـ `require_team_lead()`) أو تُربط تلقائيًا من مزوّدي الهوية المؤسسيين أثناء SSO من نوع SAML/OIDC الذي يبدأه مزوّد الخدمة.
- **ثبات الأدوار**: تعيينات الأدوار غير قابلة للتغيير بعد الإنشاء. لا توجد نقطة نهاية عامة لتعديل أدوار المستخدمين (`PUT /users/{id}` غير موجود)، مما يلغي نواقل تصعيد الصلاحيات الأفقية والعمودية (مثل ترقية `recon` إلى `team_lead` أو تشغيل `reporter` لوحدات هجومية).
- **جرد مستخدمين مُدقَّق**: توفّر وحدة تحكم `Security` في لوحة المعلومات جردًا شفافًا لجميع الهويات المسجّلة والجلسات النشطة لمساءلة المشاركة.
---
## 🔌 بوابة ARES MCP وواجهة سطر أوامر بمستوى المنتج
يوفّر ARES بوابة **Model Context Protocol (MCP)** بمستوى إنتاجي تُمكّن مساعدي البرمجة بالذكاء الاصطناعي الحديثين (Cursor IDE، Claude Desktop، Windsurf، VS Code Cline، Zed، Open-WebUI، LibreChat) من التفاعل مع منصة ARES الهجومية للفريق البنفسجي بأمان وتحت حوكمة صارمة.
<div align="center">
*مراقب طرفية ARES MCP ثنائي الجزئين (بنمط OpenClaw) مع قياس أدوات في الوقت الفعلي، وفحص نطاق حي، وتفويض رمز بمفتاح واحد.*
</div>
على عكس خوادم MCP الأساسية التي تعرّض نقاط نهاية خام لنماذج اللغة الكبيرة دون حواجز، يفرض ARES **ثبات النطاق قبل التنفيذ (`ScopeGuard`)**، و**عزل التلوث المضاد لحقن الأوامر**، و**رموز تأكيد HMAC أحادية الاستخدام لمدة 60 ثانية** قبل تنفيذ أي إجراء هجومي حي.
### 🚀 من أين أبدأ أولًا؟ (الإعداد خطوة بخطوة)
للمشغّلين أو المطوّرين الذين يربطون Cursor أو Claude Desktop أو Windsurf بـ ARES:
1. **التحقق من جاهزية النظام الفرعي (`doctor`)**:
تأكد من أن جميع الأنظمة الفرعية الأساسية (محرك البروتوكول، 9 أدوات، 3 موارد، 3 أوامر توجيهية، 62 وحدة، بوابات الأمان) تُبلّغ عن `PASS`: ```powershell
.\mcp.bat doctor
إعداد عميل الذكاء الاصطناعي بنقرة واحدة (بدون تحرير JSON يدويًا): قم بتهيئة IDE المفضل لديك تلقائيًا بأمر واحد: ```powershell
.\mcp.bat setup --client cursor
.\mcp.bat setup --client claude
.\mcp.bat setup --client windsurf
.\mcp.bat setup --client cline
هذا يكتب مسار بيئة Python الافتراضية النشطة الخاصة بك مباشرةً في ملف إعدادات العميل (على سبيل المثال .cursor/mcp.json).
أعد تحميل النافذة في Cursor IDE:
Ctrl + Shift + P.Developer: Reload Window.Ctrl + ,) → Features → MCP Servers. سيعرض خادم ares نقطة خضراء (Connected).شغّل المراقب المباشر ذا الجزأين (نافذة مرافقة اختيارية): في نافذة طرفية مخصصة، شغّل المراقب ذا الجزأين بأسلوب OpenClaw لمراقبة استدعاءات أدوات الذكاء الاصطناعي في الوقت الفعلي، وفحوصات النطاق، والموافقة على الرموز: ```powershell .\mcp.bat monitor
ares_scope_check، ares_dry_run_module، ares_run_tool).
A للموافقة على رمز تنفيذ معلق، R للرفض، C لمسح البث، Q للخروج.Ctrl + I أو Ctrl + L)، وجرّب هذا الطلب:
"تحقق من حالة الحملة النشطة، وتحقق من النطاق للهدف 10.0.1.50، وجهّز تشغيلاً تجريبياً للوحدة ad_kerberoast."
للاطلاع على البنية المعمارية المتعمقة، والثوابت الأمنية السبعة، وقابلية البرمجة النصية عبر CLI (--json)، ورموز الخروج POSIX، ومخططات الأدوات التشغيلية، راجع ARES MCP Gateway & Product-Grade CLI Specification.
يوفر ARES حزمة تطوير برامج Python آمنة النوع من الدرجة الأولى (ares.sdk) لبناء وحدات خصوم مخصصة، ومحاكاة التقنيات في بيئات اختبار معزولة، وأتمتة المهام برمجياً:
BaseModule[P, R] العام و @ares_module)أعلن عن مخططات معاملات مُتحقق منها باستخدام Pydantic v2 واكتب الوحدات مع إكمال تلقائي كامل في IDE:```python from ares.sdk import ( BaseModule, ExecutionContext, ModuleResult, ModuleParams, param, SecretParam, OpsecLevel, Severity, ares_module, )
class KerberoastParams(ModuleParams): dc: str = param("Target Domain Controller IP or FQDN", min_length=3) domain: str = param("AD DNS domain name, e.g. CORP.LOCAL", min_length=3) password: SecretParam = param("Domain user password", secret=True, required=False)
class CustomKerberoastModule(BaseModule[KerberoastParams, ModuleResult]): MODULE_ID = "custom.ad.kerberoast" MODULE_NAME = "Custom Kerberoasting" MODULE_CATEGORY = "ad" OPSEC_LEVEL = OpsecLevel.LOW MITRE_TECHNIQUES = ["T1558.003"] PARAMS_MODEL = KerberoastParams
async def execute(self, ctx: ExecutionContext[KerberoastParams]) -> ModuleResult:
# ctx.params provides full static typing and runtime validation
await self.before_request(ctx.params.dc)
# Emit findings using fluent context helpers
finding = ctx.emit_finding(
title=f"Kerberoastable SPN Captured on {ctx.params.dc}",
severity=Severity.HIGH,
mitre_technique="T1558.003",
)
return ModuleResult(status="success", findings=[finding], module_id=self.MODULE_ID)
### 2. الاختبار المعزول والمحاكاة (`ModuleTestHarness`)
اختبر التقنيات المخصصة محليًا باستخدام حراس نطاق وهميين، وخزائن بيانات اعتماد اصطناعية، ومطابقات تأكيد سلسة:```python
from ares.sdk import ModuleTestHarness, Severity
async def test_module():
harness = ModuleTestHarness(CustomKerberoastModule)
result = await harness.simulate(params={"dc": "10.0.0.10", "domain": "LAB.LOCAL"})
result.assert_success()
result.assert_finding(severity=Severity.HIGH, mitre="T1558.003")
AresClient)أتمت المهام، وأرسل الوحدات، وبث القياسات عن بُعد عبر WebSocket في الوقت الفعلي باستخدام نصوص Python أو خطوط أنابيب CI/CD:```python from ares.sdk import AresClient
async with AresClient(base_url="http://127.0.0.1:8000", api_key="ares_key_...") as ares: campaign = await ares.campaigns.create(name="Op-Titan", scope=["10.0.0.0/24"]) job = await ares.modules.run("ad.kerberoast", target="dc01.corp.local", campaign_id=campaign["id"]) findings = await ares.campaigns.findings(campaign["id"])
راجع [docs/module_sdk.md](https://github.com/mafifrizi/ares/blob/main/docs/module_sdk.md) و[docs/module-development.md](https://github.com/mafifrizi/ares/blob/main/docs/module-development.md) للحصول على وثائق المطورين الكاملة ومواصفات البنية والأمثلة.
---
## 📚 خريطة موقع الوثائق
تتوفر وثائق شاملة في دليل [`docs/`](https://github.com/mafifrizi/ares/blob/main/docs):
- [**بوابة الوثائق وفهرس الأنظمة الفرعية**](https://github.com/mafifrizi/ares/blob/main/docs/README.md)
- [**دليل البدء السريع للانخراط**](https://github.com/mafifrizi/ares/blob/main/QUICKSTART.md)
- [**مواصفات SDK للوحدات من الجيل التالي (v2)**](https://github.com/mafifrizi/ares/blob/main/docs/module_sdk.md)
- [**مواصفات خادم ARES MCP وواجهة سطر الأوامر بمستوى المنتج**](https://github.com/mafifrizi/ares/blob/main/docs/mcp-server.md)
- [**دليل تطوير الوحدات خطوة بخطوة**](https://github.com/mafifrizi/ares/blob/main/docs/module-development.md)
- [**دليل لوحة التحكم سطحًا بسطح**](https://github.com/mafifrizi/ares/blob/main/docs/dashboard-guide.md)
- [**كتالوج وحدات الخصم والمخططات**](https://github.com/mafifrizi/ares/blob/main/docs/modules.md)
- [**مرجع نقاط نهاية API والحمولات**](https://github.com/mafifrizi/ares/blob/main/docs/api-reference.md)
- [**دليل تكامل SSO للمؤسسات (SAML 2.0 / OIDC)**](https://github.com/mafifrizi/ares/blob/main/docs/sso-setup.md)
- [**أمن المؤسسات ونموذج التهديد**](https://github.com/mafifrizi/ares/blob/main/docs/security-model.md)
- [**مختبر التحقق وأداة الاختبار**](https://github.com/mafifrizi/ares/blob/main/docs/validation-lab.md)
---
## ⚖️ الاستخدام المسؤول وإخلاء المسؤولية القانونية
> [!IMPORTANT]
> **ARES هو إطار برمجي مزدوج الاستخدام مصمم حصريًا لأبحاث الأمن السيبراني المصرح بها، والتحقق الداخلي من مرونة المؤسسات، ومهام الفريق الأحمر المهنية بإذن كتابي صريح.**
- **لا تقم** بتشغيل ARES ضد أي شبكة أو مضيف أو بنية تحتية سحابية دون إذن كتابي مسبق من مالكي النظام.
- الوصول غير المصرح به إلى الأنظمة أو اختبارها ينتهك التشريعات الوطنية والدولية لمكافحة الجرائم الإلكترونية (مثل قانون الاحتيال وإساءة استخدام الحاسوب 18 U.S.C. § 1030).
- لا يتحمل منشئو ARES والقائمون على صيانته أي مسؤولية عن سوء الاستخدام أو الأضرار أو الانتهاكات التنظيمية الناجمة عن هذا البرنامج.
للإبلاغ عن ثغرات أمنية في ARES، يرجى اتباع [سياسة الأمان](https://github.com/mafifrizi/ares/blob/main/SECURITY.md) الخاصة بنا.
---
## 📄 الترخيص
يُوزَّع ARES بموجب **[ترخيص MIT](https://github.com/mafifrizi/ares/blob/main/LICENSE)** مفتوح المصدر.
<br>
<div align="center">
**ARES — نظام انخراط الفريق الأحمر المستقل بمستوى المؤسسات.**
*التحقق الأمني المستمر. مخاطر جانبية صفرية.*
</div>
Plan BuilderObjectiveActiveResultAccountAPI KeysAuditKnowledge BaseReport OutcomeStreamBuffer