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

啟用安全性模組

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

安全性模組會找出你的 SQL Server 實例、身份和 Azure 訂閱中的弱點,並加入來自 Microsoft Defender for Cloud 及 Wazuh 的發現。每項檢查都只讀取;每個發現都附有證據及建議的處理方式,供人員跟進,絕不會自動為你變更任何內容。本指南說明如何開啟模組、授予唯讀存取權、為分數設定權重,以及接受風險。

方案

安全性模組及安全分數屬於 Enterprise 方案,並且是 Pro 方案的附加元件。

開始之前​

  • 若要開啟模組,你需要 Super admin 角色。
  • 若要新增資源和憑證,以及設定分數權重,你需要在該實體上具備 Entity admin 角色。
  • 若要接受風險,你需要在該發現所屬的實體上具備 Editor 或以上的角色。
  • 請閱讀安全態勢,了解什麼是發現、分數如何計算,以及每項檢查偵測什麼。

開啟模組​

  1. 開啟 Settings › Instance。

  2. 在 Features 下的 Security 群組中,開啟你需要的項目:

    功能作用
    securitySecurity posture 頁面、發現及分數,以及數據庫、身份識別和雲端模組
    security.recommendations顯示 Defender for Cloud 建議(中和低嚴重程度的評估),計入分數,並列在收件匣中。關閉時,只有高嚴重程度的評估會以發現的形式保留
    security.defender採集 Defender for Cloud 評估。預設為關閉
    security.wazuh採集 Wazuh 警報及弱點。預設為關閉
  3. 可選擇開啟 collab.jira,讓發現可以傳送到 Jira。

其餘三個開關都需要 security。關閉 Defender 或 Wazuh 會停止採集;已產生的發現會維持開啟,直到被解決。

為現有資源新增檢查​

從現在起新增的資源,會立即取得其類型的安全性檢查。在開啟模組之前已存在的資源,需要透過 API 一次性新增缺少的檢查:

curl -s "${H[@]}" -X POST "$BASE/resources/$SQL01/checks" -d '{"check_ids": []}' \
| jq -r '.[].check_id' | grep security

空清單會新增該資源類型所有缺少的預設檢查。探索到的數據庫和可用性群組,會在其實例下一次執行 Discover 時取得各自的檢查。$BASE 和 H 的設定方式與快速入門:使用 API 新增 SQL Server 實例相同。

授予模組唯讀存取權​

數據庫​

SQL Server 安全性檢查使用實例的監控登入。它需要 VIEW SERVER STATE、VIEW ANY DEFINITION、CONNECT ANY DATABASE 及 msdb.dbo.backupset 上的 SELECT,除此之外不需要其他權限。請參閱為採集器儲存憑證。

身份識別​

  1. 在租用戶所屬的實體下(例如桃花島物流),新增類型為 Entra ID tenant / domain services 的資源,並填入租用戶的 tenant_id。
  2. 以下列兩種方式之一,授予它對 Microsoft Graph 的讀取權限:
    • 具備 Microsoft Graph 應用程式權限 RoleManagement.Read.Directory、AuditLog.Read.All 及 IdentityRiskEvent.Read.All 的應用程式註冊,全部為唯讀,並取得系統管理員同意。把它儲存為類型 Azure service principal 的憑證:用戶端 ID、用戶端密碼及 tenant_id。然後把它選為資源的憑證。
    • 將相同的權限授予 Excubius 伺服器的受控識別。
  3. 如果使用 Active Directory 檢查,請在安裝了 Active Directory PowerShell 模組的主機上,提供唯讀網域帳戶(憑證類型 Windows account),並經由 WinRM 連線。

多重要素驗證的註冊詳細資料需要 Microsoft Entra ID P1 或 P2;完整的風險偵測需要 P2。

雲端​

Azure 檢查透過 Azure Resource Graph 及 Defender for Cloud 讀取,使用伺服器的受控識別,或儲存為 Azure service principal 憑證的應用程式註冊:

  • 每個訂閱上的 Reader,供 Resource Graph 檢查使用。
  • 每個訂閱上的 Security Reader,供 Defender for Cloud 使用。

使用應用程式註冊時,透過 API 設定的憑證 subscriptions 屬性會限制讀取哪些訂閱;否則會套用伺服器的 AZURE_SUBSCRIPTION_IDS 設定。有關角色及其 ID,請參閱申請 Azure 伺服器。

Resource Graph 檢查查看資源的 resource_id:可以是一個資源、一個資源群組,或整個訂閱,例如 /subscriptions/<id>。

Defender for Cloud 及 Wazuh​

Defender for Cloud 評估、Azure 角色指派變更、Wazuh 發現,以及平台自身映像的掃描,都在類型為 Monitoring platform itself 的資源上執行。如果還沒有,請使用 Resources › Add resource 新增,例如放在根實體之下。發現隨後會附加到它們所涉及的資源:Defender 的發現附加到 resource_id 相符的清查資源,Wazuh 的發現則附加到名稱、主機名稱、IP 位址或電腦名稱與代理程式相符的主機。

如果使用 Wazuh:

  1. 建立唯讀的 Wazuh 用戶,具備 wazuh-alerts-* 及 wazuh-states-vulnerabilities-* 索引的讀取權限,並可選擇具備管理器 API 的 agents:read 權限。

  2. 在 Settings › Credentials 中把它儲存為 HTTP user and password 類型。如果索引器的憑證不是伺服器信任的憑證,請改為透過 API 建立憑證,並帶有 "attributes": {"verify_tls": false};控制台沒有此欄位。

  3. 透過 API,把檢查指向你的 Wazuh 索引器並提供憑證:

    curl -s "${H[@]}" -X PATCH "$BASE/resources/$PLATFORM/checks/security_cloud.wazuh_alerts" -d '{
    "params": {"indexer_url": "https://wazuh.areito.example:9200",
    "api_url": "https://wazuh.areito.example:55000"},
    "credential_id": "'"$WAZUH_CRED"'"
    }'

Wazuh 用戶端只會傳送搜尋要求及管理器的驗證呼叫;其他任何操作都會在代碼層面被拒絕。Excubius 從不部署 Wazuh 代理程式,這由你自己的工具負責。

為分數的範疇設定權重​

整體分數是各個已評估範疇(identity、database 和 cloud)的平均值,預設每個範疇的權重為 1。實體可以設定自己的權重(0 至 100),其下的每個實體都會繼承。此版本沒有對應的畫面;請使用 API:

# Ciguapa cares most about its databases
curl -s "${H[@]}" -X PUT "$BASE/entities/$CIGUAPA/security/score-weights" \
-d '{"identity": 1, "database": 3, "cloud": 1}'

# back to the inherited weights
curl -s "${H[@]}" -X PUT "$BASE/entities/$CIGUAPA/security/score-weights" -d '{}'

GET /entities/{id}/security/score-weights 會顯示實體自己的權重及有效的權重。

接受風險​

當某個發現是已知的,而且在一段時間內可以接受(例如因舊有工作而啟用 xp_cmdshell,直到該工作被取代為止),請接受風險,而不要讓它一直處於開啟狀態。

  1. 開啟 Security posture 並選取該發現。
  2. 選取 Accept risk…。
  3. 填寫 Reason:說明風險為何可以接受,以及有什麼緩解措施,長度為 3 至 2,000 個字元。
  4. 在 Accepted for 下,選擇天數,或選擇 Until a date。結束日期必須在一年以內。
  5. 選取 Accept risk。

該發現會離開開啟清單,並停止計入分數。它仍會持續接受檢查,並在接受期結束時自動重新開啟;如果嚴重程度上升,則會更早重新開啟。這項決定會連同你的姓名、日期、結束日期及結束方式一併保存。

若要提早結束接受期,請開啟該發現並選取 Reopen。

有些發現屬於變更而非狀況,例如 sysadmin 的新成員或新的 Owner 角色指派。它們無法被接受:請審查該項變更,然後手動解決該發現。

提交平台映像的掃描結果​

檢查 security_cloud.platform_images 會回報 Excubius 自身容器映像中的嚴重弱點。請以 trivy image --format json <image> 產生報告,並提交到 POST /api/v1/security/platform-report;這需要 Super admin 角色。每個映像以最新的報告為準。