启用安全模块
安全模块会查找你的 SQL Server 实例、标识和 Azure 订阅中的弱点,并加入来自 Microsoft Defender for Cloud 和 Wazuh 的发现。每项检查都只读取;发现附带证据和供人员执行的建议措施,绝不会替你更改任何内容。本指南介绍如何启用这些模块、授予它们只读访问权限、为分数设置权重以及接受风险。
安全模块和安全分数包含在 Enterprise 计划中,在 Pro 计划中则是附加产品。
开始之前
- 若要启用这些模块,你需要 Super admin 角色。
- 若要添加资源和凭据以及设置分数权重,你需要在该实体上具有 Entity admin 角色。
- 若要接受风险,你需要在发现所属的实体上具有 Editor 角色或更高角色。
- 阅读安全态势,了解什么是发现、分数如何计算以及每项检查检测什么。
启用模块
-
打开 Settings › Instance。
-
在 Features 下的 Security 组中,打开你需要的功能:
功能 效果 securitySecurity posture 页面、发现和分数,以及数据库、身份和云模块 security.recommendations显示 Defender for Cloud 建议(中等和低严重性评估),将其计入分数,并在收件箱中列出。关闭时,只保留高严重性评估,作为发现 security.defender收集 Defender for Cloud 评估。默认关闭 security.wazuh收集 Wazuh 警报和漏洞。默认关闭 -
还可以选择打开
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 权限,除此之外不需要任何权限。参阅为采集器存储凭据。
身份
- 在租户所属的实体下(例如高密物流),添加类型为 Entra ID tenant / domain services 的资源,并填入租户的
tenant_id。 - 通过以下两种方式之一,授予它对 Microsoft Graph 的读取权限:
- 具有 Microsoft Graph 应用程序权限
RoleManagement.Read.Directory、AuditLog.Read.All和IdentityRiskEvent.Read.All的应用注册,全部为只读,并经管理员同意。将其存储为类型为 Azure service principal 的凭据:客户端 ID、客户端密码和tenant_id。选择它作为该资源的凭据。 - 向 Excubius 服务器的托管标识授予相同的权限。
- 具有 Microsoft Graph 应用程序权限
- 对于 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:
-
创建一个只读 Wazuh 用户,对
wazuh-alerts-*和wazuh-states-vulnerabilities-*索引具有读取权限,还可以选择在管理器 API 上具有agents:read权限。 -
在 Settings › Credentials 中将其存储为类型 HTTP user and password。如果索引器的证书不是服务器信任的证书,请改为通过 API 创建凭据,并带上
"attributes": {"verify_tls": false};控制台中没有对应的字段。 -
通过 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,直到替换该作业),请接受该风险,而不是任其保持打开。
- 打开 Security posture,选择该发现。
- 选择 Accept risk…。
- 填写 Reason:说明为什么该风险可以接受以及有哪些缓解措施,长度为 3 到 2,000 个字符。
- 在 Accepted for 下,选择天数,或选择 Until a date。结束日期必须在一年以内。
- 选择 Accept risk。
该发现会离开未解决列表,并且不再计入分数。它仍会继续被检查,并在接受期结束时自动重新打开;如果其严重性升高,则会更早重新打开。该决定会连同你的姓名、日期、结束时间以及结束方式一并保留。
若要提前结束接受,请打开该发现并选择 Reopen。
有些发现是变更而不是状态,例如 sysadmin 的新成员或新的 Owner 角色分配。它们不能被接受:请审查该变更,然后手动解决该发现。
发布平台映像的扫描结果
检查 security_cloud.platform_images 会报告 Excubius 自身容器映像中的严重漏洞。使用 trivy image --format json <image> 生成报告,并将其发布到 POST /api/v1/security/platform-report;这需要 Super admin 角色。每个映像以最新的报告为准。