HopBaseAPI Key 外洩了,第一件事是立刻在控制台停用這把 Key——停用後它的請求馬上被拒絕,不影響其他 Key;接著新建一把相同設定的 Key 替換上線,再按 Key 篩選用量、匯出 CSV,確認外洩期間呼叫了哪些模型、花了多少。員工離職也一樣:停用成員帳號,他名下所有 Key 立即失效,再處理他建立的部門 Key。本文是一份可照做的手冊:前 10 分鐘做什麼、平時該開哪些預防設定、離職回收清單,以及如何用稽核紀錄與用量 CSV 確認處理到位。
前 10 分鐘:Key 外洩應變步驟
發現 Key 出現在公開程式庫、聊天群組、截圖或日誌裡,先別追查原因,先止血。
- 0–2 分鐘,停用:在控制台「API 密鑰」找到這把 Key,按停用。停用即時生效,只影響這一把。確認不再需要後再撤銷(刪除);已刪除的密鑰仍保留刪除人、刪除時間與歷史用量,可以回查。
- 2–5 分鐘,輪換:新建一把 Key,照原本的分組、額度、到期時間、IP 名單與並發設定,替換到使用它的服務或設定檔中。
- 5–8 分鐘,看用量:在「用量」頁按這把 Key 篩選,檢視外洩期間的請求時間、模型、token 數與狀態,找出異常從何時開始。
- 8–10 分鐘,留存證據:以相同條件匯出 CSV(單一檔案最多 5 萬列、400 天),交給財務或資安同事。每列可重算「官方成本 × 折扣 ÷ 匯率 = 實扣」;失敗請求不計費。
完成這四步,再回頭追查外洩來源,並確認同一人建立的其他 Key 是否也要輪換——每把 Key 都顯示建立人,用量頁也能按「Key 建立人」篩選。
輪換的建議順序
非緊急的定期輪換,用「先新後舊」避免中斷服務:
- 新建 Key,設定與舊 Key 相同;
- 把新 Key 部署到服務;
- 在用量頁按舊 Key 篩選,確認已無新請求;
- 停用並撤銷舊 Key。
為 Key 設定到期時間,能把「定期輪換」變成到期必做的事;到期時間留空則永不過期。
預防設定:讓外洩的 Key 能做的事越少越好
外洩無法完全避免,但可以事先鎖死一把 Key 的最大損失。每把 Key 都能單獨設定以下項目:
| 設定 | 作用 | 建議 |
|---|---|---|
| Key 額度 | 這把 Key 最多能花多少美元;用完後請求在處理前被拒絕(HTTP 402 insufficient_quota) | 依服務一個月的正常用量設定,保留少量餘裕 |
| 到期時間 | 到期自動失效 | 臨時任務、外包、CI 測試務必設定 |
| IP 名單 | 限制可使用這把 Key 的 IP | 線上服務填寫對外出口 IP;每行一個 |
| 分組(1–10 個) | Key 只能呼叫所含分組的模型,GET /v1/models 回傳可用模型 | 只給業務需要的分組,外洩的 Key 叫不動其他模型 |
| 並發 | 限制同時進行的請求數 | 批次作業 Key 設低,避免被拿去大量呼叫 |
另外三項組織層面的保護:
- 一個服務一把 Key:外洩時只停一個服務;
- 成員額度與部門額度:即使 Key 本身沒設額度,也會被所屬成員與部門的本期額度封頂;
- 餘額預警:按「可用餘額」設定多檔門檻,跌破時發送電郵與站內通知,及早發現異常消耗。
成員、部門與三級額度如何搭建,見企業怎麼給員工分配大模型 API Key;完整的安全評估項目見企業接入大模型 API 的安全清單。
員工離職 API Key 回收清單
離職當天依序執行:
- 停用成員:在「團隊管理 → 成員」停用該成員。停用後他名下所有密鑰立即不可用。
- 清查他建立的部門 Key:有些 Key 不掛成員、直掛部門(例如他維護的線上服務)。在密鑰列表看建立人,或在用量頁按「Key 建立人」篩選,逐一輪換。
- 匯出最後一期用量:按成員篩選匯出 CSV,用於本期結算與部門分攤。
- 調整角色:若他是部門負責人,為部門改派負責人;若他是企業管理員,由企業主取消管理員身分。
- 刪除成員(選用):刪除後登入帳號停用、名下所有密鑰一併刪除,無法復原;歷史用量與紀錄保留,可在「已移除成員」查看。
- 輪換他接觸過的共用設定:凡是他看過明文的服務 Key,依上面的「先新後舊」輪換。
用稽核紀錄與用量 CSV 確認處理到位
處理完不代表結束,還要能證明做過、而且生效:
- 稽核紀錄:組織調整、成員異動、額度與權限調整、密鑰操作全程留痕,可按時間與對象查詢。企業主與企業管理員可檢視,用來核對「誰在幾點停用了哪把 Key、停用了哪位成員」。
- 用量 CSV:每個請求都記錄模型、token 數、延遲與狀態。按舊 Key 或離職成員篩選,停用時間之後不應再有成功且計費的請求。
- 舊 Key 自我檢查:用舊 Key 呼叫一次
GET /v1/usage,確認它已不可用(此端點以is_active判斷,見查詢餘額與額度文件)。
排查時你看到的是計費元資料:提示詞與輸出只用於完成請求,不作為業務資料保留,也不用於訓練;全程 TLS。
註冊 HopBase,為每把 Key 設好額度與 IP 名單
常見問題
API Key 外洩怎麼辦,刪掉就夠了嗎?
先停用止血,再新建一把相同設定的 Key 替換上線,然後按舊 Key 篩選用量、匯出 CSV 核對外洩期間的消耗。只刪不查,你不知道損失多大,也不知道同一人建立的其他 Key 要不要換。
員工離職後,他建立的 API Key 怎麼回收?
停用成員後,他名下所有 Key 立即失效。再按「Key 建立人」找出他建立、但直掛部門的 Key,逐一輪換。刪除成員會一併刪除名下密鑰,歷史用量保留。
怎麼查一把 Key 什麼時候呼叫了哪些模型?
在用量頁按這把 Key 篩選,可看到每個請求的時間、模型、token 數、延遲與狀態,並可匯出 CSV。Key 的建立、修改、停用等操作則在稽核紀錄中按時間與對象查詢。