全部产品
Search

搜索本产品

    EventBridge：Kelola tujuan API

    文档中心

    EventBridge：Kelola tujuan API

    更新时间：Jun 28, 2025

    Topik ini menjelaskan cara membuat, melihat, memodifikasi, dan menghapus koneksi serta tujuan API untuk membantu Anda dengan cepat mengintegrasikan EventBridge dengan aplikasi lain.

    Prasyarat

    Aktifkan EventBridge dan berikan izin kepada pengguna RAM.

    Informasi latar belakang

    Tujuan API memungkinkan Anda memanggil operasi API dari sistem Software as a Service (SaaS) pihak ketiga atau sistem yang dikelola sendiri yang terhubung melalui HTTP dengan pendekatan berkode rendah tanpa arsitektur tambahan. Anda dapat menggunakan tujuan API untuk dengan mudah membangun dan terhubung ke aplikasi SaaS, mencegah silo data. Selain itu, koneksi dapat dibagi di antara beberapa operasi API untuk menyediakan kemampuan otentikasi yang nyaman dan dapat dipasang.

    Operasi API dalam sistem SaaS pihak ketiga atau sistem yang dikelola sendiri mencakup tujuan API dan koneksi.

    Tujuan API mendefinisikan metadata operasi API. Saat membuat aturan acara, Anda dapat mereferensikan tujuan API yang berbeda untuk mengakses sistem SaaS pihak ketiga atau sistem yang dikelola sendiri. Anda juga dapat menggunakan tujuan API yang sama untuk beberapa aturan acara. Sebagai contoh, jika Anda mengirimkan acara ke operasi API layanan menggunakan beberapa aturan acara dan ingin mengubah parameter tertentu dalam aturan tersebut, tanpa tujuan API, Anda harus memperbarui parameter di setiap aturan acara secara manual. Namun, dengan mendefinisikan tujuan API, Anda hanya perlu memodifikasi konfigurasi tujuan API, sehingga parameter terkait akan diperbarui secara otomatis di semua aturan acara yang mereferensikannya.

    Koneksi digunakan untuk menghubungkan sistem SaaS pihak ketiga atau sistem yang dikelola sendiri ke tujuan API saat ini. Konfigurasi koneksi mencakup konfigurasi jaringan dan otentikasi. Konfigurasi jaringan menentukan apakah sistem terhubung melalui Internet atau jaringan pribadi. Di EventBridge, Anda dapat memilih salah satu metode otentikasi berikut: otentikasi dasar, otentikasi OAuth, dan Kunci API.

    • Otentikasi Dasar: Nama pengguna dan kata sandi diverifikasi sebelum mengakses sumber daya data. Nama pengguna dan kata sandi dienkripsi Base64 dan diberi awalan Basic dan spasi sebelum dikirim ke layanan tujuan. Jika nama pengguna dan kata sandi didekodekan dan lolos verifikasi, server merespons permintaan dari EventBridge. Jika tidak, permintaan dikembalikan.

    • Otentikasi OAuth: Metode ini aman dan andal. Otentikasi OAuth memungkinkan Anda mengotorisasi aplikasi pihak ketiga menggunakan kode otorisasi, kode otorisasi implisit, kata sandi, atau kredensial klien. Dalam skenario berbasis acara, kredensial klien sering digunakan. Jika Anda menggunakan kredensial klien, Anda harus mengonfigurasi informasi seperti alamat IP layanan OAuth, ID klien, dan kata sandi klien di EventBridge. EventBridge mendukung metode GET atau POST untuk mendapatkan kredensial klien.

    • Kunci API: Metode ini relatif mudah. Pengguna dapat menggunakan nama kunci dan nilai kunci kustom untuk memanggil operasi API. EventBridge mengirimkan nama kunci dan nilai kunci ke server untuk otentikasi menggunakan header HTTP.

    API destination

    Koneksi

    Buat koneksi

    Saat membuat tujuan API, Anda dapat menentukan koneksi untuk mendefinisikan jenis otorisasi dan parameter yang digunakan untuk mendefinisikan titik akhir API.

    1. Masuk ke Konsol EventBridge. Di panel navigasi sisi kiri, pilih Integration Center > API Destination.

    2. Di bilah navigasi atas, pilih wilayah tempat Anda ingin mengonfigurasi koneksi. Lalu, klik tab Connection Configuration.

    3. Di tab Connection Configuration, klik Create. Di panel Create Connection, atur parameter berikut dan klik OK.

      Parameter

      Deskripsi

      Contoh

      Name

      Nama koneksi.

      testName

      Description

      Deskripsi koneksi.

      test

      Authentication

      Metode otentikasi koneksi. Nilai valid:

      • Basic

      • OAuth Client Credential

      • API Key

      Dasar

      Username

      Nama pengguna yang digunakan untuk otorisasi. Parameter ini diperlukan hanya jika parameter Authentication disetel ke Basic.

      Admin

      Password

      Kata sandi yang digunakan untuk otorisasi. Parameter ini diperlukan hanya jika parameter Authentication disetel ke Basic.

      ******

      Endpoint

      Titik akhir yang digunakan untuk mendapatkan access_token yang diperlukan oleh server untuk memanggil operasi API. Parameter ini diperlukan hanya jika parameter Authentication disetel ke OAuth Client Credential.

      https://postman-echo.com/oauth1

      HTTP Method

      Jenis permintaan yang digunakan untuk mendapatkan access_token. Parameter ini diperlukan hanya jika parameter Authentication disetel ke OAuth Client Credential.

      POST

      Client ID

      ID klien yang Anda otorisasi untuk mendapatkan access_token. Parameter ini diperlukan hanya jika parameter Authentication disetel ke OAuth Client Credential.

      Admin

      ClientSecret

      Kata sandi klien yang Anda beri izin. Parameter ini diperlukan hanya jika parameter Authentication disetel ke OAuth Client Credential.

      ******

      OAuth HTTP Parameter

      Header permintaan, badan permintaan, dan parameter permintaan yang akan ditambahkan saat Anda mengonfigurasi permintaan untuk mendapatkan access_token. Parameter ini diperlukan hanya jika parameter Authentication disetel ke OAuth Client Credential.

      Parameter:Header
key:name
Value:eventbridge

      ApiKeyName

      Nama pengguna yang digunakan untuk otorisasi. Parameter ini diperlukan hanya jika parameter Authentication disetel ke API Key.

      Admin

      ApiKeyValue

      Kata sandi akun yang diotorisasi. Parameter ini diperlukan hanya jika parameter Authentication disetel ke API Key.

      ******

      Network

      Koneksi jaringan antara tujuan API dan aplikasi pihak ketiga. Nilai default: Internet

      Internet

    Operasi lain yang didukung

    Setelah membuat koneksi, Anda dapat melihat, memodifikasi, dan menghapus koneksi di konsol EventBridge.

    Other supported operations

    • Lihat detail koneksi: Klik Details di kolom Actions koneksi yang dibuat untuk melihat informasi dasar, konfigurasi otentikasi, konfigurasi jaringan, dan tujuan API yang terhubung dari koneksi tersebut.

    • Modifikasi koneksi: Klik Edit di kolom Actions untuk memodifikasi deskripsi koneksi.

    • Hapus koneksi: Temukan koneksi yang telah Anda buat, lalu klik Delete di kolom Actions. Baca pesan Note yang muncul, kemudian klik OK.

    Tujuan API

    Buat tujuan API

    1. Masuk ke Konsol EventBridge. Di panel navigasi sisi kiri, pilih Integration Center > API Destination.

    2. Di bilah navigasi atas, pilih wilayah tempat Anda ingin mengonfigurasi tujuan API. Lalu, klik tab API Destination.

    3. Di tab API Destination, klik Create. Di panel Create API Destination, atur parameter berikut dan klik OK.

      1. Di bagian Basic Information, setel Method ke Custom. Lalu, tentukan nama dan deskripsi tujuan API.

      2. Di bagian API Configuration, setel URL ke URL API dari sumber daya yang ingin Anda akses di server, dan setel HTTP Method ke metode yang digunakan untuk mendapatkan URL.

      3. Di bagian Connection Configuration, pilih Create Connection atau Select Existing Connection. Lalu, klik OK.

        • Jika Anda memilih Create Connection untuk parameter ini, konfigurasikan parameter Nama, Deskripsi, dan Otentikasi dengan mengikuti petunjuk di bagian "Buat koneksi" topik ini.

        • Jika Anda memilih Select Existing Connection untuk parameter ini, pilih koneksi yang ada dari daftar drop-down.

    Pilih tujuan API sebagai target acara

    1. Masuk ke Konsol EventBridge. Di panel navigasi sisi kiri, klik Event Buses.

    2. Di bilah navigasi atas, pilih wilayah. Di halaman Event Buses, klik nama bus acara yang ingin Anda kelola.

    3. Di panel navigasi sisi kiri, klik Event Rules. Di halaman yang muncul, klik Create Rule.

    4. Di panel Create Rule, lengkapi konfigurasi berikut dan klik Create.

      1. Konfigurasikan parameter di tab Konfigurasi Informasi Dasar dan Konfigurasi Pola Acara. Untuk informasi lebih lanjut, lihat Buat aturan acara.

      2. Di langkah Configure Targets, pilih Triggered by API Operation dari daftar drop-down Service Type.

        • Untuk membuat tujuan API kustom: Di bagian Basic Information, pilih Custom untuk parameter Metode. Lalu, konfigurasikan parameter lainnya dengan mengikuti petunjuk di bagian "Buat tujuan API" topik ini.

        • Untuk menggunakan tujuan API yang sudah ada: Di bagian Basic Information, pilih Use Existing Item untuk parameter Metode dan pilih tujuan API yang sudah dibuat dari daftar drop-down.

    Operasi lain yang didukung

    Setelah tujuan API dibuat, Anda dapat melihat, memodifikasi, dan menghapus tujuan API di konsol EventBridge.

    Other supported operations

    • Lihat detail tujuan API: Temukan tujuan API yang Anda buat dan klik Details di kolom Actions untuk melihat informasi dasar, konfigurasi API, dan konfigurasi terhubung dari tujuan API tersebut.

    • Modifikasi tujuan API: Temukan tujuan API yang Anda buat dan klik Edit di kolom Actions untuk memodifikasi deskripsi dan konfigurasi API dari tujuan API tersebut.

    • Hapus tujuan API: Temukan tujuan API yang Anda buat dan klik Delete di kolom Actions. Baca pesan Note yang muncul dan klik OK.