Mengembangkan proxy API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Catatan: Gunakan pengembangan lokal dengan Apigee dan Apigee Hybrid 1.5 dan yang lebih tinggi.

Mengekspos API di Apigee dengan mengimplementasikan proxy API. Proxy API memisahkan API yang ditampilkan ke aplikasi dari layanan backend Anda, sehingga melindungi aplikasi tersebut dari perubahan kode backend.

Kembangkan proxy API Anda menggunakan Apigee di Cloud Code seperti yang dijelaskan di bagian berikut. Lihat juga Mengelola folder dan file di ruang kerja Apigee.

Sebelum memulai: Pahami konsep yang dijelaskan dalam topik berikut:

• Memahami API dan proxy API
• Poin penting dari pengembangan proxy API

Membuat proxy API

Untuk membuat proxy API menggunakan Apigee di {code_name}}:

1. Lakukan salah satu tindakan berikut:

   • Di bagian Apigee, posisikan kursor ke folder apiproxies, lalu klik .

     

   • Pilih Lihat > Palet Perintah untuk membuka palet Perintah, lalu pilih Cloud Code: Buat paket proxy Apigee.

   Wizard Buat proxy akan terbuka.

2. Pilih salah satu opsi berikut:

   Jenis	Deskripsi
   Reverse proxy	Proxy API yang merutekan permintaan masuk ke layanan backend HTTP yang ada. Bisa JSON atau XML API. Lihat Membuat pembalikan proxy untuk layanan HTTP nanti di bagian ini.
   No target	Proxy API tanpa backend API ("tidak ada target"). Mirip dengan Membuat reverse proxy untuk HTTP , kecuali Anda tidak akan menentukan URL target yang sudah ada saat menentukan detail proxy API.

Bagian berikut menjelaskan langkah-langkah tambahan yang diperlukan untuk membuat setiap jenis proxy API.

Membuat reverse proxy untuk layanan HTTP

Apigee membuat proxy API terbalik berdasarkan informasi berikut:

• URL layanan backend
• Jalur URI yang mengidentifikasi API secara unik yang akan diekspos oleh proxy API ke aplikasi konsumen

Jika memilih Reverse proxy saat membuat proxy API, Anda akan diminta untuk memberikan Autentikasi keamanan dan detail proxy API yang dijelaskan dalam tabel berikut.

Untuk Security authentication, pilih salah satu opsi berikut:

Autentikasi keamanan	Deskripsi
API key based authentication	Menambahkan verifikasi kunci API sederhana ke proxy API yang Anda mendefinisikan. Apigee otomatis menambahkan kebijakan berikut ke proxy API Anda: VerifyAPIKey untuk memvalidasi kunci API yang diberikan dengan meminta aplikasi. TetapkanMessage untuk menghapus kunci API, yang disediakan dalam panggilan API sebagai parameter kueri, dari permintaan diteruskan ke server backend.
Access token based authentication	Menambahkan autentikasi berbasis OAuth 2.0 ke proxy API Anda. Apigee secara otomatis menambahkan kebijakan berikut pada proxy API Anda: VerifyAPIKey untuk memverifikasi token akses. TetapkanMessage untuk menghapus header Authorization yang diteruskan untuk autentikasi. Untuk mempelajari cara mengautentikasi menggunakan token akses, lihat Memverifikasi token akses.
No authentication	Tidak diperlukan autentikasi. Permintaan diteruskan ke backend tanpa keamanan apa pun pemeriksaan di Apigee.

Untuk detail proxy API, tanggapi setiap perintah berikut dan tekan Enter untuk mengonfirmasi dan melanjutkan, atau Esc untuk membatalkan wizard:

Kolom	Deskripsi
Backend target URL	URL layanan backend yang dipanggil oleh proxy API ini.
API proxy name	Nama yang ditampilkan untuk API Anda. Tentukan karakter alfanumerik, tanda hubung (-), atau garis bawah (_). Catatan: Nama proxy API tidak boleh sama dengan nama proxy API apa pun di organisasi yang dapat di-deploy ke lingkungan dengan Deployment proxy diaktifkan.
API proxy base path	Fragmen URI yang muncul setelah alamat http://[host] atau https://[host] proxy API Anda. Apigee menggunakan URI jalur dasar untuk mencocokkan dan merutekan pesan permintaan masuk ke proxy API yang tepat. Catatan: Jalur dasar harus unik; Anda tidak dapat men-deploy dua proxy API dengan jalur dasar yang sama. Jika Anda mengedit proxy API yang di-deploy dan menetapkan jalur dasar ke nilai yang sama dengan jalur dasar proxy API lainnya, Apigee secara otomatis membatalkan deployment proxy API saat Anda menyimpannya. Sebelum dapat men-deploy ulang proxy API, Anda harus mengedit jalur dasar agar menjadi unik. Menggunakan karakter pengganti di jalur dasar Gunakan satu atau beberapa karakter pengganti /*/ di jalur dasar proxy API agar proxy API Anda siap menghadapi masa depan. Misalnya, jalur dasar /team/*/members memungkinkan klien memanggil https://[host]/team/blue/members dan https://[host]/team/green/members tanpa perlu membuat proxy API baru untuk mendukung tim baru. Perlu diketahui bahwa /**/ tidak didukung.

Setelah Anda menyelesaikan langkah-langkah di wizard, folder apiproxy-name baru akan ditambahkan di bagian apiproxies di bagian Apigee. Setiap folder proxy API memiliki struktur seperti yang dijelaskan di struktur direktori konfigurasi proxy API.

Berikut ini contoh konfigurasi default yang dibuat untuk proxy reverse API bernama helloworld dengan kebijakan yang ditambahkan untuk mendukung autentikasi berbasis kunci API.

Untuk mengetahui deskripsi tentang konfigurasi default, lihat Menjelajahi konfigurasi proxy API default.

Membuat proxy API tanpa target backend

Proses pembuatan proxy API tanpa target backend sama dengan membuat reverse proxy, tetapi Anda tidak diminta menentukan URL untuk layanan backend (Target (Existing API)) dan konfigurasi endpoint target default tidak disertakan. Lihat Membuat reverse proxy untuk layanan HTTP untuk informasi selengkapnya.

Menjelajahi konfigurasi proxy API default

Tabel berikut merangkum konten yang disertakan dalam konfigurasi default saat Anda membuat proxy API berdasarkan jenis proxy API dan opsi autentikasi yang dipilih.

Konfigurasi fileReverse proxy	Reverse proxy	Tidak ada target	Autentikasi OAuthV2	Autentikasi kunci API
proxies/default.xml Konfigurasi endpoint proxy default.
targets/default.xml Konfigurasi endpoint target default.
impose-quota.xml Kebijakan kuota untuk menentukan kuota default.
remove-header-authorization.xml Kebijakan MenetapkanMessage untuk menghapus header Authorization yang diteruskan untuk autentikasi.
remove-query-param-apikey.xml Kebijakan MenetapkanMessage untuk menghapus parameter kueri apikey yang diteruskan untuk autentikasi.
verify-api-key.xml Kebijakan VerifyAPIKey untuk menerapkan verifikasi kunci API.
verify-oauth-v2-access-token.xml Kebijakan OAuthV2 untuk memvalidasi token akses OAuth V2.

Mengupload paket proxy API

Untuk mengupload paket proxy API ke Apigee di Cloud Code:

1. Lakukan salah satu tindakan berikut:

   • Di bagian Apigee, posisikan kursor ke folder apiproxies, lalu klik .

   • Pilih Lihat > Palet Perintah untuk membuka palet Perintah, lalu pilih Cloud Code: Impor paket proxy Apigee.

2. Buka paket proxy API yang ingin diupload, lalu klik Import proxy. Paket proxy API harus disusun seperti yang dijelaskan dalam struktur direktori konfigurasi proxy API.

3. (Opsional) Secara default, nama file ZIP tanpa ekstensinya digunakan untuk nama proxy API. Jika nama ini tidak unik, Anda akan diminta untuk memasukkan nama yang unik.

Folder apiproxy-name yang diupload akan ditambahkan di apiproxies di bagian Apigee.

Mengelola endpoint proxy

Seperti yang dijelaskan dalam Apa itu proxy API?, endpoint proxy (ProxyEndpoint) menentukan cara aplikasi klien menggunakan API Anda. Anda konfigurasikan endpoint proxy untuk menentukan URL proxy API Anda. Endpoint proxy juga menentukan apakah aplikasi mengakses proxy API melalui HTTP atau HTTPS. Anda dapat melampirkan kebijakan ke endpoint proxy untuk menerapkan keamanan, pemeriksaan kuota, akses kontrol dan pembatasan kapasitas.

Buat dan konfigurasi endpoint proxy seperti yang dijelaskan di bagian berikut.

Membuat endpoint proxy

Saat Anda membuat proxy API, endpoint proxy default akan ditambahkan ke konfigurasi proxy API. Untuk informasi selengkapnya, lihat Menjelajahi konfigurasi proxy API default. Anda dapat membuat endpoint proxy tambahan, sesuai kebutuhan.

Catatan: Sebelum menambahkan beberapa endpoint proxy, tinjau topik berikut Antipola: Menentukan beberapa ProxyEndpoint di proxy API.

Untuk membuat endpoint proxy menggunakan Apigee di Cloud Code:

1. Di bagian Apigee, lakukan salah satu tindakan berikut:

   • Di bagian Apigee, posisikan kursor ke salah satu folder berikut, klik , lalu pilih Buat endpoint proxy:
     • Paket proxy apiproxy-name
     • apiproxy-name/apiproxy
   • Di bagian Apigee, posisikan kursor ke folder apiproxy-name/apiproxy/proxies, lalu klik .

   Wizard Buat endpoint proxy akan terbuka.

2. Masukkan nilai untuk kumpulan perintah berikutnya. Tekan Enter untuk mengonfirmasi dan melanjutkan atau Esc untuk membatalkan.

   Kolom	Deskripsi
   Proxy endpoint name	Nama yang digunakan untuk mengidentifikasi endpoint proxy.
   API proxy base path	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.

Endpoint dibuat dan ditambahkan ke folder apiproxy-name/apiproxy/proxies di bagian Apigee dan dibuka di editor. Konfigurasikan endpoint proxy, seperti yang dijelaskan di bagian berikut.

Mengonfigurasi endpoint proxy

Untuk mengonfigurasi endpoint proxy, lihat bagian berikut:

• Mengontrol cara proxy dieksekusi dengan flow
• Menentukan URL endpoint proxy API
• Menambahkan fitur menggunakan kebijakan
• Mengelola resource
• Konfigurasi ProxyEndpoint
• Referensi konfigurasi flow
• Referensi properti endpoint

Mengelola endpoint target

Seperti yang dijelaskan dalam Apa itu proxy API?, endpoint target (TargetEndpoint) menentukan cara proxy API berinteraksi dengan dan layanan backend. Anda mengonfigurasi endpoint target untuk meneruskan permintaan ke backend yang tepat layanan IT, termasuk menentukan setelan keamanan, protokol HTTP atau HTTPS, dan koneksi tidak akurat atau tidak sesuai. Anda dapat melampirkan kebijakan ke endpoint target untuk memastikan bahwa pesan respons diformat dengan benar untuk aplikasi yang membuat permintaan awal.

Buat dan konfigurasi endpoint target seperti yang dijelaskan di bagian ini.

Membuat endpoint target

Saat Anda membuat proxy reverse API, endpoint target default akan ditambahkan ke konfigurasi proxy API. Saat membuat proxy API tanpa target backend, hanya endpoint proxy default yang ditambahkan ke konfigurasi proxy API, dan tidak ada endpoint target yang ditambahkan. Untuk informasi selengkapnya, lihat Menjelajahi konfigurasi proxy API default.

Buat endpoint target, sesuai kebutuhan.

Catatan: Proxy API tidak memerlukan endpoint target. Endpoint proxy dapat dikonfigurasi untuk memanggil URL secara langsung. Proxy API tanpa endpoint target biasanya berisi endpoint proxy yang secara langsung memanggil layanan backend atau dikonfigurasi untuk memanggil layanan menggunakan Java atau JavaScript.

Untuk membuat endpoint target menggunakan Apigee di Cloud Code:

1. Di bagian Apigee, lakukan salah satu tindakan berikut:

   • Di bagian Apigee, posisikan kursor ke salah satu folder berikut, klik , lalu pilih Buat endpoint target:
     • Paket proxy apiproxy-name
     • apiproxy-name/apiproxy
   • Di bagian Apigee, posisikan kursor ke folder apiproxy-name/apiproxy/targets, lalu klik .

   Wizard Buat endpoint target akan terbuka.

2. Lakukan langkah-langkah berikut berdasarkan jenis endpoint target yang ingin Anda buat:

   Jenis	Langkah
   Target HTTP eksternal	Untuk menentukan target HTTP eksternal: Pilih HTTP(s) target. Masukkan nama endpoint target di Nama endpoint target. Masukkan URL layanan backend yang dipanggil endpoint target ini di URL target backend. Untuk informasi selengkapnya, lihat Menentukan URL endpoint target.
   Perantaian proxy	Untuk menentukan proxy API yang di-deploy secara lokal sebagai target: Pilih Perantaian proxy. Masukkan nama endpoint target di Nama endpoint target. Pilih proxy API. Pilih endpoint proxy. Untuk informasi selengkapnya, lihat Menautkan proxy bersama-sama.
   Target load balanced	Untuk menentukan target load balanced menggunakan server target yang ditentukan di lingkungan: Pilih Target load balanced. Masukkan nama endpoint target di Nama endpoint target. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi TargetEndpoint untuk melakukan load balancing di seluruh TargetServers yang bernama.

Endpoint target dibuat dan ditambahkan ke folder apiproxy-name/apiproxy/targets di bagian Apigee dan dibuka di editor. Konfigurasi endpoint target, seperti yang dijelaskan di bagian berikut.

Mengonfigurasi endpoint target

Konfigurasi endpoint target, seperti yang dijelaskan dalam topik berikut.

• Load balancing di semua server backend
• Mengontrol cara proxy dieksekusi dengan flow
• Menghubungkan proxy API menjadi satu
• Menentukan URL endpoint target
• Menambahkan fitur menggunakan kebijakan
• Mengelola resource
• Konfigurasi TargetEndpoint
• Referensi konfigurasi flow
• Referensi properti endpoint