Authentication

ProxyOmega supports three ways to authenticate: IP whitelisting for credential-free access, username & password embedded in the proxy URL, and an API key for the REST API. All three are managed from your dashboard.

Overview

Every proxy connection you make must be authenticated so that traffic is attributed to your account. There are two ways to authenticate the proxy connection itself, by IP whitelist or by username & password, plus a separate API key used only for the REST API. Pick whichever proxy method suits your setup. You can mix and match across servers.

IP whitelist

Add your server's public IP in the dashboard and connect with no username or password. Best for machines with a static IP.

Username + password

Embed your credentials in the proxy URL: http://username:password@endpoint:port. Works from any IP.

API key

Sent via the X-API-Key header to authenticate the REST API. Not used for the proxy connection itself.

Which method to use

Method	How you connect	Best for
IP whitelist	No credentials, just point at the endpoint and port	Servers with a fixed, static public IP
Username + password	`http://username:password@endpoint:port`	Dynamic IPs, laptops, rotating cloud workers, any source IP
API key (`X-API-Key`)	Header on requests to the REST API base	Managing your account programmatically, not for proxy traffic

IP whitelist (credential-free)

Add your server's public IP under Whitelist in the dashboard, then connect to the proxy with no username or password. This is the simplest option when your source machine has a stable, static IP.

You can whitelist multiple IPs, so add every server or location you connect from.
Once an IP is whitelisted, connections from it are authenticated automatically, with no credentials required in the proxy URL.
Ideal for dedicated servers, VPS instances, and any host with a fixed public IP.

A non-empty whitelist locks the door. If you have any IPs on your whitelist, connections from IPs that are not on it are refused. Either whitelist every source IP you connect from, or switch that source to username & password authentication instead.

Example: connect through Budget Unlimited from a whitelisted server, with no credentials in the URL.

curl -x http://residential.proxyomega.com:10000 https://api.ipify.org

Username + password

Embed your credentials directly in the proxy URL. Your username and password are shown in your dashboard. This method works from any IP, so it's the right choice when your source machine's IP changes or when you connect from many hosts.

curl -x http://username:[email protected]:10000 https://api.ipify.org

To target a specific country or configure sticky sessions, append targeting parameters to the username (the password stays unchanged). For example, to request a US IP:

curl -x http://username-country-us:[email protected]:10000 https://api.ipify.org

Both methods work together. You can use IP whitelisting on your static servers and username & password on everything else at the same time. See Targeting for the full username parameter syntax and Sessions & rotation for sticky-IP control.

API key (REST API only)

The API key authenticates the Public API, not the proxy connection. It is sent via the X-API-Key header (or as a query parameter) on requests to https://proxyomega.com/api. Use it to manage your whitelist, export proxy lists, pull usage and bandwidth stats, and manage subscriptions programmatically.

curl https://proxyomega.com/api/... \
  -H "X-API-Key: your_api_key_here"

Don't confuse the two. Your API key never goes into a proxy URL, and your proxy username/password never goes into an API request. Proxy traffic uses the whitelist or username & password; the REST API uses the X-API-Key header.

If you run a reseller account, the Reseller API uses a different scheme. It expects Authorization: Bearer <api_key> against https://proxyomega.com/api/reseller/v1 and requires an approved, KYC-verified reseller account.

Finding and rotating your credentials

Everything is managed from your dashboard:

Proxy username & password. Shown alongside your subscription. Copy them straight into your proxy URL.
IP whitelist. Open the Whitelist section to add, view, or remove the IPs allowed to connect without credentials. You can add multiple IPs.
API key. View or rotate it in your account settings. Rotating the key invalidates the old one, so update any scripts that use it.
Proxy-list generator. Builds ready-to-paste connection strings (including targeting parameters) so you don't have to assemble them by hand.

✓

Next step. Ready to send your first request? Head to the Quickstart, or jump straight to your product's page: Budget Unlimited, Premium Unlimited, Residential / ISP, Mobile, IPv6, or Static ISP.

Last updated July 6, 2026