Skip to content
Start free trial

Authentication

There are two ways to prove a request is yours. Pick one per product.

The default. Your credentials are in the dashboard under Proxy Access → Proxy Parameters.

Terminal window
curl -x USERNAME:[email protected]:8000 https://checkip.amazonaws.com

Targeting options are appended to the password:

Terminal window
curl -x USERNAME:[email protected]:8000 \
https://checkip.amazonaws.com

Your real password still authenticates, because we strip the modifier run before checking it. You never rewrite the username.

Each product has its own login, and the suffix shows which product a username belongs to.

ProductUsername
Premium Residential<login>
Premium Rotating ISP<login>-isp
Premium Rotating DC<login>-dc
Scale Residential<login>_scale
Scale Rotating ISP<login>_scaleisp
Scale Rotating DC<login>_scaledc
Web Unblocker<login>-wu

A sub-account on a Scale login adds _sub, _sub1 and so on to its master’s username, such as <login>_scaleisp_sub. A Scale username can also end in a digit, such as <login>_scale1, and some older Rotating ISP and Rotating DC usernames have no suffix. Copy the username and password for each product from its Proxy Access page.

Changing a suffix by hand gives you an unknown user, and 407. The tier belongs to the login, so one account can hold a Premium login and a Scale login side by side.

Register the addresses your traffic comes from and send no credentials at all. Targeting then moves into X-Rayobyte-* headers.

Terminal window
curl --proxy-header "X-Rayobyte-Country: US" \
-x us-east.gw.rayobyte.com:8000 https://checkip.amazonaws.com

Set it up under Proxy Access → IP Authorization. Full detail: IP whitelisting. Scale logins use a username and password only.

Use IP whitelisting when your traffic leaves from a fixed set of servers. There is nothing to leak into a log or a repository, and it is one less string to rotate.

Use username and password when your egress IP moves: laptops, CI runners, autoscaling workers, anything behind a NAT you do not control.

Read them from the environment. A proxy password in a committed file is a password you will be rotating on someone else’s schedule.

Terminal window
export RAYOBYTE_USER=...
export RAYOBYTE_PASS=...
curl -x "$RAYOBYTE_USER:$RAYOBYTE_PASS@us-east.gw.rayobyte.com:8000" https://checkip.amazonaws.com

Was this page helpful?