Architecture Delta · Security Specification

API 金鑰資安防護與前後端分層架構

新手開發 AI 應用最致命的直覺錯誤:「直接在前端 HTML / JS 中寫死 API Key」。 只要造訪者按一下滑鼠右鍵「檢視網頁原始碼」或按 F12,金鑰在 30 秒內就會被爬蟲抓走。本圖解以編輯級架構對比,示範如何透過 BFF(Backend-for-Frontend)後端代理 實現零信任資安隔離。

真實資安血淚代價

韓國開發者遭 Claude API 扣款 1,660 萬美元(約 5.3 億台幣): 開發者因程式碼缺乏預算熔斷機制、金鑰未於安全後端隔離,且遭外部併發循環觸發,短時間內累積上千億 Token 帳單。

新聞報導資料來源:動區動趨 BlockTempo · Anthropic 異常帳單事件

$16.6M 最高單次扣款紀錄 (NT$ 5.3 億)
API 金鑰防護:從前端直連到後端代理架構演進 左側為高風險前端直連架構,金鑰暴露於客戶端;中間為六大安全重構變更日誌;右側為後端代理與環境變數隔離架構,確保零金鑰外洩。 Before · 致命前端直連 FATAL · CLIENT-SIDE LEAK (v1) Changes · 安全重構日誌 6 ACTIONS · ZERO CLIENT TRUST After · 安全後端代理 (BFF) SECURE · VAULT & RATE-LIMITED (v2) r2 · 明文直連 (危險) r1 · 右鍵偷金鑰 r3 · 併發盜刷 ~ CLIENT · EXPOSED KEY 前端網頁 (Client HTML/JS) const KEY = "sk-ant-api03..." − ATTACKER · SCRAPER 惡意爬蟲 / 訪客 F12 檢視原始碼 30秒取走 = LLM PROVIDER · UNCHANGED Anthropic Claude API api.anthropic.com/v1/messages ⚠️ 只要有 Key 一律扣款!無防護 ❌ 弱點:用戶端代碼完全公開,任何人皆可盜刷金鑰 01 REMOVED · client_key 徹底刪除瀏覽器中任何明文金鑰 前端 JS 絕不出現 sk-ant- / sk-proj- 字串 02 ADDED · backend_proxy 建立 BFF 後端伺服器 (Node.js/FastAPI) 所有 AI 呼叫皆轉由伺服器內部發起 03 ADDED · env_vault 金鑰隔離至 .env 與雲端 Secret Manager 僅在伺服器記憶體中讀取,永不上傳前端 04 ADDED · rate_limit & budget_cap 後端防護網:限速 + 每日花費上限熔斷 限制每 IP 5次/分;超過預算自動停機保護 05 REWIRED · client_traffic 前端請求改發內部端點 POST /api/chat 改用 Session/Cookie 驗證,絕不傳遞 API Key 06 ADDED · server_secure_link 受控環境私密發送至 Anthropic API 回傳結果先由後端清洗,再送給前端渲染 PRESERVED COMPONENTS 前端使用者操作介面 · Claude 頂級 AI 模型能力 POST /api/chat (零金鑰) 帶 .env 金鑰私密調用 🚫 403 阻絕 ~ CLIENT · ZERO SECRETS 前端網頁 (Client Browser) 🛡️ 原始碼零金鑰 · 僅送用戶輸入 + BACKEND PROXY (BFF) · ADDED 受保護伺服器 (Node / Python) 🔒 .env Vault : process.env.ANTHROPIC_KEY ⚡ Rate Limit (5次/分) + Spending Cap 🛡️ Session Auth / CORS 白名單嚴格校驗 = LLM PROVIDER · PROTECTED Anthropic Claude API api.anthropic.com/v1/messages ✅ 僅接受後端受控調用 · 預算有熔斷保護 ✅ 成果:任何人右鍵檢視原始碼,均找不到任何金鑰! = 保留不變 (Unchanged) + 新增防護 (Added) − 廢除危險端點 (Removed) ~ 架構改道 (Changed) ⇢ 重定向流量 (Rewired) 規範說明:依據 diagram-design 體系,元件 ID 與生命週期跨快照持久化;線條虛實代表架構演進變更,非協議差異。 6 COMPONENTS · 5 RELATIONSHIPS · 6 DELTA ACTIONS

🚨 守則一:前端代碼視為「公共廣場」

任何在瀏覽器執行的代碼(HTML, JS, CSS, Webpack 打包檔),只要造訪者按一下右鍵「檢視原始碼」或 F12,其內部的字串完全公開透明。 任何寫在前端的 API Key 都等於直接貼在公車站牌上。

🛡️ 守則二:金鑰必須放在「伺服器金庫」

API Key 必須存放在只有伺服器能讀取的環境變數(.env 或 Cloud Secret Manager), 且 .env 必須加入 .gitignore,絕對不可推送至 GitHub!

💸 守則三:必須設定「每日花費熔斷」

在 OpenAI / Anthropic 儀表板中,務必設定 Monthly Budget Limit(預算硬性上限) 與 Usage Alerts。 即使不幸外洩,最多扣完預設額度(例如 \$20 美元)即刻斷線,絕不會引發 1,660 萬美元的滅頂災難。