تكوين المثيل
يأتي كل تثبيت من Excubius بجميع الإمكانات. ويحدد Settings › Instance أيًّا منها يعرضه التثبيت، وبأي اسم وشعار وسمة. وتسري التغييرات على الجميع دفعة واحدة وتُكتب في سجل التدقيق. يوضح هذا الدليل كيفية تشغيل الميزات وتطبيق إعداد مسبق وضبط العلامة التجارية.
قبل البدء
- تحتاج إلى دور Super admin. ولا تُعرض الشاشة لأي شخص آخر.
- تحتاج بعض الميزات أيضًا إلى إعداد على الخادم، مثل الرمز المميز لـ Slack أو بيانات اعتماد Jira. يؤدي تشغيل ميزة إلى إظهارها؛ ولا يؤدي إلى إعدادها.
فتح الشاشة
- حدد Settings، ثم Instance.
- ابحث عن الأقسام Presets وFeatures وBranding الموضحة أدناه. وفي أسفل الشاشة، تخبرك الشاشة هل الميزات الموقوفة مخفية فقط أم ترفضها واجهة API أيضًا، ومتى أُجري آخر تغيير.
للأسماء وTLS الخاصة بالخادم شاشة مستقلة، يظهر رابطها في أعلى الشاشة باسم Server names and HTTPS. راجع إعداد الأسماء وTLS.
البدء من إعداد مسبق
الإعداد المسبق نقطة بداية مسمّاة: مجموعة من مفاتيح الميزات إضافةً إلى العلامة التجارية. ويُعرض كل منها على شكل بطاقة مع وصفه. والإعدادات المسبقة العامة الغرض هي:
| الإعداد المسبق | المحتوى |
|---|---|
enterprise | كل شيء مشغّل؛ وهو الافتراضي للتثبيت الجديد |
databases | البنية التحتية والتنبيهات وصفحة الحالة ووحدات قواعد البيانات |
core | البنية التحتية والتنبيهات وصفحة الحالة |
يؤدي تحديد بطاقة إعداد مسبق إلى تطبيقه فورًا. فهو يستبدل جميع مفاتيح الميزات والعلامة التجارية بما في الإعداد المسبق. دوّن علامتك التجارية قبل أن تطبّق أحدها، واضبط المفاتيح المفردة بعد ذلك.
حتى في enterprise، يظل مصدرا Defender for Cloud وWazuh متوقفين إلى أن تشغّلهما.
تشغيل ميزة أو إيقافها
- ضمن Features، ابحث عن الميزة في مجموعتها: Sources أو Monitoring أو Security أو Collaboration أو Access أو Interface. يعرض كل سطر مفتاح الميزة، وما تفعله، والميزة التي تتطلبها إن وُجدت.
- استخدم مفتاحها.
يسري التغيير فورًا.
- تظهر الميزة التي تتطلب ميزة أخرى باللون الرمادي ما دامت الأخرى موقوفة. ويؤدي إيقاف متطلَّب إلى إيقاف الميزات التابعة له أيضًا؛ فمثلًا يؤدي إيقاف
securityإلى إيقافsecurity.defenderوsecurity.wazuhأيضًا. - يؤدي إيقاف ميزة تملك وحدات كتالوج إلى إزالة تلك الوحدات من قائمة الكتالوج.
- الإخفاء شكلي افتراضيًا: يخضع التنقل والشاشات وعناصر الواجهة للمفاتيح، بينما يستمر جمع البيانات وتخزينها وعمل واجهة API. وعندما تعيد تشغيل ميزة يكون سجلها موجودًا. ولجعل واجهة API ترفض الميزات الموقوفة أيضًا، اضبط
EXCUBIUS_FEATURES_ENFORCE_API=trueفي إعدادات الخادم؛ وعندئذٍ ترد نقاط نهايتها بالرمز404. - تُفرض بعض المفاتيح في جميع الأحوال. فعند إيقاف
access.google_login، يُرفض تسجيل الدخول عبر Google.
الميزات التي تشير إليها أدلة أخرى:
| الميزة | ما تتحكم فيه |
|---|---|
monitoring.databases | وحدات SQL Server (بما فيها مجموعات التوفر) وAzure SQL وManaged Instance وPostgreSQL |
monitoring.updates | صفحة Updates & advisories وفحوصها |
security | صفحة Security posture والاكتشافات ودرجة الأمان |
security.defender، security.wazuh | جمع البيانات من Microsoft Defender for Cloud ومن Wazuh. موقوفان افتراضيًا |
security.recommendations | تعرض توصيات Defender for Cloud بجوار الاكتشافات |
collab.jira | Create Jira ticket على التنبيهات والاكتشافات؛ وتتطلب collab.assign |
access.google_login | تسجيل الدخول عبر Google |
access.directory_groups | أدوار مجموعات Microsoft Entra ID |
ui.public_status_page | صفحات الحالة العامة |
ui.i18n | اللغات غير الإنجليزية، في وحدة التحكم وفي رسائل Slack |
ui.themes | السمات اللونية الإضافية إلى جانب الفاتحة والداكنة |
ضبط العلامة التجارية
-
ضمن Branding، املأ الحقول:
الحقل التأثير Product name عنوان المتصفح، والترويسة، وصفحة تسجيل الدخول، واسم التطبيق المثبَّت، وبادئة قضايا Jira وتسميتها. حتى 60 حرفًا Tagline يُعرض بجوار الاسم على الشاشات العريضة وفي وصف التطبيق المثبَّت. حتى 120 حرفًا Logo None، أو Built-in mark، أو Image URL: عنوان httpsأو مسار على هذا الخادم يبدأ بـ/Default theme سمة صفحة تسجيل الدخول والمستخدمين الجدد. ولا يزال بإمكان الناس اختيار سماتهم الخاصة Show "powered by" line سطر اعتماد في التذييل، يظهر مع العلامة المضمّنة فقط -
حدد Save.
عندما يكون Logo مضبوطًا على None، تُستخدم أيقونة محايدة في كل مكان، بما في ذلك تبويب المتصفح والتطبيق المثبَّت، فلا يذكر شيء في المتصفح اسم المنتج. ولا تذكر رسائل Slack وصفحات الحالة العامة اسم المنتج أبدًا، أيًّا كانت العلامة التجارية.
السمات هي Midnight وDaylight وSlate and amber وOps room (high contrast) وOkabe–Ito (colour-blind safe) وPaper. وعند إيقاف ui.themes، يقدّم التثبيت السمتين الفاتحة والداكنة فقط.
يمكن أن يكون لفرع العميل سمته وشعاره الافتراضيان الخاصان به؛ راجع ضبط مظهر الفرع.
التنفيذ عبر API
يتطلب كل طلب دور Super admin ويخضع للتدقيق.
| المهمة | الطلب |
|---|---|
| قراءة الإعدادات الكاملة والإعدادات المسبقة وسجل الميزات | GET /api/v1/instance/admin |
| تطبيق إعداد مسبق | POST /api/v1/instance/preset مع {"name": "databases"} |
| تشغيل الميزات أو إيقافها | PATCH /api/v1/instance/features مع {"changes": {"collab.jira": false}} |
| تغيير العلامة التجارية | PATCH /api/v1/instance/branding مع أي من product_name وtagline وlogo وshow_powered_by وtheme_default |
لا يتطلب GET /api/v1/instance تسجيل دخول: فهو يعيد العلامة التجارية والمفاتيح كما يراها المتصل، وهذا ما تقرؤه وحدة التحكم عند تحميلها.