IP Whitelisting & Auth
Learn how to create or edit an IP whitelist for your Residential Proxies.
IP whitelisting allows you to access Oxylabs Residential Proxies using your personal whitelisted IPs to bypass username and password requirement in your proxy request.
Create an IP whitelist
To enable IP-based authentication, register your server's static public IPv4 address in the Oxylabs Dashboard.
Log in to the Oxylabs Dashboard.
Create a Residential Proxy product instance.
In the Authentication setting select Whitelisted IPs.

Enter up to 10 public IPv4 addresses (in
xx.xx.xx.xxformat).Fill in all necessary details and click Create instance.
Requests with whitelisted IPs
When using IP Whitelisting, parameters (such as location, session IDs, or ASNs) cannot be embedded into a username string. Instead, all proxy flags are added directly to the entry node host address as a subdomain pointing to .bc.pr.oxylabs.io:7777.
city
Requires cc parameter. Spaces use _.
E.g. cc-us-city-new_york.bc.pr.oxylabs.io:7777
cn
2-letter continent code (AF, AN, AS, EU, NA, OC, SA).
E.g. cn-eu.bc.pr.oxylabs.io:7777
postalcode
5-digit US ZIP code; requires cc-us.
E.g. cc-us-postalcode-90210.bc.pr.oxylabs.io:7777
geohash
Grid cell levels 1 to 4 (9 to drq4).
E.g. geohash-u09.bc.pr.oxylabs.io:7777
sessid
Binds sequential requests to the same IP (10-min default).
E.g. sessid-test123.bc.pr.oxylabs.io:7777
sesstime
Extends session duration in minutes.
E.g. sessid-test123-sesstime-15.bc.pr.oxylabs.io:7777
Code examples
Last updated
Was this helpful?