受信任的 IP

某支 API 金鑰從未經核准的 IP 位址發出呼叫時,先攔下來,等有人核准這個位址再放行。金鑰外洩後被別人從新位址使用,得到的只會是拒絕,而不是模型的回應。

在控制台側邊欄(該功能適用於你的帳戶時才會出現): Settings › Security 開啟 ↗

操作步驟

  1. 前往系統設定 › 安全性,開啟新 IP 須核准。對話框會列出每支金鑰過去 7 天用過的位址,其中公開位址預設勾選;取消勾選你不認得的位址,再確認開啟。只有工作區擁有者和管理員能變更這項設定;如果閘道看不到真實的用戶端位址(所有呼叫看起來都來自代理後方的內網位址),這項設定無法開啟。
  2. 開啟後,來自其他位址的呼叫會被拒絕,回傳 403,錯誤代碼為 ip_not_trusted。錯誤訊息會寫出閘道看到的位址,並附上核准頁面的連結(欄位 ip 與 approve_url)。金鑰的建立者會收到電子郵件,寫明位址、所在位置、用戶端和請求的模型(管理金鑰則是呼叫的操作);屬於工作區的管理金鑰,或建立者已離開工作區的金鑰,郵件會寄給擁有者和管理員。
  3. 打開連結並登入,核准這個位址;如果用戶端的對外位址會變動,也可以核准它所在的網段(IPv4 為 /24,IPv6 為 /64);也可以拒絕。核准後,這個位址的下一次呼叫就會通過。
  4. 受信任的 IP 清單列出你的金鑰呼叫過的位址,以及各自的位置和狀態。已知的位址按一下即可信任;也可以用新增 IP 手動加入位址或網段(IPv4 最寬 /16,IPv6 最寬 /32),或移除已信任的位址。

限制與注意事項

  • 信任以金鑰為單位:核准一個位址,只讓這支金鑰能從該位址呼叫,不會放行工作區裡的其他金鑰。推論金鑰和管理金鑰都適用。
  • 自帶 IP 允許清單的金鑰,只要清單裡沒有比 /16(IPv4)或 /32(IPv6)更寬的網段,就不受影響,只由它自己的允許清單決定。清單裡有更寬網段(例如 0.0.0.0/0)的金鑰,和其他金鑰一樣須經核准。關閉新 IP 須核准後,所有位址都能再次呼叫,已信任的位址會保留,下次開啟時仍然有效。
  • 金鑰的建立者、工作區擁有者和管理員都可以核准(屬於工作區的管理金鑰只能由擁有者和管理員核准)。核准要在控制台登入後進行;電子郵件裡沒有核准按鈕,轉寄出去的郵件核准不了任何位址。
  • 待核准的請求 7 天後過期。位址被拒絕後的 30 天內,來自它的呼叫照樣會被拒絕,但不會建立新請求,也不會寄信通知。每次執行都換對外位址的 Serverless 函式和 CI 執行器,每次都會被攔下:讓它們改用一支設了 IP 允許清單的金鑰,或信任它們所在的網段。