Подключение NinjaOne
Подключите 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 (оповещения) | Активные оповещения, по одному оповещению на каждое, где правилом служит условие NinjaOne | 5 минут в режиме Polling; сверка каждые 15 минут в режиме Hybrid |
Подготовка NinjaOne
- Откройте Administration › Apps › API › Client App IDs и выберите Add.
- Выберите платформу приложения API Services (machine-to-machine), только область Monitoring и тип предоставления Client Credentials.
- Сохраните, а затем скопируйте идентификатор клиента и секрет клиента.
- Запишите регион вашего экземпляра:
app.ninjarmm.com(США),eu.,oc.илиca.ninjarmm.com.
Дайте клиенту только область Monitoring. Области Management и Control позволяют изменять устройства и запускать скрипты, а Excubius они никогда не нужны.
Добавление источника
- Откройте Settings › Sources, выберите Add a source, а затем NinjaOne.
- В разделе General введите Name и выберите Entity.
- В разделе Connection выберите Region и введите Client ID и Client secret.
- При необходимости перечислите в поле Organizations организации для чтения в виде идентификаторов, разделенных запятыми. Оставьте поле пустым, чтобы читать все организации, которые видит клиент.
- Оставьте включенным Pending patches, чтобы получать утвержденные исправления операционной системы и программного обеспечения, которые еще не установлены.
- В разделе Ingest mode выберите Hybrid (recommended) или Polling, если NinjaOne не может обратиться к серверу Excubius.
- При необходимости в разделе Webhook введите Webhook secret.
- Выберите 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; остальные действия игнорируются.
Проверка и синхронизация
- На странице источника выберите Test. Каждая операция чтения перечислена со своим результатом: учетные данные, организации, устройства, оповещения и исправления.
- Выберите Sync now, чтобы сразу получить устройства, метрики и оповещения, не дожидаясь расписания.
Устройства отображаются как узлы Windows, Linux и macOS, сопоставляются с теми же серверами из других источников и помечаются тегом своей организации. У них появляются проверки NinjaOne и проверка ожидающих исправлений, а оповещения NinjaOne отображаются в Alert inbox.