Authentication

Aethyn uses standard HTTP proxy authentication — username:password sent in the Proxy-Authorization header. No SDK, no token exchange, no separate API key.

Credential format

Each account has one canonical credential pair, surfaced in the dashboard under the Aethyn Credentials card. The base username has the form aethyn-XXXXX and the password is a generated secret you can copy or reset.

bash
username = aethyn-d9e2c
password = 4f7K2qP9xL8mN3vR

Username suffixes

Targeting parameters are appended to the username with hyphen separators. The base credential always comes first; everything after is interpreted as a directive.

bash
aethyn-d9e2c-country-us-session-a3xq-lifetime-10
└────┬─────┘└───┬─────┘└────┬──────┘└────┬─────┘
   base      country     session     lifetime

Default behaviour

With no suffixes, every request gets a fresh exit IP, drawn worldwide. With session-XXXX, the same exit IP is reused for the session lifetime — 30 minutes by default, up to 1440 (24h), configurable via lifetime.

Password rotation

The dashboard has a Reset password action that generates a new secret and invalidates the old one immediately. Every active connection using the old password will be dropped within ~60 seconds (the credential cache TTL).

Heads up
Rotating the password does not affect targeting suffixes or session IDs — those are stateless and embedded per-request.

IP allowlist (coming soon)

For deployments where storing the password in client code is undesirable, IP-based allowlisting will let you authorize requests by source IP without sending credentials at all. Email support@aethyn.io to be in the early-access cohort.

Related resources

  • Official proxy SDK — proxy-builder-sdk for Node.js and Python — typed URLs, sticky sessions, and Playwright helpers.
  • Integrations hub — Copy-paste proxy setup for Python, Node.js, Playwright, Scrapy, and 25+ developer tools.
  • Premium residential proxies — Cost-efficient rotating residential pool from €2.00/GB for bulk scraping and monitoring.
  • Quickstart — Credential format and first request walkthrough.
  • Solution guides — Step-by-step how-to guides for scraping, monitoring, and automation with residential proxies.