用途:该技能提供阿里云密钥管理服务(KMS)凭据管理的核心功能,用于安全存储、管理和访问敏感信息,如数据库连接凭据、API 密钥、OAuth 令牌、证书私钥等。架构为阿里云 KMS 服务加凭据管理(Secrets Manager),支持通用凭据及 RDS、RAM、ECS、Redis、PolarDB 等托管凭据轮转。
主要能力:支持凭据的创建、删除、更新、查询操作,版本管理(列出、更新版本阶段),以及自动轮转策略配置和已删除凭据恢复。
使用方式:依赖 Aliyun CLI,若提示命令未找到可参考 references/cli-installation-guide.md 安装。建议设置超时,如 export ALIBABA_CLOUD_CONNECT_TIMEOUT=30 与 export ALIBABA_CLOUD_READ_TIMEOUT=30,或使用 --connect-timeout 30 --read-timeout 30。创建凭据需先获取 KMS 实例 ID 与加密密钥 ID,再执行 CreateSecret;常用命令包括 ListSecrets、GetSecretValue、PutSecretValue、DescribeSecret、ListSecretVersionIds、UpdateSecretRotationPolicy、RestoreSecret、DeleteSecret 等,均需指定 --region 与 --user-agent AlibabaCloud-Agent-Skills。
安全规则:禁止读取、打印或显示 AK/SK 值,禁止要求用户在对话中直接输入 AK/SK;GetSecretValue 返回的凭据值默认脱敏,仅在用户明确要求时以明文输出。获取凭据值需用户明确请求并确认后执行,且应提醒在安全环境操作。删除前须先用 DescribeSecret 校验存在性与元数据,确认后再强制删除。
权限要求:执行用户需具备相应 KMS 权限,只读最小权限包括 kms:DescribeSecret、kms:ListSecrets、kms:GetSecretValue、kms:ListSecretVersionIds、kms:GetSecretPolicy;读写完整权限另含 kms:CreateSecret、kms:DeleteSecret、kms:UpdateSecret、kms:PutSecretValue、kms:UpdateSecretVersionStage、kms:UpdateSecretRotationPolicy、kms:RotateSecret、kms:RestoreSecret、kms:SetSecretPolicy、kms:ListKmsInstances、kms:ListKeys、kms:CreateKey 等,详见 references/ram-policies.md。
适用场景:需要集中管理应用凭据、API 密钥、令牌与私钥,并希望实现版本控制与自动轮转的云上场景。限制:依赖 Aliyun CLI 与相应 RAM 权限;托管凭据等高级功能详见 references/managed-credentials.md;具体收费与平台细节暂未提供。