設定 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"
    ]
  }
}

後續步驟