Authentication
There are two ways to prove a request is yours. Pick one per product.
Username and password
Section titled “Username and password”The default. Your credentials are in the dashboard under Proxy Access → Proxy Parameters.
Targeting options are appended to the password:
https://checkip.amazonaws.comYour real password still authenticates, because we strip the modifier run before checking it. You never rewrite the username.
Username formats
Section titled “Username formats”Each product has its own login, and the suffix shows which product a username belongs to.
| Product | Username |
|---|---|
| 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.
IP whitelisting
Section titled “IP whitelisting”Register the addresses your traffic comes from and send no credentials at all.
Targeting then moves into X-Rayobyte-* headers.
curl --proxy-header "X-Rayobyte-Country: US" \ -x us-east.gw.rayobyte.com:8000 https://checkip.amazonaws.comSet it up under Proxy Access → IP Authorization. Full detail: IP whitelisting. Scale logins use a username and password only.
Which to use
Section titled “Which to use”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.
Keep credentials out of your code
Section titled “Keep credentials out of your code”Read them from the environment. A proxy password in a committed file is a password you will be rotating on someone else’s schedule.
export RAYOBYTE_USER=...export RAYOBYTE_PASS=...curl -x "$RAYOBYTE_USER:$RAYOBYTE_PASS@us-east.gw.rayobyte.com:8000" https://checkip.amazonaws.comWas this page helpful?
Thanks. That helps us fix it.