Anda sedang melihat dokumentasi Apigee Edge.
Buka
Dokumentasi Apigee X. info
Anda dapat menentukan bahwa satu {i>proxy<i} adalah titik akhir target dari {i>proxy<i} lain, yang secara efektif menghubungkan dua {i>proxy<i} dalam rantai {i>proxy<i}. Membuat rantai {i>proxy<i} dengan cara ini dapat membantu Anda menghindari {i>network hop<i}, dan jadi meningkatkan performa secara keseluruhan.
Dengan perantaian proxy, Anda menentukan bahwa satu proxy adalah endpoint target lokal yang lain.
Daripada menggunakan elemen HTTPTargetConnection
untuk melakukan panggilan ke elemen kedua
gunakan elemen LocalTargetConnection
.
<LocalTargetConnection> <APIProxy>myproxy2</APIProxy> <ProxyEndpoint>default</ProxyEndpoint> </LocalTargetConnection>
Anda mungkin menemukan manfaat perantaian proxy ketika Anda memiliki {i>proxy<i} yang menawarkan beberapa tingkat fungsionalitas yang akan digunakan oleh {i>proxy<i} lain. Misalnya, {i>proxy<i} yang mengekspos operasi create/read/update/delete dengan penyimpanan data backend dapat menjadi proxy target untuk beberapa {i>proxy<i} lain yang mengekspos data ke klien.
Video: Tonton video singkat untuk mempelajari lebih lanjut perantaian proxy API.
Cara kerja perantaian proxy
Perantaian proxy menggunakan koneksi lokal untuk meminimalkan overhead jaringan saat memanggil satu proxy dari yang lain. Koneksi lokal ini lebih efisien karena melewati fitur jaringan seperti sebagai load balancer, router, dan pemroses pesan.
Berikut ini perbedaan antara menghubungkan proxy menggunakan HTTPTargetConnection
dan LocalTargetConnection
(peranan proxy):
Anda menghubungkan proxy dengan menentukan bahwa salah satunya adalah endpoint target lokal yang lain. Anda dapat membuat koneksi lokal antar {i>proxy<i} dengan dua cara:
- Dengan menentukan nama proxy target dan nama
ProxyEndpoint
- Dengan menentukan jalur ke endpoint proxy target
Anda menghubungkan proxy target dalam konfigurasi TargetEndpoint
, menggunakan
LocalTargetConnection
, seperti yang dijelaskan di bawah ini.
Menghubungkan proxy berdasarkan nama proxy
Anda dapat menentukan proxy target berdasarkan nama. Anda mungkin menemukan bahwa ini paling berguna ketika Anda membuat koneksi dari awal dan mengembangkan {i>proxy<i} bersama-sama. Jika Anda tidak tahu (atau namanya mungkin berubah), pertimbangkan untuk menghubungkan dengan jalur endpoint proxy target, karena yang dijelaskan di bawah.
Saat terhubung ke proxy target menurut nama, Anda menentukan nama proxy dan nama proxy
ProxyEndpoint
.
Contoh berikut menentukan proxy target yang disebut data-manager
, beserta
nama ProxyEndpoint
yang ditampilkan oleh data-manager
. Untuk referensi
informasi selengkapnya, lihat Referensi konfigurasi proxy API.
<TargetEndpoint name="datamanager"> <PreFlow name="PreFlow"> <!-- PreFlow policies --> </PreFlow> <PostFlow name="PostFlow"> <!-- PostFlow policies --> </PostFlow> <LocalTargetConnection> <APIProxy>data-manager</APIProxy> <ProxyEndpoint>default</ProxyEndpoint> </LocalTargetConnection> </TargetEndpoint>
Menghubungkan proxy menurut jalur
Anda dapat menentukan proxy target berdasarkan jalur endpoint-nya. Anda mungkin ingin melakukannya dengan cara ini ketika Anda tidak mengetahui nama {i>proxy<i}, atau kapan namanya mungkin berubah.
Jika proxy Anda hanyalah konsumen proxy target—seperti saat Anda sedang tidak mengembangkan keduanya—jalur tersebut mungkin menjadi cara yang paling dapat diandalkan untuk terhubung. Misalnya, jika {i>proxy<i} yang Anda dikembangkan dan dikelola oleh tim lain, Anda mungkin ingin terhubung menggunakan yang dapat diandalkan.
Contoh berikut menetapkan proxy target di
/v1/streetcarts/foodcarts/data-manager
, yang mana host dianggap sama dengan
{i>proxy<i} saat ini. Untuk informasi referensi, lihat Referensi konfigurasi proxy API.
<TargetEndpoint name="datamanager"> <PreFlow name="PreFlow"> <!-- PreFlow policies --> </PreFlow> <PostFlow name="PostFlow"> <!-- PostFlow policies --> </PostFlow> <LocalTargetConnection> <Path>/v1/streetcarts/foodcarts/data-manager</Path> </LocalTargetConnection> </TargetEndpoint>
Menghubungkan {i>proxy<i} dengan manajemen konsol
Anda dapat membuat koneksi perantaian proxy menggunakan konsol pengelolaan Edge.
- Buka proxy yang akan memakai proxy target.
- Di Navigator, klik tanda plus di samping Target Endpoints.
- Dalam dialog New Target Endpoint, masukkan nama endpoint target.
- Di bawah kotak Target Endpoint Name, pilih salah satu opsi berikut:
-
Rantai Proxy untuk memilih dari daftar proxy yang sudah ada di organisasi dan
lingkungan fleksibel App Engine.
- Di menu drop-down Nama Proxy, pilih proxy target.
- Di kotak Endpoint Proxy, masukkan jalur endpoint proxy target yang ingin Anda hubungkan.
- Peranan Jalur untuk memasuki jalur dasar proxy target, seperti
/mypath/myproxy/myendpoint
.
-
Rantai Proxy untuk memilih dari daftar proxy yang sudah ada di organisasi dan
lingkungan fleksibel App Engine.
- Klik Tambahkan.
Proxy berantai, produk API, dan keamanan
Perantaian proxy paling cocok untuk kasus ketika kedua proxy berada dalam produk API yang sama. Secara {i>default<i}, keduanya tersedia untuk klien. Apigee saat ini tidak mendukung pemaketan proxy kedua dalam produk API terpisah yang seharusnya tidak dapat diakses oleh klien.
Jika {i>proxy<i} kedua Anda harus diamankan dari permintaan klien langsung, pertimbangkan untuk menambahkan logika ke meminta {i>proxy<i} kedua Anda memeriksa alamat IP klien. Jika panggilan telepon dilakukan melalui perantaian, alamat IP-nya akan bersifat lokal. Kode Anda dapat memvalidasi bahwa kode tersebut bersifat lokal sebelum mengizinkan sebelum melanjutkan. Lihat kebijakan Kontrol Akses untuk satu untuk melakukan ini.