Перейти к основному содержимому
Версия: 0.4 · текущая

Подключение NinjaOne

Практическое руководствоПроверено 11 октября 2026 г.
Область применения:Excubius 0.4Роли: Администратор сущности
ПланыFree · Core · Pro · EnterpriseРазвертываниеСамостоятельное размещение

Подключите NinjaOne, чтобы передавать в Excubius устройства Windows, Linux и macOS ваших организаций вместе со временем последнего контакта, ожидающими исправлениями и собственными оповещениями NinjaOne. В этом руководстве показаны клиент API с минимальными привилегиями на стороне NinjaOne, добавление источника и получение оповещений через веб-перехватчик.

Перед началом работы​

  • Вам нужна роль Entity admin (администратор сущности) в сущности, которой принадлежат устройства.
  • В NinjaOne вы можете добавить приложение клиента API в разделе Administration › Apps › API.
  • Функция sources.ninjaone включена. См. статью Источники.

Что считывает Excubius​

NinjaOne считывается через его общедоступный API v2 только запросами GET плюс запрос токена OAuth.

ЭтапЧтоИнтервал по умолчанию
Inventory (инвентаризация)Подробные сведения об устройствах и названия организаций. Устройства Windows, Linux и macOS становятся узлами с указанием операционной системы, последнего контакта, признака отсутствия в сети и организации в виде тега client. Другие классы узлов, например сетевые устройства, облачные мониторы и гипервизоры, подсчитываются и пропускаются15 минут
Metrics (метрики)Минуты с момента последнего контакта (предупреждение через 15, критическое состояние через 60) и, если вы не отключите, ожидающие исправления операционной системы и программного обеспечения, которые утверждены, но не установлены15 минут
Alerts (оповещения)Активные оповещения, по одному оповещению на каждое, где правилом служит условие NinjaOne5 минут в режиме Polling; сверка каждые 15 минут в режиме Hybrid

Подготовка NinjaOne​

  1. Откройте Administration › Apps › API › Client App IDs и выберите Add.
  2. Выберите платформу приложения API Services (machine-to-machine), только область Monitoring и тип предоставления Client Credentials.
  3. Сохраните, а затем скопируйте идентификатор клиента и секрет клиента.
  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 и скопируйте URL-адрес веб-перехватчика. Он отображается только один раз.

Получение оповещений через веб-перехватчик​

NinjaOne отправляет веб-перехватчики на URL-адрес, зарегистрированный через его API (PUT /v2/webhook). Администратор делает это один раз с помощью приложения API, которому разрешено управлять NinjaOne, и никогда — с помощью клиента только для чтения, который вы дали Excubius.

  • Зарегистрируйте URL-адрес, который показал Excubius.
  • Если вы задали секрет веб-перехватчика, добавьте заголовок X-Custom-Webhook-Secret: <secret>. NinjaOne принимает заголовки Authorization и x-custom-*.

Действия условия TRIGGERED и RESET открывают и закрывают оповещения в Excubius; остальные действия игнорируются.

Проверка и синхронизация​

  1. На странице источника выберите Test. Каждая операция чтения перечислена со своим результатом: учетные данные, организации, устройства, оповещения и исправления.
  2. Выберите Sync now, чтобы сразу получить устройства, метрики и оповещения, не дожидаясь расписания.

Устройства отображаются как узлы Windows, Linux и macOS, сопоставляются с теми же серверами из других источников и помечаются тегом своей организации. У них появляются проверки NinjaOne и проверка ожидающих исправлений, а оповещения NinjaOne отображаются в Alert inbox.