SuperAPI AI 工具集

alicloud-security-kms

安全与审计

查看项目

更新于 10-15 13:55

技能介绍

用途

该技能用于通过阿里云 OpenAPI/SDK 管理阿里云密钥管理服务(Key Management Service,KMS)。当用户需要进行密钥生命周期与资源操作、策略或配置变更等任务时,可使用本技能。

主要能力

  • 使用阿里云 OpenAPI(RPC)配合官方 SDK 或 OpenAPI Explorer 管理 KeyManagementService 资源。
  • 产品代码为 Kms,默认 API 版本为 2016-01-20。
  • 支持通过 OpenAPI 元数据端点列出 API 并获取 schema。
  • 高频操作模式:
    • 清单/列表:优先使用 List* / Describe* API 获取当前资源。
    • 变更/配置:优先使用 Create* / Update* / Modify* / Set* API 执行变更。
    • 状态/排障:优先使用 Get* / Query* / Describe*Status API 进行诊断。

使用方式

凭证配置

执行前需配置最小权限的阿里云凭证,优先级如下:

  1. 环境变量:ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID。其中 ALICLOUD_REGION_ID 为可选默认值;若未设置,需为任务决定最合理的地域,若仍不明确则询问用户。
  2. 共享配置文件:~/.alibabacloud/credentials。

工作流程

  1. 确认地域、资源标识与目标操作。
  2. 发现 API 列表与所需参数(参见 references)。
  3. 使用 SDK 或 OpenAPI Explorer 调用 API。
  4. 通过 describe/list API 验证结果。

最小可执行快速开始

在调用业务 API 前,先进行元数据优先的发现:

python scripts/list_openapi_meta_apis.py

可选覆盖参数:

python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>

该脚本会将 API 清单产物写入技能输出目录。

验证

mkdir -p output/alicloud-security-kms
python -m py_compile skills/security/key-management/alicloud-security-kms/scripts/list_openapi_meta_apis.py && echo "py_compile_ok" > output/alicloud-security-kms/validate.txt

通过标准:命令退出码为 0,且生成 output/alicloud-security-kms/validate.txt。

输出与证据

  • 将 KMS API 发现输出与操作结果保存在 output/alicloud-security-kms/ 目录下。
  • 每种操作类型至少保留一个请求参数示例。
  • 如需保存响应或生成的产物,写入 output/alicloud-security-kms/ 目录。

适用场景

  • 需要管理阿里云 KMS 密钥生命周期与资源。
  • 需要变更 KMS 策略或配置。
  • 需要查询或诊断 KMS 资源状态。

限制

  • 执行前必须配置最小权限的阿里云凭证。
  • 若地域不明确,在执行变更类操作前应先询问用户。
  • 具体支持的 API 列表与参数需通过元数据发现获取,资料中未逐一列出。
  • 关于收费、价格、平台支持范围等细节,资料暂未提供。