إنتقل إلى المحتوى الرئيسي
الإصدار: 0.4 · الحالي

تفعيل وحدات الأمان

دليل إرشاديتمت المراجعة في 11 أكتوبر 2026
ينطبق على:Excubius 0.4الأدوار: المسؤول الأعلى, مسؤول الكيان, المحرر
الخططPro · Enterpriseالنشراستضافة ذاتية

تبحث وحدات الأمان عن نقاط الضعف في مثيلات SQL Server وهوياتك واشتراكات Azure، وتضيف اكتشافات من Microsoft Defender for Cloud وWazuh. يقتصر كل فحص على القراءة؛ ويأتي الاكتشاف مع أدلته وإجراء مقترح يتبعه شخص، ولا يتغير شيء من تلقاء نفسه أبدًا. يوضح هذا الدليل كيفية تفعيل الوحدات، ومنحها وصولًا للقراءة فقط، وتحديد أوزان الدرجة، وقبول مخاطرة.

الخطة

وحدات الأمان ودرجة الأمان جزء من خطة Enterprise، وإضافة اختيارية في خطة Pro.

قبل البدء​

  • لتفعيل الوحدات، تحتاج إلى دور Super admin (المسؤول الأعلى).
  • لإضافة الموارد وبيانات الاعتماد، ولضبط أوزان الدرجة، تحتاج إلى دور Entity admin على الكيان.
  • لقبول مخاطرة، تحتاج إلى دور Editor (المحرر) أو أعلى على كيان الاكتشاف.
  • اقرأ الوضع الأمني لمعرفة ما هو الاكتشاف، وكيف تُحسب الدرجة، وما الذي يكتشفه كل فحص.

تفعيل الوحدات​

  1. افتح Settings › Instance.

  2. ضمن Features، في المجموعة Security، فعّل ما تحتاج إليه:

    الميزةالتأثير
    securityصفحة Security posture، والاكتشافات والدرجة، مع وحدات قواعد البيانات والهوية والسحابة
    security.recommendationsتُعرض توصيات Defender for Cloud (التقييمات المتوسطة والمنخفضة)، وتُحتسب في الدرجة، وتُدرج في صندوق وارد التنبيهات. وعند تعطيلها لا تبقى سوى التقييمات عالية الخطورة، بوصفها اكتشافات
    security.defenderجمع تقييمات Defender for Cloud. معطّلة افتراضيًا
    security.wazuhجمع تنبيهات Wazuh ونقاط الضعف. معطّلة افتراضيًا
  3. فعّل اختياريًا collab.jira ليمكن إرسال الاكتشافات إلى Jira.

تتطلب المفاتيح الثلاثة الأخرى تفعيل security. ويؤدي تعطيل Defender أو Wazuh إلى إيقاف الجمع؛ وتبقى الاكتشافات التي ظهرت بالفعل مفتوحة إلى أن تُحل.

إضافة الفحوصات إلى الموارد الموجودة​

الموارد التي تضيفها من الآن فصاعدًا تحصل على فحوصات الأمان الخاصة بنوعها فورًا. أما الموارد التي كانت موجودة قبل تفعيل الوحدات فتحتاج إلى إضافة الفحوصات الناقصة مرة واحدة، عبر API:

curl -s "${H[@]}" -X POST "$BASE/resources/$SQL01/checks" -d '{"check_ids": []}' \
| jq -r '.[].check_id' | grep security

تضيف القائمة الفارغة كل فحص افتراضي ناقص لنوع المورد. وتحصل قواعد البيانات ومجموعات التوفر المكتشفة على فحوصاتها عند Discover التالي لمثيلها. وتُضبط $BASE وH كما في التشغيل السريع: إضافة مثيل SQL Server عبر API.

منح الوحدات وصولًا للقراءة فقط​

قواعد البيانات​

تستخدم فحوصات أمان SQL Server حساب دخول المراقبة الخاص بالمثيل. وهو يحتاج إلى VIEW SERVER STATE وVIEW ANY DEFINITION وCONNECT ANY DATABASE وSELECT على msdb.dbo.backupset، ولا شيء غير ذلك. راجع تخزين بيانات اعتماد للمُجمِّع.

الهوية​

  1. أضف موردًا من النوع Entra ID tenant / domain services مع tenant_id الخاص بالمستأجر، تحت الكيان الذي ينتمي إليه، مثل شركة خان الخليلي.
  2. امنحه صلاحية القراءة على Microsoft Graph، بإحدى طريقتين:
    • تسجيل تطبيق بأذونات التطبيق (application) التالية في Microsoft Graph: RoleManagement.Read.Directory وAuditLog.Read.All وIdentityRiskEvent.Read.All، وكلها للقراءة فقط، مع موافقة المسؤول. خزّنه بوصفه بيانات اعتماد من النوع Azure service principal: معرّف العميل وسر العميل وtenant_id. واختره بيانات اعتماد للمورد.
    • الأذونات نفسها تُمنح للهوية المُدارة لخادم Excubius.
  3. لفحوصات Active Directory، وفّر حساب نطاق للقراءة فقط (من النوع Windows account) على مضيف مثبّت عليه وحدة Active Directory لـ PowerShell، يُوصَل إليه عبر WinRM.

تتطلب تفاصيل التسجيل للمصادقة متعددة العوامل Microsoft Entra ID P1 أو P2؛ وتتطلب عمليات رصد المخاطر الكاملة P2.

السحابة​

تقرأ فحوصات Azure عبر Azure Resource Graph وDefender for Cloud، إما بالهوية المُدارة للخادم أو بتسجيل تطبيق مخزَّن بوصفه بيانات اعتماد Azure service principal:

  • Reader على كل اشتراك، لفحوصات Resource Graph.
  • Security Reader على كل اشتراك، لـ Defender for Cloud.

مع تسجيل التطبيق، تحدد السمة subscriptions في بيانات الاعتماد، وتُضبط عبر API، الاشتراكات التي تُقرأ؛ وإلا فيُطبَّق إعداد الخادم AZURE_SUBSCRIPTION_IDS. راجع طلب خادم Azure للاطلاع على الأدوار ومعرّفاتها.

تنظر فحوصات Resource Graph إلى resource_id الخاص بالمورد: مورد، أو مجموعة موارد، أو اشتراك كامل، مثل /subscriptions/<id>.

Defender for Cloud وWazuh​

تعمل تقييمات Defender for Cloud، والتغييرات في تعيينات أدوار Azure، واكتشافات Wazuh، وفحص صور المنصة نفسها، على مورد من النوع Monitoring platform itself. إن لم يكن لديك واحد بعد، فأضفه بـ Resources › Add resource، مثلًا تحت الكيان الجذر. وتُربط الاكتشافات بعد ذلك بالمورد الذي تخصه: اكتشافات Defender بمورد الجرد الذي يطابق resource_id الخاص به، واكتشافات Wazuh بالمضيف الذي تتطابق مع الوكيل فيه إحدى هذه القيم: الاسم أو اسم المضيف أو عنوان IP أو اسم الجهاز.

لـ Wazuh:

  1. أنشئ مستخدم Wazuh للقراءة فقط مع صلاحية القراءة على الفهرسين wazuh-alerts-* وwazuh-states-vulnerabilities-* واختياريًا agents:read على واجهة API الخاصة بالمدير (manager).

  2. خزّنه في Settings › Credentials من النوع HTTP user and password. وإذا كانت شهادة المفهرس (indexer) غير موثوقة لدى الخادم، فأنشئ بيانات الاعتماد عبر API بدلًا من ذلك، مع "attributes": {"verify_tls": false}؛ فلا يوجد حقل لذلك في وحدة التحكم.

  3. وجّه الفحص إلى مفهرس Wazuh لديك وامنحه بيانات الاعتماد، عبر API:

    curl -s "${H[@]}" -X PATCH "$BASE/resources/$PLATFORM/checks/security_cloud.wazuh_alerts" -d '{
    "params": {"indexer_url": "https://wazuh.areito.example:9200",
    "api_url": "https://wazuh.areito.example:55000"},
    "credential_id": "'"$WAZUH_CRED"'"
    }'

لا يرسل عميل Wazuh سوى عمليات البحث واستدعاء مصادقة المدير؛ وأي شيء آخر يُرفض في الشيفرة. ولا ينشر Excubius وكلاء Wazuh أبدًا؛ بل تنشرهم أدواتك أنت.

ضبط أوزان مجالات الدرجة​

تحسب الدرجة الإجمالية متوسط المجالات المقيَّمة، وهي identity وdatabase وcloud، بوزن 1 لكل منها افتراضيًا. ويستطيع الكيان ضبط أوزانه الخاصة، من 0 إلى 100، ويرثها كل كيان تحته. ولا توجد شاشة لذلك في هذا الإصدار؛ استخدم API:

# Ciguapa cares most about its databases
curl -s "${H[@]}" -X PUT "$BASE/entities/$CIGUAPA/security/score-weights" \
-d '{"identity": 1, "database": 3, "cloud": 1}'

# back to the inherited weights
curl -s "${H[@]}" -X PUT "$BASE/entities/$CIGUAPA/security/score-weights" -d '{}'

يعرض GET /entities/{id}/security/score-weights أوزان الكيان الخاصة والأوزان الفعلية.

قبول مخاطرة​

عندما يكون الاكتشاف معروفًا ومقبولًا لفترة، مثل تفعيل xp_cmdshell لمهمة قديمة إلى أن تُستبدل، فاقبل المخاطرة بدلًا من تركه مفتوحًا.

  1. افتح Security posture وحدد الاكتشاف.
  2. حدد Accept risk….
  3. اكتب Reason: لماذا المخاطرة مقبولة وما الذي يخفف منها، من 3 إلى 2,000 حرف.
  4. ضمن Accepted for، اختر عددًا من الأيام، أو Until a date. يجب أن يقع الانتهاء خلال سنة.
  5. حدد Accept risk.

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

لإنهاء القبول مبكرًا، افتح الاكتشاف وحدد Reopen.

بعض الاكتشافات تغييرات لا حالات، مثل عضو جديد في sysadmin أو تعيين جديد للدور Owner. ولا يمكن قبولها: راجع التغيير، ثم قم بحل الاكتشاف يدويًا.

نشر فحص لصور المنصة​

يبلغ الفحص security_cloud.platform_images عن نقاط الضعف الحرجة في صور الحاويات الخاصة بـ Excubius نفسه. أنشئ تقريرًا بالأمر trivy image --format json <image> وأرسله إلى POST /api/v1/security/platform-report؛ ويتطلب ذلك دور Super admin. ويُعتد بأحدث تقرير لكل صورة.