Mengelola region

Application Integration bersifat regional. Artinya, infrastruktur yang menjalankan integrasi Anda terletak di region tertentu, dan Google mengelolanya sehingga integrasi Anda tersedia secara redundan di semua zona dalam region tersebut. Selain memilih region penyediaan awal untuk Application Integration selama proses penyiapan, Anda juga dapat mengaktifkan atau menyediakan region baru untuk membuat dan mengelola integrasi dalam project Google Cloud yang sama.

Halaman ini menjelaskan langkah-langkah yang diperlukan agar berhasil menyediakan region Application Integration baru dan mengedit region yang ada di project Google Cloud Anda.

Sebelum memulai

Mengaktifkan API berikut:

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

Menyediakan region baru

Untuk menyediakan region baru untuk Application Integration di project Google Cloud Anda, pilih salah satu opsi berikut:

Konsol

1. Buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Regions

   Halaman Regions akan muncul dan mencantumkan semua region yang disediakan dalam project Anda.

3. Klik Provision new region.
4. Konfigurasikan kolom berikut di halaman Provision new region:
   1. Region: Pilih lokasi regional baru yang ingin Anda sediakan.

      Untuk mengetahui informasi tentang region Application Integration yang didukung, lihat Lokasi Application Integration.

   2. Advanced settings: Jika perlu, luaskan bagian ini untuk mengaktifkan atau menonaktifkan akses HTTP untuk integrasi dan mengonfigurasi metode enkripsi untuk region yang dipilih.
      • HTTP: Klik tombol Enable HTTP untuk mengaktifkan akses HTTP bagi integrasi dalam region yang dipilih. Jika diaktifkan, integrasi di region ini dapat diakses melalui HTTP.
        Catatan: Tombol HTTP dinonaktifkan secara default untuk memastikan semua integrasi dipanggil dengan aman melalui HTTPS.
      • Fitur AI: Klik tombol Aktifkan fitur AI untuk mengaktifkan fitur AI di region yang dipilih. Untuk mengetahui informasi selengkapnya tentang pemecahan masalah menggunakan AI Gemini, lihat Memecahkan masalah log eksekusi yang gagal menggunakan AI.
      • Encryption: Pilih metode enkripsi untuk region yang dipilih. Ada dua opsi:
        • Google-owned and Google-managed encryption key: Ini adalah metode enkripsi default. Gunakan metode ini jika Anda ingin Google mengelola kunci enkripsi yang melindungi data Anda di region yang dipilih.
        • Kunci enkripsi yang dikelola pelanggan (CMEK): Gunakan metode ini jika Anda ingin mengelola kunci enkripsi yang melindungi data Anda di region yang dipilih.
          Perhatian: Mengaktifkan enkripsi CMEK untuk region Application Integration tidak dapat diurungkan. Hal ini juga berarti Anda tidak dapat mengubah/mengalihkan metode enkripsi untuk suatu region setelah CMEK diaktifkan.

          Saat mengonfigurasi setelan enkripsi, Anda memiliki dua opsi untuk mengelola CMEK: Application Integration dan Connectors (CMEK), serta Use a different CMEK for Integration Connectors, sebagai berikut:

          • Application Integration and Connectors - CMEK: Ini adalah opsi default dan cocok jika Anda ingin menggunakan kunci enkripsi yang sama untuk Application Integration dan Integration Connectors. Untuk menggunakan opsi ini, lakukan langkah-langkah berikut:
            1. Klik Select a Cloud KMS key dan pilih kunci CMEK yang ada dan tersedia di region yang dipilih. Anda juga dapat membuat kunci baru atau menggunakan ID resource KMS dari kunci yang ada.
            2. Klik Verify untuk memeriksa apakah akun layanan default Anda memiliki akses CryptoKey ke kunci CMEK yang dipilih.
            3. Jika verifikasi gagal, klik Grant untuk menetapkan peran IAM CryptoKey Encrypter/Decrypter ke akun layanan default.
            Tips: Memberikan akses CryptoKey adalah langkah opsional, yang berarti Anda dapat langsung mengklik Done untuk menyelesaikan proses penyiapan Application Integration. Namun, jika Anda tidak memberikan akses CryptoKey, profil autentikasi untuk Application Integration tidak akan dikonfigurasi, dan Anda harus memberikan akses ini secara manual saat membuat profil autentikasi baru.
          • Gunakan CMEK yang berbeda untuk Integration Connectors: Centang kotak ini jika Anda lebih suka menggunakan kunci enkripsi terpisah untuk Application Integration dan Integration Connectors. Jika dipilih, opsi berikut akan muncul:
            • Application Integration - CMEK
              1. Klik Select a Cloud KMS key dan pilih kunci CMEK yang ada untuk Application Integration di region yang dipilih. Atau, Anda dapat membuat kunci baru atau menggunakan ID resource Kunci yang sudah ada.
              2. Klik Verify untuk menyelesaikan penyiapan CMEK untuk Application Integration.
            • Integration Connectors - CMEK
              1. Klik Select a Cloud KMS key dan pilih kunci CMEK yang ada untuk Integration Connectors di region yang dipilih. Atau, Anda dapat membuat kunci baru atau menggunakan ID resource Kunci dari kunci yang ada.
              2. Klik Verify untuk memeriksa apakah akun layanan default Anda memiliki akses CryptoKey ke CMEK yang dipilih.
              3. Jika verifikasi untuk kunci CMEK yang dipilih gagal, klik Grant untuk menetapkan peran IAM CryptoKey Encrypter/Decrypter ke akun layanan default.
            Catatan: Application Integration akan otomatis memeriksa apakah akun layanan default Anda memiliki akses CryptoKey ke CMEK yang dipilih, jika CMEK Integration Connectors diaktifkan. Jika verifikasi gagal, Anda harus memberikan akses ini secara manual.

          Untuk mengetahui informasi selengkapnya tentang CMEK, lihat Kunci enkripsi yang dikelola pelanggan.

5. Klik Done.

Terraform

Gunakan resource google_integrations_client. Contoh berikut menyediakan region 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
  }
}

Edit wilayah

Anda dapat mengedit region yang ada untuk mengaktifkan atau menonaktifkan tata kelola integrasi, dan untuk memperbarui metode enkripsi data untuk region tersebut.

Perhatian: Mengaktifkan enkripsi CMEK untuk region Application Integration tidak dapat diurungkan. Hal ini juga berarti Anda tidak dapat mengubah metode enkripsi untuk suatu region jika CMEK sudah diaktifkan.

Untuk mengedit region yang ada di Application Integration, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Regions.

Halaman Regions akan muncul, yang mencantumkan region yang disediakan di Application Integration.

3. Untuk wilayah yang sudah ada yang ingin Anda edit, di kolom Tindakan, klik Tindakan wilayah, lalu pilih Edit.

   Panel Edit wilayah akan muncul.

4. Luaskan Setelan lanjutan.
5. Untuk mengaktifkan atau menonaktifkan tata kelola integrasi untuk region yang dipilih, klik tombol Enable governance.
   Catatan:

   • Aktifkan tata kelola untuk mewajibkan autentikasi akun layanan di region tersebut. Setelah tata kelola diaktifkan, Anda harus menambahkan akun layanan secara manual ke semua integrasi dan versi integrasi baru yang dibuat di region ini. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration settings di toolbar integrasi.

     Jika tata kelola diaktifkan, Anda dapat memublikasikan atau menguji integrasi hanya jika akun layanan dilampirkan ke integrasi tersebut.

   • Jika Anda menonaktifkan tata kelola untuk region yang dipilih, semua integrasi yang sudah dipublikasikan akan terus menggunakan akun layanan terlampir masing-masing hingga versi baru integrasi dibuat.
6. Untuk mengaktifkan atau menonaktifkan akses HTTP untuk integrasi di region yang dipilih, klik tombol Enable HTTP. Jika diaktifkan, integrasi di region ini dapat diakses melalui HTTP.
7. Untuk mengaktifkan atau menonaktifkan fitur AI untuk integrasi di region yang dipilih, klik tombol Enable AI features. Jika diaktifkan, Anda dapat menggunakan fitur AI seperti pemecahan masalah menggunakan AI Gemini di region yang dipilih.
8. Untuk mengaktifkan penyamaran variabel, di bagian Variable Masking, klik tombol Enable Variable Masking in logs.

   Untuk mengetahui informasi tentang penyamaran, lihat Menyamarkan data sensitif di log.

9. Untuk mengaktifkan enkripsi CMEK untuk region yang dipilih, pilih Customer-managed encryption key (CMEK), dan lakukan hal berikut:
   1. Pilih CMEK dari menu drop-down yang tersedia. CMEK yang tercantum dalam menu drop-down didasarkan pada region yang disediakan. Untuk membuat kunci baru, lihat Membuat CMEK baru.
   2. Klik Verify untuk memeriksa apakah akun layanan default Anda memiliki akses CryptoKey ke CMEK yang dipilih.
   3. Jika verifikasi untuk CMEK yang dipilih gagal, klik Grant untuk menetapkan peran IAM CryptoKey Encrypter/Decrypter ke akun layanan default.
10. Untuk mengaktifkan enkripsi CMEK bagi Integration Connectors, pilih Use different CMEK for Integration connectors, dan lakukan hal berikut:
    1. Pilih CMEK dari menu drop-down yang tersedia. CMEK yang tercantum dalam menu drop-down didasarkan pada region yang disediakan. Untuk membuat kunci baru, lihat Membuat CMEK baru.
    2. Klik Verify untuk menyelesaikan penyiapan CMEK Integration Connectors.
11. Klik Selesai untuk menyelesaikan pengeditan wilayah.