查看 API 密鑰需區(qū)分主賬號代查和子賬號自查兩種場景,核心差異在于:主賬號可查看子賬號的SecretId(無法查看 SecretKey),子賬號可查看自己的SecretId,但SecretKey 僅在創(chuàng)建時可見一次,后續(xù)無法再次查看。以下是完整操作指南與安全規(guī)范。
一、主賬號查看子賬號 API 密鑰(代查權限)
前提條件
- 主賬號擁有cam:ListApiKeys和cam:GetApiKey權限(默認擁有管理員權限)
- 知道目標子賬號的用戶名 / UIN
控制臺操作步驟(1 分鐘完成)
- 主賬號登錄騰訊云控制臺,進入訪問管理 CAM
- 左側菜單:用戶 → 用戶列表
- 找到目標子賬號,點擊用戶名進入詳情頁
- 切換至API 密鑰標簽頁,查看子賬號所有 API 密鑰信息騰訊云
- 可查看:SecretId、密鑰狀態(tài)(啟用 / 禁用)、創(chuàng)建時間、最近使用時間
- 不可查看:SecretKey(出于安全,騰訊云不存儲明文 SecretKey)
- 如需復制 SecretId,點擊密鑰右側復制按鈕
API/CLI 查詢方法(批量場景)
# 安裝騰訊云CLI(已安裝可跳過)
pip install tccli
# 查詢指定子賬號的API密鑰列表(僅返回SecretId)
tccli cam ListApiKeys --Version 2019-01-16 --TargetUin 100000000001
參數說明:
- TargetUin:必填,子賬號的 UIN(主賬號查詢子賬號密鑰時必須指定)
- 返回結果:包含子賬號所有 API 密鑰的 SecretId、狀態(tài)、創(chuàng)建時間等信息
二、子賬號自助查看 API 密鑰(自查權限)
前提條件
- 主賬號已授予子賬號QcloudCollApiKeyManageAccess預設策略(或包含
cam:ListApiKeys權限的自定義策略)
- 子賬號只能查看自己的API 密鑰,無法查看其他賬號密鑰
控制臺操作步驟(30 秒完成)
- 子賬號登錄騰訊云控制臺,進入API 密鑰管理頁(或通過:訪問管理 CAM → 左側菜單「訪問密鑰」→「API 密鑰管理」)
- 在 API 密鑰列表中,查看自己的密鑰信息騰訊云
- 可查看:SecretId、密鑰狀態(tài)、創(chuàng)建時間、最近使用記錄
- 不可查看:SecretKey(創(chuàng)建后無法再次查看,需提前保存)
- 如需復制 SecretId,點擊右側復制按鈕
權限驗證方法
子賬號登錄后,若能看到 API 密鑰管理頁面的密鑰列表,說明權限已正確授予;若看不到,需主賬號檢查并添加QcloudCollApiKeyManageAccess策略。
三、API 密鑰查看的核心限制與安全設計
| 查看主體 |
可查看內容 |
不可查看內容 |
安全設計目的 |
| 主賬號 |
SecretId、密鑰狀態(tài)、使用記錄 |
SecretKey |
防止主賬號權限過大導致密鑰泄露 |
| 子賬號 |
SecretId、密鑰狀態(tài)、使用記錄 |
SecretKey(創(chuàng)建后不可見) |
避免密鑰長期暴露,降低泄露風險 |
| 所有賬號 |
無 |
明文 SecretKey |
騰訊云僅存儲 SecretKey 的加密哈希值,不存儲明文 |
關鍵提示:SecretKey 的查看時機
- SecretKey 僅在創(chuàng)建時可見一次,創(chuàng)建成功后頁面會提示 “請立即保存 SecretId 和 SecretKey,SecretKey 將無法再次顯示”
- 若子賬號未保存 SecretKey,無法通過任何方式找回,只能通過 “重置 API 密鑰” 生成新密鑰(會導致舊密鑰失效)
四、查看密鑰的安全操作規(guī)范(生產環(huán)境必執(zhí)行)
1. 查看前安全檢查
- ✅ 確認操作必要性(避免無關人員查看密鑰信息)
- ✅ 啟用主賬號 MFA 雙重驗證(CAM → 安全設置中開啟)
- ✅ 記錄查看操作(操作人、時間、SecretId)
2. 密鑰信息管理規(guī)范
- ✅ 禁止截圖保存 SecretId(避免泄露)
- ✅ 復制 SecretId 后立即粘貼到安全文檔(如加密的密碼管理器)
- ✅ 定期清理未使用的密鑰(降低安全風險)
3. 常見問題與解決方案
| 問題 |
原因 |
解決方法 |
| 子賬號看不到 API 密鑰管理頁面 |
缺少cam:ListApiKeys權限 |
主賬號為其添加QcloudCollApiKeyManageAccess策略 |
| 主賬號無法查看子賬號密鑰 |
主賬號權限不足 |
檢查主賬號是否擁有管理員權限,或添加QcloudCamFullAccess策略 |
| 子賬號忘記 SecretKey |
SecretKey 創(chuàng)建后未保存 |
子賬號自助重置 API 密鑰(生成新密鑰,舊密鑰失效) |
| 主賬號需要子賬號 SecretKey |
主賬號無法查看 SecretKey |
讓子賬號自行重置 API 密鑰,并提供新的 SecretKey(需驗證身份) |
五、快速操作清單(1 分鐘核對)
✅ 確認查看場景(主賬號代查 / 子賬號自查)
✅ 檢查賬號權限(主賬號管理員權限 / 子賬號 API 密鑰管理權限)
✅ 進入對應頁面(子賬號詳情頁 / API 密鑰管理頁)
✅ 查看并復制 SecretId(不涉及 SecretKey)
✅ 記錄操作并關閉頁面(防止密鑰信息暴露) |