Skip to main content
To use our proxy network, every request you send to the proxy gateway must be authenticated. This ensures that only authorized users can access the service and that we can correctly attribute traffic usage to your account. We offer two methods for authentication:

Username & Password

The most common method. You include your proxy’s unique credentials in every request.

IP Whitelisting (Coming Soon)

A more seamless method for servers. You pre-authorize your server’s IP address, allowing it to connect without sending credentials.

1. Username & Password Authentication

This is the standard and most flexible authentication method. Each proxy you create in your dashboard has its own unique username and password.

How it Works

You need to include these credentials in your proxy connection string in the following format: protocol://username:password@host:port

Example

Let’s say your credentials are:
  • Username: 2xt-customer-a1b2-proxy-steam
  • Password: a_very_secure_password
  • Host & Port: proxy.2extract.net:5555
Your connection string for an HTTP client would look like this:
http://2xt-customer-a1b2-proxy-steam:a_very_secure_password@proxy.2extract.net:5555
# Using the credentials with cURL
curl "https://api.ipify.org" \
  --proxy "http://2xt-customer-a1b2-proxy-steam:a_very_secure_password@proxy.2extract.net:5555"
Remember, you can dynamically add parameters like -country-de to your username to control the proxy’s behavior. Learn more in the Geo-Targeting Parameters guide.

2. IP Whitelisting (Authorized IPs) (Coming Soon)

This method is ideal for servers or any machine with a static IP address. By whitelisting your IP, you can send requests without embedding credentials in your code.

How it Works

  1. Add your IP: In your proxy’s settings page, go to the “Advanced Settings” section and add your server’s IP address (e.g., 34.123.45.67) to the Authorized IPs list.
  2. Connect without credentials: Now, any request coming from that IP address to your proxy’s host:port will be automatically authenticated.

Example

Assuming your server’s IP 34.123.45.67 has been whitelisted for the proxy at proxy.2extract.net:5555.
# No username or password needed!
curl "https://api.ipify.org" \
  --proxy "http://proxy.2extract.net:5555"
Important: IP Whitelisting only works for IPv4 addresses. If your server has a dynamic IP, you must use the Username & Password method.

Which Method Should I Use?

ScenarioRecommended Method
Running scripts from your local machine (dynamic IP)Username & Password
Running scripts on a cloud server (static IP)IP Whitelisting
Using a tool that doesn’t support proxy authenticationIP Whitelisting
Needing maximum flexibility and controlUsername & Password
I