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