此頁面由機器翻譯。查看原文英文文章。

EKM KMS 金鑰生命週期

KMS 金鑰生命週期端到端指引,涵蓋設定檢查至撤銷後清理

更新日期:3 days ago

先決條件

以下內容假設你已按照下列其中一份指南,向 OpenAI 註冊外部 KMS 金鑰

關鍵術語

金鑰輪換和金鑰撤銷用途不同。請務必為您的使用案例選擇正確操作。

  • 金鑰輪換:產生新的加密材料以加密新資料,同時允許解密使用先前金鑰加密的較舊資料

    • 金鑰輪換不會影響對 OpenAI 資料的存取

  • 金鑰撤銷:撤銷對所有以先前金鑰加密的資料的存取權。

    • 金鑰撤銷會撤銷對 OpenAI 資料的存取權

如何輪替金鑰

可用的輪替選項視乎供應商和金鑰類型而定。請按照下列供應商指引操作;自動輪替可能需要使用支援此功能的金鑰或保存庫設定。

測試時:你對 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 金鑰,從而重用舊工作區。這是因為當金鑰撤銷按設計運作時,以已撤銷金鑰加密的先前資料會變得無法存取。

這篇文章對你有幫助嗎?