تخزين بيانات اعتماد للمُجمِّع
بيانات الاعتماد هي حساب الدخول للقراءة فقط الذي يستخدمه المُجمِّع للوصول إلى نظام ما: حساب دخول SQL، أو حساب Windows، أو مفتاح SSH، أو كيان خدمة (service principal) في Azure. تخزّنها مرة واحدة على كيان، ويمكن لكل مورد في ذلك الكيان وما تحته استخدامها. يوضح هذا الدليل كيفية إضافة بيانات اعتماد، وأي نوع تختار، وخيارات الاتصال لكل نوع، وكيف يجد المورد بيانات الاعتماد التي يستخدمها.
قبل البدء
- تحتاج إلى دور Entity admin على الكيان الذي سيملك بيانات الاعتماد.
- حساب الدخول موجود على النظام المراقَب بأذونات القراءة فقط. بالنسبة إلى SQL Server، راجع المتطلبات الأساسية لمجموعات التوفر؛ ولكل منصة، راجع الأذونات.
- خزّن بيانات الاعتماد في أعلى موضع في شجرة الكيانات تكون صالحة فيه. فحساب دخول SQL المستخدم على كل خادم لدى شركة خان الخليلي مكانه شركة خان الخليلي، وليس كل بيئة.
اختيار النوع
| النوع | المستخدم | السر | يُستخدم لـ |
|---|---|---|---|
SQL login (sql_login) | SQL login | Password | مثيلات SQL Server ومجموعات التوفر؛ وتستخدم قواعد البيانات والخوادم المرتبطة المكتشفة فيها بيانات اعتماد المثيل. وكذلك سجل التنفيذ في Reporting Services |
Windows account (windows) | Account (DOMAIN\user) | Password | مضيفات Windows عبر WinRM؛ وخوادم التقارير ونقاط نهاية الويب التي تستخدم مصادقة Windows (NTLM) |
HTTP user and password (http_basic) | User | Password | نقاط نهاية الويب وخوادم التقارير التي تستخدم المصادقة الأساسية (Basic)؛ وفحوص Wazuh |
Bearer token (token) | — | Token | نقاط نهاية الويب التي تستخدم مصادقة الحامل (bearer) |
SSH key (ssh_key) | User | Private key | مضيفات Linux |
SSH password (ssh_password) | User | Password | مضيفات Linux |
Azure service principal (azure_sp) | Client id | Client secret | فحوص الوضع الأمني في Azure وفحوص الهوية في Entra ID، لمستأجر لا تستطيع الهوية المُدارة للخادم الوصول إليه |
مصادقة Windows المتكاملة مع SQL Server غير مدعومة: فالمُجمِّع يعمل في حاوية Linux دون تذكرة Kerberos. استخدم حساب دخول SQL، وهو يتطلب أن يقبل المثيل مصادقة SQL Server (الوضع المختلط).
إضافة بيانات اعتماد
- افتح Settings › Credentials واختر الكيان في أداة اختيار الكيان، مثل شركة خان الخليلي.
- حدد Add credential.
- أدخل Name تتعرف عليه، مثل
sql-monitoring، واختر Kind. ولا يمكن تغيير النوع لاحقًا. - تحقق من Entity: يمكن للموارد في هذا الكيان وما تحته استخدام بيانات الاعتماد.
- أدخل المستخدم والسر. تتبع التسميات النوع، مثل SQL login وPassword، أو Client id وClient secret.
- ضمن Connection options، اضبط ما يحتاج إليه النوع. راجع القسم التالي.
- حدد Create.
تظهر بيانات الاعتماد في القائمة مع وسم السر بالقيمة stored، وعدد الموارد التي تستخدمها، ووقت آخر استخدام لها.
خيارات الاتصال
| النوع | الخيار | القيم | التأثير |
|---|---|---|---|
| SQL login | encrypt | yes (الافتراضي)، no، strict | يشفّر الاتصال. يستخدم strict بروتوكول TDS 8 ويتطلب SQL Server 2022 أو أحدث |
| SQL login | trust_server_certificate | true (الافتراضي)، false | تستخدم معظم المثيلات شهادات موقّعة ذاتيًا. اضبطه على false بعد أن يحصل المثيل على شهادة يثق بها المُجمِّع |
| SQL login | host_name_in_certificate | اسم مضيف | الاسم الذي يُتحقق منه عندما يختلف عن المضيف، مثلًا عبر وحدة استماع أو اسم مستعار |
| SQL login | application_intent | ReadOnly (الافتراضي)، ReadWrite | لا يغيّر ReadWrite سوى التوجيه، حتى تشمل الفحوص لكل قاعدة بيانات قواعد بيانات التوفر الموجودة على نسخة أساسية ترفض اتصالات نية القراءة (read-intent). ولا يزال حساب الدخول بلا أي إذن كتابة |
| Windows account | auth | kerberos (الافتراضي)، negotiate، ntlm | كيفية مصادقة WinRM. لا تحتوي صورة المُجمِّع على إعدادات Kerberos، لذا اختر negotiate أو ntlm |
| SSH key، SSH password | known_hosts | أسطر known_hosts الخاصة بـ OpenSSH، على أن يكون لكل مدخل سطر مستقل | يثبّت مفاتيح المضيف التي يقبلها المُجمِّع |
| Azure service principal | tenant_id | معرّف مستأجر Entra | مستأجر تسجيل التطبيق |
تُضبط بعض الخيارات عبر API فقط، في attributes الخاصة ببيانات الاعتماد:
| النوع | الخيار | التأثير |
|---|---|---|
| Azure service principal | subscriptions | يقصر فحوص الوضع الأمني في Azure على هذه الاشتراكات. وبدونه يُطبَّق AZURE_SUBSCRIPTION_IDS، وإلا فكل اشتراك تستطيع الهوية قراءته |
| HTTP user and password | verify_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إلى أن تدخلها مرة أخرى.
أي بيانات اعتماد يستخدمها المورد
يبحث المورد عن بيانات اعتماد بهذا الترتيب ويأخذ أولها الذي يناسب نوعه الفحص:
- بيانات الاعتماد الخاصة بالفحص نفسه، إن وُجدت.
- بيانات اعتماد المورد.
- بيانات اعتماد أقرب مورد أصل. تستخدم مجموعة التوفر أو قاعدة البيانات المكتشفة تحت مثيل حساب دخول SQL الخاص بالمثيل.
مثلًا، فحص سجل التنفيذ لخادم تقارير هو فحص T-SQL. وعندما يحمل مورد خادم التقارير حساب Windows لبوابته، يستخدم الفحص حساب دخول SQL الخاص بالمثيل الذي فوقه، أو حساب دخول SQL تضبطه على ذلك الفحص وحده.
لضبط بيانات اعتماد على فحص واحد، استخدم API: PATCH /api/v1/resources/{id}/checks/{check_id} مع credential_id. ويتطلب توجيه مورد أو فحص إلى بيانات اعتماد دور Entity admin على الكيان الذي يملك بيانات الاعتماد.
تحرير بيانات اعتماد أو حذفها
- يغيّر Edit الاسم والمستخدم والسر والخيارات. ويبقى النوع كما هو.
- لا يعمل Delete إلا عندما لا يستخدم أي شيء بيانات الاعتماد. غيّر الموارد والفحوص التي تستخدمها أولًا.
- ويؤدي حذف كيان إلى حذف بيانات الاعتماد التي يملكها أيضًا.
تعرض القائمة، لكل بيانات اعتماد، عدد الموارد والفحوص التي تستخدمها ووقت آخر استخدام لها من فحص ناجح.
المحتوى ذو الصلة
- كيف يعمل المُجمِّع
- إضافة مورد، حيث يثبت Test connection أن بيانات الاعتماد تعمل
- أخطاء المُجمِّع
- الأذونات