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、簡訊或電子郵件服務的金鑰,以及資料庫密碼。
簡單的原則:只要金鑰能花錢、能讀取所有資料或能略過權限檢查,就只能放在伺服器上。
自行檢查有沒有金鑰外洩
- 用 Chrome 開啟你的網站,按 F12 並切換到 Sources 分頁。
- 按 Ctrl+Shift+F(Mac:Cmd+Option+F)搜尋所有檔案,逐一搜尋:
sk-、sk_live、service_role、secret、api_key。 - 檢查結尾為
.map的檔案能否載入,如果可以,請在正式環境關閉 source map。 - 在 GitHub 用 repo 的搜尋功能搜尋同樣的字詞,並確認 repo 裡沒有
.env檔。
金鑰已經外洩時,請依序處理
- 先到服務供應商撤銷或更換金鑰:進入供應商的 API keys 頁面,按 Revoke 或 Roll。只從程式碼刪除金鑰沒有用,已經拿到金鑰的人仍然可以使用。
- 查看過去的用量:打開 Usage 或 Billing 頁面,確認是否有不是你的使用紀錄。若有,請立即聯絡供應商。
- 設定費用上限:在 Billing 頁面設定每月額度與電子郵件通知。
- 把呼叫移到伺服器:讓網頁呼叫你自己的 API(例如
/api/chat),再由伺服器使用存放在環境變數(不帶公開前綴)中的金鑰呼叫 OpenAI。 - 在伺服器端限制用量:檢查登入、限制每位使用者的呼叫次數,並設定
max_tokens,否則別人仍可透過你的 API 免費使用 AI。 - 若曾提交金鑰,清理 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 檔。
