跳至主要内容
版本:0.4 · 現行版

安全模型

概念審閱日期:2026年10月11日
適用於:Excubius 0.4角色: 檢視者, 操作員, 編輯者, 實體管理員, 超級管理員
方案Free · Core · Pro · Enterprise部署自行託管

Excubius 不會為你的團隊另設密碼:用戶使用你的組織已經管理的 Microsoft 或 Google 帳戶登入。之後他們可以看到和執行的內容,取決於他們在實體樹每個分支上所擁有的角色,而且每個請求都會再次檢查。採集器所需的機密以加密方式儲存,永遠無法再次讀取。本文說明每一層的運作。

登入​

Excubius 透過授權碼流程配合 PKCE、state 及 nonce,使用 OpenID Connect 與 Microsoft Entra ID(單一租用戶)及 Google 整合。系統不使用任何供應商 SDK,也不涉及任何付費的身份識別服務。

  • 每次登入都會驗證 ID 令牌:包括根據供應商發佈的密鑰檢查簽章、簽發者(Entra ID 為你的租用戶)、對象、到期時間,以及該次登入的 nonce。
  • 進行中的登入會保存在已簽署的 HttpOnly Cookie 中,有效期 10 分鐘。登入後返回的頁面必須是同一網站的頁面,因此偽造的連結無法把任何人帶到其他地方。
  • 帳戶以供應商及主體作為識別,即用戶在 Entra ID 中的物件 ID 或 Google 的主體,而不是單靠電郵地址。
  • 誰可以取得帳戶按實體決定:憑邀請,或憑獲允許的電郵網域。只有當 Google 帳戶是該網域的 Google Workspace 帳戶時,才會算作屬於該網域;個人 Google 帳戶一律需要邀請。
  • 供應商機密只來自伺服器的設定。這些機密、授權碼及令牌,都不會儲存在數據庫中、由 API 傳回或寫入日誌。
供應商方案
GoogleFree、Core、Pro、Enterprise
Microsoft Entra IDCore、Pro、Enterprise
以 Microsoft Entra ID 群組作為角色持有者Enterprise

多重要素驗證​

MFA 由你的身份識別提供者強制執行:Entra ID 條件式存取或 Google 兩步驟驗證。Excubius 目前不會檢查 MFA 聲明,因此請在提供者端要求所有可登入的人使用 MFA,尤其是實體管理員。

工作階段及令牌​

登入成功後會設定兩個 Cookie,兩者都是 HttpOnly,在 HTTPS 下為 Secure,並設為 SameSite=Lax:

令牌有效期用途
存取令牌15 分鐘在每個請求中證明你的身份
重新整理令牌14 天取得新的一對令牌;每次重新整理都會簽發新的一對

權限不會包含在令牌內,而是在每個請求時從數據庫讀取,因此停用用戶、移除角色或更改群組指派,都會在對方下一個請求時生效。目錄群組的成員資格則在每次登入時重新讀取。

備註

目前尚無法逐一撤銷重新整理令牌。如要在工作階段到期前結束某人的存取權,請停用該用戶。登出 Excubius 不會同時登出 Microsoft 或 Google。

目前尚未提供 API 密鑰:在此版本中,指令碼及其他工具無法自行呼叫 API。

實體樹上的角色​

角色是在某個實體上授予個人或目錄群組的,並適用於該實體及其下的所有內容。同一個人可以在一個客戶擔任 Entity admin,在另一個客戶擔任 Operator。在任何實體上,有效角色是該實體及其上層實體中找到的最高角色,並同時計算此人自己的角色及其群組的角色。

角色權限
Viewer閱讀儀表板、警報、發現及資源詳細資料;更改自己的設定
Operator檢視者可以做的一切,另加確認、靜音、指派及解決警報,建立 Jira 工單,以及規劃維護時段
Editor操作員可以做的一切,另加更改資源的檢查及閾值,以及接受安全風險
Entity admin編輯者可以做的一切,另加管理該分支的實體、實體預設值、資源、憑證、數據源、人員、角色、邀請、通知頻道、Jira 設定及狀態頁
Super admin在每個分支上可以做一切事情,另加整個安裝的設定。只能在根層級授予,並且由另一位超級管理員授予

實際情況如下:

  • 每個清單都限於你的分支:實體、資源、警報、Overview、憑證、頻道及人員。如果你的角色從 桃花島物流 開始,你所見的實體樹也從那裡開始。
  • 你的分支以外的任何內容,對你而言並不存在:開啟其位址時,回應是 Not found, or no longer visible to you。你可以看到但無法更改的內容,回應是 Your role does not allow this。
  • 授予角色只限於你的分支及層級:實體管理員只能邀請人員並在自己管理的實體上授予角色,而且不能授予高於自己的角色。
  • 憑證屬於擁有它的實體,該實體及其下的資源都可以使用。要讓採集器使用某個憑證連線到主機,需要在該憑證所屬的實體上擁有實體管理員角色,因此一個客戶的管理員無法把從上層共用的登入帳戶指向自己選擇的主機。

實體、標記及繼承說明實體樹本身。

機密​

監控憑證、數據源 API 密鑰、用戶端機密及已上載證書的密鑰都是只能寫入的:

  • 它們在數據庫中以 AES 及 HMAC 簽章(Fernet)加密,所用的密鑰由安裝程式產生並保存在伺服器的設定檔中,而不是數據庫內。單憑一份數據庫傾印檔無法得知任何機密。
  • 畫面及 API 只會顯示機密是否已設定,例如 stored — leave empty to keep it。無論角色是什麼,沒有人可以讀回機密。
  • 機密會在伺服器上解密,或在檢查需要時透過伺服器的內部網絡發送給採集器。採集器只在記憶體中保存機密,絕不會把它寫入日誌。
  • 採集器容器只會收到自己的令牌及設定:絕不會收到數據庫密碼、工作階段簽署機密或加密密鑰。採集器的路由會在伺服器邊緣被拒絕,因此只能從內部連線。

這些憑證本身在建立時,對受監控系統不具備寫入或安裝權限;請參閱架構。

審核​

透過 API 進行的每項變更,都會連同執行操作的用戶、時間及請求的 IP 位址寫入稽核記錄。就登入及存取而言,包括:

事件記錄為
登入login
供應商回應後的拒絕,連同原因login.failed
首次登入時建立的帳戶user.create
建立、接受或刪除的邀請invitation.create、invitation.accept、invitation.delete
授予或移除的角色role.grant、role.revoke
註冊模式的變更registration.update、registration.reset
用戶或其偏好設定的變更user.update、user.preferences

警報操作、閾值變更、數據源變更、維護時段及狀態頁的編輯,也以同樣方式審核。稽核記錄保存在平台數據庫中。