Proxy glossary

What is proxy authentication?

Proxy authentication is how a proxy checks a connection is yours, usually with a username and password or by recognising your IP address.

Proxy authentication explained

With a username and password, your client sends the credentials to the proxy in a Proxy-Authorization header. The target never sees them. Most tools accept them inside the proxy URL, as http://USER:PASS@host:port.

Wrong or missing credentials get a 407 Proxy Authentication Required. The usual culprit is a password containing @, : or #, which breaks the URL. Percent-encode those characters, or pass the credentials separately.

Chrome's --proxy-server flag ignores credentials in the URL. That is why Puppeteer has page.authenticate() and Playwright takes the username and password as separate options.

For example

Your password ends in #1. Pasted into the proxy URL, everything after the # is read as a fragment and the proxy answers 407. Passing it with --proxy-user avoids the parsing.

terminal
curl --proxy http://resi.proxymonkey.io:8000 \
     --proxy-user 'USER:PASS' \
     https://httpbin.org/ip

Swap in your own credentials from the dashboard. It also lists the host and port for each order; where they differ from this example, the dashboard is right.

How it works at ProxyMonkey

  • Every line supports username-password auth or an IP allowlist. The credentials are in your dashboard.
The community layer

Not sure how it applies to you?

Post what you are trying to do in Discord. Someone who has hit the same thing will explain it against your setup.

Join the Discord

4,200+monkeys in the Discord

  • Help from humans

    Post your error, get an answer. Usually in minutes, usually from someone who has hit the same wall.

  • A status bot that tells on us

    Pool health, incidents and maintenance posted automatically. Including the bad days.

  • Deals and free traffic

    Bonus GB drops, early access to new pools, and the occasional giveaway for a good bug report.

Join the Discord4,200+ monkeys, free to lurk