跳到主要内容
版本:0.4 · 当前版

连接 NinjaOne

操作指南审阅日期:2026年10月11日
适用于:Excubius 0.4角色: 实体管理员
计划Free · Core · Pro · Enterprise部署自托管

连接 NinjaOne,即可将你的组织的 Windows、Linux 和 macOS 设备连同其上次联系时间、待安装的修补程序以及 NinjaOne 自己的警报一起引入 Excubius。本指南说明 NinjaOne 端的最小权限 API 客户端、如何添加数据源,以及如何通过 webhook 接收警报。

开始之前​

  • 你需要在设备所属的实体上拥有 Entity admin(实体管理员)角色。
  • 在 NinjaOne 中,你可以在 Administration › Apps › API 下添加 API 客户端应用。
  • 功能 sources.ninjaone 已打开。请参阅数据源。

Excubius 读取的内容​

Excubius 通过 NinjaOne 的公共 API v2 读取数据,只使用 GET 请求,外加获取 OAuth 令牌的请求。

阶段内容默认间隔
清单详细的设备和组织名称。Windows、Linux 和 macOS 设备成为主机,带有其操作系统、上次联系时间、脱机标志,以及作为标记 client 的所属组织。其他节点类别(例如网络设备、云监视器和虚拟机监控程序)只计数并跳过15 分钟
指标自上次联系以来的分钟数(15 分钟后警告,60 分钟后严重),以及(除非你将其关闭)已批准但未安装的待安装操作系统和软件修补程序15 分钟
警报活动警报,每个对应一个警报,并以 NinjaOne 条件作为规则Polling 模式下 5 分钟;Hybrid 模式下每 15 分钟核对一次

准备 NinjaOne​

  1. 打开 Administration › Apps › API › Client App IDs 并选择 Add。
  2. 选择应用程序平台 API Services (machine-to-machine),仅选择范围 Monitoring,授权类型选择 Client Credentials。
  3. 保存,然后复制客户端 ID 和客户端密码。
  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,以逗号分隔的组织 ID 形式输入。留空则读取客户端可以看到的每个组织。
  5. 保留 Pending patches,以引入已批准但尚未安装的操作系统和软件修补程序。
  6. 在 Ingest mode 下,选择 Hybrid (recommended);如果 NinjaOne 无法访问 Excubius 服务器,则选择 Polling。
  7. 也可以在 Webhook 下输入 Webhook secret。
  8. 选择 Create source 并复制 webhook URL。它只显示一次。

通过 webhook 接收警报​

NinjaOne 将 webhook 发送到通过其 API(PUT /v2/webhook)注册的 URL。这需要由管理员使用被允许管理 NinjaOne 的 API 应用执行一次,绝不能使用你提供给 Excubius 的只读客户端。

  • 注册 Excubius 显示的 URL。
  • 如果你设置了 webhook 机密,请添加标头 X-Custom-Webhook-Secret: <secret>。NinjaOne 接受 Authorization 和 x-custom-* 标头。

条件活动 TRIGGERED 和 RESET 会在 Excubius 中打开和关闭警报;其他活动会被忽略。

测试和同步​

  1. 在数据源页面上,选择 Test。每次读取都会连同其结果一起列出:凭据、组织、设备、警报和修补程序。
  2. 选择 Sync now,立即引入设备、指标和警报,而不必等待。

设备显示为 Windows、Linux 和 macOS 主机,与来自其他数据源的相同服务器匹配,并带有所属组织的标记。NinjaOne 检查和待安装修补程序检查会出现在这些主机上,NinjaOne 警报会出现在 Alert inbox 中。