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

為採集器儲存憑證

操作指南審閱日期:2026年10月11日
適用於:Excubius 0.4角色: 實體管理員
方案Free · Core · Pro · Enterprise部署自行託管

憑證是採集器用來連線到系統的唯讀登入:SQL 登入、Windows 帳戶、SSH 金鑰或 Azure 服務主體。你只需在實體上儲存一次,該實體及其下的每個資源都可以使用。本指南說明如何新增憑證、應選擇哪種類型、每種類型的連線選項,以及資源如何找到它所使用的憑證。

開始之前​

  • 你需要在擁有該憑證的實體上擁有 Entity admin(實體管理員)角色。
  • 該登入已在受監控的系統上建立,並且只有唯讀權限。對於 SQL Server,請參閱可用性群組的先決條件;各個平台的要求請參閱權限。
  • 把憑證儲存在實體樹中盡可能高的層級,只要它在該層級仍然有效。在 桃花島物流 的每部伺服器上使用的 SQL 登入,應放在 桃花島物流 上,而不是放在每個環境上。

選擇類型​

類型用戶機密用途
SQL login (sql_login)SQL 登入密碼SQL Server 實例和可用性群組;它們探索到的數據庫和連結伺服器會使用該實例的憑證。也用於 Reporting Services 執行記錄
Windows account (windows)帳戶(DOMAIN\user)密碼透過 WinRM 連線的 Windows 主機;使用 Windows 驗證(NTLM)的報表伺服器和網頁端點
HTTP user and password (http_basic)用戶密碼使用 Basic 驗證的網頁端點和報表伺服器;Wazuh 檢查
Bearer token (token)—權杖使用 Bearer 驗證的網頁端點
SSH key (ssh_key)用戶私密金鑰Linux 主機
SSH password (ssh_password)用戶密碼Linux 主機
Azure service principal (azure_sp)用戶端 ID用戶端密碼針對伺服器的受控識別無法存取的租用戶,進行 Azure 態勢檢查和 Entra ID 身分識別檢查

不支援使用 Windows 整合驗證連線到 SQL Server:採集器在沒有 Kerberos 票證的 Linux 容器中運行。請使用 SQL 登入,這要求實例接受 SQL Server 驗證(混合模式)。

新增憑證​

  1. 開啟 Settings › Credentials,並在實體選擇器中選取實體,例如 桃花島物流。
  2. 選取 Add credential。
  3. 輸入你能辨認的 Name,例如 sql-monitoring,並選擇 Kind。類型之後無法變更。
  4. 檢查 Entity:此實體及其下的資源可以使用該憑證。
  5. 輸入用戶和機密。標籤會隨類型而變,例如 SQL login 和 Password,或 Client id 和 Client secret。
  6. 在 Connection options 下,設定該類型所需的內容。請參閱下一節。
  7. 選取 Create。

憑證會出現在清單中,機密標示為 stored,並顯示有多少資源使用它,以及最後一次使用的時間。

連線選項​

類型選項值效果
SQL 登入encryptyes(預設)、no、strict加密連線。strict 使用 TDS 8,需要 SQL Server 2022 或更高版本
SQL 登入trust_server_certificatetrue(預設)、false大多數實例使用自簽證書。當實例擁有採集器信任的證書後,請設為 false
SQL 登入host_name_in_certificate主機名稱當要驗證的名稱與主機不同時使用,例如透過接聽程式或別名連線
SQL 登入application_intentReadOnly(預設)、ReadWriteReadWrite 只會改變路由,使逐數據庫檢查涵蓋拒絕唯讀意圖連線的主要複本上的可用性數據庫。登入仍然沒有寫入權限
Windows 帳戶authkerberos(預設)、negotiate、ntlmWinRM 的驗證方式。採集器映像沒有 Kerberos 設定,因此請選擇 negotiate 或 ntlm
SSH 金鑰、SSH 密碼known_hostsOpenSSH known_hosts 行,每行一項固定採集器接受的主機金鑰
Azure 服務主體tenant_idEntra 租用戶 ID應用程式註冊所屬的租用戶

有些選項只能透過 API 在憑證的 attributes 中設定:

類型選項效果
Azure 服務主體subscriptions把 Azure 態勢檢查限制在這些訂閱。沒有設定時,套用 AZURE_SUBSCRIPTION_IDS,否則涵蓋該身分識別可以讀取的所有訂閱
HTTP 用戶及密碼verify_tlsfalse 會接受 Wazuh 索引器和管理器上不受信任的證書。預設為 true

選項名稱絕不會保存機密:如果選項名稱包含 pass、secret、token、private 或 pwd,API 會拒絕它。請把機密放在機密欄位中。

機密如何受到保護​

  • 機密是唯寫的。它以安裝的數據金鑰(EXCUBIUS_DATA_KEY)加密,之後不會在任何畫面或透過 API 再次顯示,API 只會說明是否已儲存機密。
  • 若要變更機密,請編輯憑證並輸入新的機密。讓欄位保持空白會保留已儲存的機密,或選取 Remove the stored secret 將它清除。
  • 採集器透過內部網絡接收機密,只保存在記憶體中,絕不記錄到日誌。
  • 請把 EXCUBIUS_DATA_KEY 與 .env 檔案的備份放在一起。沒有它,已儲存的機密就無法解密,檢查會以錯誤類型 config 失敗,直到你重新輸入為止。

資源使用哪個憑證​

資源會按以下順序尋找憑證,並採用第一個類型適合該檢查的憑證:

  1. 檢查本身的憑證(如果已設定)。
  2. 資源的憑證。
  3. 最近的父資源的憑證。在實例下探索到的可用性群組或數據庫,會使用該實例的 SQL 登入。

例如,報表伺服器的執行記錄檢查是 T-SQL 檢查。當報表伺服器資源為其入口網站保存了 Windows 帳戶時,該檢查會使用上層實例的 SQL 登入,或你在這項檢查上單獨設定的 SQL 登入。

若要為單一檢查設定憑證,請使用 API:PATCH /api/v1/resources/{id}/checks/{check_id},附帶 credential_id。要讓資源或檢查指向某個憑證,你需要在擁有該憑證的實體上擁有 Entity admin 角色。

編輯或刪除憑證​

  • Edit 可變更名稱、用戶、機密和選項。類型保持不變。
  • Delete 只有在沒有任何項目使用該憑證時才可使用。請先變更使用它的資源和檢查。
  • 刪除實體時,也會一併刪除它所擁有的憑證。

清單會顯示每個憑證有多少資源和檢查使用它,以及成功的檢查最後一次使用它的時間。