跳到主要内容
版本: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 角色。每个映像以最新的报告为准。