Pengaturan Proxy di Postman untuk Pengujian API: Panduan Lengkap dengan Contoh

Postman adalah salah satu alat paling populer untuk pengujian API yang digunakan oleh pengembang, insinyur QA, dan spesialis backend di seluruh dunia. Namun, apa yang harus dilakukan jika Anda perlu menguji API yang hanya tersedia dari wilayah tertentu, menghindari pemblokiran berdasarkan IP, atau memerlukan verifikasi permintaan dari lokasi yang berbeda? Solusinya adalah mengatur server proxy di Postman.

Dalam panduan ini, Anda akan belajar bagaimana cara mengatur proxy dengan benar di Postman untuk berbagai skenario: dari pengalihan lalu lintas yang sederhana hingga bekerja dengan endpoint yang dibatasi secara geografis dan debugging permintaan melalui server proxy perusahaan. Kami akan membahas pengaturan proxy global dan individu, bekerja dengan protokol HTTP dan SOCKS5, otentikasi, dan menyelesaikan masalah umum.

Mengapa menggunakan proxy saat menguji API

Server proxy dalam konteks pengujian API menyelesaikan beberapa tugas kritis yang tidak dapat dilakukan dengan alat standar Postman. Memahami skenario ini akan membantu Anda memilih jenis proxy yang tepat dan mengatur sesuai kebutuhan spesifik.

Pengujian API yang dibatasi secara geografis. Banyak API modern mengembalikan data yang berbeda tergantung pada lokasi geografis klien. Misalnya, API layanan cuaca, platform streaming, aplikasi keuangan, atau marketplace. Untuk menguji bagaimana aplikasi Anda berfungsi untuk pengguna dari Jerman, AS, atau Jepang, Anda memerlukan server proxy dengan alamat IP dari negara yang sesuai. Tanpa proxy, Anda secara fisik tidak dapat mereproduksi perilaku API untuk pengguna dari wilayah lain.

Menghindari pembatasan laju dan pemblokiran IP. Saat melakukan pengujian API secara intensif, Anda mungkin menghadapi batasan jumlah permintaan dari satu alamat IP. Banyak layanan menerapkan pembatasan laju di tingkat IP — misalnya, tidak lebih dari 100 permintaan per menit dari satu alamat. Rotasi proxy memungkinkan Anda mendistribusikan permintaan di antara beberapa alamat IP dan melanjutkan pengujian tanpa penundaan. Ini sangat relevan saat melakukan pengujian beban atau pemeriksaan otomatis.

Bekerja melalui proxy perusahaan. Jika Anda bekerja di perusahaan dengan kebijakan jaringan yang ketat, semua lalu lintas keluar mungkin melewati server proxy perusahaan. Dalam hal ini, mengatur proxy di Postman bukanlah pilihan, tetapi suatu keharusan. Tanpa konfigurasi yang benar, permintaan Anda tidak akan sampai ke API eksternal.

Debugging dan pemantauan lalu lintas. Server proxy dapat digunakan untuk menangkap dan menganalisis lalu lintas HTTP/HTTPS. Alat seperti Charles Proxy, Fiddler, atau mitmproxy memungkinkan Anda melihat detail setiap permintaan dan respons, termasuk header, tubuh permintaan, dan waktu eksekusi. Dengan mengatur Postman untuk bekerja melalui proxy semacam itu, Anda mendapatkan alat yang kuat untuk debugging interaksi API yang kompleks.

Pengaturan global proxy di Postman

Postman menawarkan dua cara utama untuk mengatur proxy: global (berlaku untuk semua permintaan) dan individu (untuk koleksi atau permintaan tertentu). Mari kita mulai dengan pengaturan global yang terletak di menu Pengaturan aplikasi.

Panduan langkah demi langkah untuk mengakses pengaturan proxy:

1. Buka Postman dan klik ikon roda gigi (Pengaturan) di sudut kanan atas aplikasi, atau gunakan pintasan Ctrl+, (Windows/Linux) atau Cmd+, (macOS).
2. Di jendela pengaturan yang terbuka, pergi ke tab Proxy.
3. Di sini Anda akan melihat beberapa opsi konfigurasi server proxy yang akan kami bahas secara rinci di bawah.

Di bagian Pengaturan Proxy, Anda akan menemukan tiga mode utama untuk bekerja dengan proxy:

• Gunakan Proxy Sistem — menggunakan pengaturan proxy sistem operasi Anda
• Tambahkan konfigurasi proxy kustom — mengatur server proxy sendiri secara manual
• Konfigurasi Proxy Global — konfigurasi global dengan opsi untuk menentukan proxy yang berbeda untuk HTTP dan HTTPS

Setiap mode ini memiliki kelebihan dan cocok untuk berbagai skenario penggunaan. Mari kita bahas secara rinci.

Menggunakan pengaturan proxy sistem

Cara paling sederhana untuk mengatur proxy di Postman adalah dengan menggunakan pengaturan sistem. Mode ini sangat nyaman jika Anda bekerja di lingkungan perusahaan di mana proxy sudah diatur di tingkat sistem operasi, atau jika Anda menggunakan klien VPN yang secara otomatis mengonfigurasi proxy sistem.

Bagaimana cara mengaktifkan penggunaan proxy sistem:

1. Buka Pengaturan → Proxy di Postman.
2. Centang kotak di sebelah Gunakan Proxy Sistem.
3. Postman secara otomatis akan mendeteksi pengaturan proxy dari konfigurasi OS Anda.
4. Klik tombol Perbarui untuk menyimpan perubahan.

Setelah mengaktifkan opsi ini, Postman akan menggunakan pengaturan proxy yang sama dengan browser atau aplikasi lain Anda. Ini berarti jika Anda mengatur proxy di Windows (Pengaturan → Jaringan dan Internet → Proxy), macOS (Pengaturan Sistem → Jaringan → Lanjutan → Proxy), atau Linux (melalui variabel lingkungan), Postman akan secara otomatis mengambil parameter ini.

Mengatur server proxy kustom

Pengaturan proxy kustom memberi Anda kontrol penuh atas pengalihan lalu lintas. Anda dapat menentukan server proxy tertentu, port, jenis protokol, dan bahkan mengatur proxy yang berbeda untuk permintaan HTTP dan HTTPS. Cara ini sangat cocok untuk pengujian menggunakan layanan proxy komersial atau infrastruktur proxy Anda sendiri.

Panduan langkah demi langkah untuk mengatur proxy kustom:

1. Buka Pengaturan → Proxy di Postman.
2. Pastikan opsi Gunakan Proxy Sistem dimatikan.
3. Aktifkan opsi Tambahkan konfigurasi proxy kustom.
4. Di kolom Jenis Proxy, pilih protokol: HTTP, HTTPS, atau SOCKS5.
5. Di kolom Server Proxy, masukkan alamat server proxy Anda (misalnya, proxy.example.com atau alamat IP 192.168.1.100).
6. Di kolom Port Proxy, masukkan port (biasanya 8080 untuk HTTP, 1080 untuk SOCKS5, tetapi tergantung pada penyedia Anda).
7. Jika proxy memerlukan otentikasi, aktifkan opsi Otentikasi Proxy dan masukkan nama pengguna dan kata sandi.
8. Klik Perbarui untuk menerapkan pengaturan.

Setelah menyimpan pengaturan, semua permintaan keluar dari Postman akan melewati server proxy yang ditentukan. Anda dapat memeriksa keakuratan pengaturan dengan mengirimkan permintaan uji ke layanan pemeriksaan IP, misalnya:

GET https://api.ipify.org?format=json

Dalam respons, Anda harus melihat alamat IP dari server proxy Anda, bukan alamat IP asli Anda. Jika IP tidak berubah, periksa keakuratan data yang dimasukkan dan pastikan server proxy berfungsi.

Mengatur proxy yang berbeda untuk HTTP dan HTTPS

Postman memungkinkan Anda mengatur server proxy terpisah untuk lalu lintas HTTP dan HTTPS. Ini berguna jika Anda bekerja dengan infrastruktur perusahaan di mana proxy terpisah digunakan untuk koneksi yang aman dengan inspeksi SSL.

Untuk pengaturan terpisah:

1. Di bagian Pengaturan Proxy, aktifkan Konfigurasi Proxy Global.
2. Anda akan melihat dua blok terpisah: Proxy HTTP dan Proxy HTTPS.
3. Untuk setiap blok, tentukan server, port, dan data otentikasi Anda.
4. Simpan perubahan.

Sekarang permintaan HTTP akan melalui satu proxy, dan HTTPS — melalui yang lain. Ini sangat relevan untuk pengujian di infrastruktur hibrida.

Bekerja dengan proxy yang memerlukan otentikasi

Sebagian besar layanan proxy komersial dan proxy perusahaan memerlukan otentikasi untuk akses. Postman mendukung otentikasi HTTP dasar (Basic Auth) untuk server proxy, yang memungkinkan pengiriman kredensial dengan aman.

Pengaturan otentikasi proxy:

1. Di pengaturan proxy (Pengaturan → Proxy), aktifkan opsi Otentikasi Proxy.
2. Di kolom Nama Pengguna, masukkan nama pengguna yang diberikan oleh penyedia proxy Anda.
3. Di kolom Kata Sandi, masukkan kata sandi.
4. Klik Perbarui untuk menyimpan.

Postman secara otomatis akan menambahkan header Proxy-Authorization ke setiap permintaan yang melewati proxy. Kredensial dikirim dalam bentuk yang terkode (Base64), tetapi untuk keamanan maksimal, disarankan untuk menggunakan proxy HTTPS atau SOCKS5 dengan enkripsi.

Contoh pengaturan dengan proxy residensial

Misalkan Anda menggunakan proxy residensial untuk menguji API yang mengembalikan konten yang berbeda untuk pengguna dari AS dan Eropa. Penyedia proxy Anda memberikan data berikut:

• Server: us.residential.proxy.com
• Port: 8080
• Nama Pengguna: user_12345
• Kata Sandi: SecurePass789

Pengaturan di Postman akan terlihat seperti ini:

• Jenis Proxy: HTTP
• Server Proxy: us.residential.proxy.com
• Port Proxy: 8080
• Otentikasi Proxy: diaktifkan
• Nama Pengguna: user_12345
• Kata Sandi: SecurePass789

Setelah menerapkan pengaturan, semua permintaan Anda akan keluar dengan alamat IP dari AS, yang memungkinkan Anda menguji perilaku API yang spesifik untuk geo.

Pengaturan proxy SOCKS5 di Postman

SOCKS5 adalah protokol proxy yang lebih universal dibandingkan dengan HTTP/HTTPS. Ini beroperasi pada tingkat yang lebih rendah dari tumpukan jaringan dan dapat memproxy semua jenis lalu lintas, bukan hanya HTTP. SOCKS5 sangat berguna untuk menguji API yang menggunakan protokol non-standar, atau ketika diperlukan anonimitas maksimum.

Keuntungan SOCKS5 untuk pengujian API:

• Dukungan untuk semua protokol (HTTP, HTTPS, WebSocket, FTP, dll.)
• Tidak memodifikasi header permintaan (berbeda dengan proxy HTTP)
• Dukungan untuk lalu lintas UDP (relevan untuk beberapa API waktu nyata)
• Dukungan otentikasi bawaan pada tingkat protokol
• Kinerja lebih baik untuk koneksi HTTPS (tidak ada ganda SSL-handshake)

Pengaturan SOCKS5 di Postman:

1. Buka Pengaturan → Proxy.
2. Aktifkan Tambahkan konfigurasi proxy kustom.
3. Di kolom Jenis Proxy, pilih SOCKS5.
4. Masukkan alamat server SOCKS5 dan port (biasanya 1080, tetapi tergantung pada penyedia).
5. Jika memerlukan otentikasi, aktifkan Otentikasi Proxy dan masukkan kredensial.
6. Simpan pengaturan.

Penting untuk dicatat bahwa tidak semua penyedia proxy mendukung SOCKS5. Jika Anda memerlukan protokol ini untuk pengujian, pastikan untuk memeriksa ketersediaan endpoint SOCKS5 dari penyedia. Misalnya, proxy seluler sering menyediakan SOCKS5 selain HTTP/HTTPS untuk fleksibilitas maksimum.

Mengatur aturan penghindaran proxy

Terkadang Anda perlu agar sebagian permintaan melewati proxy, sementara sebagian lainnya langsung. Misalnya, Anda menguji API eksternal melalui proxy, tetapi juga bekerja dengan server pengembangan lokal (localhost) yang harus dapat diakses langsung. Untuk skenario semacam ini, Postman menawarkan pengaturan aturan penghindaran proxy (Proxy Bypass).

Bagaimana cara mengatur aturan penghindaran:

1. Di Pengaturan → Proxy, temukan bagian Bypass proxy for these hosts & domains.
2. Masukkan daftar domain atau alamat IP yang harus menghindari proxy, pisahkan dengan koma.
3. Masker didukung: misalnya, *.internal.company.com akan mengecualikan semua subdomain.
4. Simpan perubahan.

Contoh aturan penghindaran:

• localhost — penghindaran untuk host lokal
• 127.0.0.1 — penghindaran untuk alamat loopback
• 192.168.*.* — penghindaran untuk seluruh jaringan lokal
• *.dev.company.com — penghindaran untuk server dev internal
• api.internal.service — penghindaran untuk API internal tertentu

Aturan penghindaran sangat berguna di lingkungan hibrida, di mana Anda secara bersamaan menguji API eksternal (melalui proxy untuk geo-targeting atau menghindari batasan) dan layanan internal (langsung untuk kecepatan dan kemudahan debugging).

Skenario praktis penggunaan proxy di Postman

Teori itu baik, tetapi mari kita lihat skenario nyata penggunaan proxy saat menguji API. Contoh-contoh ini akan membantu Anda memahami bagaimana menerapkan pengaturan proxy untuk menyelesaikan tugas tertentu.

Skenario 1: Menguji API yang dibatasi secara geografis dari layanan streaming musik

Tugas: Perusahaan Anda sedang mengembangkan aplikasi seluler untuk streaming musik. API mengembalikan katalog trek yang berbeda tergantung pada negara pengguna karena batasan lisensi. Anda perlu menguji bahwa pengguna dari AS, Jerman, dan Jepang melihat konten yang benar.

Solusi:

1. Dapatkan proxy residensial dari tiga negara: AS, Jerman, Jepang.
2. Buat tiga lingkungan (Environments) di Postman: "Pengujian AS", "Pengujian Jerman", "Pengujian Jepang".
3. Di setiap lingkungan, buat variabel untuk pengaturan proxy (meskipun Postman tidak mendukung variabel dalam pengaturan proxy secara langsung, Anda dapat mendokumentasikannya dalam deskripsi lingkungan).
4. Secara manual beralih proxy di Pengaturan → Proxy sebelum menguji setiap wilayah.
5. Kirim permintaan ke API: GET https://api.musicservice.com/v1/catalog
6. Bandingkan hasilnya: dalam respons harus ada trek yang berbeda untuk setiap negara.

Untuk mengotomatiskan proses ini, Anda dapat menggunakan Newman (versi CLI dari Postman) dengan parameter proxy, yang memungkinkan Anda menjalankan pengujian dari pipeline CI/CD dengan penggantian proxy otomatis.

Skenario 2: Menghindari pembatasan laju saat pengujian beban

Tugas: Anda menguji kinerja API publik yang memiliki batas 100 permintaan per menit dari satu IP. Untuk pengujian beban yang lengkap, Anda perlu mengirim 1000 permintaan dalam satu menit.

Solusi:

1. Gunakan kumpulan 10+ server proxy dengan rotasi.
2. Atur Pengumpul Koleksi Postman dengan permintaan uji Anda.
3. Di Skrip Pre-request, tambahkan logika untuk rotasi proxy (catatan: Postman tidak mendukung penggantian proxy secara programatik dalam skrip, jadi skenario ini lebih baik diimplementasikan melalui Newman dengan skrip eksternal).
4. Alternatif: gunakan penyedia proxy dengan rotasi IP otomatis (sesi lengket dengan TTL pendek).

Untuk skenario semacam ini, proxy data center dengan rotasi sangat cocok — mereka memberikan kecepatan tinggi dan memungkinkan Anda mendistribusikan beban di antara banyak alamat IP.

Skenario 3: Debugging API HTTPS dengan inspeksi SSL

Tugas: Anda mengintegrasikan dengan API eksternal yang mengembalikan kesalahan 500, tetapi detail kesalahan tidak disebutkan. Anda perlu melihat konten lengkap dari permintaan dan respons HTTPS, termasuk semua header dan tubuh.

Solusi:

1. Instal alat untuk menangkap lalu lintas HTTPS: Charles Proxy, Fiddler, atau mitmproxy.
2. Atur alat untuk mendengarkan port (biasanya 8888 untuk Charles, 8888 untuk Fiddler).
3. Instal sertifikat SSL alat di sistem (instruksi biasanya ada di aplikasi itu sendiri).
4. Di Postman Pengaturan → Proxy, atur proxy ke localhost:8888.
5. Matikan verifikasi SSL di Postman (Pengaturan → Umum → Verifikasi sertifikat SSL → MATI) untuk tujuan pengujian.
6. Kirim permintaan yang bermasalah dari Postman.
7. Di Charles/Fiddler, Anda akan melihat dump lengkap dari permintaan dan respons, termasuk lalu lintas HTTPS yang terdekripsi.

Metode ini sangat berharga untuk debugging masalah kompleks dengan API, terutama ketika dokumentasi tidak lengkap atau kesalahan terjadi di sisi server.

Skenario 4: Menguji API melalui proxy perusahaan dengan whitelist

Tugas: Anda bekerja di perusahaan besar di mana semua lalu lintas keluar melewati proxy perusahaan. Proxy hanya mengizinkan akses ke domain dalam whitelist. Anda perlu menguji API eksternal baru yang belum ditambahkan ke whitelist.

Solusi:

1. Buat permintaan ke departemen TI untuk menambahkan domain API ke whitelist (mungkin memakan waktu berhari-hari atau berminggu-minggu).
2. Untuk pengujian segera: gunakan internet seluler pribadi atau atur VPN.
3. Di Postman, tambahkan domain API ke aturan penghindaran proxy (Bypass proxy for these hosts).
4. Sambungkan ke jaringan alternatif (hotspot seluler, Wi-Fi rumah melalui VPN).
5. Lakukan pengujian.
6. Setelah domain ditambahkan ke whitelist perusahaan, hapus aturan penghindaran dan bekerja melalui proxy standar.

Skenario ini menunjukkan pentingnya pengaturan proxy yang fleksibel dan aturan penghindaran di lingkungan perusahaan.

Menyelesaikan masalah umum saat bekerja dengan proxy

Bahkan dengan pengaturan proxy yang benar, masalah dapat muncul. Mari kita lihat kesalahan yang paling umum dan cara mengatasinya.

Masalah 1: "Could not get any response" atau "Error: connect ETIMEDOUT"

Penyebab:

• Server proxy tidak tersedia atau alamat/port salah
• Proxy memerlukan otentikasi, tetapi kredensial tidak diberikan
• Firewall memblokir koneksi ke proxy
• Server proxy kelebihan beban atau sementara tidak tersedia

Solusi:

1. Periksa ketersediaan proxy melalui terminal: curl -x http://proxy:port https://api.ipify.org
2. Pastikan alamat dan port ditentukan dengan benar (tanpa spasi tambahan, protokol yang benar)
3. Periksa apakah otentikasi diaktifkan dan nama pengguna/kata sandi dimasukkan dengan benar
4. Cobalah server proxy lain dari kumpulan Anda
5. Matikan sementara proxy di Postman dan periksa apakah permintaan berfungsi langsung

Masalah 2: "407 Proxy Authentication Required"

Penyebab: Proxy memerlukan otentikasi, tetapi kredensial tidak diberikan atau salah.

Solusi:

1. Aktifkan Otentikasi Proxy di pengaturan Postman
2. Periksa keakuratan nama pengguna dan kata sandi (perhatikan huruf besar, karakter khusus)
3. Pastikan alamat IP Anda diizinkan dalam whitelist penyedia proxy (jika berlaku)
4. Periksa masa berlaku kredensial (beberapa penyedia menghasilkan kata sandi sementara)

Masalah 3: Kesalahan SSL/TLS saat menggunakan proxy HTTPS

Kesalahan umum: "Masalah sertifikat SSL", "tidak dapat memverifikasi sertifikat pertama", "sertifikat yang ditandatangani sendiri dalam rantai sertifikat".

Penyebab:

• Proxy melakukan inspeksi SSL dan menyisipkan sertifikatnya sendiri
• Sertifikat proxy tidak diinstal di sistem Anda sebagai sertifikat tepercaya
• Masalah dengan rantai sertifikat di sisi API

Solusi:

1. Untuk tujuan pengujian: matikan verifikasi SSL di Postman (Pengaturan → Umum → Verifikasi sertifikat SSL → MATI). Peringatan: jangan gunakan ini di produksi!
2. Untuk produksi: instal sertifikat akar proxy di sistem dan Postman (Pengaturan → Sertifikat → Sertifikat CA)
3. Gunakan proxy tanpa inspeksi SSL (SOCKS5 atau proxy HTTP dengan pass-through SSL)
4. Hubungi administrator proxy untuk mendapatkan sertifikat yang benar

Masalah 4: Kecepatan permintaan yang lambat melalui proxy

Penyebab:

• Server proxy secara geografis jauh dari Anda atau dari API target
• Proxy kelebihan beban (terutama berlaku untuk proxy gratis atau murah)
• Koneksi lambat dari penyedia proxy
• Enkripsi SSL ganda (klien Anda → proxy → API)

Solusi:

1. Pilih server proxy yang lebih dekat ke API target (jika API berada di AS, gunakan proxy dari AS)
2. Beralih ke jenis proxy yang lebih cepat (misalnya, dari residensial ke data center untuk tugas di mana geo tidak kritis)
3. Gunakan SOCKS5 daripada HTTP untuk permintaan HTTPS (overhead lebih sedikit)
4. Pertimbangkan proxy premium dengan bandwidth terjamin
5. Untuk permintaan yang tidak kritis, matikan proxy sementara

Masalah 5: Alamat IP tidak berubah, meskipun proxy sudah diatur

Penyebab:

• Proxy sudah diatur, tetapi tidak diaktifkan (lupa menekan Perbarui)
• Domain API ditambahkan ke aturan penghindaran proxy
• Proxy sistem menimpa pengaturan Postman
• Permintaan DNS dilakukan langsung (DNS leak)

Solusi:

1. Periksa apakah proxy benar-benar aktif: kirim permintaan ke https://api.ipify.org dan periksa IP dalam respons
2. Pastikan Gunakan Proxy Sistem dimatikan jika Anda menggunakan proxy kustom
3. Periksa daftar domain bypass dan hapus domain target jika ada di sana
4. Restart Postman setelah mengubah pengaturan proxy

Kesimpulan

Mengatur proxy di Postman adalah alat yang kuat untuk memperluas kemampuan pengujian API. Anda telah belajar mengatur baik proxy sistem maupun kustom, bekerja dengan protokol HTTP dan SOCKS5, mengatur otentikasi dan aturan penghindaran. Keterampilan ini akan memungkinkan Anda untuk menguji API yang dibatasi secara geografis secara efektif, menghindari pembatasan laju, bekerja melalui proxy perusahaan, dan mendebug masalah kompleks dengan alat penangkap lalu lintas.

Kesimpulan utama dari ini...