使用 Cloud KMS 和 Cloud HSM 設定金鑰存取依據
本頁面說明如何透過 Cloud KMS 或 Cloud HSM,為 Assured Workloads 日本資料邊界設定金鑰存取依據。
在為日本區域建立新的 Assured Workloads 資料夾時,您可以選擇為加密編譯金鑰建立新專案和金鑰環。Cloud KMS 和 Cloud HSM 金鑰可新增至這個金鑰環,您也可以設定金鑰存取依據政策,控管各個金鑰的存取權。
事前準備
- 金鑰存取依據只能與 Cloud KMS 和 Cloud HSM 金鑰搭配使用,且金鑰必須位於 Assured Workloads 中註冊日本資料邊界的資料夾。
- 請確認管理員已授予您必要的 Identity and Access Management (IAM) 角色,以便建立及管理金鑰存取依據政策,以及 Cloud KMS 和 Cloud HSM 金鑰。
必要的 IAM 權限
如要取得建立及管理 Cloud KMS 和 Cloud HSM 金鑰及其金鑰存取依據政策所需的權限,請要求管理員在包含金鑰環的專案中,授予您 Cloud KMS 管理員 (roles/cloudkms.admin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備建立及管理 Cloud KMS 和 Cloud HSM 金鑰,以及金鑰存取依據政策所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能建立及管理 Cloud KMS 和 Cloud HSM 金鑰,以及其金鑰存取依據政策:
-
cloudkms.cryptoKeys.create -
cloudkms.cryptoKeys.update -
cloudkms.cryptoKeys.get
設定金鑰存取依據
如要使用 Cloud KMS 或 Cloud HSM 金鑰設定金鑰存取依據,您可以在建立金鑰時將金鑰存取政策納入參數,也可以在建立金鑰後使用政策更新金鑰。
建立新的金鑰和政策
控制台
前往 Google Cloud 控制台的「Key management」(金鑰管理) 頁面。
按一下要建立金鑰的金鑰環名稱。
按一下 [Create key] (建立金鑰)。
在「Key name」(金鑰名稱) 部分,輸入金鑰名稱。
在「防護等級」部分,選取「軟體」或「HSM」。
繼續視需要選取設定。
在「Additional settings」(其他設定) >「Key Access Justifications policy」(金鑰存取依據政策) 下方,依序選取「Set custom policy」(設定自訂政策) 和「Allow specific reason codes」(允許特定原因代碼)。
在「Justification reasons」(理由) 部分,選取「Customer-initiated access」(客戶發起的存取要求)、「Google-initiated system operation」(Google 發起的系統作業),以及要允許的其他原因代碼。「客戶發起的存取要求」和「Google 發起的系統作業」都是正常運作的必要條件。
點選「建立」。
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:金鑰環的位置,例如
asia-northeast1。 - KEY_RING:建立 Assured Workloads 資料夾的金鑰管理專案和金鑰環時,指定的金鑰環名稱。
- KEY_NAME:要建立的 HSM 金鑰名稱,例如
my-hsm-key。
要求主體:
{ "purpose": "PURPOSE", "versionTemplate": { "protectionLevel": "PROTECTION_LEVEL", "algorithm": "ALGORITHM" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ ALLOWED_ACCESS_REASONS ] } }
在要求主體中,替換下列預留位置值:
- PURPOSE:金鑰用途,如需不同金鑰用途的清單,請參閱「金鑰用途」,例如
ENCRYPT_DECRYPT。 - PROTECTION_LEVEL:金鑰的保護層級,例如
SOFTWARE或HSM。 - ALGORITHM:要使用的加密編譯演算法。如需可用演算法清單,請參閱「Cloud KMS 演算法」,例如
GOOGLE_SYMMETRIC_ENCRYPTION。 - ALLOWED_ACCESS_REASONS:金鑰存取依據政策,定義零或多個允許存取加密金鑰的依據代碼,例如
["CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION"]。
下列要求和要求主體範例會建立 Cloud HSM 金鑰,僅允許基於少數原因存取:
POST https://cloudkms.googleapis.com/v1/projects/919698201234/locations/asia-northeast1/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" ] } }
更新現有金鑰的政策
控制台
前往 Google Cloud 控制台的「Key management」(金鑰管理) 頁面。
按一下您建立金鑰的金鑰環名稱。
按一下要更新金鑰存取依據政策的金鑰名稱。
按一下「Edit Key Access Justifications policy」(編輯金鑰存取依據政策)。
執行下列其中一個步驟:
如要停用金鑰的金鑰存取依據政策,請取消勾選「Set Key Access Justification policy」(設定金鑰存取依據政策) 核取方塊。
如要變更允許的原因,請按一下「Justification reasons」(原因) 方塊,然後視需要選取或清除原因代碼。「客戶發起的存取要求」和「Google 發起的系統作業」都是正常運作的必要條件。
如要拒絕所有原因代碼,請選取「Deny all reason codes (not recommended)」(拒絕所有原因代碼 (不建議))。即使金鑰已啟用,且要求者具備必要權限,也無法使用金鑰。
按一下「儲存」。
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:金鑰環的位置,例如
asia-northeast1。 - KEY_RING:建立 Assured Workloads 資料夾的金鑰管理專案和金鑰環時,指定的金鑰環名稱。
- KEY_NAME:要更新的金鑰名稱。
要求主體:
{ "purpose": "PURPOSE", "versionTemplate": { "protectionLevel": "PROTECTION_LEVEL", "algorithm": "ALGORITHM" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ ALLOWED_ACCESS_REASONS ] } }
在要求主體中,替換下列預留位置值:
- PURPOSE:金鑰用途,如需不同金鑰用途的清單,請參閱「金鑰用途」,例如
ENCRYPT_DECRYPT。 - PROTECTION_LEVEL:金鑰的保護層級,例如
SOFTWARE或HSM。 - 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/asia-northeast1/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:金鑰環的位置,例如
asia-northeast1。 - KEY_RING:建立 Assured Workloads 資料夾的金鑰管理專案和金鑰環時指定的金鑰環名稱,例如
my-key-ring。 - KEY_NAME:要取得的金鑰名稱。
下列範例要求會取得 Cloud KMS 中金鑰的中繼資料:
GET https://cloudkms.googleapis.com/v1/projects/919698201234/locations/asia-northeast1/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" ] } }
後續步驟
- 您也可以設定預設金鑰存取依據政策。