先決條件
以下內容假設你已按照下列其中一份指南,向 OpenAI 註冊外部 KMS 金鑰
關鍵術語
金鑰輪換和金鑰撤銷用途不同。請務必為您的使用案例選擇正確操作。
金鑰輪換:產生新的加密材料以加密新資料,同時允許解密使用先前金鑰加密的較舊資料
金鑰輪換不會影響對 OpenAI 資料的存取
金鑰撤銷:撤銷對所有以先前金鑰加密的資料的存取權。
金鑰撤銷會撤銷對 OpenAI 資料的存取權
如何確認你的 KMS 金鑰正在使用中
你的雲端供應商應有提供日誌:
如何輪替金鑰
可用的輪替選項視乎供應商和金鑰類型而定。請按照下列供應商指引操作;自動輪替可能需要使用支援此功能的金鑰或保存庫設定。
AWS - https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html
GCP - https://cloud.google.com/kms/docs/rotate-key#automatic
Azure - https://learn.microsoft.com/en-us/azure/key-vault/keys/how-to-configure-key-rotation
測試時:你對 OpenAI 資料的存取不會受此變更影響
更換 PSP 復原金鑰與 EKM 輪替是獨立的操作。註冊替換用的 RSA 金鑰及其版本,然後在 psp_decryption_key_id 中選擇該金鑰的註冊 ID。雲端金鑰版本變更後,復原金鑰的註冊記錄仍會使用原有的公開金鑰快照。請保留舊版私密金鑰,確保可用於復原較舊的資料。設定方法請參閱:設定非對稱金鑰。
如何撤銷金鑰
以下 EKM 撤銷程序適用於用來包裝資料加密金鑰的金鑰。PSP 復原金鑰的選擇有獨立的生命週期:變更雲端金鑰的讀取權限,不會移除 OpenAI 已儲存的復原公開金鑰。
撤銷 OpenAI 對你金鑰的存取權有多種方式;任何中斷驗證授權流程的操作均可,包括:
撤銷 OpenAI 角色對 KMS 金鑰的存取權
移除 KMS 金鑰的加密/解密權限
如你使用 AWS 金鑰別名(不建議),切換該別名所指向的 KMS ARN。這項操作有時會被誤以為是金鑰輪替,但實際上是撤銷金鑰,因此除非你確定要撤銷金鑰,否則不建議這樣做。
要求 OpenAI 更新你的 ChatGPT Enterprise 工作區所使用的 KMS ARN
如要驗證金鑰撤銷是否生效:
等待一小時,讓 OpenAI 端的所有快取項目過期,然後測試撤銷是否生效
如果你使用 ChatGPT Enterprise,你將無法再讀取以往的對話,對話搜尋也不會顯示以往對話的結果,並且無法存取以往的自訂 GPT。
如果你使用 API,你將無法再下載以往的批次檔案、使用以往經微調的模型,或引用以往透過 Responses API 建立的回應。
如果你使用 API,也可以立即測試,確認 OpenAI 已處理你的金鑰撤銷操作,並將於一小時內生效
建立管理員 API 金鑰(並非一般 API 金鑰):
執行以下指令,取得與你的工作區或專案關聯的 OpenAI 外部金鑰 ID(extkey_xxx):curl -X GET -H "Authorization: Bearer $ADMIN_API_KEY" https://api.openai.com/v1/organization/external_keys
接着執行:curl -X POST -H "Authorization: Bearer $ADMIN_API_KEY" "https://api.openai.com/v1/organization/external_keys/extkey_xxx/validate"
金鑰撤銷最佳做法
如果您正在使用 API
封存您已令其資料無法存取的 API 專案。然後,設定新的 KMS 金鑰,並建立與新 KMS 金鑰相關聯的新 API 專案。
請注意,您無法更換已執行金鑰撤銷的舊 API 專案所關聯的 KMS 金鑰——您必須封存舊專案。已發出金鑰撤銷的專案不應繼續使用。API 讓建立新專案變得非常簡單,因此請使用該功能。
如果您正在使用 ChatGPT Enterprise
執行金鑰撤銷後,請聯絡 OpenAI 支援。
我們會與您合作啟動一個新工作區。我們不會嘗試更新舊工作區以使用新的 KMS 金鑰,從而重用舊工作區。這是因為當金鑰撤銷按設計運作時,以已撤銷金鑰加密的先前資料會變得無法存取。