用途
本技能用于对华为云租户进行风险巡检:从华为云优化顾问(OA)、配置审计(Config)和安全云脑(SecMaster)三个服务获取租户资源的巡检结果,并生成巡检分析报告。
主要能力
- 从 OA 获取原始风险巡检结果。
- 从 Config 获取资源合规检查结果。
- 从 SecMaster 获取基线检查结果。
- 将 Config 与 SecMaster 的原始结果转换为 OA 巡检结果格式,并生成合并数据文件。
- 生成租户巡检分析报告(HTML 与 Excel)。
- 清理中间过程产生的临时 JSON 文件。
使用方式
技能按以下工作流执行,并需逐步跟踪进度:
- 环境检查:检查是否安装 Python、Python 第三方库依赖(参考 requirements.txt,可用
pip install --dry-run -r requirements.txt验证)、hcloud 命令行工具及其认证信息。任一检查失败须报告缺失项与修复指引并终止流程。 - 获取 OA 风险巡检结果:调用
oa_risk_inspection.py,先用--help查看帮助,再向用户询问并确认命令行参数。 - 获取 Config 资源合规结果:调用
config_compliance_inspection.py,同样先查看帮助并确认参数。 - 获取 SecMaster 基线检查结果:调用
secmaster_baseline_inspection.py,先查看帮助并确认参数,尤其需再次确认--region_id,不得静默复用上一步的区域 ID。 - 转换原始结果:调用
merge_inspection_results.py,将 Config 与 SecMaster 结果转换为 OA 格式并生成合并数据文件;运行前须展示完整命令行并请求确认;运行后须检查合并日志中的“Blacklist filtered out”行,记录被过滤项(名称 + 状态 + 黑名单原因)供后续汇总。 - 生成报告:调用
merge_report_generator.py,先查看帮助、准备并确认参数,展示完整命令行后运行。 - 清理临时文件:删除第 2 至第 5 步产生的 5 个临时 JSON 文件(oa_risk_inspection_results_<timestamp>.json、config_compliance_inspection_results_<timestamp>.json、secmaster_baseline_inspection_results_<timestamp>.json、secmaster_baseline_inspection_stats_<timestamp>.json、merge_inspection_results_<timestamp>.json),不得删除第 6 步生成的最终报告产物(HTML 与 Excel),并在汇总中列出所有已删除文件的完整绝对路径。
- 工作流汇总:以表格呈现各步骤完成状态(表头含序号、步骤、状态、备注),列出最终产物与已删除临时文件的完整绝对路径,并单独列出第 5 步被黑名单过滤的项。
适用场景
适用于需要对华为云租户资源进行风险巡检、合规检查与基线检查,并汇总生成分析报告的场景。
限制与前置条件
- Python >= 3.9。
- hcloud >= 7.2.2。
- 需完成 hcloud 命令行工具的安装与认证配置(AK/SK 与区域配置)。
- 各步骤脚本的具体命令行参数需由用户提供并逐步确认,脚本无法在缺少必要参数时运行。
- 合并过程会依据 references/blacklists 下的黑名单对 Config / SecMaster 项去重,被过滤项不会出现在最终报告中。
参考资料
- 华为云 Config 服务文档
- 华为云 OA 服务文档
- 华为云 SecMaster 服务文档
- 华为云 KooCLI 安装
- IAM 认证指南
- CLI 安装指南(本地参考:hcloud CLI 设置步骤)
- IAM 认证指南(本地参考:AK/SK 与区域配置)
- 验证方法(本地参考:环境与功能验证流程)
- 验收标准(本地参考:验收门禁清单)