Proxy Authentication: Username Password vs IP Whitelist

Kamu sudah punya alamat proxy dan port yang benar, tetapi koneksi tetap ditolak? Bisa jadi masalahnya bukan pada IP proxy, melainkan metode autentikasi yang digunakan server. Ada proxy yang cukup memakai username dan password, sementara layanan lain hanya menerima koneksi dari IP yang sudah masuk whitelist.

Keduanya mempunyai tujuan yang sama: memastikan proxy tidak dapat dipakai sembarang orang. Tetapi cara kerjanya berbeda cukup jauh. Username dan password mengikuti credential yang diberikan ke client, sedangkan IP whitelist melihat dari alamat jaringan mana koneksi menuju proxy berasal.

Perbedaan ini penting terutama kalau proxy dipakai pada browser, server, cURL, script Python/Node.js, atau perangkat yang sering berpindah jaringan. Salah memilih metode authentication bisa membuat proxy terlihat seperti mati padahal servernya sebenarnya masih normal.

Kalau kamu belum familiar dengan format proxy seperti 203.0.113.20:8080, baca dahulu artikel apa itu IP proxy.

Apa Itu Proxy Authentication?

Proxy authentication adalah mekanisme untuk memastikan client mempunyai izin sebelum proxy meneruskan koneksi menuju internet atau server tujuan.

Tanpa autentikasi, siapa pun yang mengetahui IP dan port sebuah proxy publik berpotensi mencoba menggunakannya. Pada private proxy, provider biasanya menambahkan lapisan authentication.

Kalau client lolos pengecekan, proxy meneruskan request. Kalau tidak, koneksi dapat ditolak atau server meminta credential.

Dua Metode Authentication yang Sering Ditemui

Dalam penggunaan proxy sehari-hari, dua pendekatan yang sering diberikan provider adalah:

Keduanya tidak selalu saling menggantikan. Ada provider yang menawarkan pilihan salah satunya, dan ada pula konfigurasi yang memang diwajibkan menggunakan metode tertentu.

Bagaimana Username dan Password Proxy Bekerja?

Pada metode ini, pengguna mendapatkan credential dari provider proxy.

Client kemudian memberikan credential tersebut ketika berkomunikasi dengan proxy.

Format proxy sering ditulis seperti:

Namun format persisnya tergantung software yang digunakan. Browser dapat menampilkan popup authentication, sementara cURL atau library pemrograman biasanya mempunyai opsi tersendiri untuk memasukkan credential.

Apa Itu Error 407 Proxy Authentication Required?

Ketika HTTP proxy membutuhkan authentication tetapi credential belum diberikan atau tidak valid, server dapat membalas:

Respons tersebut berbeda dari 401 Unauthorized. Status 401 biasanya berkaitan dengan autentikasi pada server tujuan, sedangkan 407 berasal dari proxy.

RFC 9110 mendefinisikan status 407 untuk kondisi ketika proxy menantang client agar melakukan authentication.

Referensinya bisa dibaca di RFC 9110.

Bagaimana Proses 407 Berjalan?

Secara sederhana, alurnya seperti ini:

Proxy dapat menyertakan header:

Client kemudian mengirim kembali authentication melalui:

Menurut RFC 9110, Proxy-Authenticate digunakan proxy untuk memberikan authentication challenge, sedangkan Proxy-Authorization membawa credential client menuju proxy.

Proxy-Authorization Bukan Authorization Website

Ini detail kecil yang cukup penting saat debugging API atau script.

Header:

biasanya ditujukan ke website atau API tujuan.

Sementara:

digunakan untuk authentication ke proxy.

Jadi sebuah request sebenarnya dapat mempunyai authentication ke dua pihak sekaligus:

Cara Menggunakan Proxy Username Password dengan cURL

cURL menyediakan opsi khusus untuk proxy authentication.

Untuk debugging lebih detail, tambahkan verbose:

Dengan -v, kamu bisa melihat apakah proxy mengembalikan 407, berhasil membuat koneksi, atau justru gagal pada tahap lain.

Apa Itu IP Whitelist pada Proxy?

IP whitelist menggunakan pendekatan berbeda. Kamu tidak selalu perlu mengirim username dan password setiap kali terhubung.

Provider proxy menyimpan daftar IP yang diizinkan.

Misalnya public IP server kamu:

Ketika koneksi menuju proxy datang dari IP tersebut, server mengizinkannya.

Kalau koneksi datang dari IP lain:

Metode ini sering praktis untuk server dengan public IP tetap.

IP Proxy dan Whitelist IP Itu Berbeda

Dua istilah ini cukup mudah tertukar.

Contohnya:

Kamu menghubungi proxy 203.0.113.20, tetapi proxy hanya menerima koneksi dari client dengan public IP 198.51.100.25.

Username Password vs IP Whitelist: Apa Bedanya?

Kapan Username dan Password Lebih Praktis?

Credential biasanya lebih praktis kalau perangkat sering berpindah jaringan.

Contohnya:

• laptop berpindah antara rumah dan kantor,
• developer menggunakan beberapa Wi-Fi,
• mobile device berpindah jaringan,
• server cloud menggunakan outbound IP yang dapat berubah,
• pengguna tidak punya kontrol terhadap public IP jaringan.

Selama aplikasi mendukung proxy authentication, credential bisa dibawa ke berbagai jaringan tanpa harus mendaftarkan IP baru setiap kali.

Kapan IP Whitelist Lebih Praktis?

Whitelist sangat nyaman pada infrastruktur yang mempunyai public outbound IP tetap.

Contohnya:

• VPS dengan static public IP,
• server dedicated,
• kantor dengan fixed public IP,
• gateway perusahaan,
• worker automation di server tetap.

Setelah alamat server masuk whitelist, aplikasi biasanya cukup menggunakan:

tanpa harus memasukkan username dan password pada setiap konfigurasi.

Kenapa IP Whitelist Tidak Bekerja dari Laptop?

Salah satu penyebab paling umum adalah kamu memasukkan IP yang salah ke whitelist.

Yang dibutuhkan biasanya adalah public outbound IP, bukan alamat private LAN seperti:

Alamat tersebut hanya digunakan di jaringan lokal.

Proxy yang berada di internet melihat public IP dari router atau gateway tempat koneksi keluar.

Apa Pengaruh IP Dinamis pada Whitelist?

Banyak koneksi rumahan tidak menjamin public IP selalu tetap.

Hari ini jaringan mungkin keluar melalui:

kemudian setelah reconnect atau perubahan dari ISP menjadi:

Kalau whitelist masih berisi alamat lama, koneksi ke proxy dapat ditolak.

Karena itu IP whitelist lebih nyaman jika kamu mempunyai alamat public IP yang stabil.

Bagaimana dengan CGNAT?

Pada jaringan tertentu, terutama mobile atau ISP yang menggunakan Carrier-Grade NAT, pengguna tidak selalu mempunyai satu public IPv4 pribadi.

Banyak pelanggan dapat berbagi public IP yang sama melalui infrastruktur operator.

Dalam kondisi seperti ini, whitelist berbasis IP bisa menjadi kurang nyaman, terutama jika public outbound IP berubah atau tidak berada dalam kontrol pengguna.

Untuk perangkat mobile dan laptop yang sering berpindah jaringan, username dan password biasanya lebih fleksibel.

Kenapa Proxy Tetap Error 407 Padahal Password Benar?

Credential benar belum tentu berarti format authentication yang digunakan client sesuai dengan server.

Periksa beberapa hal berikut:

• username tidak salah ketik,
• password belum expired,
• proxy host dan port benar,
• client mendukung metode authentication server,
• credential memang dibuat untuk endpoint tersebut,
• akun proxy masih aktif.

MDN menjelaskan bahwa response 407 harus disertai Proxy-Authenticate yang memberi informasi challenge kepada client.

Dokumentasinya bisa dibaca di MDN 407 Proxy Authentication Required.

Username atau Password Mengandung Karakter Khusus

Masalah lain yang sering terjadi muncul ketika credential langsung ditulis ke URL.

Misalnya password:

Karakter seperti @, :, /, atau karakter khusus lain dapat mempunyai arti tersendiri di dalam URL.

Jika aplikasi meminta proxy dalam format URL, credential mungkin perlu di-encode dengan benar.

Karena itu lebih aman menggunakan API authentication milik software kalau tersedia daripada membangun URL proxy secara manual tanpa memahami URL encoding.

Apakah Username Password Proxy Aman?

Keamanan tidak hanya bergantung pada ada atau tidaknya password.

Yang perlu dipikirkan juga adalah bagaimana credential dikirim, bagaimana aplikasi menyimpannya, siapa operator proxy, dan apakah koneksi menuju proxy dilindungi sesuai kebutuhan.

MDN juga mengingatkan bahwa Basic authentication tidak memberikan confidentiality sendiri tanpa koneksi yang aman.

Jangan Hardcode Password Proxy di Repository

Kalau proxy digunakan dalam script atau aplikasi, hindari menulis credential langsung seperti ini pada project publik:

Kalau repository bocor atau menjadi public, credential proxy juga ikut terekspos.

Untuk production, lebih baik gunakan:

• environment variable,
• secret manager,
• configuration file yang tidak masuk Git,
• credential storage milik platform deployment.

Authentication di Python atau Node.js

Library HTTP pada bahasa pemrograman biasanya mempunyai caranya masing-masing untuk menerima proxy credential.

Konsep dasarnya tetap sama:

Yang berbeda hanya syntax dan library.

Jangan berasumsi seluruh software menerima format:

selalu dengan cara yang sama. Cek dokumentasi HTTP client yang digunakan.

Apakah SOCKS5 Punya Authentication?

Ya. SOCKS5 mempunyai mekanisme authentication sendiri dan tidak menggunakan mekanisme HTTP 407 dengan cara yang sama seperti HTTP proxy.

Jadi jangan menganggap error authentication pada SOCKS5 harus selalu menghasilkan:

Status 407 adalah mekanisme HTTP proxy authentication.

Untuk memahami perbedaannya, baca artikel SOCKS5 Proxy.

IP Whitelist dan Firewall Whitelist Apakah Sama?

Konsepnya mirip karena sama-sama membatasi berdasarkan alamat IP, tetapi implementasinya bisa berada pada lapisan berbeda.

Whitelist provider proxy dapat menjadi bagian dari sistem akses layanan proxy. Firewall whitelist lebih umum sebagai aturan jaringan yang mengizinkan atau menolak traffic.

Dari sisi pengguna, efeknya dapat terlihat sama: IP tertentu boleh terhubung dan IP lain ditolak.

Bagaimana Cara Tahu Proxy Menggunakan Authentication Apa?

Jangan menebak hanya dari format IP dan port.

Cek informasi dari provider. Biasanya akan disebutkan sebagai:

• Username / Password Authentication
• User:Pass Auth
• IP Authentication
• IP Whitelist
• Authorized IP

Kalau hanya mendapatkan IP dan port tetapi koneksi selalu ditolak, cek apakah provider membutuhkan whitelist atau credential tambahan.

Proxy Bisa Menggunakan Dua Metode Sekaligus?

Bisa saja sebuah layanan menyediakan kedua metode sebagai pilihan atau menerapkan policy tambahan.

Contohnya sebuah dashboard dapat membolehkan pengguna memilih:

Namun jangan menganggap semua provider bekerja seperti itu. Aturan tetap mengikuti layanan proxy masing-masing.

Kenapa Proxy Berfungsi di Server tetapi Tidak di Laptop?

Kalau endpoint menggunakan IP whitelist, kemungkinan server sudah masuk daftar authorized IP tetapi laptop belum.

Misalnya:

VPS berhasil menggunakan proxy, sedangkan laptop ditolak.

Dalam kondisi ini, masalah bukan pada browser atau laptop. Public IP laptop memang belum mendapat izin.

Kenapa Proxy Berfungsi di WiFi tetapi Tidak di Mobile Hotspot?

Alasannya serupa.

Ketika berpindah dari WiFi ke hotspot seluler, public outbound IP berubah.

Kalau authentication menggunakan username dan password, perpindahan jaringan seperti ini biasanya lebih fleksibel selama proxy tidak menerapkan pembatasan IP tambahan.

Authentication Gagal atau Proxy Offline?

Keduanya kadang terlihat mirip dari sisi pengguna karena sama-sama membuat internet tidak berjalan.

Cara Troubleshooting Proxy Authentication

1. Pastikan Jenis Authentication

Cari tahu apakah proxy memakai username/password atau whitelist.

2. Cek Host dan Port

Authentication tidak akan berguna kalau endpoint proxy sendiri salah.

3. Jika Menggunakan User/Pass, Cek Credential

Pastikan username dan password masih aktif dan tidak salah ketik.

4. Jika Menggunakan Whitelist, Cek Public IP

Pastikan alamat yang didaftarkan adalah public outbound IP koneksi saat ini.

5. Periksa Apakah IP Berubah

Kalau ISP menggunakan dynamic IP, whitelist lama mungkin sudah tidak cocok.

6. Coba cURL Verbose

Output verbose membantu melihat apakah error terjadi pada authentication, koneksi ke proxy, atau koneksi menuju destination.

7. Coba dari Jaringan Lain

Langkah ini berguna untuk mengecek apakah provider membatasi source IP tertentu.

Mana yang Lebih Baik: Username Password atau IP Whitelist?

Tidak ada metode yang selalu lebih baik. Pilih berdasarkan lingkungan penggunaan.

Kalau kamu mengelola server tetap, whitelist bisa membuat konfigurasi aplikasi lebih bersih karena credential tidak harus ditaruh pada setiap client.

Kalau koneksi sering berpindah tempat, credential biasanya lebih praktis.

Tips Menggunakan Proxy Authentication

• Pastikan tahu jenis authentication sebelum konfigurasi.
• Jangan menyimpan password proxy di repository publik.
• Gunakan public IP yang benar untuk whitelist.
• Ingat bahwa dynamic IP dapat berubah.
• Jangan memasukkan alamat private LAN ke whitelist internet.
• Gunakan cURL verbose untuk troubleshooting error 407.
• Cek kembali authentication jika proxy hanya bekerja dari satu jaringan.
• Gunakan provider yang dapat dipercaya untuk koneksi sensitif.

Untuk memahami bagaimana proxy meneruskan request setelah client mendapat akses, baca artikel cara kerja proxy server.

FAQ Proxy Authentication

Apa itu proxy authentication?

Proxy authentication adalah mekanisme yang digunakan server proxy untuk memastikan client memiliki izin sebelum proxy meneruskan koneksi.

Apa arti error 407 Proxy Authentication Required?

Status 407 berarti proxy membutuhkan authentication dan credential yang dibutuhkan belum diberikan, tidak lengkap, atau tidak diterima.

Apa beda username password dengan IP whitelist?

Username dan password mengenali client berdasarkan credential, sedangkan IP whitelist mengizinkan koneksi berdasarkan public source IP.

Mana yang lebih cocok untuk VPS?

Kalau VPS mempunyai public IP tetap, IP whitelist biasanya praktis karena aplikasi tidak perlu selalu menyimpan username dan password proxy.

Mana yang lebih cocok untuk laptop?

Username dan password biasanya lebih fleksibel karena laptop sering berpindah WiFi dan public IP bisa berubah.

Kenapa whitelist proxy tiba-tiba tidak bekerja?

Public IP jaringan mungkin berubah. Cek public outbound IP terbaru dan bandingkan dengan alamat yang terdaftar di whitelist.

Apakah 192.168.x.x bisa dimasukkan ke whitelist proxy?

Untuk proxy internet biasanya yang dibutuhkan adalah public outbound IP. Alamat 192.168.x.x merupakan alamat private pada jaringan lokal.

Apakah SOCKS5 menggunakan error 407?

Tidak dengan mekanisme yang sama. Status 407 merupakan bagian dari HTTP proxy authentication, sedangkan SOCKS5 memiliki mekanisme authentication tersendiri.

Apakah username dan password proxy aman ditaruh di URL?

Untuk testing bisa saja software menerima format tersebut, tetapi credential dapat terekspos melalui source code, log, shell history, atau konfigurasi. Untuk production gunakan penyimpanan secret yang lebih aman.

Kenapa proxy bekerja di server tetapi tidak di komputer saya?

Kalau proxy memakai IP whitelist, public IP server kemungkinan sudah diizinkan sedangkan public IP komputer belum terdaftar.