禁用 API 密钥是高安全优先级操作,禁用后所有使用该密钥的请求将被立即拒绝。以下是子账号自助禁用的完整流程,含权限要求、操作步骤与安全规范。
一、前提条件(必须满足)
- 权限要求:主账号已授予子账号包含
cam:DisableApiKey权限的策略(推荐:QcloudCollApiKeyManageAccess预设策略,或之前提供的自定义 CDN 查询策略)
- 自定义策略需包含以下权限片段:
{
"effect": "allow",
"action": ["cam:DisableApiKey"],
"resource": ["*"]
}
- 操作范围:子账号只能禁用自己的API 密钥,无法操作其他账号密钥
- 安全验证:子账号需完成身份验证(验证码 / MFA,主账号已开启安全设置)
二、控制台自助禁用步骤(30 秒完成)
- 子账号登录腾讯云控制台,进入API 密钥管理页(或通过:访问管理 CAM → 左侧菜单「访问密钥」→「API 密钥管理」)
- 在 API 密钥列表中,找到目标密钥(状态为启用)
- 点击密钥右侧操作列的禁用按钮
- 在弹出的确认窗口中,完成身份验证(短信验证码 / MFA),点击确认禁用
- 验证结果:密钥状态变为已禁用,表示操作成功Tencent Cloud
操作截图示意
| 步骤 |
界面特征 |
| 进入管理页 |
显示子账号名下所有 API 密钥,含 SecretId、状态、创建时间 |
| 点击禁用 |
启用状态的密钥显示「禁用」按钮,禁用状态显示「启用」按钮 |
| 身份验证 |
弹出窗口要求输入验证码或 MFA 动态密码 |
| 操作成功 |
密钥状态列显示「已禁用」,背景色变灰 |
三、API/CLI 禁用方法(批量 / 自动化场景)
1. 腾讯云 CLI 命令
# 安装腾讯云CLI(已安装可跳过)
pip install tccli
# 禁用当前子账号的API密钥(无需指定TargetUin,默认操作自己的密钥)
tccli cam DisableApiKey --SecretId AKIDz8krbsJ5yKBZQpn74WFkmLPx3******* --Version 2019-01-16
参数说明:
- SecretId:必填,指定要禁用的 API 密钥 ID
2. API 调用示例(Python SDK)
import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.cam.v20190116 import cam_client, models
# 配置子账号凭证(使用待禁用密钥或其他有效密钥)
cred = credential.Credential("子账号SecretId", "子账号SecretKey")
httpProfile = HttpProfile()
httpProfile.endpoint = "cam.tencentcloudapi.com"
clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile
client = cam_client.CamClient(cred, "", clientProfile)
# 构建请求
req = models.DisableApiKeyRequest()
params = {
"SecretId": "要禁用的SecretId"
}
req.from_json_string(json.dumps(params))
# 发送请求并获取结果
resp = client.DisableApiKey(req)
print(resp.to_json_string())
四、禁用后的状态与影响
| 状态变化 |
具体影响 |
恢复方法 |
| 密钥状态 |
从「启用」变为「已禁用」 |
点击「启用」按钮可恢复使用 |
| API 调用 |
所有使用该密钥的请求返回401 Unauthorized |
恢复启用或创建新密钥 |
| 业务影响 |
依赖该密钥的程序、脚本、工具将中断 |
紧急恢复启用或替换新密钥 |
| 安全审计 |
操作记录会被记录在「操作审计 CloudAudit」中 |
可通过 EventName=DisableApiKey 查询 |
五、安全操作规范(生产环境必执行)
1. 禁用前检查(避免业务中断)
- ✅ 查看密钥最近使用记录(API 密钥管理页 → 「最近使用」列)
- ✅ 通知相关团队密钥即将禁用(开发 / 运维 / 测试)
- ✅ 准备备用密钥(如需要,提前创建新密钥备用)
2. 禁用操作安全措施
- ✅ 启用 MFA 双重验证(主账号在 CAM → 安全设置中开启)
- ✅ 记录操作详情(操作人、时间、SecretId)
- ✅ 禁用后立即检查业务状态(确保无关键服务依赖该密钥)
3. 常见问题与解决方案
| 问题 |
原因 |
解决方法 |
| 看不到「禁用」按钮 |
子账号无cam:DisableApiKey权限 |
主账号为其添加QcloudCollApiKeyManageAccess策略 |
| 禁用失败:身份验证错误 |
验证码 / MFA 输入错误或过期 |
重新获取验证码,核对 MFA 动态密码 |
| 禁用后业务中断 |
有未发现的服务依赖该密钥 |
临时恢复启用,排查依赖并更新为新密钥 |
六、快速操作清单(1 分钟核对)
✅ 确认要禁用的密钥 SecretId 和当前状态(启用)
✅ 检查子账号是否有 cam:DisableApiKey权限
✅ 通知相关团队密钥即将禁用
✅ 完成身份验证并执行禁用
✅ 验证密钥状态已变为「已禁用」
✅ 记录操作并更新密钥管理文档 |