管理區域

Application Integration 具有區域性，這表示執行整合的基礎架構位於特定區域，並由 Google 負責管理，實現該區域內所有可用區之間的備援可用性。除了在設定程序中選取 Application Integration 的初始佈建區域外，您也可以啟用或佈建新區域，在同一個 Google Cloud 專案中建立及管理整合項目。

本頁說明如何成功佈建新的 Application Integration 區域，以及編輯 Google Cloud 專案中的現有區域。

事前準備

啟用下列 API：

• Application Integration API (integrations.googleapis.com)
• Connectors API (connectors.googleapis.com)

佈建新區域

如要在 Google Cloud 專案中為 Application Integration 佈建新區域，請選取下列其中一個選項：

控制台

1. 前往「Application Integration」頁面。

   前往 Application Integration

2. 在導覽選單中，按一下「Regions」(區域)

   「Regions」(區域) 頁面會隨即顯示，當中列出專案中佈建的所有區域。

3. 按一下「佈建新區域」。
4. 在「Provision new region」(佈建新區域) 頁面中，設定下列欄位：
   1. 區域：選取要佈建的新區域位置。

      如要瞭解支援的 Application Integration 區域，請參閱「Application Integration 位置」。

   2. 進階設定：您可以展開這個部分，啟用或停用整合功能的 HTTP 存取權，並設定所選區域的加密方法。
      • HTTP：按一下「啟用 HTTP」切換鈕，即可為所選區域內的整合啟用 HTTP 存取權。啟用後，即可透過 HTTP 存取這個區域中的整合項目。
        注意：HTTP 切換鈕預設為停用，確保所有整合項目都透過 HTTPS 安全叫用。
      • AI 功能：按一下「啟用 AI 功能」切換鈕，即可在所選區域啟用 AI 功能。如要進一步瞭解如何使用 Gemini AI 進行疑難排解，請參閱「使用 AI 排解執行失敗記錄的問題」。
      • 加密：選取所選區域的加密方式。做法有以下兩種：
        • Google-owned and Google-managed encryption key：這是預設的加密方法。如果您希望 Google 管理加密金鑰，保護所選區域中的資料，請使用這個方法。
        • 客戶自行管理的加密金鑰 (CMEK)：如要管理用於保護所選區域資料的加密金鑰，請使用這個方法。
          注意：為 Application Integration 區域啟用 CMEK 加密後，即無法復原。這也表示啟用 CMEK 後，您無法變更/切換區域的加密方法。

          設定加密設定時，您可以透過下列兩種方式管理 CMEK：Application Integration 和連接器 (CMEK)，以及為 Integration Connectors 使用不同的 CMEK：

          • Application Integration 和連接器 - CMEK：這是預設選項，如果您想在 Application Integration 和 Integration Connectors 使用相同的加密金鑰，請選取這個選項。如要使用這個選項，請按照下列步驟操作：
            1. 按一下「選取 Cloud KMS 金鑰」，然後選擇所選區域中現有的 CMEK 金鑰。您也可以建立新金鑰，或使用現有金鑰的 KMS 資源 ID。
            2. 按一下「驗證」，確認預設服務帳戶是否具備所選 CMEK 金鑰的 CryptoKey 存取權。
            3. 如果驗證失敗，請按一下「Grant」(授予)，將 CryptoKey 加密者/解密者 IAM 角色指派給預設服務帳戶。
            提示：授予 CryptoKey 存取權是選用步驟，也就是說，您可以直接點選「完成」來完成 Application Integration 設定程序。不過，如果您未授予 CryptoKey 存取權，系統就不會設定 Application Integration 的驗證設定檔，您必須在建立新的驗證設定檔時手動授予這項存取權。
          • Use different CMEK for Integration Connectors (為 Integration Connectors 使用不同的 CMEK)：如要為 Application Integration 和 Integration Connectors 使用不同的加密金鑰，請勾選這個核取方塊。如果選取，系統會顯示下列選項：
            • Application Integration - CMEK
              1. 按一下「選取 Cloud KMS 金鑰」，然後在所選區域中選擇現有的 Application Integration CMEK 金鑰。或者，您也可以建立新的金鑰，或使用現有金鑰的資源 ID。
              2. 按一下「Verify」(驗證)，完成 Application Integration 的 CMEK 設定。
            • Integration Connectors - CMEK
              1. 按一下「選取 Cloud KMS 金鑰」，然後在所選區域中，選擇 Integration Connectors 現有的 CMEK 金鑰。或者，您也可以建立新的金鑰，或使用現有金鑰的金鑰資源 ID。
              2. 按一下「驗證」，確認預設服務帳戶是否具備所選 CMEK 的 CryptoKey 存取權。
              3. 如果所選 CMEK 金鑰驗證失敗，請按一下「授予」，將 CryptoKey 加密者/解密者 IAM 角色指派給預設服務帳戶。
            注意：如果已啟用 Integration Connectors CMEK，Application Integration 會自動檢查預設服務帳戶是否具備所選 CMEK 的 CryptoKey 存取權。如果驗證失敗，您必須手動授予這項存取權。

          如要進一步瞭解 CMEK，請參閱「客戶自行管理的加密金鑰」。

5. 按一下「完成」。

Terraform

使用 google_integrations_client 資源。 以下範例會佈建 us-east1 區域：

resource "random_id" "default" {
  byte_length = 8
}

resource "google_kms_key_ring" "default" {
  name     = "${random_id.default.hex}-example-keyring"
  location = "us-east1"
}

resource "google_kms_crypto_key" "default" {
  name            = "crypto-key-example"
  key_ring        = google_kms_key_ring.default.id
  rotation_period = "7776000s"
}

resource "google_kms_crypto_key_version" "default" {
  crypto_key = google_kms_crypto_key.default.id
}

resource "google_service_account" "default" {
  account_id   = "service-account-id"
  display_name = "Service Account"
}

resource "google_integrations_client" "example" {
  location                   = "us-east1"
  create_sample_integrations = true
  run_as_service_account     = google_service_account.default.email
  cloud_kms_config {
    kms_location   = "us-east1"
    kms_ring       = basename(google_kms_key_ring.default.id)
    key            = basename(google_kms_crypto_key.default.id)
    key_version    = basename(google_kms_crypto_key_version.default.id)
    kms_project_id = data.google_project.default.project_id
  }
}

編輯區域

您可以編輯現有區域，啟用或停用整合治理功能，以及更新該區域的資料加密方法。

注意：為 Application Integration 區域啟用 CMEK 加密後，即無法復原。這也表示，如果已啟用 CMEK，就無法變更區域的加密方法。

如要在 Application Integration 編輯現有區域，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Application Integration」頁面。

   前往 Application Integration

2. 在導覽選單中，按一下「Regions」(區域)。

「Regions」(區域) 頁面隨即顯示，列出 Application Integration 中已佈建的區域。

3. 在「動作」欄中，找出要編輯的現有區域，然後按一下「區域動作」圖示 ，並選取「編輯」。

   「編輯區域」窗格隨即顯示。

4. 展開「進階設定」。
5. 如要啟用或停用所選區域的整合管理機制，請按一下「啟用管理機制」切換鈕。
   注意：

   • 啟用管理機制，強制要求這個區域進行服務帳戶驗證。啟用管理機制之後，您必須手動將服務帳戶新增至這個區域中建立的所有新整合項目和整合版本。您隨時可以透過整合工具列中的「 整合設定」窗格，變更或更新整合的服務帳戶詳細資料。

     啟用管理機制後，整合項目必須附加服務帳戶，才能發布或測試。

   • 如果停用所選區域的管理機制，所有現有已發布的整合項目會繼續使用各自附加的服務帳戶，直到建立新版整合項目為止。
6. 如要啟用或停用所選區域中整合項目的 HTTP 存取權，請按一下「啟用 HTTP」切換鈕。啟用後，即可透過 HTTP 存取這個區域的整合項目。
7. 如要啟用或停用所選區域中整合項目的 AI 功能，請按一下「啟用 AI 功能」切換鈕。啟用後，您就能在所選區域使用 AI 功能，例如透過 Gemini AI 排解問題。
8. 如要啟用變數遮蓋功能，請在「Variable Masking」(變數遮蓋) 區段中，按一下「Enable Variable Masking in logs」(在記錄中啟用變數遮蓋功能) 切換鈕。

   如要瞭解遮蓋功能，請參閱「遮蓋記錄中的機密資料」。

9. 如要為所選區域啟用 CMEK 加密功能，請選取「客戶自行管理的加密金鑰 (CMEK)」，然後執行下列操作：
   1. 從可用的下拉式選單中選取 CMEK。下拉式選單中列出的 CMEK 是根據佈建區域而定。如要建立新的金鑰，請參閱「建立新的 CMEK」。
   2. 按一下「驗證」，確認預設服務帳戶是否具備所選 CMEK 的 CryptoKey 存取權。
   3. 如果所選 CMEK 的驗證失敗，請按一下「授予」，將 CryptoKey 加密者/解密者 IAM 角色指派給預設服務帳戶。
10. 如要為 Integration Connectors 啟用 CMEK 加密功能，請選取「Use different CMEK for Integration connectors」(為 Integration Connectors 使用不同的 CMEK)，然後執行下列操作：
    1. 從可用的下拉式選單中選取 CMEK。下拉式選單中列出的 CMEK 是根據佈建區域而定。如要建立新的金鑰，請參閱「建立新的 CMEK」。
    2. 按一下「驗證」，完成 Integration Connectors CMEK 設定。
11. 點選「完成」，結束編輯區域。