連接 NinjaOne
連接 NinjaOne,即可把你的機構中的 Windows、Linux 和 macOS 裝置,連同其上次聯絡時間、待處理的修補程式和 NinjaOne 自己的警報帶入 Excubius。本指南說明 NinjaOne 端的最低權限 API 用戶端、如何新增數據源,以及如何透過 Webhook 接收警報。
開始之前
- 你需要在裝置所屬的實體上擁有 Entity admin(實體管理員)角色。
- 在 NinjaOne 中,你可以在 Administration › Apps › API 下新增 API 用戶端應用程式。
- 功能
sources.ninjaone已開啟。請參閱數據源。
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 中。