Mulai menggunakan target Integrasi proxy Apigee dan Apigee

Tutorial ini menunjukkan cara menggunakan wizard proxy Apigee untuk membuat proxy dengan Target integrasi. Proxy menggunakan referensi pemicu API dari integrasi yang ada untuk memulai urutan langkah dalam integrasi.

Langkah-langkah di bawah ini menjelaskan cara mengonfigurasi proxy Integration target untuk menjalankan integrasi yang berhasil saat proxy dipanggil.

Sebelum memulai

  • Konfirmasi kredensial login dan detail organisasi Apigee Anda. Informasi ini diperlukan untuk mengakses fitur Integrasi Apigee dan wizard proxy dalam UI Apigee.
  • Buat dan publikasikan integrasi dengan Pemicu API dan setidaknya satu tugas.
    • Jika Anda belum membuat integrasi yang menggunakan Pemicu API, ikuti langkah-langkah dalam artikel Memulai Integrasi Apigee.
    • Catat nama integrasi yang Anda buat, atau integrasi lama yang ingin digunakan, karena hal ini digunakan dalam langkah berikutnya.
  • Buat akun layanan Google di project Google Cloud yang sama tempat organisasi Apigee Anda dibuat, dan lakukan langkah berikut:
    • Tetapkan peran Apigee Integration Invoker (roles/integrations.apigeeIntegrationInvokerRole) ke akun layanan. Untuk informasi tentang peran Integrasi Apigee yang telah ditetapkan, lihat Peran IAM yang telah ditetapkan.
    • Izinkan akun pengguna (akun utama) Anda untuk melampirkan akun layanan ke resource dengan izin iam.serviceAccounts.actAs. Untuk mengetahui informasi tentang izin akun layanan, lihat Peran untuk autentikasi akun layanan .

    Anda harus menyediakan akun layanan ini saat men-deploy proxy API.

Membuat proxy target Integrasi Apigee

Lakukan hal berikut untuk membuat proxy Target integrasi di UI Apigee:

  1. Buka UI Apigee dan login.
  2. Pilih organisasi Anda menggunakan menu drop-down di sudut kiri atas UI.
  3. Klik API Proxy di tampilan utama.

    Atau, Anda dapat memilih Develop > API Proxies di menu navigasi sebelah kiri.

  4. Dari menu drop-down Environment, pilih lingkungan tempat Anda ingin membuat proxy API baru.
  5. Klik Create New.
  6. Pilih Integration target dari tampilan jenis proxy.

    Wizard Create Proxy akan dimulai.

  7. Di halaman konfigurasi Detail proxy, berikan detail berikut:
    • Nama: Masukkan nama untuk proxy.

      Nama proxy dapat berisi karakter alfanumerik, tanda pisah, dan garis bawah.

    • Jalur Dasar: Jalur ini diisi otomatis berdasarkan nama proxy.

      Jalur Dasar adalah bagian dari URL yang digunakan untuk membuat permintaan ke API Anda. Apigee menggunakan URL untuk mencocokkan dan mengarahkan permintaan masuk ke proxy API yang tepat.

    • Deskripsi: (Opsional) Masukkan deskripsi singkat tentang proxy.

      Misalnya, Proxy test for Apigee Integration.

    • Region integrasi: Pilih region integrasi dari menu drop-down.
    • Target integrasi: Pilih nama target integrasi dari menu drop-down. Perhatikan bahwa daftar target integrasi diisi berdasarkan region integrasi yang dipilih.
    • Pemicu: Pilih pemicu API yang terkait dengan integrasi dari menu drop-down.
    • Jenis endpoint: Pilih Sinkronisasi.
  8. Klik Next.
  9. Di halaman konfigurasi Kebijakan umum, biarkan pilihan default, lalu klik Berikutnya.
  10. Di halaman Summary, klik Create.

    Proxy Target integrasi berhasil dibuat.

Men-deploy proxy

Lakukan langkah-langkah berikut untuk men-deploy proxy yang baru dibuat:

  1. Di Apigee UI, pilih Develop > API Proxies.

    UI menampilkan daftar proxy API dan status deployment-nya.

  2. Dari menu drop-down Environment, pilih lingkungan tempat Anda ingin men-deploy proxy API.

  3. Klik proxy yang baru saja dibuat yang ingin di-deploy. UI menampilkan halaman Overview secara default.

  4. Untuk men-deploy perubahan, pertama-tama klik Deploy untuk menampilkan dialog Deploy.
  5. Masukkan info berikut:
    • Revisi: Nomor revisi proxy yang ingin Anda deploy.
    • Environment: Lingkungan tempat Anda ingin men-deploy proxy.
    • Akun layanan: Akun layanan yang dibuat untuk proxy.
  6. Klik Deploy.

UI akan memulai proses deployment revisi yang dipilih. Diperlukan waktu hingga satu menit hingga deployment proxy selesai.

Saat proxy di-deploy, kolom Status di bagian Deployment akan menampilkan ikon hijau untuk menunjukkan bahwa revisi 1 proxy telah di-deploy.

Menguji proxy target Integrasi

Jalankan perintah berikut dari jendela terminal untuk memanggil proxy dan memicu integrasi: 

curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME

dengan YOUR_ENV_GROUP_HOSTNAME adalah nama host untuk grup lingkungan yang berisi lingkungan tempat proxy Anda di-deploy.

Contoh: 

curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy

Untuk mengonfirmasi bahwa integrasi dipicu dengan memanggil proxy:

  1. Buka UI Apigee.
  2. Klik Develop > Integrations.
  3. Telusuri atau pilih nama integrasi yang dibuat pada langkah-langkah di atas, lalu klik nama integrasi.
  4. Klik Log.
  5. Pastikan bahwa log eksekusi ada untuk integrasi yang dipicu. Untuk melihat detail log, klik baris untuk meluaskan detail eksekusi.

Mengupdate payload permintaan proxy (Opsional)

Gunakan langkah-langkah berikut untuk mengupdate payload permintaan proxy:

  1. Di UI Apigee, pilih Develop > API Proxies di menu navigasi sebelah kiri.
  2. Klik proxy yang baru saja dibuat.

    Secara default, UI menampilkan tab Ringkasan untuk proxy tersebut di Proxy Editor.

  3. Klik tab Mengembangkan.
  4. Di panel Navigator, pilih Set Integration Request di bagian judul Policies.
  5. Hapus tanda komentar pada blok <Parameters>, lalu masukkan detail parameter Anda.

    Untuk menentukan parameter individual, gunakan elemen <Parameter>. Untuk menentukan array parameter, gunakan elemen <ParameterArray>.

  6. Klik Save.

Langkah selanjutnya

Pelajari Tata letak desainer integrasi dan pahami berbagai konsep integrasi yang dijelaskan dalam Semua konsep.