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

ربط NinjaOne

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

اربط NinjaOne لجلب أجهزة Windows وLinux وmacOS الخاصة بمؤسساتك إلى Excubius، مع آخر اتصال لها وتصحيحاتها المعلّقة وتنبيهات NinjaOne نفسها. يوضح هذا الدليل عميل API بأقل الامتيازات على جانب NinjaOne، وكيفية إضافة المصدر، وكيفية استقبال التنبيهات عبر webhook.

قبل البدء​

  • تحتاج إلى دور Entity admin على الكيان الذي تنتمي إليه الأجهزة.
  • في NinjaOne، تستطيع إضافة تطبيق عميل API ضمن Administration › Apps › API.
  • الميزة sources.ninjaone مشغّلة. راجع المصادر.

ما الذي يقرؤه Excubius​

تُقرأ NinjaOne عبر واجهة API العامة الإصدار 2، بطلبات GET فقط، إضافةً إلى طلب رمز OAuth المميز.

المرحلةما الذي يُقرأالفاصل الافتراضي
Inventoryالأجهزة التفصيلية وأسماء المؤسسات. تصبح أجهزة Windows وLinux وmacOS مضيفات مع نظام التشغيل وآخر اتصال وعلامة عدم الاتصال ومؤسستها بوصفها العلامة client. أما فئات العقد الأخرى، مثل أجهزة الشبكة ومراقبات السحابة وأجهزة hypervisor، فتُحصى وتُتخطى15 دقيقة
Metricsالدقائق منذ آخر اتصال (تحذير بعد 15، وحرج بعد 60)، وما لم توقفه، تصحيحات نظام التشغيل والبرامج المعلّقة التي تمت الموافقة عليها ولم تُثبَّت15 دقيقة
Alertsالتنبيهات النشطة، تنبيه واحد لكل منها، مع شرط NinjaOne بوصفه القاعدة5 دقائق في Polling؛ ومصالحة كل 15 دقيقة في Hybrid

تجهيز NinjaOne​

  1. افتح Administration › Apps › API › Client App IDs وحدد Add.
  2. اختر منصة التطبيق API Services (machine-to-machine)، والنطاق Monitoring فقط، ونوع المنح (grant type) Client Credentials.
  3. احفظ، ثم انسخ معرّف العميل (client ID) وسر العميل (client secret).
  4. دوّن منطقة مثيلك: app.ninjarmm.com (الولايات المتحدة)، أو eu. أو oc. أو ca.ninjarmm.com.
تحذير

امنح العميل النطاق Monitoring فقط. فالنطاقان Management وControl يستطيعان تغيير الأجهزة وتشغيل البرامج النصية، ولا يحتاج Excubius إليهما أبدًا.

إضافة المصدر​

  1. افتح Settings › Sources وحدد Add a source واختر NinjaOne.
  2. ضمن General، أدخل Name واختر Entity.
  3. ضمن Connection، اختر Region وأدخل Client ID وClient secret.
  4. اختياريًا، أدرج Organizations المراد قراءتها، على هيئة معرّفات مؤسسات مفصولة بفواصل. واتركه فارغًا لقراءة كل مؤسسة يستطيع العميل رؤيتها.
  5. أبقِ Pending patches لجلب تصحيحات نظام التشغيل والبرامج المعتمدة التي لم تُثبَّت بعد.
  6. ضمن Ingest mode، اختر Hybrid (recommended)، أو Polling عندما لا تستطيع NinjaOne الوصول إلى خادم Excubius.
  7. اختياريًا، ضمن Webhook، أدخل Webhook secret.
  8. حدد Create source وانسخ عنوان webhook URL. يُعرض مرة واحدة فقط.

استقبال التنبيهات عبر webhook​

ترسل NinjaOne webhooks إلى عنوان URL مسجَّل عبر واجهة API الخاصة بها (PUT /v2/webhook). ويفعل مسؤول ذلك مرة واحدة، بتطبيق API مسموح له بإدارة NinjaOne، وليس أبدًا بالعميل للقراءة فقط الذي منحته لـ Excubius.

  • سجّل العنوان الذي عرضه Excubius.
  • إذا ضبطت webhook secret، فأضف الترويسة X-Custom-Webhook-Secret: <secret>. تقبل NinjaOne الترويسات Authorization وx-custom-*.

تفتح أنشطة الشرط TRIGGERED وRESET التنبيهات وتغلقها في Excubius على التوالي؛ أما الأنشطة الأخرى فتُتجاهل.

الاختبار والمزامنة​

  1. في صفحة المصدر، حدد Test. تُدرج كل قراءة مع نتيجتها: بيانات الاعتماد والمؤسسات والأجهزة والتنبيهات والتصحيحات.
  2. حدد Sync now لجلب الأجهزة والمقاييس والتنبيهات دون انتظار.

تظهر الأجهزة مضيفات Windows وLinux وmacOS، تتم مطابقتها مع الخوادم نفسها من المصادر الأخرى وتُوسم بمؤسستها. وتظهر عليها فحوص NinjaOne وفحص التصحيحات المعلّقة، وتظهر تنبيهات NinjaOne في Alert inbox.