> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/proxies/residential-proxies/getting-started/user-and-pass-auth.md).

# User & Pass auth

Configure username and password access for Thordata Residential Proxies, generate a proxy endpoint, and use it in HTTP or HTTPS requests.

This guide provides key details and procedures for accessing Thordata's **Dynamic Residential Proxy** service via **username/password** authentication.

{% stepper %}
{% step %}

### Register ＆ Log in

Visit the [<mark style="color:blue;">**Thordata website**</mark>](https://www.thordata.com/)<mark style="color:green;">,</mark> complete account registration, and log in.

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FurD6UqNHglmG59eduIMA%2Fimage.png?alt=media&amp;token=c9bdbed7-8ff2-4b0f-9796-3e365cb8bb28" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FnP12a3agOQhg9u2DYTmY%2Fimage.png?alt=media&amp;token=ece8dc1a-2032-458a-8be0-05d4088ffa71" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Purchase a Plan

Navigate within your dashboard to: **Proxies → Residential Proxies → Pricing**. Select a plan that fits your business requirements, complete payment, and activate the service.

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FCbrwC9AwSZrvTB324oBQ%2Fimage.png?alt=media&amp;token=d61c3567-854f-401e-8405-791dbfd91d9d" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Proxy User Setup

#### Create an Account

In the user dashboard, navigate to: **Proxies** → **Residential Proxies** → **Proxy Setup** → **Users**. Click **Add** to create a new proxy user account.

{% hint style="success" %}
For quick setup: Use **Quick Add** to auto-generate a username and password
{% endhint %}

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FGsdLcFYzr5aEMMfY3hlK%2Fimage.png?alt=media&amp;token=f5d1679a-c982-42bf-b843-91f8660dad35" alt="" width="375"><figcaption></figcaption></figure></div>

After clicking **【Add】**, configure the following:**Username**、**Password**、**Status** (Enabled / Disabled)、**Traffic Limits** (Unlimited / Limited)。If Limite&#x64;*:* Specify the **Traffic Cap (MB).**

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FzzYKxPYWW8EI0Smd2GLw%2Fimage.png?alt=media&amp;token=4110c242-3295-4212-9ce6-9ea66d3482d8" alt="" width="375"><figcaption></figcaption></figure></div>

#### Manage Accounts

① **Filter** by Date: Set start and end dates to find accounts created within a specific period.&#x20;

② **Search** by Username: Enter a username to locate a specific account.&#x20;

③ **Edit** Account: Click Edit to update the username, password, status, usage limits, or notes.&#x20;

④ **Delete** Accounts:

* Single Account: Click **Delete** within the edit view.
* Multiple accounts:: Select multiple accounts and use **Batch Delete.**

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FDxODwA8ETZEoTn9ou9CZ%2Fimage.png?alt=media&amp;token=fad70e9f-2ede-4d39-87fd-3275e41e9927" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Generate Proxy Endpoint

① Navigate to: **Proxies** → **Residential Proxies** → **Proxy Setup** → **Endpoint Generator**.&#x20;

② **Authentication method**: Select 【User】，then choose a proxy user from the username dropdown.&#x20;

* If no account exists, click **【Add Now】** to create one.&#x20;

③ **Location settings**：

The system automatically assigns the optimal domain based on the selected proxy region.

Manual override: Use dropdowns to select Continent, Country/Region, State, City, or ISP.

Refer to the [<mark style="color:blue;">**Location Settings**</mark>](/doc/proxies/residential-proxies/location-settings.md)  for detailed instructions.&#x20;

④ **Session Settings**:

* Rotating Session: Automatically switches IPs with each request (ideal for high anonymity).
* Sticky Session: Maintains the same IP for 1-90 minutes (ideal for session continuity).

⑤ **Submit Request**:&#x20;

Send a request with authentication credentials to [<mark style="color:blue;">**https://ipinfo.thordata.com**</mark>](https://ipinfo.thordata.com) via the proxy endpoint to start using Thordata’s proxy service.

Refer to the [<mark style="color:blue;">**Making Requests**</mark>](/doc/proxies/residential-proxies/making-request.md) guide for detailed instructions.&#x20;

Example：

```
 curl -x "https://td-customer-Username-sessid-123456-sesstime-90:Password@t.pr.thordata.net:9999" "https://ipinfo.thordata.com
```

⑥ **Output Format**: The system generates a single-string proxy credential:

`ProxyAddress:ProxyPort：ProxyUsername：ProxyPassword`

Select your preferred Output Format, set the Number of Proxies, specify the Connection [<mark style="color:blue;">**Protocol**</mark>](/doc/proxies/residential-proxies/protocols.md), then Generate ＆ Activate.

{% hint style="warning" %}
**Your Proxy Authentication Username differs from your Dashboard Management Username and cannot be used interchangeably.**
{% endhint %}

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2F54OaOJGv4AzV1eJBLkbU%2Fimage.png?alt=media&amp;token=8bc2746d-1e1e-46d4-8a5b-609a0b9bc065" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Usage Statistics&#x20;

Navigate to: **Proxies → Residential Proxies → Statistics.**&#x20;

Filter data by: Time Period、Identity Type (Account or IP Whitelist)、Account Level (Master Account or Specific Sub-Account)、Region、Target Domain and Timezone.

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2Fe1Ip0E7FRLObUYTWuEVx%2Fimage.png?alt=media&amp;token=7902832f-71ec-4d9a-a52f-47f84c280e03" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}
