設定 Cloud HSM 的金鑰存取依據
本頁面說明如何為 Assured Workloads 的日本資料邊界,設定金鑰存取依據和 Cloud HSM。
在為日本資料邊界建立新的 Assured Workloads 資料夾時,您可以選擇為加密編譯金鑰建立新的專案和金鑰環。您可以將 Cloud HSM 金鑰新增至這個金鑰環,也可以設定金鑰存取依據政策,控管各個金鑰的存取權。
事前準備
- 只有 Assured Workloads 的日本資料邊界,才能搭配 Cloud HSM 金鑰使用金鑰存取依據。
- 確認管理員已授予您必要的 Identity and Access Management (IAM) 角色,以便建立及管理金鑰存取依據政策和 Cloud HSM 金鑰。
必要的 IAM 權限
如要取得建立及管理 Cloud HSM 金鑰和金鑰存取依據政策所需的權限,請要求管理員針對包含金鑰環的專案,授予您 Cloud KMS 管理員 (roles/cloudkms.admin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備建立及管理 Cloud HSM 金鑰和金鑰存取依據政策所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能建立及管理 Cloud HSM 金鑰和金鑰存取依據政策:
-
cloudkms.cryptoKeys.create -
cloudkms.cryptoKeys.update -
cloudkms.cryptoKeys.get
設定 Cloud HSM 金鑰和金鑰存取依據
如要使用 Cloud HSM 金鑰設定金鑰存取依據,您可以在建立金鑰時將金鑰存取政策納入參數,也可以在建立金鑰後,使用政策更新金鑰。
建立新的金鑰和政策
REST
使用 cryptoKeys.create 方法建立新的金鑰和政策:
POST https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys?crypto_key_id=KEY_NAME
在要求中,替換下列預留位置值:
- PROJECT_ID:專案 ID,其中包含要新增金鑰的金鑰環,例如
919698201234。 - LOCATION:金鑰環的位置,例如
us-west1。 - KEY_RING:建立 Assured Workloads 資料夾的金鑰管理專案和金鑰環時指定的金鑰環名稱,例如
my-key-ring。 - KEY_NAME:要建立的 HSM 金鑰名稱,例如
my-hsm-key。
要求主體:
{ "purpose": "PURPOSE", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "ALGORITHM" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ ALLOWED_ACCESS_REASONS ] } }
在要求主體中,替換下列預留位置值:
- PURPOSE:金鑰用途,如需不同金鑰用途的清單,請參閱金鑰用途,例如
ENCRYPT_DECRYPT。 - ALGORITHM:要使用的加密編譯演算法。如需可用演算法清單,請參閱「Cloud KMS 演算法」,例如
GOOGLE_SYMMETRIC_ENCRYPTION。 - ALLOWED_ACCESS_REASONS:金鑰存取依據政策,定義零或多個允許存取加密金鑰的依據代碼,例如
["CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION"]。
下列範例要求和要求主體僅允許存取原因為:
POST https://cloudkms.googleapis.com/v1/projects/919698201234/locations/us-west1/keyRings/my-key-ring/cryptoKeys?crypto_key_id=my-hsm-key
{ "purpose": "ENCRYPT_DECRYPT", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ "CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION" ] } }
更新現有金鑰的政策
REST
使用 cryptoKeys.patch 方法更新 Cloud KMS 中的現有金鑰:
PATCH https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME?update_mask=keyAccessJustificationsPolicy
在要求中,替換下列預留位置值:
- PROJECT_ID:金鑰所屬金鑰環的專案 ID,例如
919698201234。 - LOCATION:金鑰環的位置,例如
us-west1。 - KEY_RING:建立 Assured Workloads 資料夾的金鑰管理專案和金鑰環時指定的金鑰環名稱,例如
my-key-ring。 - KEY_NAME:要更新的 HSM 金鑰名稱,例如
my-hsm-key。
要求主體:
{ "purpose": "PURPOSE", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "ALGORITHM" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ ALLOWED_ACCESS_REASONS ] } }
在要求主體中,替換下列預留位置值:
- PURPOSE:金鑰用途,如需不同金鑰用途的清單,請參閱「金鑰用途」,例如
ENCRYPT_DECRYPT。 - ALGORITHM:要使用的加密編譯演算法。如需可用演算法清單,請參閱「Cloud KMS 演算法」,例如
GOOGLE_SYMMETRIC_ENCRYPTION。 - ALLOWED_ACCESS_REASONS:金鑰存取依據政策,定義零或多個允許存取加密金鑰的依據代碼,例如
["CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION"]。
下列範例要求和要求主體僅允許存取原因為:
PATCH https://cloudkms.googleapis.com/v1/projects/919698201234/locations/us-west1/keyRings/my-key-ring/cryptoKeys/my-hsm-key?keyAccessJustificationsPolicy{ "purpose": "ENCRYPT_DECRYPT", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ "CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION" ] } }
取得金鑰的金鑰存取依據政策
REST
使用 cryptoKeys.get 方法,取得 Cloud KMS 中現有金鑰的中繼資料:
GET https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME在要求參數中,將下列預留位置值替換為您自己的值:
- PROJECT_ID:金鑰環所在專案的 ID,例如
919698201234。 - LOCATION:金鑰環的位置,例如
us-west1。 - KEY_RING:建立 Assured Workloads 資料夾的金鑰管理專案和金鑰環時指定的金鑰環名稱,例如
my-key-ring。 - KEY_NAME:要取得的 HSM 金鑰名稱,例如
my-hsm-key。
下列範例要求會取得 Cloud KMS 中金鑰的中繼資料:
GET https://cloudkms.googleapis.com/v1/projects/919698201234/locations/us-west1/keyRings/my-key-ring/cryptoKeys/my-hsm-key回應主體包含金鑰的中繼資料,包括 keyAccessJustificationsPolicy。例如:
{ "purpose": "ENCRYPT_DECRYPT", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ "CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION" ] } }
後續步驟
- 您也可以設定預設金鑰存取依據政策 (預先發布版)。