在 Cloud KMS 中,用於加密、解密、簽署及驗證資料的加密編譯金鑰內容會儲存在金鑰版本中。金鑰有零個或多個金鑰版本。輪替金鑰時,您會建立新的金鑰版本。
本文將說明如何停用金鑰版本。在金鑰停用期間,您將無法存取以該金鑰加密的資料。如要存取資料,您可以重新啟用金鑰版本。
除非在 Service Health 資訊主頁中另有說明,否則在 1 分鐘內停用金鑰版本通常是一致的。啟用金鑰版本幾乎是即時作業。您也可以使用 Identity and Access Management (IAM) 管理金鑰版本的存取權。IAM 作業在幾秒內保持一致。詳情請參閱「使用身分與存取權管理」。
您也可以永久刪除金鑰版本。視貴機構的政策而定,您可能需要先停用金鑰版本,才能刪除該版本。詳情請參閱「控制金鑰版本銷毀」一文。
停用金鑰版本
您可以在已啟用的狀態下停用金鑰版本。停用金鑰版本前,建議您先確認金鑰是否仍在使用中。您可以查看金鑰使用情形追蹤詳細資料,瞭解金鑰是否用於保護 CMEK 資源。如果任何資源都受到您要停用的金鑰版本保護,請先使用其他金鑰版本重新加密這些資源,再停用金鑰。
控制台
前往 Google Cloud 控制台的「Key Management」頁面。
按一下金鑰環名稱,該金鑰環包含您將停用金鑰版本的金鑰。
按一下您要停用金鑰版本的金鑰。
找出要停用的金鑰版本,然後勾選旁邊的方塊。
按一下頁首中的「停用」。
在確認提示中,按一下「停用」。
gcloud
如要在指令列上使用 Cloud KMS,請先安裝或升級至最新版 Google Cloud CLI。
gcloud kms keys versions disable key-version \ --key key \ --keyring key-ring \ --location location
將 key-version 替換為要停用的金鑰版本。將 key 替換為金鑰名稱。將 key-ring 替換為金鑰所在的金鑰環名稱。將 location 替換為金鑰環的 Cloud KMS 位置。
如需所有旗標和可能值的相關資訊,請搭配 --help
旗標執行指令。
C#
如要執行這段程式碼,請先設定 C# 開發環境,然後安裝 Cloud KMS C# SDK。
Go
如要執行這段程式碼,請先設定 Go 開發環境,然後安裝 Cloud KMS Go SDK。
Java
如要執行這段程式碼,請先設定 Java 開發環境,然後安裝 Cloud KMS Java SDK。
Node.js
如要執行這段程式碼,請先設定 Node.js 開發環境,然後安裝 Cloud KMS Node.js SDK。
PHP
如要執行這段程式碼,請先瞭解如何在 Google Cloud上使用 PHP,並安裝 Cloud KMS PHP SDK。
Python
如要執行這段程式碼,請先設定 Python 開發環境,然後安裝 Cloud KMS Python SDK。
Ruby
如要執行這段程式碼,請先設定 Ruby 開發環境,然後安裝 Cloud KMS Ruby SDK。
提交要求後,金鑰版本的狀態會變更為停用。
已停用的金鑰版本會計入帳單資源。
停用或刪除外部金鑰
如要暫時停用 Cloud EKM 金鑰與外部金鑰之間的關聯,您可以停用 Cloud EKM 金鑰或金鑰版本。建議您停用所有金鑰版本。停用金鑰的效果會在三小時內生效。
停用金鑰時,您也應撤銷金鑰存取權。身分與存取權管理作業在幾秒內就會一致。您也可以考慮在外部金鑰管理合作夥伴系統中,撤銷 Google Cloud 服務帳戶的存取權。
如要永久移除 Cloud EKM 金鑰與外部金鑰之間的關聯,您可以安排刪除 Cloud EKM 金鑰版本。在排定的銷毀期限過後,系統就會銷毀金鑰。而且這項操作無法復原。金鑰版本遭到刪除後,您就無法再加密資料,也無法解密以 Cloud EKM 金鑰版本加密的資料。即使您使用相同的外部金鑰 URI 或金鑰路徑,也無法重新建立已銷毀的 Cloud EKM 金鑰版本。刪除外部金鑰內容時,建議您先在 Google Cloud 中刪除金鑰或金鑰版本,然後再刪除外部金鑰管理工具中的金鑰內容。
在 Cloud KMS 中停用金鑰或金鑰版本,並不會修改外部金鑰管理合作夥伴系統中的金鑰。
在 Cloud KMS 中刪除手動管理的金鑰版本,不會修改外部金鑰管理合作夥伴系統中的金鑰。在 Cloud KMS 中刪除協調外部金鑰版本,會刪除內部金鑰內容,並向外部金鑰管理合作夥伴系統傳送要求,以便刪除外部金鑰內容。
啟用金鑰版本
您可以在已停用的狀態下啟用金鑰版本。
控制台
前往 Google Cloud 控制台的「Key Management」頁面。
按一下金鑰環名稱,該金鑰環包含您將啟用金鑰版本的金鑰。
按一下您要啟用金鑰版本的金鑰。
找出要啟用的金鑰版本,然後勾選旁邊的方塊。
按一下頁首中的「啟用」。
在確認提示中,按一下「啟用」。
gcloud
如要在指令列上使用 Cloud KMS,請先安裝或升級至最新版 Google Cloud CLI。
gcloud kms keys versions enable key-version \ --key key \ --keyring key-ring \ --location location
將 key-version 替換為要啟用的金鑰版本。將 key 替換為鍵名稱。將 key-ring 替換為金鑰所在的金鑰環名稱。將 location 替換為金鑰環的 Cloud KMS 位置。
如需所有旗標和可能值的相關資訊,請搭配 --help
旗標執行指令。
C#
如要執行這段程式碼,請先設定 C# 開發環境,然後安裝 Cloud KMS C# SDK。
Go
如要執行這段程式碼,請先設定 Go 開發環境,然後安裝 Cloud KMS Go SDK。
Java
如要執行這段程式碼,請先設定 Java 開發環境,然後安裝 Cloud KMS Java SDK。
Node.js
如要執行這段程式碼,請先設定 Node.js 開發環境,然後安裝 Cloud KMS Node.js SDK。
PHP
如要執行這段程式碼,請先瞭解如何在 Google Cloud上使用 PHP,並安裝 Cloud KMS PHP SDK。
Python
如要執行這段程式碼,請先設定 Python 開發環境,然後安裝 Cloud KMS Python SDK。
Ruby
如要執行這段程式碼,請先設定 Ruby 開發環境,然後安裝 Cloud KMS Ruby SDK。
提交要求後,金鑰版本的狀態會變更為已啟用。
必要的 IAM 權限
如要啟用或停用金鑰版本,呼叫端需要金鑰、金鑰環或專案、資料夾或機構的 cloudkms.cryptoKeyVersions.update
IAM 權限。
這項權限會授予 Cloud KMS 管理員角色 (roles/cloudkms.admin
)。