Mengembangkan proxy API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Baca dokumentasi Apigee Edge.

Mengekspos API di Apigee dengan menerapkan 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.

Membuat proxy API

Untuk membuat proxy API menggunakan Apigee di Cloud Code, pastikan Anda telah membuat ruang kerja pengembangan lokal, lalu:

  1. Lakukan salah satu tindakan berikut:

    • Di ruang kerja, arahkan kursor ke folder apiproxies, lalu klik Membuat ikon proxy API.

      + ditampilkan saat Anda memosisikan kursor ke folder apiproxies

    • Pilih View > Command Palette untuk membuka Command palette, lalu pilih Cloud Code: Create Apigee proxy bundle.

    Wizard Create proxy akan terbuka.

  2. Pilih salah satu opsi berikut:

    Jenis Deskripsi
    Access token-based authentication

    Menambahkan autentikasi berbasis OAuth 2.0 ke proxy API Anda. Apigee otomatis menambahkan kebijakan berikut ke proxy API Anda:

    • Kuota untuk mengelola kuota di proxy.
    • AssignMessage untuk menghapus kunci API, yang disediakan dalam panggilan API sebagai parameter kueri, dari permintaan yang diteruskan ke server backend.
    • OAuthV2 sebagai metode autentikasi.
    API key-based authentication

    Proxy API yang menggunakan verifikasi kunci API sederhana. Apigee otomatis menambahkan kebijakan berikut ke proxy API Anda:

    • Kuota untuk mengelola kuota di proxy.
    • VerifyAPIKey untuk memvalidasi kunci API yang ditampilkan oleh aplikasi yang meminta.
    • AssignMessage untuk menghapus kunci API, yang disediakan dalam panggilan API sebagai parameter kueri, dari permintaan yang diteruskan ke server backend.
    Echo request

    Proxy API yang mengulang permintaan. Tidak ada backend target/API untuk jenis proxy ini dan tidak ada autentikasi. Anda tidak diminta untuk menentukan URL untuk layanan backend (Target (Existing API)) dan konfigurasi endpoint target default tidak disertakan.

    Simple reverse proxy

    Proxy API yang meneruskan permintaan ke target backend. API ini tidak menyertakan autentikasi, sehingga permintaan diteruskan ke backend tanpa pemeriksaan keamanan.
    OpenAPI 3.0 spec

    Buat proxy dengan memuat spesifikasi OpenAPI 3.0 yang ada. Untuk informasi selengkapnya, lihat OpenAPI Initiative.

  3. Lihat Kolom utama proxy API untuk mengetahui informasi tentang kolom, seperti jalur dasar, yang diperlukan untuk membuat setiap jenis proxy. Respons setiap perintah dan tekan Enter untuk mengonfirmasi dan melanjutkan, atau Esc untuk membatalkan wizard.

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

Berikut adalah contoh konfigurasi default yang dibuat untuk proxy API yang dibuat dengan jenis API key-based authentication.

Struktur folder proxy autentikasi berbasis kunci API

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

Mempelajari konfigurasi proxy API default

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

File konfigurasi
Reverse proxy sederhana
Permintaan echo
Autentikasi token akses (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 AssignMessage untuk menghapus header Authorization yang diteruskan untuk autentikasi.		    
 
remove-query-param-apikey.xml
Kebijakan AssignMessage untuk menghapus parameter kueri apikey yang diteruskan untuk autentikasi.		      
verify-api-key.xml
Kebijakan VerifyAPIKey untuk menerapkan verifikasi kunci API.		      
Kebijakan verify-oauth-v2-access-token.xml
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 ruang kerja Apigee, posisikan kursor ke folder apiproxies, lalu klik Ikon impor paket proxy API.

    • Pilih View > Command Palette untuk membuka Command palette, lalu pilih Cloud Code: Import Apigee proxy bundle.

  2. Buka paket proxy API yang ingin Anda upload, lalu klik Pilih. Paket proxy API harus disusun seperti yang dijelaskan dalam Struktur direktori konfigurasi proxy API.

  3. (Opsional) Secara default, nama file zip tanpa ekstensi 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 bagian apiproxies di ruang kerja Anda.

Mengelola endpoint proxy

Seperti yang dijelaskan dalam Apa yang dimaksud dengan proxy API?, endpoint proxy (ProxyEndpoint) menentukan cara aplikasi klien menggunakan API Anda. Anda mengonfigurasi 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, dan jenis kontrol akses dan pembatasan kapasitas lainnya.

Buat dan konfigurasikan 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.

Untuk membuat endpoint proxy menggunakan Apigee di Cloud Code:

  1. Di ruang kerja Apigee, lakukan salah satu tindakan berikut:

    • Arahkan kursor ke salah satu folder berikut, klik Membuat ikon endpoint proxy, lalu pilih Create proxy endpoint:
      • Paket proxy apiproxy-name
      • apiproxy-name/apiproxy
    • Arahkan kursor ke folder apiproxy-name/apiproxy/proxies, lalu klik Membuat ikon endpoint proxy.

    Wizard Create proxy endpoint akan terbuka.

  2. Masukkan nilai untuk kumpulan perintah berikutnya. Tekan Enter setelah setiap perintah 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 URL yang digunakan untuk membuat permintaan ke API Anda. Apigee menggunakan URL untuk mencocokkan dan merutekan permintaan masuk ke proxy API yang sesuai.
    Target endpoint Pilih no target atau default. Lihat Elemen konfigurasi ProxyEndpoint untuk mengetahui informasinya.

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:

Mengelola endpoint target

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

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

Membuat endpoint target

Saat Anda membuat proxy API terbalik, 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, tidak ada endpoint target yang ditambahkan. Untuk informasi selengkapnya, lihat Menjelajahi konfigurasi proxy API default.

Buat endpoint target, sesuai kebutuhan.

Untuk membuat endpoint target menggunakan Apigee di Cloud Code:

  1. Di ruang kerja Apigee, lakukan salah satu tindakan berikut:

    • Arahkan kursor ke salah satu folder berikut, klik Membuat ikon endpoint target, lalu pilih Create target endpoint:
      • Paket proxy apiproxy-name
      • apiproxy-name/apiproxy
    • Arahkan kursor ke folder apiproxy-name/apiproxy/targets, lalu klik Membuat ikon endpoint target.

    Wizard Create target endpoint akan terbuka.

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

    Jenis Langkah
    Target HTTP(s) eksternal

    Untuk menentukan target HTTP(s) eksternal:

    1. Pilih Target HTTP(s).
    2. Masukkan nama endpoint target di Target endpoint name.
    3. Masukkan URL layanan backend yang dipanggil endpoint target ini di Backend target URL.

    Untuk mengetahui informasi selengkapnya, lihat Menentukan URL endpoint target.
    Rantai proxy

    Untuk menentukan proxy API yang di-deploy secara lokal sebagai target Anda:

    1. Pilih Perantaian proxy.
    2. Masukkan nama endpoint target di Target endpoint name.
    3. Pilih proxy API.
    4. Pilih endpoint proxy.

    Untuk informasi selengkapnya, lihat Menyambungkan proxy.

    Target load balancing

    Untuk menentukan target load balancing menggunakan server target yang ditentukan di lingkungan:

    1. Pilih Load balanced target.
    2. Masukkan nama endpoint target di Target endpoint name.

    Untuk informasi selengkapnya, lihat Mengonfigurasi TargetEndpoint untuk melakukan load balancing di seluruh TargetServer yang dinamai.

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

Mengonfigurasi endpoint target

Konfigurasikan endpoint target, seperti yang dijelaskan dalam topik berikut.