连接 NinjaOne
连接 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
- 打开 Administration › Apps › API › Client App IDs 并选择 Add。
- 选择应用程序平台 API Services (machine-to-machine),仅选择范围 Monitoring,授权类型选择 Client Credentials。
- 保存,然后复制客户端 ID 和客户端密码。
- 记下实例所在的区域:
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,以逗号分隔的组织 ID 形式输入。留空则读取客户端可以看到的每个组织。
- 保留 Pending patches,以引入已批准但尚未安装的操作系统和软件修补程序。
- 在 Ingest mode 下,选择 Hybrid (recommended);如果 NinjaOne 无法访问 Excubius 服务器,则选择 Polling。
- 也可以在 Webhook 下输入 Webhook secret。
- 选择 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 中打开和关闭警报;其他活动会被忽略。
测试和同步
- 在数据源页面上,选择 Test。每次读取都会连同其结果一起列出:凭据、组织、设备、警报和修补程序。
- 选择 Sync now,立即引入设备、指标和警报,而不必等待。
设备显示为 Windows、Linux 和 macOS 主机,与来自其他数据源的相同服务器匹配,并带有所属组织的标记。NinjaOne 检查和待安装修补程序检查会出现在这些主机上,NinjaOne 警报会出现在 Alert inbox 中。