Lihat konektor yang didukung untuk Application Integration.

Pemicu IBM MQ

Pemicu MQ IBM adalah pemicu Peristiwa Konektor yang memungkinkan Anda memanggil integrasi berdasarkan peristiwa IBM MQ yang telah Anda langgani dalam koneksi IBM MQ Anda.

Penting: Integration Connectors adalah komponen Google Cloud yang dapat ditagih. Untuk informasi tentang biaya dan tagihan penggunaan Konektor Integrasi, lihat Harga Konektor Integrasi.

Sebelum memulai

Jika Anda berencana membuat atau mengonfigurasi koneksi baru untuk pemicu IBM MQ, pastikan Anda memiliki peran IAM berikut di project:

• Admin Konektor (roles/connectors.admin)

Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses.

Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk pemicu IBM MQ:

• Invoker Integrasi Aplikasi (roles/integrations.integrationInvoker)

Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Menambahkan pemicu IBM MQ

Untuk menambahkan pemicu IBM MQ ke integrasi Anda, lakukan langkah-langkah berikut:

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

   Buka Application Integration

2. Di menu navigasi, klik Integrasi

   Halaman Integrations List akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Create Integration.
   2. Pilih region untuk integrasi.
      Catatan: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan wilayah baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen IBM MQ trigger di editor integrasi.

Untuk mengonfigurasi pemicu IBM MQ, Anda dapat menggunakan koneksi IBM MQ yang ada di Integration Connectors, atau membuat koneksi IBM MQ baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu IBM MQ menggunakan koneksi yang ada

Anda dapat mengonfigurasi pemicu IBM MQ menggunakan koneksi IBM MQ yang ada di Integration Connectors. Perhatikan bahwa pemicu IBM MQ adalah pemicu Peristiwa Konektor, sehingga Anda hanya dapat menggunakan koneksi IBM MQ dengan langganan peristiwa yang diaktifkan untuk mengonfigurasi pemicu.

Untuk mengetahui informasi tentang cara mengonfigurasi pemicu IBM MQ menggunakan koneksi IBM MQ baru, Lihat Mengonfigurasi pemicu IBM MQ menggunakan koneksi baru

Untuk mengonfigurasi pemicu IBM MQ menggunakan koneksi IBM MQ yang ada, lakukan langkah-langkah berikut:

1. Klik elemen IBM MQ trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Berikan detail konfigurasi berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Region: Pilih region koneksi IBM MQ Anda.
   2. Koneksi: Pilih koneksi IBM MQ yang ingin Anda gunakan.

      Application Integration hanya menampilkan koneksi IBM MQ yang aktif dan memiliki langganan acara yang diaktifkan.

   3. Pilih Queue atau Topik sebagai JMS Source Type.
      • Jika Anda memilih Queue, masukkan nama antrean IBM MQ di kolom Nama Sumber JMS.
      • Jika Anda memilih Topic, masukkan nama topik IBM MQ di kolom JMS Source Name.
   4. Akun Layanan: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu IBM MQ.
4. Klik Selesai untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Mengonfigurasi pemicu IBM MQ menggunakan koneksi baru

Untuk mengonfigurasi pemicu IBM MQ menggunakan koneksi IBM MQ baru, lakukan langkah-langkah berikut:

1. Klik elemen IBM MQ trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Lewati kolom Region.
4. Klik Connection, lalu pilih opsi Create Connection di menu drop-down.
5. Selesaikan langkah-langkah berikut di panel Create Connection:
   1. Pada langkah Lokasi, pilih lokasi untuk koneksi IBM MQ baru:
      1. Region: Pilih wilayah dari menu drop-down.
      2. Klik Next.
   2. Pada langkah Connection Details, berikan detail tentang koneksi IBM MQ baru:
      1. Versi konektor: Pilih versi konektor IBM MQ yang tersedia dari menu drop-down.
      2. Connection Name: Masukkan nama untuk koneksi IBM MQ.
         Catatan: Nama koneksi harus memenuhi kriteria berikut:

         • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
         • Huruf harus kecil.
         • Nama koneksi harus dimulai dengan huruf dan diakhiri dengan huruf atau angka.
         • Nama koneksi tidak boleh lebih dari 63 karakter.
      3. (Opsional) Deskripsi: Masukkan deskripsi untuk koneksi.
      4. (Opsional) Aktifkan Cloud Logging: Centang kotak ini untuk menyimpan semua data log koneksi.
      5. Akun Layanan: Pilih akun layanan dengan peran IAM yang diperlukan untuk koneksi IBM MQ.
      6. Aktifkan langganan acara: Pilih opsi ini guna mengaktifkan langganan acara untuk koneksi IBM MQ.
         Catatan: Konektor ini tidak mendukung opsi Enable only event subscription.
      7. (Opsional) Luaskan Setelan lanjutan untuk mengonfigurasi setelan node koneksi.

         Untuk informasi selengkapnya tentang setelan node koneksi untuk IBM MQ, lihat dokumentasi Koneksi IBM MQ.

      8. (Opsional) Klik + Tambahkan label untuk menambahkan label ke koneksi dalam bentuk pasangan nilai kunci.
      9. Klik Next.
   3. Secara opsional, jika Anda ingin menggunakan SSL, pilih Aktifkan SSL. Tindakan ini akan menampilkan detail konfigurasi SSL.
      1. Pilih jenis penyimpanan trust. Koneksi tersebut dapat berupa Publik, Pribadi, atau Koneksi Tidak Aman.
      2. Pilih sertifikat yang ditampilkan berdasarkan pilihan trust store Anda.
      3. Jika Anda menggunakan mTLS, pilih sertifikat key store di bagian Key Store.
      4. Secara opsional, pilih versi TLS.
      5. Masukkan cipher suite yang didukung. Masukkan beberapa cipher suite, sebagai nilai yang dipisahkan koma. Untuk mengetahui informasi selengkapnya, lihat Cipher suite yang didukung.
      Catatan:

      • Semua sertifikat Anda harus berupa sertifikat X.509 dan harus dalam format PEM (Email yang Ditingkatkan untuk Privasi).
      • Anda tidak dapat memilih sertifikat secara langsung saat mengonfigurasi SSL. Anda harus menyimpan semua sertifikat dan kunci pribadi sebagai Secret Manager Secret, lalu memilih secret yang diperlukan selama konfigurasi SSL.
   4. Pada langkah Tujuan, berikan detail instance IBM MQ:
      1. Jenis Tujuan: Pilih Alamat host.
      2. Host: Masukkan nama host atau alamat IP instance IBM MQ Anda.
      3. Klik Next.
   5. Pada langkah Autentikasi, berikan detail autentikasi untuk instance IBM MQ:
      1. Pilih jenis autentikasi yang Anda inginkan dan masukkan detail yang relevan untuk mengakses URL host IBM MQ yang diberikan.

         Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

      2. Klik Next.
   6. Peninjauan: Tinjau detail koneksi IBM MQ yang diberikan.
   7. Klik Create untuk menyelesaikan pembuatan koneksi IBM MQ baru.
6. Klik Selesai dan tutup halaman.

Cipher suite yang didukung

Versi TLS	Cipher suite yang didukung
1,2	TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 TLS_DHE_RSA_WITH_AES_128_CBC_SHA TLS_DHE_RSA_WITH_AES_256_CBC_SHA TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
1,3	TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 TLS_AES_128_GCM_SHA256

Output pemicu

Pemicu MQ IBM memerlukan waktu beberapa menit untuk menyelesaikan konfigurasi langganan peristiwa. Anda dapat melihat status langganan peristiwa di panel konfigurasi pemicu di bagian Detail Langganan Peristiwa.

Pemicu MQ IBM menunjukkan status langganan peristiwa menggunakan status berikut:

• Creating: Menunjukkan bahwa pemicu berlangganan langganan peristiwa.
• Active: Menunjukkan bahwa pemicu berhasil berlangganan ke langganan peristiwa.
• Error: Menunjukkan bahwa ada masalah dengan langganan peristiwa yang dikonfigurasi.

Selain status langganan acara, bagian Detail Langganan Acara juga menampilkan detail lainnya seperti region koneksi, nama koneksi, dan nama langganan acara.

Gambar berikut menunjukkan contoh tata letak panel konfigurasi pemicu IBM MQ:

Variabel output pemicu

Untuk setiap peristiwa, pemicu IBM MQ menghasilkan variabel output ConnectorEventPayload (dalam format JSON) yang dapat Anda gunakan dalam tugas downstream. Variabel output akan memiliki payload dari peristiwa MQ IBM Anda. Contoh:

{
"message": "Hello world",
"messageContentType": "Text"
}

Lihat langganan acara

Untuk melihat dan mengelola semua langganan peristiwa yang terkait dengan koneksi di Integration Connectors, lakukan hal berikut:

1. Buka halaman Integration Connectors > Connections.

   Buka halaman Connections

2. Klik koneksi yang ingin Anda lihat langganannya.
3. Klik tab Langganan acara.

   Ini akan menampilkan semua langganan peristiwa untuk koneksi tersebut.

Edit pemicu IBM MQ

Anda dapat mengedit pemicu IBM MQ untuk mengubah atau memperbarui konfigurasi koneksi dan detail langganan peristiwa.

Penting: Saat mengedit atau mengubah pemicu IBM MQ, Anda dapat mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya yang dilampirkan ke pemicu tersebut, atau Anda dapat menghapusnya. Menghapus langganan acara akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan acara tersebut.

Untuk mengedit pemicu IBM MQ, lakukan langkah-langkah berikut:

1. Klik elemen IBM MQ trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Configure IBM MQ trigger.
3. Lakukan tindakan berikut di halaman Connector Event Trigger Editor:
   1. Untuk mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya, klik Pertahankan, atau klik Hapus.
      Peringatan: Menghapus langganan acara akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan acara. Tugas ini tidak dapat diurungkan.
   2. Perbarui konfigurasi koneksi dan detail langganan peristiwa sesuai keinginan.
   3. Klik Done.

Anda dapat melihat detail langganan peristiwa dan koneksi yang diperbarui di panel konfigurasi pemicu di bagian Detail Langganan Acara.