For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

  1. Log in to the Oxylabs Dashboard.

  2. Create a Residential Proxy product instance.

  3. In the Authentication setting select Whitelisted IPs.

  4. Enter up to 10 public IPv4 addresses (in xx.xx.xx.xx format).

  5. Fill in all necessary details and click Create instance.

Note: A single IP address can be whitelisted for only one Residential Proxies instance at a time. If the IP is already whitelisted on another instance, remove it from there before adding it to a new one.

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.

Type
Parameter
Description

cc

2-letter ISO country code. E.g. cc-de.bc.pr.oxylabs.io:7777

city

Requires cc parameter. Spaces use _. E.g. cc-us-city-new_york.bc.pr.oxylabs.io:7777

st

US states; requires us_ prefix. E.g. st-us_california.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

ASN

Target specific Autonomous System Numbers. E.g. asn-21928.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?