API Key 疑似泄露後的排查路徑:定位並處置泄露 Key 止損,查用量與費用鎖定異常時段,查審計日誌與推理日誌確認調用行為,透過操作審計核對管理操作,完成定損取證與輪換恢復。
排查思路
若已確認泄露,請先前往API Key 管理頁面重設或刪除泄露的 Key 立即止損,再按本頁步驟排查影響面;尚不確定是否泄露時,從第二步的用量核對開始。
泄露排查要回答五個問題,每個問題對應一個控制台資訊來源:
要回答的問題 | 查詢入口 | 能得到什麼 |
|---|---|---|
泄露的是哪個 Key?誰建立的?現在什麼狀態? | API Key 管理頁面 | Key ID、脫敏 Key、描述、歸屬帳號、建立時間;重設、編輯、刪除、查看費用操作 |
這個 Key 被調用了多少、花了多少錢? | 模型用量、費用概覽與賬單 | 按 API Key 分組的調用次數、Token 用量、按天粒度的用量曲線、金額 |
調用從哪來、調用了什麼模型、成功還是失敗? | 審計日誌 | Request ID、時間、模型、Token 用量、延遲、狀態碼、錯誤碼;可按 API Key 篩選 |
調用的輸入輸出內容是什麼? | 推理日誌(需事先開啟) | 完整 Prompt 與 Response(長度上限 128K) |
這個 Key 經歷過哪些管理操作? | 操作審計 ActionTrail | 控制台與 OpenAPI 層面的操作事件記錄 |
第一步:定位並處置泄露的 Key
前往阿里雲百鍊API Key頁面,在右上角選擇地區:各地區的 Key 相互獨立,不能跨地區混用。
已確認泄露時,優先重設或刪除該 Key 立即止損;編輯收窄許可權僅適合尚無法確認泄露、需要觀察期的情境。在 API Key 清單中找到目標 Key,在其操作欄執行:
- 重設:為該 Key 換發新值,舊值隨即失效。
- 編輯:收窄許可權(IP 白名單、模型範圍),參見API Key 防泄露最佳實務。
- 刪除:立即失效、無法恢復。
- 查看費用:跳轉到該 Key 的費用與用量檢視。
- 僅建立新 Key不會使舊 Key 自動失效,舊 Key 必須單獨處置。
- 不要把新 Key 放回尚未排查完成的可疑環境,否則等於把新憑證再次交出去。
第二步:查用量與費用,鎖定異常時段
泄露最直接的訊號是不該出現的調用量或費用。在百鍊控制台費用用量 > 模型用量頁面,將分組維度設為 API Key,即可對比各 Key 的調用量,一眼看出哪個 Key 異常:
- 時間粒度:分鐘(最多查 1 天)、小時(最多 7 天)、天(最多 31 天)、月(最多 12 個月);定位突發高額調用用小時粒度。
- 資料延遲:調用次數延遲約 1 分鐘內,Token 用量與費用約延遲 10 分鐘;剛發生的濫用可能稍後才體現,不要因暫時無資料排除嫌疑。
- 明細行可點擊查看費用關聯金額;費用概覽與賬單核算參見查看費用概覽與查詢賬單。
第三步:查調用日誌,確認調用行為
百鍊的調用日誌分為審計日誌與推理日誌兩類,能力邊界不同,排查時要分清。
審計日誌
審計日誌預設開啟、儲存在平台側,無須配置,是排查主力,可在模型監控頁面查看:
- 記錄欄位:Request ID、時間、模型、Token 用量、延遲、狀態、錯誤碼,不包含輸入輸出內容。
- 篩選與搜尋:按時間(最長 30 天)、模型、API Key ID、狀態、推理類型篩選,或按 Request ID 搜尋。
- 用途:確認泄露時間窗內該 Key 的調用是否來自預期行為,例如大量 4xx/5xx、異常的調用節奏、陌生模型的調用記錄。
推理日誌
推理日誌包含完整的 Prompt 與 Response 及中間步驟(長度上限 128K),需要事先在資料投遞中開啟並投遞到您自有日誌服務(SLS,開啟涉及雲產品授權與日誌服務費用),只對未來資料生效:開啟前的歷史調用無法追溯,關閉期間產生的日誌不補錄。開啟方法與地區支援參見開啟推理日誌。未開啟推理日誌時,此前的調用只能透過審計日誌的欄位級資訊排查。
溯源邊界
平台可基於調用日誌協助核查異常行為,但調用 IP、模型與時間資訊通常不足以直接確認真實使用者或最初泄露管道,進一步溯源需要您側的程式碼存放庫、伺服器、終端與第三方服務證據。排查的交付物是證據鏈與影響面,而不是定責結論;涉及違法行為的,依法保留證據並透過適當管道處理。
第四步:查管理操作歷史
API Key 的建立、刪除等生命週期操作統一彙集到阿里雲操作審計(ActionTrail)。前往操作審計控制台的事件查詢頁面,按服務(百鍊)與時間範圍篩選:
- 查找 Key 的建立事件,確認這個 Key 是誰、在什麼時間建立的,核對歸屬責任。
- 查找 Key 的刪除事件,確認泄露時間窗前後是否有人刪除過 Key,例如攻擊者或內部人員試圖抹除痕跡。
第五步:定損、取證與恢復
- 彙總定損:異常時間窗(用量曲線)加上調用來源與狀態(審計日誌)加上金額(賬單),形成影響面結論。
- 圈定影響面:按 Key 的授權範圍評估。持有百鍊 API Key 不等同於獲得帳號密碼或全部雲資源許可權,實際影響限於該 Key 的授權調用範圍。注意百鍊 API Key 與阿里雲 AccessKey(AK)不是同一種憑證:若泄露的是 AK,應走 RAM 的 AK 處理流程。
- 留存脫敏證據:保存截圖與 Request ID 清單時,對 Key 值、帳號 ID 做脫敏,不再在任何管道傳播完整 Key。
- 核對非同步任務:刪除 Key 不取消已提交的非同步任務,需終止可取消任務並追蹤不可取消任務的費用。
- 確定輪換範圍:已確認泄露的 Key 儘快失效並替換;其餘 Key 按暴露範圍判斷,與多個 Key 保存在同一已暴露環境中的,一併輪換並修復環境。
- 恢復順序:參照高危位置清單修復泄露源後,在可信環境建立新 Key 並重新配置許可權與預算,更新各服務端、任務與第三方整合的憑證引用,確認新 Key 調用正常,最後核對舊 Key 已失效。
常見問題
泄露的 Key 已經刪除了,為什麼還會收到告警?
泄露的 Key 已經刪除了,為什麼還會收到告警?
同一個 Key 重複收到告警,是否等於確認泄露?
同一個 Key 重複收到告警,是否等於確認泄露?
發生泄露卻沒有收到平台告警,為什麼?
發生泄露卻沒有收到平台告警,為什麼?
為什麼控制台看不到完整 Key,能否請客服查明文?
為什麼控制台看不到完整 Key,能否請客服查明文?
剛開啟推理日誌,為什麼查不到昨天的輸入輸出?
剛開啟推理日誌,為什麼查不到昨天的輸入輸出?
用量頁資料和實際調用對不上?
用量頁資料和實際調用對不上?
調用返回 429,是被限流還是被預算停止?
調用返回 429,是被限流還是被預算停止?
能否把日誌批次匯出做自己的分析?
能否把日誌批次匯出做自己的分析?
怎麼確認泄露的是百鍊 API Key 還是阿里雲 AccessKey?
怎麼確認泄露的是百鍊 API Key 還是阿里雲 AccessKey?