Skip to main content

Dynamic IP Whitelisting for Proxy Access

Proxyrack avatar
Written by Proxyrack
Updated over a week ago

Overview

Traditional IP whitelisting requires static IP addresses, which can be limiting in dynamic environments. To offer more flexibility and security, we've introduced dynamic IP whitelisting via API. This streamlined solution eliminates the need for username/password authentication or frequent manual IP updates—making it easier than ever to manage access while maintaining robust protection.

Use Dynamic IP Whitelisting

Users commonly report the following challenges:

  • Dynamic IPs that change frequently (e.g., every 24 hours).

  • Software limitations preventing use of username/password authentication.

  • Hitting the whitelist limit (e.g., 800 IPs already added).

  • Requests to use DNS entries (e.g., domain name that resolves to a dynamic IP).

  • Desire for automation through an API-driven solution.

Benefits of the Dynamic IP Whitelisting API

  • Automate IP whitelisting without logging in.

  • No need to switch to username/password proxies.

  • Set custom expiration times for added IPs.

  • Supports labeling and management of entries.


API Guide

You can use the following API endpoints to manage your IP whitelist dynamically.

Add a Custom IP to Whitelist

curl -v -x <http://USERNAME:[email protected]:9000> \\ api.proxyrack.net/v1-beta/ip-whitelist \\ -d '{"ip": "209.205.202.186", "label":"testip", "expireTime":"7777"}'
  • ip: IP address to whitelist.

  • label: Optional label for easy identification.

  • expireTime: Can be in seconds, ISO format, or Unix timestamp.

Add Your Current IP Automatically

If you omit the ip field, your current IP will be whitelisted:

curl -v -x <http://USERNAME:[email protected]:9000> \\ api.proxyrack.net/v1-beta/ip-whitelist \\ -d '{"label":"testip", "expireTime":"7777"}'

List Whitelisted IPs

curl -v -x <http://USERNAME:[email protected]:9000> \\ api.proxyrack.net/v1-beta/ip-whitelist

Delete a Whitelisted IP

To remove a specific IP, use its unique ID:

curl -v -X DELETE -x <http://USERNAME:[email protected]:9000> \\ api.proxyrack.net/v1-beta/ip-whitelist/{UNIQUE_ID}

About expireTime

You can specify expiration in three ways:

  • As seconds (e.g., "expireTime": "86400" for 24 hours),

  • As a Unix timestamp,

  • As an ISO date (e.g., "2025-06-30T15:00:00Z").

Best Practices

  • Set a reasonable expireTime to avoid stale entries.

  • Use meaningful label values for easy management.

Need Help?

If you encounter issues using the API or have special cases, reach out to our support team with the following:

  • Your username.

  • The issue you're facing.

  • Example API requests (with sensitive info redacted).

Did this answer your question?