獲取騰訊云 API 密鑰(SecretId 和 SecretKey)是調(diào)用所有騰訊云 API(包括 CDN 緩存預(yù)熱查詢)的必要前提。以下提供主賬號(hào)快速獲取和子賬號(hào)安全配置兩種方案,以及關(guān)鍵安全注意事項(xiàng)。
一、主賬號(hào)獲取 API 密鑰(快速入門)
這是最直接的方式,適合個(gè)人或小型團(tuán)隊(duì)快速開發(fā)測(cè)試。
步驟 1:登錄騰訊云控制臺(tái)
- 訪問騰訊云官網(wǎng)并登錄賬號(hào)
- 推薦直接訪問 API 密鑰管理頁(yè)面:https://console.cloud.tencent.com/cam/capi
步驟 2:進(jìn)入 API 密鑰管理
- 常規(guī)路徑:點(diǎn)擊右上角用戶頭像 → 選擇訪問管理(CAM)
- 在左側(cè)導(dǎo)航欄選擇訪問密鑰 → API 密鑰管理
步驟 3:創(chuàng)建新密鑰
- 點(diǎn)擊頁(yè)面中的新建密鑰按鈕(藍(lán)色)
- 系統(tǒng)會(huì)彈出確認(rèn)框,點(diǎn)擊確定生成密鑰
- 關(guān)鍵操作:立即復(fù)制并保存 SecretId 和 SecretKey 到安全位置
- ⚠️ SecretKey 僅在創(chuàng)建時(shí)顯示,關(guān)閉彈窗后無(wú)法再次查看
- 建議使用密碼管理器存儲(chǔ),避免泄露
步驟 4:驗(yàn)證密鑰可用性
創(chuàng)建后會(huì)在列表中顯示:
- 密鑰 ID(SecretId):公開標(biāo)識(shí),如
AKIDz8krbsJ5yKBZQpn74WFkmLPx3*******
- 狀態(tài):?jiǎn)⒂?/ 禁用
- 創(chuàng)建時(shí)間:精確到秒
二、子賬號(hào)獲取 API 密鑰(企業(yè)級(jí)安全推薦)
主賬號(hào)密鑰權(quán)限過大,生產(chǎn)環(huán)境強(qiáng)烈建議使用子賬號(hào),遵循最小權(quán)限原則。
步驟 1:創(chuàng)建子賬號(hào)
- 訪問管理 → 用戶 → 新建用戶
- 選擇自定義創(chuàng)建 → 輸入用戶名和描述
- 勾選編程訪問(API 訪問需要),可選控制臺(tái)訪問騰訊云
步驟 2:授權(quán)子賬號(hào) CDN 權(quán)限
- 進(jìn)入子用戶詳情頁(yè) → 權(quán)限標(biāo)簽
- 點(diǎn)擊添加權(quán)限 → 搜索并選擇QcloudCDNFullAccess(CDN 全權(quán)限)或QcloudCDNReadOnlyAccess(只讀權(quán)限)
- 確認(rèn)添加權(quán)限,確保子賬號(hào)僅能訪問必要資源騰訊云
步驟 3:為子賬號(hào)創(chuàng)建 API 密鑰
- 在子用戶詳情頁(yè) → API 密鑰標(biāo)簽
- 點(diǎn)擊新建密鑰 → 保存生成的 SecretId 和 SecretKey騰訊云
三、API 密鑰安全管理(必看)
| 安全措施 |
操作方法 |
風(fēng)險(xiǎn)說明 |
| 密鑰保密 |
永不分享密鑰,不在代碼中硬編碼 |
泄露可能導(dǎo)致賬號(hào)資源被惡意操作 |
| 定期輪換 |
每 90 天新建密鑰,禁用舊密鑰 |
降低長(zhǎng)期密鑰泄露風(fēng)險(xiǎn) |
| 最小權(quán)限 |
使用子賬號(hào)并僅授權(quán)必要權(quán)限 |
限制密鑰泄露后的影響范圍 |
| 密鑰禁用 |
長(zhǎng)期不用時(shí)禁用,刪除前確認(rèn)無(wú)依賴 |
防止誤操作和安全風(fēng)險(xiǎn) |
| 操作審計(jì) |
開啟 CAM 操作日志,監(jiān)控密鑰使用 |
及時(shí)發(fā)現(xiàn)異常訪問行為 |
四、常見問題與排查
1. 找不到 "新建密鑰" 按鈕
- 原因:子賬號(hào)未被授權(quán)創(chuàng)建 API 密鑰
- 解決:主賬號(hào)需為子賬號(hào)添加
QcloudCamSubAccountAccessKeyFullAccess權(quán)限騰訊云
2. SecretKey 忘記保存
- 解決:無(wú)法找回已創(chuàng)建的 SecretKey,需新建密鑰并更新所有配置,同時(shí)禁用舊密鑰
3. 密鑰權(quán)限不足
- 解決:檢查子賬號(hào)權(quán)限策略,確保包含
QcloudCDNFullAccess或QcloudCDNReadOnlyAccess騰訊云
五、快速操作清單(5 分鐘完成)
- ✅ 登錄騰訊云 → 訪問 https://console.cloud.tencent.com/cam/capi
- ✅ 點(diǎn)擊 "新建密鑰" → 保存 SecretId 和 SecretKey
- ✅ 生產(chǎn)環(huán)境:創(chuàng)建子賬號(hào) → 授權(quán) CDN 權(quán)限 → 為子賬號(hào)創(chuàng)建密鑰
- ✅ 配置到代碼 / SDK 中,測(cè)試 API 調(diào)用
|