كيف يعمل المُجمِّع
المُجمِّع هو الجزء من Excubius الذي يصل إلى أنظمتك. يشغّل فحوص الكتالوج عبر اتصالات للقراءة فقط، ويقرأ المصادر التي تضيفها، ويرسل النتائج الخام إلى API، التي تقيّمها وترفع التنبيهات وترسل الإشعارات. تشرح هذه المقالة كيف يعمل، وأي وسائل نقل يستخدم، وما تحتاج إليه كل وحدة، وأي مسارات شبكة ينبغي فتحها، وما لا يفعله أبدًا.
كيف يعمل الفحص
- كل 30 ثانية يسأل المُجمِّع API عمّا يجب تشغيله: تعريفات الفحوص من الكتالوج، والموارد التي تستهدفها، وبيانات الاعتماد التي تستخدمها. وعندما لا يتغير شيء، يكون الرد فارغًا وبالكاد يكلّف شيئًا.
- يشغّل كل فحص وفق فاصله عبر وسيلة النقل التي يحددها الكتالوج، مثل T-SQL لمثيل SQL Server أو HTTP لنقطة نهاية ويب.
- يرسل النتائج الخام إلى API على دفعات. تقارنها API بالحدود الفعلية، وتفتح التنبيهات وتحلها، وتُشعر القنوات المناسبة.
- كل 10 ثوانٍ يلتقط المهام التي تُنفَّذ لمرة واحدة، مثل Test connection وDiscover وTest وSync now الخاصة بمصدر. وكل 60 ثانية يرسل إشارة نبض، تعرضها منطقة Sources في لوحة المعلومات Overview.
يعمل المُجمِّع داخل خادم Excubius، بجوار API. ولا يتلقى إلا الرمز المميز الخاص به وإعداداته؛ ولا يرى أبدًا كلمة مرور قاعدة البيانات ولا المفتاح الذي يشفّر الأسرار المخزنة. وتصل إليه بيانات الاعتماد عبر الشبكة الداخلية، وتبقى في الذاكرة، ولا تُسجَّل في السجلات أبدًا.
وسائل النقل
وسيلة النقل هي الطريقة التي يتحدث بها المُجمِّع مع نوع واحد من الأنظمة. وكل واحدة منها تقرأ فقط.
| وسيلة النقل | تصل إلى | المنفذ | نوع بيانات الاعتماد | الحالة |
|---|---|---|---|---|
| T-SQL (Microsoft ODBC Driver 18) | مثيلات SQL Server ومجموعات التوفر والخوادم المرتبطة وسجل التنفيذ في Reporting Services | 1433 أو منفذ المثيل؛ وUDP 1434 للمثيلات المسماة التي ليس لها منفذ ثابت | SQL login | مدعومة |
| HTTP(S) | نقاط نهاية الويب وبوابات Reporting Services وشهادات TLS وانتهاء صلاحية النطاق (RDAP) | 443، 80 | لا شيء، أو Windows account (NTLM)، أو HTTP user and password، أو Bearer token | مدعومة |
| DNS | تحليل أسماء نقاط النهاية ووحدات استماع مجموعات التوفر، باستخدام محلّل الخادم | 53 | لا شيء | مدعومة |
| Azure Resource Graph | فحوص الوضع في السحابة، وتقييمات Defender for Cloud، وAzure Update Manager، وService Health | 443 | الهوية المُدارة للخادم، أو Azure service principal | مدعومة |
| Microsoft Graph | فحوص الهوية في Entra ID | 443 | الهوية المُدارة للخادم، أو Azure service principal | مدعومة |
| Wazuh | Wazuh indexer، وواجهة API الخاصة بـ manager اختياريًا | عناوين URL التي تضبطها | HTTP user and password | مدعومة عند تشغيل Wazuh |
| WinRM | فحوص مضيفات Windows وفحوص Active Directory | 5986 (HTTPS) | Windows account | تجريبية |
| SSH | فحوص مضيفات Linux | 22، أو ssh_port الخاص بالمضيف | SSH key، SSH password | تجريبية |
| PostgreSQL | فحوص وحدة PostgreSQL | 5432 | SQL login | غير متاحة بعد: تُضاف الفحوص لكنها تبقى غير معروف |
وسيلتا النقل WinRM وSSH موجودتان وتُضاف فحوصهما إلى مضيفات Windows وLinux، لكنهما لم يُتحقق منهما بعد على مضيفات حقيقية. لهذه المضيفات، استخدم NinjaOne أو New Relic أو Azure Monitor كمصدر إلى أن يصنّفهما أحد الإصدارات على أنهما مدعومتان.
يقرأ المُجمِّع المصادر أيضًا، عبر HTTPS (المنفذ 443)، ولكل منها محوّله الخاص: New Relic عبر NerdGraph، وNinjaOne عبر واجهة API العامة الخاصة به، وAzure Monitor عبر Azure Resource Manager وResource Graph وAzure Monitor وData Factory وKey Vault وMicrosoft Graph. راجع المصادر.
يتيح المُجمِّع افتراضيًا كل وسيلة نقل تتوفر مكتباتها في صورته. ويضيّق EXCUBIUS_COLLECTOR_TRANSPORTS هذه القائمة؛ راجع متغيرات البيئة.
ما تحتاج إليه كل وحدة
| الوحدة | يُجمع عبر | ما تقدمه |
|---|---|---|
| SQL Server، مجموعات التوفر، أمان SQL Server | T-SQL | حساب دخول SQL للقراءة فقط على كل مثيل وكل نسخة متماثلة |
| Windows | WinRM (تجريبي)، أو New Relic وNinjaOne | حساب Windows في ثلاث مجموعات قراءة محلية، أو مصدر |
| Linux | SSH (تجريبي)، أو New Relic وNinjaOne | مستخدم غير root بمفتاح، أو مصدر |
| PostgreSQL | غير متاح بعد أصلًا؛ وخوادم Azure المرنة عبر Azure Monitor | دور يحمل pg_monitor، جاهزًا لحين توفر الجمع |
| Azure، Azure Data Factory | مصدر Azure Monitor | Reader وMonitoring Reader، إضافةً إلى دور Data Factory للقراءة فقط |
| الاختبارات الاصطناعية | HTTP وDNS وT-SQL | بيانات اعتماد لنقاط النهاية المحمية وخوادم التقارير فقط |
| انتهاء الصلاحية | Azure Monitor وHTTP (RDAP) وT-SQL وWinRM | أذونات قراءة Key Vault وMicrosoft Graph |
| التحديثات | خلاصات الموردين التي تقرؤها API، إضافةً إلى فحوص الجرد | اتصال HTTPS صادر من الخادم إلى الخلاصات |
| أمان الهوية | Microsoft Graph وWinRM | أذونات تطبيق Graph للقراءة فقط |
| أمان السحابة | Resource Graph وDefender for Cloud وWazuh | Reader وSecurity Reader؛ ومستخدم Wazuh للقراءة فقط |
| New Relic، NinjaOne | مصدرها الخاص | مفتاح أو عميل API للقراءة فقط |
كل الأذونات في مكان واحد: الأذونات.
مسارات الشبكة
يبدأ كل اتصال من خادم Excubius. ولا شيء يتصل بالمُجمِّع.
| إلى | المنفذ | الغرض |
|---|---|---|
| كل مثيل SQL Server وكل نسخة متماثلة واسم وحدة استماع وعنوان IP لوحدة استماع | منفذ SQL، وهو 1433 افتراضيًا | وحدات SQL Server ومجموعات التوفر واختبارات SQL الاصطناعية ذهابًا وإيابًا |
| المثيلات المسماة التي ليس لها منفذ ثابت | UDP 1434 | SQL Server Browser |
| نقاط نهاية الويب وبوابات Reporting Services | 443، 80 | الاختبارات الاصطناعية وشهادات TLS |
| محلّل DNS الخاص بالخادم | 53 | فحوص تحليل الأسماء |
data.iana.org وخوادم RDAP الخاصة بالسجلات | 443 | انتهاء صلاحية النطاق |
| مضيفات Windows | 5986 | WinRM (تجريبي) |
| مضيفات Linux | 22 | SSH (تجريبي) |
management.azure.com وgraph.microsoft.com وخزائن المفاتيح لديك (*.vault.azure.net)، وlogin.microsoftonline.com عند استخدام service principal | 443 | مصدر Azure Monitor وفحوص الوضع الأمني والهوية في Azure |
api.newrelic.com أو api.eu.newrelic.com | 443 | مصدر New Relic |
app.ninjarmm.com، أو eu. أو oc. أو ca.ninjarmm.com | 443 | مصدر NinjaOne |
| Wazuh indexer وmanager | منفذاهما | Wazuh |
تجلب API، وليس المُجمِّع، خلاصات التحديثات وتتحدث إلى Slack وJira؛ راجع متغيرات البيئة. وتصل webhooks من المصادر إلى العنوان العام للخادم على المنفذ 443 وتذهب إلى API، وليس إلى المُجمِّع أبدًا.
القيود والمهلات
| القيد | القيمة |
|---|---|
| الفحوص التي تعمل في وقت واحد | 32 في المجموع؛ لكل وسيلة نقل: T-SQL 8، وHTTP وDNS 16، وSSH 8، وWinRM 4، وResource Graph 4، وDefender وMicrosoft Graph وWazuh 2 |
| مهلة تسجيل الدخول إلى SQL Server · مهلة الاستعلام | 10 ث · 30 ث (معلمات الكتالوج timeout_seconds وquery_timeout_seconds) |
| الصفوف المقروءة لكل استعلام | 1,000 |
| أطول مدة يجوز أن يعمل فيها فحص واحد | 120 ث |
| النتائج المحفوظة أثناء تعذر الوصول إلى API | 10,000؛ وتُحذف الأقدم أولًا |
تحمل جلسات SQL Server اسم التطبيق monitoring-collector، حتى يتمكن مسؤولو قواعد البيانات من التعرف عليها في sys.dm_exec_sessions.
ما لا يفعله المُجمِّع أبدًا
المُجمِّع للقراءة فقط بحكم التهيئة وبحكم الشفرة. فهو لا يثبّت ولا يحدّث ولا يعيد تشغيل ولا يوقف أي شيء، ولا يكتب بيانات أو سجل النظام (registry) أو إعدادات، ولا ينهي أي جلسة، ولا ينفّذ أي معالجة تصحيحية. والفحص الذي يتطلب كتابة يُرفض عند مراجعته للإدراج في الكتالوج.
ما يرسله فعلًا:
- SQL Server: استعلامات
SELECTعلى طرق عرض الإدارة الديناميكية وطرق عرض الكتالوج وجداول النسخ الاحتياطي والمهام فيmsdbوExecutionLog3الخاص بخادم التقارير؛ وsys.sp_readerrorlogإلى متغير جدولي؛ وsp_testlinkedserverللخوادم المرتبطة. - HTTP:
GETوHEADفقط. - Azure وWazuh: عمليات قراءة، إضافةً إلى القليل من طلبات
POSTالتي هي استعلامات، مثل استعلام Resource Graph أو استعلام تشغيلات Data Factory أو_searchفي Wazuh. وأي شيء آخر يُرفض في الشفرة. - WinRM وSSH: أوامر PowerShell وshell المكتوبة في الكتالوج، وهي تقرأ فقط.
الاستعلام الدقيق لكل فحص موجود في الكتالوج وفي API على GET /api/v1/catalog/checks/{id}.
وكلاء المصادر الاختيارية
لا يثبّت Excubius أي شيء على الأنظمة التي يراقبها. أما وكلاء المصادر الاختيارية، مثل Wazuh، فتنشرهم أدواتك الخاصة، مثل NinjaOne أو أداة إدارة الإعدادات لديك.