使用 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 金鑰設定金鑰存取依據,您可以在建立金鑰時將金鑰存取政策納入參數,也可以在建立金鑰後使用政策更新金鑰。

建立新的金鑰和政策

控制台

  1. 前往 Google Cloud 控制台的「Key management」(金鑰管理) 頁面。

    前往「Key management」(金鑰管理) 頁面

  2. 按一下要建立金鑰的金鑰環名稱。

  3. 按一下 [Create key] (建立金鑰)。

  4. 在「Key name」(金鑰名稱) 部分,輸入金鑰名稱。

  5. 在「防護等級」部分,選取「軟體」或「HSM」。

  6. 繼續視需要選取設定。

  7. 在「Additional settings」(其他設定) >「Key Access Justifications policy」(金鑰存取依據政策) 下方,依序選取「Set custom policy」(設定自訂政策) 和「Allow specific reason codes」(允許特定原因代碼)。

  8. 在「Justification reasons」(理由) 部分,選取「Customer-initiated access」(客戶發起的存取要求)、「Google-initiated system operation」(Google 發起的系統作業),以及要允許的其他原因代碼。「客戶發起的存取要求」和「Google 發起的系統作業」都是正常運作的必要條件。

  9. 點選「建立」。

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

更新現有金鑰的政策

控制台

  1. 前往 Google Cloud 控制台的「Key management」(金鑰管理) 頁面。

    前往「Key management」(金鑰管理) 頁面

  2. 按一下您建立金鑰的金鑰環名稱。

  3. 按一下要更新金鑰存取依據政策的金鑰名稱。

  4. 按一下「Edit Key Access Justifications policy」(編輯金鑰存取依據政策)。

  5. 執行下列其中一個步驟:

    • 如要停用金鑰的金鑰存取依據政策,請取消勾選「Set Key Access Justification policy」(設定金鑰存取依據政策) 核取方塊。

    • 如要變更允許的原因,請按一下「Justification reasons」(原因) 方塊,然後視需要選取或清除原因代碼。「客戶發起的存取要求」和「Google 發起的系統作業」都是正常運作的必要條件。

    • 如要拒絕所有原因代碼,請選取「Deny all reason codes (not recommended)」(拒絕所有原因代碼 (不建議))。即使金鑰已啟用,且要求者具備必要權限,也無法使用金鑰。

  6. 按一下「儲存」。

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

後續步驟