Skip to main content

API Key 泄露排查

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 層面的操作事件記錄

建議按以下順序推進:
Suspected leak
  ├─ Step 1: locate the key and immediately reset or delete it (containment)
  ├─ Step 2: identify anomalous periods from usage and cost curves
  ├─ Step 3: confirm call sources and behavior in audit logs (input and output available if inference logs were enabled)
  ├─ Step 4: review management operations such as key creation and deletion
  └─ Step 5: summarize the damage, rotate credentials, and fix the leak source

第一步:定位並處置泄露的 Key

前往阿里雲百鍊API Key頁面,在右上角選擇地區:各地區的 Key 相互獨立,不能跨地區混用。 已確認泄露時,優先重設或刪除該 Key 立即止損;編輯收窄許可權僅適合尚無法確認泄露、需要觀察期的情境。在 API Key 清單中找到目標 Key,在其操作欄執行:
  • 重設:為該 Key 換發新值,舊值隨即失效。
  • 編輯:收窄許可權(IP 白名單、模型範圍),參見API Key 防泄露最佳實務。
  • 刪除:立即失效、無法恢復。
  • 查看費用:跳轉到該 Key 的費用與用量檢視。
該頁面可查到 Key 的身份資訊:Key ID、脫敏後的 API Key(如 sk-ws-H.YHXL****PgonKozeC4RM-Nm)、描述、歸屬帳號、建立時間。描述與歸屬帳號是定位 Key 歸屬應用或負責人的第一線索;完整明文通常無法查看:新版 Key 僅建立時完整顯示一次,部分舊版 Key 仍可在清單中直接複製,以清單實際提供的能力為準。排查時用脫敏值、ID 與描述比對。
刪除 Key 不會取消已關聯的非同步任務:未執行完的非同步任務仍會繼續執行並產生費用,需另行終止,參見非同步任務欠費計費說明。排查期間也可為該 Key 開啟預算的「達到預算後立即停止」作為第二道止損,參見預算管理。
處置時注意兩個易踩的誤區:
  1. 僅建立新 Key不會使舊 Key 自動失效,舊 Key 必須單獨處置。
  2. 不要把新 Key 放回尚未排查完成的可疑環境,否則等於把新憑證再次交出去。

第二步:查用量與費用,鎖定異常時段

泄露最直接的訊號是不該出現的調用量或費用。在百鍊控制台費用用量 > 模型用量頁面,將分組維度設為 API Key,即可對比各 Key 的調用量,一眼看出哪個 Key 異常:
  • 時間粒度:分鐘(最多查 1 天)、小時(最多 7 天)、天(最多 31 天)、月(最多 12 個月);定位突發高額調用用小時粒度。
  • 資料延遲:調用次數延遲約 1 分鐘內,Token 用量與費用約延遲 10 分鐘;剛發生的濫用可能稍後才體現,不要因暫時無資料排除嫌疑。
  • 明細行可點擊查看費用關聯金額;費用概覽與賬單核算參見查看費用概覽與查詢賬單。
指標口徑與操作詳情參見查看模型用量。 排查時先排除正常業務波動:將異常時間、模型、調用量與業務的發布、批次處理、壓力測試、定時任務對照,並核查使用該 Key 的服務部署地區、出口 IP 與第三方工具是否發生變化。境外 IP、新 IP、用量突增都是需要核查的訊號,不是泄露的定案證據。處置力度與懷疑程度匹配:僅有告警通知或輕度異常時,先用審計日誌核對調用來源;用量曲線確認存在陌生來源調用後,立即重設或刪除該 Key 再繼續取證。 建議以泄露確認時間為終點,向前回看 7 天(小時粒度)與 31 天(天粒度),對比該 Key 的歷史基線;鎖定的異常時間窗即後續日誌排查的範圍。

第三步:查調用日誌,確認調用行為

百鍊的調用日誌分為審計日誌與推理日誌兩類,能力邊界不同,排查時要分清。

審計日誌

審計日誌預設開啟、儲存在平台側,無須配置,是排查主力,可在模型監控頁面查看:
  • 記錄欄位: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 狀態與操作歷史,再結合調用日誌排查具體行為。

第五步:定損、取證與恢復

  1. 彙總定損:異常時間窗(用量曲線)加上調用來源與狀態(審計日誌)加上金額(賬單),形成影響面結論。
  2. 圈定影響面:按 Key 的授權範圍評估。持有百鍊 API Key 不等同於獲得帳號密碼或全部雲資源許可權,實際影響限於該 Key 的授權調用範圍。注意百鍊 API Key 與阿里雲 AccessKey(AK)不是同一種憑證:若泄露的是 AK,應走 RAM 的 AK 處理流程。
  3. 留存脫敏證據:保存截圖與 Request ID 清單時,對 Key 值、帳號 ID 做脫敏,不再在任何管道傳播完整 Key。
  4. 核對非同步任務:刪除 Key 不取消已提交的非同步任務,需終止可取消任務並追蹤不可取消任務的費用。
  5. 確定輪換範圍:已確認泄露的 Key 儘快失效並替換;其餘 Key 按暴露範圍判斷,與多個 Key 保存在同一已暴露環境中的,一併輪換並修復環境。
  6. 恢復順序:參照高危位置清單修復泄露源後,在可信環境建立新 Key 並重新配置許可權與預算,更新各服務端、任務與第三方整合的憑證引用,確認新 Key 調用正常,最後核對舊 Key 已失效。
異常費用未查清前,不要簡單提高預算或關閉止損配置後恢復調用,應先完成上述排查確認泄露源已修復。

常見問題

檢測與通知存在時間差,不能僅憑通知時間判斷異常是否仍在持續;歷史事件也可能在後續核查時才被發現並通知。收到通知不等同於舊 Key 仍能成功調用:如已處置舊 Key 且近期用量無異常,可核對通知對應的調用時間與 Key 標識後忽略。
不能僅憑重複次數確認泄露。請核對每次告警對應的調用時間、Key 標識與異常內容,區分新發生的調用、同一事件的再次通知與歷史記錄。
平台風險檢測與告警是平台主動提供的能力,不在 SLA 約定的服務範圍內,受風險情境複雜性所限不承諾絕對的告警覆蓋率;憑證的安全保管與合規使用屬於您的責任範疇。未收到告警不代表沒有泄露風險,請先按本文步驟完成疑似泄露 Key 的排查與處置,再結合異常時間與通知記錄核實告警未送達的原因。
不能。新版 Key 僅建立時完整顯示一次,之後無法再查看或複製完整明文(部分舊版 Key 仍可在清單中直接複製,以清單實際提供的能力為準)。
推理日誌只對未來資料生效,歷史資料不可追溯。此前的調用只能透過審計日誌的欄位級資訊排查。
Token 用量與費用約有 10 分鐘延遲;且用量頁僅統計按 Token 後付費的調用,模型訓練、預置吞吐(PTU)等不在其中。失敗次數、限流錯誤等指標在模型監控頁查看。
兩者都返回 429。預算耗盡的錯誤資訊為「您在『預算管理』中設定的預算額度已用盡……」,參見錯誤碼;限流 429 由限流或額度限制觸發,可在模型監控中查看限流錯誤次數指標區分。
自有分析需求請透過日誌投遞到您自有的 SLS 日誌庫,在日誌庫中檢索與匯出,參見資料投遞。
兩者不是同一種憑證:百鍊 API Key 僅用於存取其授權範圍內的模型服務;阿里雲 AccessKey 用於雲 API 身份認證,許可權由帳號與授權配置決定。先確認泄露的憑證類型,再進入對應產品的管理入口處理,不要混用流程。