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

تخزين بيانات اعتماد للمُجمِّع

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

بيانات الاعتماد هي حساب الدخول للقراءة فقط الذي يستخدمه المُجمِّع للوصول إلى نظام ما: حساب دخول SQL، أو حساب Windows، أو مفتاح SSH، أو كيان خدمة (service principal) في Azure. تخزّنها مرة واحدة على كيان، ويمكن لكل مورد في ذلك الكيان وما تحته استخدامها. يوضح هذا الدليل كيفية إضافة بيانات اعتماد، وأي نوع تختار، وخيارات الاتصال لكل نوع، وكيف يجد المورد بيانات الاعتماد التي يستخدمها.

قبل البدء​

  • تحتاج إلى دور Entity admin على الكيان الذي سيملك بيانات الاعتماد.
  • حساب الدخول موجود على النظام المراقَب بأذونات القراءة فقط. بالنسبة إلى SQL Server، راجع المتطلبات الأساسية لمجموعات التوفر؛ ولكل منصة، راجع الأذونات.
  • خزّن بيانات الاعتماد في أعلى موضع في شجرة الكيانات تكون صالحة فيه. فحساب دخول SQL المستخدم على كل خادم لدى شركة خان الخليلي مكانه شركة خان الخليلي، وليس كل بيئة.

اختيار النوع​

النوعالمستخدمالسريُستخدم لـ
SQL login (sql_login)SQL loginPasswordمثيلات SQL Server ومجموعات التوفر؛ وتستخدم قواعد البيانات والخوادم المرتبطة المكتشفة فيها بيانات اعتماد المثيل. وكذلك سجل التنفيذ في Reporting Services
Windows account (windows)Account (DOMAIN\user)Passwordمضيفات Windows عبر WinRM؛ وخوادم التقارير ونقاط نهاية الويب التي تستخدم مصادقة Windows (NTLM)
HTTP user and password (http_basic)UserPasswordنقاط نهاية الويب وخوادم التقارير التي تستخدم المصادقة الأساسية (Basic)؛ وفحوص Wazuh
Bearer token (token)—Tokenنقاط نهاية الويب التي تستخدم مصادقة الحامل (bearer)
SSH key (ssh_key)UserPrivate keyمضيفات Linux
SSH password (ssh_password)UserPasswordمضيفات Linux
Azure service principal (azure_sp)Client idClient secretفحوص الوضع الأمني في Azure وفحوص الهوية في Entra ID، لمستأجر لا تستطيع الهوية المُدارة للخادم الوصول إليه

مصادقة Windows المتكاملة مع SQL Server غير مدعومة: فالمُجمِّع يعمل في حاوية Linux دون تذكرة Kerberos. استخدم حساب دخول SQL، وهو يتطلب أن يقبل المثيل مصادقة SQL Server (الوضع المختلط).

إضافة بيانات اعتماد​

  1. افتح Settings › Credentials واختر الكيان في أداة اختيار الكيان، مثل شركة خان الخليلي.
  2. حدد Add credential.
  3. أدخل Name تتعرف عليه، مثل sql-monitoring، واختر Kind. ولا يمكن تغيير النوع لاحقًا.
  4. تحقق من Entity: يمكن للموارد في هذا الكيان وما تحته استخدام بيانات الاعتماد.
  5. أدخل المستخدم والسر. تتبع التسميات النوع، مثل SQL login وPassword، أو Client id وClient secret.
  6. ضمن Connection options، اضبط ما يحتاج إليه النوع. راجع القسم التالي.
  7. حدد Create.

تظهر بيانات الاعتماد في القائمة مع وسم السر بالقيمة stored، وعدد الموارد التي تستخدمها، ووقت آخر استخدام لها.

خيارات الاتصال​

النوعالخيارالقيمالتأثير
SQL loginencryptyes (الافتراضي)، no، strictيشفّر الاتصال. يستخدم strict بروتوكول TDS 8 ويتطلب SQL Server 2022 أو أحدث
SQL logintrust_server_certificatetrue (الافتراضي)، falseتستخدم معظم المثيلات شهادات موقّعة ذاتيًا. اضبطه على false بعد أن يحصل المثيل على شهادة يثق بها المُجمِّع
SQL loginhost_name_in_certificateاسم مضيفالاسم الذي يُتحقق منه عندما يختلف عن المضيف، مثلًا عبر وحدة استماع أو اسم مستعار
SQL loginapplication_intentReadOnly (الافتراضي)، ReadWriteلا يغيّر ReadWrite سوى التوجيه، حتى تشمل الفحوص لكل قاعدة بيانات قواعد بيانات التوفر الموجودة على نسخة أساسية ترفض اتصالات نية القراءة (read-intent). ولا يزال حساب الدخول بلا أي إذن كتابة
Windows accountauthkerberos (الافتراضي)، negotiate، ntlmكيفية مصادقة WinRM. لا تحتوي صورة المُجمِّع على إعدادات Kerberos، لذا اختر negotiate أو ntlm
SSH key، SSH passwordknown_hostsأسطر known_hosts الخاصة بـ OpenSSH، على أن يكون لكل مدخل سطر مستقليثبّت مفاتيح المضيف التي يقبلها المُجمِّع
Azure service principaltenant_idمعرّف مستأجر Entraمستأجر تسجيل التطبيق

تُضبط بعض الخيارات عبر API فقط، في attributes الخاصة ببيانات الاعتماد:

النوعالخيارالتأثير
Azure service principalsubscriptionsيقصر فحوص الوضع الأمني في Azure على هذه الاشتراكات. وبدونه يُطبَّق AZURE_SUBSCRIPTION_IDS، وإلا فكل اشتراك تستطيع الهوية قراءته
HTTP user and passwordverify_tlsيقبل false شهادة غير موثوقة على Wazuh indexer وWazuh manager. والافتراضي true

لا تحمل أسماء الخيارات أسرارًا أبدًا: فترفض واجهة API أي خيار يحتوي اسمه على pass أو secret أو token أو private أو pwd. ضع الأسرار في حقل السر.

كيف يُحمى السر​

  • السر للكتابة فقط. يُشفَّر بمفتاح بيانات التثبيت (EXCUBIUS_DATA_KEY) ولا يُعرض مرة أخرى، لا في أي شاشة ولا عبر API، التي تذكر فقط ما إذا كان هناك سر مخزن.
  • لتغييره، حرّر بيانات الاعتماد وأدخل سرًا جديدًا. اترك الحقل فارغًا للاحتفاظ بالسر المخزن، أو حدد Remove the stored secret لمسحه.
  • يتلقى المُجمِّع السر عبر الشبكة الداخلية، ويحتفظ به في الذاكرة فقط، ولا يسجّله في السجلات أبدًا.
  • احتفظ بـ EXCUBIUS_DATA_KEY مع النسخة الاحتياطية من ملف .env. وبدونه لا يمكن فك تشفير الأسرار المخزنة، وتفشل الفحوص بنوع الخطأ config إلى أن تدخلها مرة أخرى.

أي بيانات اعتماد يستخدمها المورد​

يبحث المورد عن بيانات اعتماد بهذا الترتيب ويأخذ أولها الذي يناسب نوعه الفحص:

  1. بيانات الاعتماد الخاصة بالفحص نفسه، إن وُجدت.
  2. بيانات اعتماد المورد.
  3. بيانات اعتماد أقرب مورد أصل. تستخدم مجموعة التوفر أو قاعدة البيانات المكتشفة تحت مثيل حساب دخول SQL الخاص بالمثيل.

مثلًا، فحص سجل التنفيذ لخادم تقارير هو فحص T-SQL. وعندما يحمل مورد خادم التقارير حساب Windows لبوابته، يستخدم الفحص حساب دخول SQL الخاص بالمثيل الذي فوقه، أو حساب دخول SQL تضبطه على ذلك الفحص وحده.

لضبط بيانات اعتماد على فحص واحد، استخدم API: PATCH /api/v1/resources/{id}/checks/{check_id} مع credential_id. ويتطلب توجيه مورد أو فحص إلى بيانات اعتماد دور Entity admin على الكيان الذي يملك بيانات الاعتماد.

تحرير بيانات اعتماد أو حذفها​

  • يغيّر Edit الاسم والمستخدم والسر والخيارات. ويبقى النوع كما هو.
  • لا يعمل Delete إلا عندما لا يستخدم أي شيء بيانات الاعتماد. غيّر الموارد والفحوص التي تستخدمها أولًا.
  • ويؤدي حذف كيان إلى حذف بيانات الاعتماد التي يملكها أيضًا.

تعرض القائمة، لكل بيانات اعتماد، عدد الموارد والفحوص التي تستخدمها ووقت آخر استخدام لها من فحص ناجح.