IP Whitelisting

IP whitelisting lets you authenticate to the proxy without sending credentials in each request. Once your IP is whitelisted, any request from that IP is automatically authenticated.

How it works

1. You add your server’s public IP to your whitelist in the dashboard
2. Requests from that IP to the proxy are authenticated automatically
3. No username or password required in the proxy URL

Setting up IP whitelisting

1. Find your public IP

   Run the following command on the machine that will use the proxy:

   curl https://httpbin.org/ip

   Note the IP address in the response.

2. Add to whitelist

   Via Dashboard:

   • Go to My Products → select your subscription
   • Navigate to the IP Whitelist tab
   • Click Add IP and enter your IP address
   • You can also click Auto-Detect to add your current IP

3. Use the proxy without credentials

   Once whitelisted, connect without authentication:

   curl -x http://connect.trueproxies.com:8080 \
     https://httpbin.org/ip

Limits

Limit	Value
Maximum whitelisted IPs	10 per subscription
IP format	IPv4 addresses only
Propagation time	Immediate

Caution

Only whitelist static IP addresses. If your server’s IP changes (e.g., dynamic IPs, auto-scaling instances), use username/password authentication instead.

Managing whitelisted IPs

Use the IP Whitelist tab in the dashboard to review, add, and remove whitelisted IPs for your subscription.

IP whitelisting + username parameters

When using IP whitelisting, you can still use username parameters for geo-targeting. Pass just the targeting parameters as the username with no password:

curl -x http://connect.trueproxies.com:8080 \
  -U "country-us-session-abc123:" \
  https://httpbin.org/ip