本頁說明如何在 Cloud KMS 中建立金鑰環。金鑰環是 Cloud KMS 金鑰和金鑰版本的根資源。每個金鑰環都位於特定位置。如要進一步瞭解 Cloud KMS 資源,請參閱「Cloud KMS 資源」。
事前準備
完成本頁任務前,您必須具備下列條件:
- Google Cloud 專案資源,用於容納 Cloud KMS 資源。這個專案稱為「金鑰專案」。建議您在主要專案中不包含任何其他Google Cloud 資源。在金鑰專案中啟用 Cloud KMS API。
- 您要在其中建立金鑰環的位置名稱。請選擇與其他資源相近,且支援所選保護等級的位置。如要查看可用的地區和支援的保護層級,請參閱 Cloud KMS 位置。
必要的角色
如要取得建立 KeyRing 所需的權限,請要求管理員授予您專案或上層資源的 Cloud KMS 管理員 (roles/cloudkms.admin
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色包含建立鑰匙圈所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
如要建立鑰匙圈,您必須具備下列權限:
cloudkms.keyRings.create
cloudkms.keyRings.get
cloudkms.keyRings.list
cloudkms.locations.get
cloudkms.locations.list
resourcemanager.projects.get
建立金鑰環
請按照下列步驟建立新金鑰的金鑰環。如果您想改用現有的金鑰環,可以建立金鑰。
控制台
前往 Google Cloud 控制台的「Key Management」頁面。
按一下 [Create key ring] (建立金鑰環)。
在「Key ring name」(金鑰環名稱) 中,輸入金鑰環的名稱。
針對「Key ring location」(金鑰環位置),選取
"us-east1"
等位置。按一下 [建立]。
gcloud
In the Google Cloud console, activate Cloud Shell.
- 在環境中執行
gcloud kms keyrings create
指令:gcloud kms keyrings create KEY_RING \ --location LOCATION
更改下列內容:
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。
API
這些範例會使用 curl 做為 HTTP 用戶端,以示範如何使用 API。如要進一步瞭解存取控制,請參閱「存取 Cloud KMS API」。
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings?key_ring_id=KEY_RING" \ --request "POST" \ --header "authorization: Bearer TOKEN"
更改下列內容:
PROJECT_ID
:包含金鑰環的專案 ID。KEY_RING
:金鑰所屬金鑰環的名稱。LOCATION
:金鑰環的 Cloud KMS 位置。
詳情請參閱 KeyRing.create
API 說明文件。