查看 API 密钥需区分主账号代查和子账号自查两种场景,核心差异在于:主账号可查看子账号的SecretId(无法查看 SecretKey),子账号可查看自己的SecretId,但SecretKey 仅在创建时可见一次,后续无法再次查看。以下是完整操作指南与安全规范。
一、主账号查看子账号 API 密钥(代查权限)
前提条件
- 主账号拥有cam:ListApiKeys和cam:GetApiKey权限(默认拥有管理员权限)
- 知道目标子账号的用户名 / UIN
控制台操作步骤(1 分钟完成)
- 主账号登录腾讯云控制台,进入访问管理 CAM
- 左侧菜单:用户 → 用户列表
- 找到目标子账号,点击用户名进入详情页
- 切换至API 密钥标签页,查看子账号所有 API 密钥信息腾讯云
- 可查看:SecretId、密钥状态(启用 / 禁用)、创建时间、最近使用时间
- 不可查看:SecretKey(出于安全,腾讯云不存储明文 SecretKey)
- 如需复制 SecretId,点击密钥右侧复制按钮
API/CLI 查询方法(批量场景)
# 安装腾讯云CLI(已安装可跳过)
pip install tccli
# 查询指定子账号的API密钥列表(仅返回SecretId)
tccli cam ListApiKeys --Version 2019-01-16 --TargetUin 100000000001
参数说明:
- TargetUin:必填,子账号的 UIN(主账号查询子账号密钥时必须指定)
- 返回结果:包含子账号所有 API 密钥的 SecretId、状态、创建时间等信息
二、子账号自助查看 API 密钥(自查权限)
前提条件
- 主账号已授予子账号QcloudCollApiKeyManageAccess预设策略(或包含
cam:ListApiKeys权限的自定义策略)
- 子账号只能查看自己的API 密钥,无法查看其他账号密钥
控制台操作步骤(30 秒完成)
- 子账号登录腾讯云控制台,进入API 密钥管理页(或通过:访问管理 CAM → 左侧菜单「访问密钥」→「API 密钥管理」)
- 在 API 密钥列表中,查看自己的密钥信息腾讯云
- 可查看:SecretId、密钥状态、创建时间、最近使用记录
- 不可查看:SecretKey(创建后无法再次查看,需提前保存)
- 如需复制 SecretId,点击右侧复制按钮
权限验证方法
子账号登录后,若能看到 API 密钥管理页面的密钥列表,说明权限已正确授予;若看不到,需主账号检查并添加QcloudCollApiKeyManageAccess策略。
三、API 密钥查看的核心限制与安全设计
| 查看主体 |
可查看内容 |
不可查看内容 |
安全设计目的 |
| 主账号 |
SecretId、密钥状态、使用记录 |
SecretKey |
防止主账号权限过大导致密钥泄露 |
| 子账号 |
SecretId、密钥状态、使用记录 |
SecretKey(创建后不可见) |
避免密钥长期暴露,降低泄露风险 |
| 所有账号 |
无 |
明文 SecretKey |
腾讯云仅存储 SecretKey 的加密哈希值,不存储明文 |
关键提示:SecretKey 的查看时机
- SecretKey 仅在创建时可见一次,创建成功后页面会提示 “请立即保存 SecretId 和 SecretKey,SecretKey 将无法再次显示”
- 若子账号未保存 SecretKey,无法通过任何方式找回,只能通过 “重置 API 密钥” 生成新密钥(会导致旧密钥失效)
四、查看密钥的安全操作规范(生产环境必执行)
1. 查看前安全检查
- ✅ 确认操作必要性(避免无关人员查看密钥信息)
- ✅ 启用主账号 MFA 双重验证(CAM → 安全设置中开启)
- ✅ 记录查看操作(操作人、时间、SecretId)
2. 密钥信息管理规范
- ✅ 禁止截图保存 SecretId(避免泄露)
- ✅ 复制 SecretId 后立即粘贴到安全文档(如加密的密码管理器)
- ✅ 定期清理未使用的密钥(降低安全风险)
3. 常见问题与解决方案
| 问题 |
原因 |
解决方法 |
| 子账号看不到 API 密钥管理页面 |
缺少cam:ListApiKeys权限 |
主账号为其添加QcloudCollApiKeyManageAccess策略 |
| 主账号无法查看子账号密钥 |
主账号权限不足 |
检查主账号是否拥有管理员权限,或添加QcloudCamFullAccess策略 |
| 子账号忘记 SecretKey |
SecretKey 创建后未保存 |
子账号自助重置 API 密钥(生成新密钥,旧密钥失效) |
| 主账号需要子账号 SecretKey |
主账号无法查看 SecretKey |
让子账号自行重置 API 密钥,并提供新的 SecretKey(需验证身份) |
五、快速操作清单(1 分钟核对)
✅ 确认查看场景(主账号代查 / 子账号自查)
✅ 检查账号权限(主账号管理员权限 / 子账号 API 密钥管理权限)
✅ 进入对应页面(子账号详情页 / API 密钥管理页)
✅ 查看并复制 SecretId(不涉及 SecretKey)
✅ 记录操作并关闭页面(防止密钥信息暴露) |