AI API 金鑰應該放在哪裡?
把憑據從瀏覽器、程式碼倉庫和日常日誌中移開,降低意外洩露的影響。

瀏覽器不是金鑰保險箱
寫進前端程式碼的金鑰,載入應用的人都可能看到;即使它來自構建時環境變數也一樣。把有許可權的 API 憑據儲存在你控制的伺服器。瀏覽器呼叫經過身份驗證的後端,由後端檢查使用者許可權後再發起上游請求。
畫出一次請求的路徑:使用者瀏覽器訪問你的後端,後端讀取金鑰並向 API 發起請求,再把需要的結果返回瀏覽器。金鑰不應進入 HTML、前端指令碼、移動端公開配置或帶有查詢引數的連結。即使使用 HTTPS,接收程式碼的一方仍可能讀取其中的值;傳輸加密不能把公開客戶端變成秘密儲存。
為不同環境使用獨立金鑰
開發和生產應使用不同憑據;平臺支援時,也可以按應用或團隊分開。將金鑰放在環境配置或專用金鑰管理服務中,不要提交到倉庫,也不要貼上到公開問題裡。只賦予工作負載實際需要的許可權和額度。
開發、測試和生產儘量使用不同的金鑰;條件允許時,再按應用或團隊劃分。這樣某一把金鑰洩露時,可以更快確定影響範圍並單獨撤銷。使用平臺支援的許可權、額度和訪問限制,避免一把高許可權金鑰被多個無關服務長期共用。記錄金鑰的負責人和用途,但不要在登記表中儲存明文。
保護 API 金鑰,並讓它與公開的應用程式程式碼分開。讓意外洩露可以恢復
金鑰一旦出現在截圖、日誌或公開提交中,就應視為已經洩露:撤銷或輪換金鑰、部署替換值,並檢查相關使用記錄。只從最新一次提交中刪掉文字並不夠,因為舊值可能仍在歷史記錄裡。事先明確誰負責輪換以及如何聯絡。
發生洩露時,先限制或撤銷受影響金鑰,建立並部署替代憑據,再檢查相關用量和訪問記錄。提前演練金鑰替換能減少事故中的慌亂;但不要把新金鑰寫入聊天、工單或截圖。若某個服務無法立即切換,明確責任人和過渡步驟,並持續監控,直到舊憑據不再被使用。
別忽略周邊環節
從日誌、錯誤報告和支援訊息中移除授權頭與憑據;檢查代理配置、CI 輸出以及第三方整合。簡短且真正會用的處置步驟,加上定期檢查訪問許可權,通常比無人維護的長篇制度更有幫助。具體控制能力請以平臺最新文件為準。
除了原始碼,還要檢查構建產物、CI 輸出、錯誤監控、代理日誌和截圖。授權頭、完整請求體及環境變數可能在排障時被意外列印。為日誌做脫敏,並只保留定位問題所需的資訊;對外求助時提供請求標識、時間和脫敏錯誤即可。發現敏感資訊已進入公開倉庫時,也要考慮歷史提交和快取副本。
人員、應用和部署環境會變化,曾經合理的訪問許可權也可能過期。定期檢查不再使用的金鑰、過大的許可權範圍和異常用量,並及時撤銷無需保留的訪問。具體限制能力以平臺實際提供的設定為準。金鑰安全也依賴賬戶登入保護、伺服器許可權和依賴管理,單靠隱藏字串不能解決所有問題。
先找到金鑰可能出現的位置
檢查程式碼倉庫、部署配置、持續整合日誌、工單、截圖和瀏覽器開發者工具。前端構建工具中的環境變數並不自動保密:只要變數被打包進傳送給瀏覽器的程式碼,訪問頁面的人就可能看到它。移動應用和桌面客戶端也可能被反編譯,因此不適合長期儲存可以代表服務端呼叫的高許可權金鑰。
更穩妥的方式是讓客戶端訪問自己的後端,由後端完成使用者身份檢查、輸入校驗和額度控制,再從環境變數或金鑰管理服務讀取憑據。金鑰不應出現在網址查詢引數裡,因為網址可能被代理、瀏覽器歷史或監控系統記錄。錯誤資訊也應避免回顯請求頭。
開發、測試和生產儘可能使用各自的憑據,按實際可用能力限制許可權、額度和有效期。這樣一個環境出問題時,更容易判斷影響範圍並單獨處理。團隊成員離開、專案下線或憑據用途改變時,也應及時檢查是否仍然需要這些訪問許可權。
準備一次可執行的輪換流程
先確認誰能建立和停用金鑰、應用從哪裡讀取它、哪些服務依賴它。生成替代憑據後,透過安全的配置渠道更新服務,驗證新憑據能夠完成一條最小請求,再按實際平臺提供的機制停用舊憑據。不要把新舊金鑰同時貼上到群聊或工單裡,也不要在日誌中列印完整值。
如果金鑰已經公開,不要先花很久尋找責任人。優先限制或停用受影響憑據,檢查可疑用量,並更新依賴它的服務。隨後再確定洩露入口,例如公開提交、除錯截圖或錯誤的構建配置。單純刪除倉庫中的一行通常不足以讓已洩露的憑據失效,因為歷史記錄或快取可能仍然存在。
演練時可以使用專門的測試憑據,確認監控、通知和配置更新確實有效。把步驟寫成團隊可執行的記錄,但不要把真實金鑰寫進去。具體停用順序要考慮平臺是否允許憑據重疊、服務是否支援無中斷切換,以及當前事件的風險程度。
讓保護措施適應日常工作
為不同用途建立容易識別的憑據名稱,並指定負責人。只在需要的執行環境提供金鑰,定期清理不再使用的配置。程式碼審查和自動掃描可以幫助發現誤提交,但掃描不能替代最小許可權和輪換;出現告警後應核實並處理,而不是簡單忽略。
監控側關注與業務相符的異常,例如不尋常的用量增長、未知來源或持續的認證失敗。告警資訊可以包含憑據的非敏感標識、時間和錯誤類別,但不能包含完整金鑰。檢視日誌時也要遵守實際的資料訪問許可權,避免把安全工具變成新的洩露來源。
一個簡單的上線檢查是:在構建後的前端檔案、示例配置和截圖中搜尋憑據字首;驗證失效金鑰無法繼續呼叫;確認負責人知道如何輪換。檢查結果應和部署日期一起記錄。安全不是一次性勾選,而是一套能在人員和服務變化後繼續執行的日常習慣。
如果第三方服務需要訪問你的系統,優先為它準備獨立憑據,並確認服務結束後如何撤銷。不要因為一個整合方便,就把生產環境的通用金鑰複製到多個無法審計的位置;許可權範圍越清楚,排查和輪換越容易。
上線前做一次小檢查
釋出前檢查前端產物和倉庫歷史中是否意外包含憑據,確認生產環境使用獨立金鑰,再從後端傳送一次小請求。檢查錯誤報告是否隱藏授權頭。如果金鑰已經洩露,應先輪換並檢查使用情況,不能只刪掉看得見的文字。
為每套服務明確誰可以建立和撤銷金鑰、誰負責部署更新、誰檢查異常使用。許可權交接時同步更新記錄並移除不再需要的訪問。演練時只使用測試憑據,避免把真實生產金鑰複製到演示文件;負責人變更後,也要確認緊急聯絡渠道仍然有效。