Using a Proxy

A persona can carry its own proxy. With a proxy, the persona's timezone and locale follow where the proxy exits, unless you state them.

Set the proxyCopy Anchor Link

Add "proxy" to the persona file, next to its device facts. For example, an HTTP or a SOCKS5 proxy with credentials:

"proxy": "http://user:password@host:port"

"proxy": "socks5://user:password@host:port"

Then make the persona from the file, or give an existing persona its settings anew:

bauta persona new shop --from shop.json      # a new persona
bauta persona set shop --from shop.json      # an existing one: new settings, its profile kept

A browser that is running the persona keeps the old settings until it closes, so a persona never changes under a page. A persona file to start from is personas/win-intel.json in the bauta-browser repository; see also the persona file reference.

From the packages, pass proxy:

browser = launch(proxy="http://user:pass@host:port")

const browser = await launch({ proxy: "http://user:pass@host:port" });

In Docker, a persona file's settings are the same as outside it. Personas that share a browser still each have their own proxy, timezone and the rest of their persona.

Escape special charactersCopy Anchor Link

Any :, @ or / in the user name or password is %-escaped:

For the password p@ss:word:

"proxy": "http://user:p%40ss%3Aword@host:port"

When the proxy refuses the credentialsCopy Anchor Link

If the proxy turns the credentials away, requests fail at once, and bauta serve says so.

Timezone and locale follow the proxyCopy Anchor Link

With a proxy, and neither "timezone" nor "locale" stated, they follow where the proxy exits. bauta serve asks an IP echo through the proxy and places the address with a database that bauta geo update keeps:

bauta geo update

To set them yourself, state both:

"timezone": "America/New_York",
"locale": "en-US"

From the packages, pass timezone and locale; with a proxy, they follow where the proxy exits unless you give both. A client that sets its own locale or timezone is answered as if it had, but the page keeps the persona's.

IP geolocation by DB-IP, under CC BY 4.0.

When no place is foundCopy Anchor Link

If no place can be found for the proxy's exit, and none was found before, the persona's browser does not start, rather than show this machine's timezone behind a foreign address. A persona that states both "timezone" and "locale" does not follow the proxy's exit.

NextCopy Anchor Link

• Saving proxy bandwidth
• Persona file reference
• The gateway