Apa yang dimaksud dengan ekstensi?

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

Anda dapat menggunakan ekstensi untuk mengintegrasikan resource eksternal ke dalam proxy API Anda. Misalnya, Anda dapat mengintegrasikan layanan Google Cloud Platform seperti Google Cloud Storage. Saat runtime, proxy API menggunakan ekstensi untuk menukar 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 adalah ringkasan tentang cara pemrosesan melalui ekstensi berfungsi saat runtime.

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

Menggunakan ekstensi

Setiap ekstensi dikembangkan dan dikonfigurasi dengan 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. Administrator mengonfigurasinya dengan nilai yang spesifik untuk kebutuhan bisnis. Konfigurasi ini membuat instance ekstensi yang berfokus untuk digunakan oleh developer proxy API. Misalnya, administrator dapat mengonfigurasi ekstensi untuk mengakses bucket tertentu di Google Cloud Storage, termasuk kredensial autentikasi yang diperlukan.
  • Seorang developer proxy API menggunakan ekstensi yang dikonfigurasi dalam proxy API dengan menambahkan kebijakan Panggilan Ekstensi ke proxy. Konfigurasi kebijakan menentukan
    • ekstensi yang dikonfigurasi untuk digunakan.
    • tindakan ekstensi (anggap ini sebagai panggilan fungsi ke ekstensi) yang akan dipanggil.
    • parameter tindakan yang akan diteruskan dengan panggilan tindakan. Saat runtime, kebijakan menggunakan ekstensi untuk mengakses resource eksternal sebagai bagian dari alur proxy.

Dokumentasi tentang ekstensi

Topik berikut memberikan informasi selengkapnya tentang ekstensi: