跳至主要内容
版本: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 讀取的內容​

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 中。