SAS Overview Data Query 是阿里云 AIOps 技能集中的一个技能,用于查询阿里云安全中心(SAS)概览仪表盘的数据。它通过阿里云 CLI 命令调用多个云产品接口,返回结构化的安全态势数据。
用途
该技能面向需要集中查看阿里云账号整体安全状况的场景。它从安全中心概览仪表盘提取数据,涵盖五个核心模块:安全概览、使用信息、安全运营、资产风险趋势以及账单与订阅。
主要能力
技能按模块组织查询能力,每个模块及模块内的数据项均可独立执行,便于按需匹配用户的请求范围。
- 安全概览:包括安全评分、已修复漏洞数量、基线风险统计和已处理告警数量。其中安全评分与区域无关;已修复漏洞、基线风险和已处理告警为多区域接口,需分别查询 cn-shanghai 和 ap-southeast-1 后求和。
- 使用信息:包括服务时长与订阅信息、主机资产信息(主机数量和核数)、未安装客户端数量。服务时长依赖版本配置接口,需先判断是否为付费用户;主机资产与未安装客户端为多区域接口,需跨区域求和。
- 安全运营:包括风险治理(AI 风险、CSPM、关键配置、系统漏洞等)、安全防护(WAF 拦截)、安全响应。风险治理与安全响应通过同一接口的单次调用处理,按 SuggestType 分类;安全防护使用 WAF 3.0 接口,需先获取实例 ID 再查询流量图,且仅支持 WAF 3.0,WAF 2.0 实例不兼容。
- 资产风险趋势:包括主机资产、容器资产、云产品资产的风险占比,以及趋势图数据。主机、容器、云产品资产统计为多区域接口,需分别查询求和;趋势图通过指定图表 ID 获取时间序列数据。
- 账单与订阅:查询计费模式(预付费或后付费),后付费用户可解析已启用的模块开关;账单详情通过 BssOpenApi 查询,若某区域返回权限错误会明确告知用户哪些区域成功、哪些失败。
使用方式
技能通过阿里云 CLI 执行,需满足前置条件:阿里云 CLI 版本不低于 3.3.1;启用插件自动安装并更新插件(sas、waf-openapi、bssopenapi 会在首次使用时自动安装);需要有效的阿里云凭证配置,但不能在会话中读取、回显或明文传入 AK/SK,只能通过 aliyun configure list 检查凭证状态。
每次技能执行会话需生成一个 UUID v4 作为 session-id,同一会话内所有 CLI 命令使用相同的 session-id,并作为 User-Agent 的一部分传入(模板为 AlibabaCloud-Agent-Skills/alibabacloud-sas-overview/{session-id}),每次新的技能调用需生成新的 session-id。执行前需与用户确认所有可自定义参数,例如 RegionId、WAF 实例 ID、计费周期等,不应在未经用户明确同意时使用默认值。
所需 RAM 权限为 AliyunYundunSASReadOnlyAccess、AliyunWAFReadOnlyAccess 和 AliyunBSSReadOnlyAccess。
适用场景
适用于安全运维人员或云账号管理者希望快速了解阿里云安全中心整体安全态势、资产风险分布、风险治理进展以及订阅与计费情况的场景。用户可提出单一数据项(如“我的安全评分是多少”)、单一模块(如“展示资产风险趋势”)或完整概览(如“SAS 概览”)等不同粒度的请求。
限制
- 部分接口存在可用性限制,例如 DescribeScreenScoreThread 当前不可用,安全评分暂时只能获取当前分值,无法直接获取历史趋势。
- 安全防护模块仅支持 WAF 3.0,WAF 2.0 实例不兼容,相关字段可能缺失或结构不同。
- WAF 3.0 使用集中式端点,中国站 RegionId 应为 cn-hangzhou,且不应在这些命令中传入 --version。
- 多区域数据需分别查询后求和;若某区域权限不足,不能静默跳过,需明确告知用户成功与失败的区域。
- SAS 接口使用毫秒时间戳,WAF 接口使用秒时间戳。
- 参数如 RegionId、WAF 实例 ID、计费周期等需用户确认,技能本身不假定默认值。