Apa itu ekstensi?

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Anda dapat menggunakan ekstensi untuk mengintegrasikan resource eksternal ke dalam proxy API. Misalnya, Anda dapat mengintegrasikan layanan Google Cloud Platform seperti Google Cloud Storage. Pada runtime, proxy API menggunakan ekstensi untuk bertukar permintaan dan respons dengan resource eksternal.

Framework runtime ekstensi

Saat runtime, ekstensi bertindak sebagai perantara, memproses permintaan dan respons antara proxy API dan resource eksternal.

Berikut ini ringkasan cara kerja pemrosesan melalui ekstensi saat runtime.

  1. Permintaan klien mencapai proxy API dan alur permintaannya berlanjut melalui kebijakan proxy.
  2. Alur permintaan mencapai kebijakan Info Ekstensi di proxy yang dikonfigurasi untuk meneruskan data ke ekstensi yang di-deploy di lingkungan. Data tersebut menyertakan nilai yang akan diperlukan untuk mengirim permintaan ke resource eksternal yang diwakili oleh ekstensi.
  3. Ekstensi mengirimkan permintaan ke resource eksternal, lalu menerima respons.
  4. Ekstensi meneruskan responsnya kembali ke kebijakan Info Ekstensi, yang ditangani oleh kode proxy.
  5. Alur permintaan berlanjut melalui proxy hingga menampilkan respons ke klien.

Bekerja dengan ekstensi

Setiap ekstensi dikembangkan dan dikonfigurasi dengan mempertimbangkan resource eksternal tertentu. Untuk menggunakan ekstensi, administrator Apigee Edge dan developer proxy API mengikuti langkah-langkah tingkat tinggi berikut:

  • Administrator organisasi Apigee Edge mengonfigurasi dan men-deploy ekstensi. Mereka mengonfigurasinya dengan nilai khusus untuk kebutuhan bisnis. Konfigurasi ini membuat instance ekstensi yang difokuskan untuk digunakan oleh developer proxy API. Misalnya, mereka dapat mengonfigurasi ekstensi untuk mengakses bucket tertentu di Google Cloud Storage, termasuk kredensial autentikasi yang diperlukan.
  • Developer proxy API menggunakan ekstensi yang dikonfigurasi di proxy API dengan menambahkan kebijakan Info Ekstensi ke proxy. Konfigurasi kebijakan menentukan
    • konfigurasi ekstensi yang akan digunakan.
    • tindakan ekstensi (anggap ini sebagai panggilan fungsi ke ekstensi) untuk dipanggil.
    • parameter tindakan yang akan diteruskan dengan panggilan tindakan. Pada runtime, kebijakan akan menggunakan ekstensi untuk mengakses resource eksternal sebagai bagian dari alur proxy.

Dokumentasi tentang ekstensi

Topik berikut memberikan informasi selengkapnya tentang ekstensi: