Webhook

Konektor Webhook memungkinkan Anda memproses peristiwa dari backend. Konektor ini dirancang untuk digunakan dengan pemicu Webhook. Untuk menggunakan pemicu Webhook dalam integrasi, Anda harus mengonfigurasi konektor Webhook terlebih dahulu.

Sebelum memulai

Sebelum menggunakan konektor Webhook, lakukan tugas berikut:

  • Di project Google Cloud Anda:
    • Aktifkan layanan berikut:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan.

    • Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk konektor:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Akun layanan adalah jenis Akun Google khusus yang dimaksudkan untuk mewakili pengguna non-manusia yang perlu melakukan autentikasi dan diberi otorisasi untuk mengakses data di Google API. Jika tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk mengetahui informasi selengkapnya, lihat Membuat akun layanan.

    Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

Mengonfigurasi konektor

Mengonfigurasi konektor mengharuskan Anda membuat koneksi ke sumber data (sistem backend). Koneksi bersifat khusus untuk sumber data. Artinya, jika memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan langkah-langkah berikut:

  1. Di Konsol Cloud, buka halaman Integration Connectors > Connections, lalu pilih atau buat project Google Cloud.

    Buka halaman Connections

  2. Klik + Create new untuk membuka halaman Create Connection.
  3. Di bagian Lokasi, pilih lokasi untuk koneksi.
    1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua wilayah yang didukung, lihat Lokasi.

    2. Klik Next.
  4. Di bagian Connection Details, selesaikan tindakan berikut:
    1. Konektor: Pilih Webhook dari menu drop-down Konektor yang tersedia.
    2. Versi konektor: Pilih versi Konektor dari menu drop-down versi yang tersedia.
    3. Connection Name: Masukkan nama untuk instance Connection.

      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.
    4. Deskripsi: Secara opsional, masukkan deskripsi untuk instance koneksi.
    5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
    6. Langganan Acara: Langganan peristiwa akan diaktifkan secara default dan bersifat wajib untuk konektor webhook.
    7. Secara opsional, klik + Add label untuk menambahkan label ke Connection dalam bentuk key-value pair.
    8. Klik Next.
  5. Di bagian Detail Langganan Acara, lengkapi hal berikut:
    1. Autentikasi Pemroses: Pilih jenis autentikasi untuk pemroses peristiwa dan masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh pemroses webhook:

    2. Lokasi Kolom Jenis Peristiwa: Kolom wajib yang menunjukkan lokasi (Header, Parameter Kueri, atau Isi Permintaan) tempat jenis peristiwa yang terkait dengan permintaan peristiwa yang masuk akan ada.
    3. Nama Kolom Jenis Peristiwa: Kolom wajib di lokasi yang dikonfigurasi mengidentifikasi jenis peristiwa yang terkait dengan permintaan peristiwa masuk.
      4. {
"event_type": "user.created",
...
// other request fields
...
}
       Pada contoh di atas, kolom event_type di isi permintaan menandakan bahwa permintaan berkaitan dengan peristiwa "user.created".
    4. Pilih Aktifkan konektivitas pribadi untuk konektivitas yang aman antara aplikasi backend dan koneksi Anda. Jika memilih opsi ini, Anda harus melakukan langkah konfigurasi tambahan setelah membuat koneksi. Untuk mengetahui informasi selengkapnya, lihat Konektivitas pribadi untuk langganan acara.
    5. Masukkan konfigurasi yang dihentikan pengirimannya. Jika Anda mengonfigurasi huruf mati, koneksi akan menulis peristiwa yang belum diproses ke topik Pub/Sub yang ditentukan. Masukkan detail berikut:
      1. ID project yang dihentikan pengirimannya: ID project Google Cloud tempat Anda mengonfigurasi topik Pub/Sub yang dihentikan pengirimannya.
      2. Topik yang dihentikan pengirimannya: Topik Pub/Sub tempat Anda ingin menulis detail peristiwa yang belum diproses.
    6. Klik Next.
  6. Peninjauan: Meninjau detail koneksi dan autentikasi pemroses.
  7. Klik Create.

Menggunakan koneksi Webhook dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

  • Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Apigee, lihat Tugas konektor.
  • Untuk memahami cara membuat dan menggunakan tugas Konektor dalam Application Integration, lihat tugas konektor.

Dapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Cloud Forums.

Langkah selanjutnya