SuperAPI AI 工具集

volcengine-compliance

通用与其它

查看项目

更新于 10-16 04:56

技能介绍

用途:本技能面向火山引擎配置审计(Config)的合规场景,帮助用户决定该开启哪些合规基线,以及了解账号当前合规态势。适用范围包括合规检查、合规巡检、合规最佳实践推荐、账号合规态势总览,以及编写自定义合规规则。

主要能力:一是合规推荐(只读),按用户诉求的标准、关键词、风险等级,从官方内置合规包模板中推荐应开启项,并标出哪些已开启、未开启排在前面;二是合规总览(只读),汇总账号已生效规则与合规包(内置与自定义)的评估结果,按合规类别分节、按严重度降序,输出 md/csv/json 三份产物;三是可选写操作,将推荐模板部署为合规包、注册自定义规则;四是针对具体检查诉求,先查找现成系统模板,没有则参考类似模板或从零编写 Rego 策略并注册评估。

使用方式:所有动作通过 scripts/compliance.py 完成,命令相对本技能目录根执行。例如合规推荐:python3 scripts/compliance.py recommend,可加 --standard Law、--keyword 对象存储、--risk-level High 过滤。合规总览:python3 scripts/compliance.py overview,可加 --no-detail 或 --conformance-pack-id <合规包ID>。部署合规包需先 dry-run 查看将要创建的内容:python3 scripts/compliance.py apply --template-id <模板ID> --name my-baseline --enable-recorder,用户明确同意后再加 --confirm 真正写入。底层封装 ve config <Action>,写自定义规则时直调 ve config。

前置条件:已安装 ve CLI 并完成鉴权(ve configure 或配置 VOLCENGINE_ACCESS_KEY / SECRET_KEY);合规总览与部署合规包要求账号已启用配置记录器并有评估结果;调用方需对目标账号或账号组具备配置审计读写权限。

限制与边界:recommend 与 overview 为只读,不修改任何资源;apply、--enable-recorder 及注册自定义规则属于写操作,必须用户明确同意并加 --confirm 才执行,否则仅 dry-run。规则创建后由平台自动异步评估,本技能不手动触发评估。修复具体资源配置不在本技能内执行,仅给出整改建议,合规报告与修复严格分离。报告中不得出现 AK/SK、Authorization、会话 token 等凭证。

报错处理:ve 未登录或会话过期需按文档引导登录,不要盲目重试;recorder 未启用报 SingleAccountRecorderNotEnabled 或 OrganizationRecorderNotEnabled 时,可用 apply --enable-recorder;模板 ID 错误报 NotFound.ConformancePackTemplate 时重新 recommend 获取正确 ID;规则配额不足报 QuotaExceeded.Rule 时减少部署范围或清理无用规则;CreateRuleTemplate 报策略编译错多为 Rego 语法或语义问题;自定义规则评估结果不符预期时,多因字段路径、大小写或标量数组假设错误,可用 GetResourceConfigHistory 核对真实快照。