Bologu

API 金鑰在網頁中外洩:如何檢查、該立刻做什麼

更新於 · Bologu 團隊

請 AI「幫我串接 OpenAI」,最常得到的結果就是直接在網頁呼叫 OpenAI、金鑰就寫在程式碼裡的寫法。應用程式馬上能用,但每個打開網站的人也都拿到了你的金鑰。 掃描金鑰的機器人全天候運作,外洩的金鑰常在幾天內就被刷出龐大的帳單。

金鑰是怎麼跑進網頁裡的

  • 帶有公開前綴的變數:NEXT_PUBLIC_, VITE_, REACT_APP_, EXPO_PUBLIC_ 都會被打包進送給瀏覽器的 JavaScript。只要這樣命名,任何人都看得到它的值。
  • 直接寫在程式碼裡的金鑰:AI「暫時」放進去,之後沒有人拿掉。
  • 沒有關閉的 source map:.map 檔會讓別人看到原始程式碼,包括註解與不該被看到的值。
  • 提交到 GitHub 的 .env 檔:尤其是公開的 repo。

哪些金鑰可以放在網頁,哪些不行

網頁中看到的金鑰不一定都有問題,有些本來就設計成可以公開:

  • 可以放在網頁:Stripe publishable key(pk_live_…)、Supabase publishable / anon key(前提是RLS 設定正確)、Firebase 網頁設定、已限制網域的 Google Maps 金鑰。
  • 絕對不能放在網頁:Stripe secret key(sk_live_…)、OpenAI(sk-…)、Anthropic、Supabase secret / service_role、 GitHub token、簡訊或電子郵件服務的金鑰,以及資料庫密碼。

簡單的原則:只要金鑰能花錢、能讀取所有資料或能略過權限檢查,就只能放在伺服器上。

自行檢查有沒有金鑰外洩

  1. 用 Chrome 開啟你的網站,按 F12 並切換到 Sources 分頁。
  2. 按 Ctrl+Shift+F(Mac:Cmd+Option+F)搜尋所有檔案,逐一搜尋:sk-、sk_live、service_role、secret、api_key。
  3. 檢查結尾為 .map 的檔案能否載入,如果可以,請在正式環境關閉 source map。
  4. 在 GitHub 用 repo 的搜尋功能搜尋同樣的字詞,並確認 repo 裡沒有 .env 檔。

金鑰已經外洩時,請依序處理

  1. 先到服務供應商撤銷或更換金鑰:進入供應商的 API keys 頁面,按 Revoke 或 Roll。只從程式碼刪除金鑰沒有用,已經拿到金鑰的人仍然可以使用。
  2. 查看過去的用量:打開 Usage 或 Billing 頁面,確認是否有不是你的使用紀錄。若有,請立即聯絡供應商。
  3. 設定費用上限:在 Billing 頁面設定每月額度與電子郵件通知。
  4. 把呼叫移到伺服器:讓網頁呼叫你自己的 API(例如 /api/chat),再由伺服器使用存放在環境變數(不帶公開前綴)中的金鑰呼叫 OpenAI。
  5. 在伺服器端限制用量:檢查登入、限制每位使用者的呼叫次數,並設定 max_tokens,否則別人仍可透過你的 API 免費使用 AI。
  6. 若曾提交金鑰,清理 git 歷史:使用 git filter-repo 或 BFG。但即使清理過,仍要視為金鑰已外洩,所以第 1 步最重要。

給 AI 的修正提示詞

My frontend calls the OpenAI API directly with the key in browser code.
1. Move every AI call to a server route (e.g. /api/chat) that reads the key from a
   server-only environment variable (no NEXT_PUBLIC_ / VITE_ prefix).
2. In that route: require login, rate-limit per user, cap input length and set max_tokens.
3. Remove the key from all client code and .env files that are bundled for the browser.
Do not print or log the key anywhere.

讓 Bologu 幫你檢查

網站掃描(免費)會在網頁載入的所有 JavaScript 檔案與 source map 中,搜尋超過 20 種常見服務的金鑰,並告訴你哪些可以公開、哪些必須立即更換。GitHub 程式碼檢測 則能找出提交進 repo 的金鑰,以及不該出現在 repo 中的 .env 檔。