Anda dapat men-deploy Apidog Request Proxy Agent pada mesin dengan lingkungan jaringan yang sesuai. Hal ini memungkinkan permintaan endpoint dari klien Apidog, web, atau dokumentasi bersama untuk dirutekan melalui agent ini ke endpoint target.Fitur ini sangat berguna untuk men-debug endpoint pada dokumentasi bersama, karena membantu mengatasi masalah cross-origin resource sharing (CORS). Fitur ini ideal untuk skenario ketika lingkungan yang berbeda memiliki persyaratan jaringan tertentu, sehingga debugging langsung dari lingkungan lokal tidak memungkinkan.Prasyarat#
Server, sebaiknya menjalankan Linux.
Docker terinstal pada server (Versi minimum yang diperlukan: 20.10.0. Versi yang direkomendasikan: 20.10.13). Men-deploy Request Proxy Agent#
Request proxy agent adalah sumber daya tingkat tim/organisasi. Setelah di-deploy, agent ini dapat digunakan di semua proyek dalam tim atau organisasi Anda. Untuk men-deploy agent pada server yang mendukung Docker, jalankan perintah berikut:Anda dapat mengonfigurasi pengaturan dasar menggunakan variabel lingkungan selama deployment. Gunakan opsi berikut sesuai kebutuhan:| Variabel Lingkungan | Deskripsi | Contoh |
|---|
| SOURCE_IP_WHITELIST | Daftar IP sumber yang diizinkan, dipisahkan dengan koma (Karena pembatasan sistem operasi, variabel ini hanya dapat digunakan pada Linux dan harus digunakan dengan --network=host.) | --network=host
-e SOURCE_IP_WHITELIST=134.34.4.3,123.333.33.0/24 |
| SOURCE_IP_BLACKLIST | Daftar IP sumber yang diblokir, dipisahkan dengan koma (Karena pembatasan sistem operasi, variabel ini hanya dapat digunakan pada Linux dan harus digunakan dengan --network=host.) | --network=host
-e SOURCE_IP_BLACKLIST=134.34.4.3,123.333.33.0/24 |
| DESTINATION_DOMAIN_WHITELIST | Daftar nama domain target yang diizinkan, dipisahkan dengan koma | -e DESTINATION_DOMAIN_WHITELIST=xxx.yyy.com,*.yyy.com |
| DESTINATION_DOMAIN_BLACKLIST | Daftar nama domain target yang diblokir, dipisahkan dengan koma | -e DESTINATION_DOMAIN_BLACKLIST=xxx.yyy.com,*.yyy.com |
| DESTINATION_IP_WHITELIST | Daftar IP target yang diizinkan, dipisahkan dengan koma | -e DESTINATION_IP_WHITELIST=134.34.4.3,123.333.33.0/24 |
| DESTINATION_IP_BLACKLIST | Daftar IP target yang diblokir, dipisahkan dengan koma | -e DESTINATION_IP_BLACKLIST=134.34.4.3,123.333.33.0/24 |
| ALLOW_PRIVATE_IP | Izinkan permintaan ke IP internal (boolean, default adalah false) | -e ALLOW_PRIVATE_IP=false |
Apidog Request Proxy Agent bersifat open-source, sehingga Anda dapat menyesuaikannya lebih lanjut untuk memenuhi kebutuhan Anda (misalnya, menambahkan parameter header kustom). Akses kode sumber di sini.
Menambahkan Request Proxy Agent di Apidog#
Setelah Apidog request proxy agent berjalan di Docker, Anda dapat menambahkannya ke sumber daya tim di Apidog. Masukkan informasi host server (port default adalah 9159) di jendela pop-up dan klik simpan. Apidog kemudian akan mencoba terhubung.Jika koneksi gagal, Anda akan melihat notifikasi dan pembuatan tidak akan diizinkan.
Jika koneksi berhasil, request proxy agent akan berhasil dibuat dalam tim Anda.
