> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nodemaven.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication methods

> Username and password, or IP whitelist. Where to find your proxy credentials and how to change them.

Two ways to authenticate a NodeMaven proxy:

| **Method** | **How it works** |
| - | - |
| **Username and password** | The default. Works everywhere. |
| **IP whitelist** | Approved IP addresses connect without credentials |

Both are set up on the **Proxy Setup** page, under **Rotating Residential Proxy** in the left navigation.

![Proxy Setup page in the NodeMaven dashboard](https://downloads.intercomcdn.com/i/o/yvkc0rpk/2590063394/1c83b34bc1d8a75757837ea7788c/image.png)

## The three tabs

| **Tab** | **What it is for** |
| - | - |
| **Authenticated** | Username and password proxies. Where you generate and copy proxy strings. |
| **Users** | Sub-users with their own credentials and traffic limits |
| **IP Whitelist** | Proxies that connect from approved IP addresses |

## Username and password

Your proxy credentials are generated automatically once you have an active plan. You do not create them.

Find them on the **Authenticated** tab, under **Proxy generator**.

Two things to know:

* **Proxy credentials are not your NodeMaven account login.** They are separate. Your account email and password will not connect a proxy.
* **Your username carries your settings.** Location, session type and filter are all linked to it by the dashboard. See [Understanding your proxy string](/residential-mobile/proxy-string).

![Proxy generator on the Authenticated tab](https://downloads.intercomcdn.com/i/o/yvkc0rpk/2590078059/e711d83945096e6e86a5f273955b/Screenshot+2026-08-06+at+15_49_50.png)

## IP whitelisting

Whitelisting lets a specific public IP use a proxy without sending credentials. Useful for tools that cannot store a username and password.

![IP Whitelist tab in the dashboard](https://downloads.intercomcdn.com/i/o/yvkc0rpk/2590093429/601527bada8c34d9bb16f537df49/image.png)

### Whitelist and IP

1. On your dashboard, go to Proxy Setup > IP Whitelist > Add IP
2. Add your IP to the IP field
3. Select your preferred location
4. Save

![Add IP dialog with the IP field and location selector](https://downloads.intercomcdn.com/i/o/yvkc0rpk/2590094546/68c93c39d9110a44faca41ec3779/image.png)

**Full walkthrough:** [IP Whitelist setup](/residential-mobile/ip-whitelist).

## Changing your proxy password

Do this if you think someone else has your credentials.

1. Open the **Users** tab.
2. Click the three-dot menu next to the user.
3. Click **Edit**.
4. Click **Generate password**.
5. Click **Save**.

![Edit user dialog with the Generate password button](https://downloads.intercomcdn.com/i/o/yvkc0rpk/2590118517/34119cfcb05902632ad17ca0ad2f/image.png)

<Warning>
  **This breaks every proxy string you have already generated.** Anti-detect profiles, scripts, scheduled jobs and saved configurations all stop working the moment you save. Update them straight after.
</Warning>

## Sub-users

The **Users** tab also creates sub-users. Each gets its own credentials and its own traffic limit, drawn from your account balance.

See [The Sub-user feature](/residential-mobile/sub-users).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.