انتقل إلى المحتوى الرئيسي

دليل البدء السريع

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

إذا لم تكن متأكدًا من نقطة البداية بحسب دورك، ابدأ بقراءة مسارات التعلم.

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

قبل البدء تأكد من توفر ما يلي:

  • Podman 5.0+ وpodman-compose (sudo dnf install -y podman podman-compose على Fedora).
  • Python 3.12+.
  • Node.js 22+ وnpm للوحة التحكم.
  • Git.
  • ما لا يقل عن 16 GB RAM، ويفضل 32 GB إذا كنت تريد تشغيل أسطول الوكلاء كاملًا.
  • وجود GPU اختياري، لكنه مفيد لتسريع استدلال LLM.
الحد الأدنى مقابل الوضع الكامل

يمكن تشغيل AuroraSOC بطريقتين أساسيتين:

  • Demo Mode: API + Dashboard فقط، من دون وكلاء، وباستخدام بيانات تجريبية في الذاكرة. يكفيه 4 GB RAM تقريبًا.
  • Full Mode: بنية تحتية كاملة + أسطول الوكلاء. يحتاج عادة إلى 16-32 GB RAM، وGPU يظل مستحسنًا.

يبقى rust-core اختياريًا في الحالتين، ويشغّل فقط عبر --profile rust-core.

اختر المسار المناسب​

استخدم هذا المسار إذا كنت تريد تقييم الواجهة وسير العمل بسرعة.

  • شغّل البنية التحتية من docker-compose.dev.yml.
  • شغّل API ولوحة التحكم محليًا.
  • سجّل الدخول واستعرض التنبيهات والحالات والوكلاء باستخدام البيانات المضمنة.
  • أجّل تشغيل الوكلاء المتخصصين إلى أن تحتاجهم فعليًا.
قبل أن تبدأ

في أول تشغيل، اجعل لديك نافذة طرفية لسجلات البنية التحتية ونافذة أخرى لسجلات API. ذلك يسهل استكشاف المشكلات بسرعة.

الخطوة 1: استنساخ المستودع​

git clone https://github.com/ahmeddwalid/AuroraSOC
cd AuroraSOC

الخطوة 2: تشغيل خدمات البنية التحتية​

ابدأ خدمات التطوير التي يستخدمها المسار الافتراضي لـ Python API:

# Development infrastructure (lightweight)
podman compose -f docker-compose.dev.yml up -d

# Verify the dev dependencies are healthy
podman compose -f docker-compose.dev.yml ps

هذا يشغل:

الخدمةالمنفذالغرض
PostgreSQL 165432قاعدة البيانات الأساسية
Redis 76379cache + event streams
NATS 2.104222الفيدرالية بين المواقع
Mosquitto1883/8883MQTT لأجهزة IoT/CPS

هذه الحزمة الخفيفة لا تشغّل أسطول الوكلاء، ولا vLLM، ولا خدمات observability، ولا ملف rust-core الاختياري.

إذا احتجت لاحقًا إلى المسار السريع لـ Rust، فعّله من ملف Compose الرئيسي:

podman compose --profile rust-core up -d

الخطوة 3: تثبيت تبعيات Python​

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

الخطوة 4: تشغيل الترحيلات​

alembic upgrade head

ينشئ ذلك جداول قاعدة البيانات الأساسية مثل alerts وcases وcps_devices وiocs وreports وغيرها.

الخطوة 5: تشغيل خادم API​

uvicorn aurorasoc.api.main:app --host 0.0.0.0 --port 8000 --reload

يبدأ الـ API ببيانات تجريبية شاملة حتى بدون تغذية حقيقية مسبقة، ومنها:

  • 30 تنبيهًا أمنيًا موزعة على مستويات الخطورة المختلفة.
  • 15 حالة تحقيق في مراحل متعددة.
  • 13 جهاز CPS/IoT مع حالة اعتماد.
  • سجل كامل للوكلاء، من orchestrator إلى المتخصصين.
  • سجلات SIEM وبيانات EDR وplaybooks وIOCs جاهزة للتجربة.

يمكنك فتح http://localhost:8000/docs لرؤية Swagger UI.

الخطوة 6: تشغيل لوحة التحكم​

في نافذة طرفية جديدة:

cd dashboard
npm install
npm run dev

افتح http://localhost:3000 وسجّل الدخول بالقيم التالية:

الحقلالقيمة
اسم المستخدمadmin
كلمة المرورadmin
بيانات اعتماد التطوير

في وضع التطوير يستخدم AuroraSOC مخزن مستخدمين داخل الذاكرة مع حسابات جاهزة. راجع المصادقة إذا كنت تريد إعداد الإنتاج.

خطوة اختيارية: وضع التشغيل​

يدعم AuroraSOC ثلاثة أوضاع تشغيل خلفية:

  • dummy لسلوك تجريبي اصطناعي بلا تغييرات فعلية.
  • dry_run للقراءة والتحليل من دون تغييرات في الحالة.
  • real للتشغيل الكامل مع السماح بالتغييرات.

يمكن تغيير الوضع من Settings داخل لوحة التحكم، أو عبر API.

راجع أوضاع التشغيل لمعرفة الفرق الدقيق بينها.

الخطوة 7: تشغيل الوكلاء اختياريًا​

إذا أردت تحقيقات فعلية مدعومة بالذكاء الاصطناعي فستحتاج إلى واجهة LLM خلفية:

ollama pull granite4:8b

python -m aurorasoc.tools.registry.server &
python -m aurorasoc.agents.security_analyst.server &
python -m aurorasoc.agents.threat_hunter.server &
python -m aurorasoc.agents.orchestrator.server &

أوامر Makefile المفيدة​

make help          # Show all available commands
make install       # Install Python dependencies
make test          # Run test suite
make lint          # Run linter
make api           # Start the API server
make dashboard-dev # Start the dashboard
make docker-up     # Start default compose stack
make docker-down   # Stop compose stack
make migrate       # Run database migrations

ماذا بعد؟​

بعد تشغيل AuroraSOC يمكنك الانتقال إلى:

  1. نظرة عامة على لوحة التحكم
  2. إدارة التنبيهات
  3. مختبر عرض القدرات
  4. المفاهيم الأساسية
  5. نظرة عامة على المعمارية

قائمة تحقق سريعة​

  • تعمل وثائق API على http://localhost:8000/docs.
  • تفتح لوحة التحكم على http://localhost:3000.
  • ينجح تسجيل الدخول.
  • تحمل صفحة التنبيهات بيانات seeded أو live.
  • تعمل عملية إنشاء الحالة وتحديثها.
  • يستقبل WebSocket واحد على الأقل تحديثات.

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

فشل API بسبب أسرار مفقودة​

السبب المعتاد هو غياب متغيرات البيئة أو ضعف قيمها.

الإصلاح:

  1. تأكد من وجود ملف .env وتحميله.
  2. عيّن قيمًا قوية لـ JWT_SECRET_KEY وAPI_SERVICE_KEY.
  3. أعد تشغيل API.

لوحة التحكم تفتح لكنها لا تجلب البيانات​

السبب المعتاد هو أن الـ API غير قابل للوصول.

الإصلاح:

  1. تأكد من عمل API على http://localhost:8000.
  2. راقب طلبات المتصفح وابحث عن 401 أو 403 أو 503.
  3. تحقق من أن الرمز يصدر من /api/v1/auth/token.

خدمات الحاويات تعمل لكنها تبقى غير صحية​

الأسباب المعتادة هي تعارض المنافذ أو ضغط القرص أو بقايا قديمة.

الإصلاح:

  1. شغّل podman compose -f docker-compose.dev.yml ps وافحص الخدمات غير الصحية.
  2. راجع السجلات عبر podman compose -f docker-compose.dev.yml logs <service>.
  3. أوقف الخدمات المتعارضة أو غيّر المنافذ.

أسئلة شائعة​

هل أستطيع تشغيل AuroraSOC من دون GPU؟​

نعم. وجود GPU يسرع الاستدلال فقط، لكن Demo Mode والعديد من المسارات تعمل من دونه.

هل أستطيع تأجيل تشغيل الوكلاء؟​

نعم. يمكنك تقييم الواجهة وسير العمل أولًا ثم إضافة الوكلاء لاحقًا.

ما الصفحة المناسبة بعد ذلك لتعلم التشغيل اليومي؟​

راجع نظرة عامة على لوحة التحكم و SOAR Playbooks.