SuperAPI AI 工具集

huawei-cloud-network-topology-audit

部署与运维

查看项目

更新于 10-17 03:33

技能介绍

【用途】 华为云网络拓扑审计是一个只读的编排型技能,用于对华为云网络拓扑进行安全与配置风险审计。给定用户用自然语言描述的访问路径(例如“ELB web-elb → CCE prod-cce → RDS prod-db”),技能会基于实际云资源还原真实拓扑,扩展到完整 VPC 网络面,并按规则目录评估风险,最终输出 Markdown 审计报告。技能全程只读,不会创建、修改或删除任何资源。

【主要能力】

  1. 从用户描述中解析资源类型与大致名称。
  2. 通过查询技能(路径 A)或基于官方文档自写脚本(路径 B)采集真实拓扑数据。
  3. 以真实拓扑为准,与用户描述进行差异比对并标记不一致。
  4. 扩展至整个 VPC 网络面:VPC、子网、路由表、安全组、EIP、ELB、NAT 网关、ECS、RDS、CCE、DCS。
  5. 按 rules/network-audit-rules.yaml 逐条评估风险,输出按严重级别排序、可追溯到规则 ID 的风险列表。
  6. 生成含拓扑摘要、安全组清单、风险列表、Mermaid 拓扑图与元数据的 Markdown 报告;Mermaid 渲染失败时回退为 ASCII 图。

【使用方式】 工作流共 7 步:连通性预检 → 路径解析与 find-skills 查询 → 真实拓扑发现 → 差异分析 → 用户确认 → 风险审计 → 报告渲染。 核心命令:

  • bash scripts/precheck.sh(第 1 步连通性预检)
  • python3 scripts/validate-rules.py rules/network-audit-rules.yaml(第 6 步校验规则目录)
  • bash scripts/mermaid-to-ascii.sh(第 7 步 Mermaid ASCII 回退)
  • python3 scripts/query-dcs-instances.py --region {region}(路径 B:查询 DCS 实例)

参数:访问路径(必填,带资源名的自然语言路径)、--region(必填,华为云区域,如 cn-north-4)、--output(可选,报告输出路径,如 ./audit-report.md)。

前置条件:已配置华为云凭证(环境变量 HUAWEI_ACCESS_KEY / HUAWEI_SECRET_KEY 或 HW_AK / HW_SK / HWC_ACCESS_KEY / HWC_SECRET_KEY,或 hcloud CLI 配置);Python 3.8+;路径 B 的 DCS 资源需 pip install huaweicloudsdkdcs;访问 GitCode 以进行 find-skills 索引查询;CCE 集群查询可选使用 hcloud CLI。

【适用场景】 用户能以大致资源名描述访问路径;当前环境已配置华为云凭证(CLI/SDK);需要对网络拓扑风险进行结构化审计。

【限制】 用户无法描述任何资源名时不适用;未配置华为云凭证时不适用;不支持修改资源(只读);v1 仅限单账号,不支持跨账号审计。

【其他说明】 技能集成 skill_quality_sdk.py 进行执行质量上报,每次运行自动上报 trace_id、状态、错误码、耗时及脱敏输入输出;上报非阻塞、失败静默,可通过 SKILL_QUALITY_DISABLE=1 禁用。错误码按 U(用户输入)、C(配置)、N(网络)、B(代码缺陷)、P(平台)分类。参考文档包括资源-技能映射、官方文档索引、严重级别定义、规则编写指南、IAM 策略、CLI 安装指南、数据流图、验证方法与验收标准。