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

# Authentication Methods

> Residential Proxy Authentication Methods

We support residential proxy authentication via username and password or IP-based whitelisting.

You can manage **proxy users** and **whitelisted IPs** on the [**Residential → Residential → Authentication**](https://dashboard.decodo.com/residential-proxies/authentication) section on your dashboard.

* After you purchase a plan or subscription, a proxy username and password will be automatically generated in the Authentication section.
* The default number of whitelisted IP slots is **10**. Please [**contact**](https://direct.lc.chat/12092754/1) our customer support for more information.

<Note>
  ### Dashboard Access

  If you cannot log in to your dashboard, please request a password change by going to the [**Reset Password**](https://dashboard.decodo.com/password-reset) page.
</Note>

***

## User:pass Authentication

### Managing Proxy Users

* You can manage your **proxy users** by clicking the **Users** tab in the Authentication section.
* You can **buy** additional users by clicking **Buy users** on the right.

<img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/b79190a507f947cc43fee41cefae1575d2c8371ec26f0328a754059df9d0cc3b-Group_427322941.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=142c9bd16cac7099367c93d26c75442c" alt="" width="3448" height="660" data-path="images/docs/b79190a507f947cc43fee41cefae1575d2c8371ec26f0328a754059df9d0cc3b-Group_427322941.png" />

<Note>
  Currently, you **cannot rename** proxy users. If needed, you can create a new one or recreate a proxy user by deleting it.
</Note>

### Editing Proxy Users

* To **edit** a proxy user, click the **three dots** and then **Edit user**. A menu on the right will open.
* Alternatively, you can **add** or **edit** **proxy users**, generate **passwords**, and change their traffic limit directly in the [**Proxy setup**](https://dashboard.decodo.com/residential-proxies/proxy-setup) section.

<img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/c30a95bc1f0e23ef70e0559c5cfb98c17a558f9a1a1412cc893ff453b0a69491-Group_427322942.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=3d84a3b9f488a1863b3a0bb727e0dc66" alt="" width="3448" height="1108" data-path="images/docs/c30a95bc1f0e23ef70e0559c5cfb98c17a558f9a1a1412cc893ff453b0a69491-Group_427322942.png" />

<img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/86bf633fd98a959c0a8632b6663a4462ee9f3aac0da380caaaa917ca2ca83cd7-Group_427322943.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=9fe79e3b09d9e568264e013268e44746" alt="" width="3448" height="968" data-path="images/docs/86bf633fd98a959c0a8632b6663a4462ee9f3aac0da380caaaa917ca2ca83cd7-Group_427322943.png" />

### Password Generation

* To **change** your proxy user's **password**, click the **Generate password** button next to the password.
* To reveal or hide the password, click the **eye** icon.
* You can **copy** the username and password by clicking on them.

### Traffic Limit Management

1. To **add**, **edit**, or **remove** a **traffic limit** for a specific proxy user, click **Add traffic limit**.
2. Type in the traffic limit and click the checkmark button to add or edit a limit. Click **X** to cancel.
3. Click on **Edit** to change or the **Bin** icon to **remove** the traffic limit.
4. Click **Save**

### Proxy User Deletion

* To **delete** a proxy user, click **Remove user** and then **Confirm**.

<img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/8e531e10202df741bd853f0ad08f5dd41c299b139086dd95751611792098dcc7-Group_427322945.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=3645e3eb2056dadf48d1e7a3dae8fe5e" alt="" width="3448" height="1404" data-path="images/docs/8e531e10202df741bd853f0ad08f5dd41c299b139086dd95751611792098dcc7-Group_427322945.png" />

### Adding an Extra Proxy User

1. To **create** a new proxy username and password, click **+ Add user**. A menu on the right will open.
   * A vacancy is required for this option to appear. Check the **Total users** count.
2. Type in the username you want and click **+ Add**. A password will be automatically generated.
   * The username must be 6 to 64 characters long, letters and numbers only, no spaces.

<img src="https://mintcdn.com/decodo/eRLuBYAbadfvmqDE/images/docs/27e192ff1c4e4e14a5023160609126a9840f11716337c5b1954f106fab264c9c-Group_427322947.png?fit=max&auto=format&n=eRLuBYAbadfvmqDE&q=85&s=1f9398f32d09774936b0252dc7d08c3b" alt="" width="3448" height="720" data-path="images/docs/27e192ff1c4e4e14a5023160609126a9840f11716337c5b1954f106fab264c9c-Group_427322947.png" />

<img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/57957deab03d3768dfca421abb4bf5cd4b1cf62d9ad3d15ef113f8ada69dbb5f-Group_427322950.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=97f1bf023a236a28a72aa5433dab8e9b" alt="" width="3448" height="652" data-path="images/docs/57957deab03d3768dfca421abb4bf5cd4b1cf62d9ad3d15ef113f8ada69dbb5f-Group_427322950.png" />

<Warning>
  ### 407 Error / Proxy Authentication Required

  If you cannot authenticate with proxy user credentials, then try generating a new password.
</Warning>

***

## Whitelisted IP Authentication

### Managing Whitelisted IPs

1. You can manage your **whitelisted IPs** by clicking the **Whitelisted IPs** tab in the Authentication section.
   * The list will be empty by default.
2. To **add** a new **IP address** to the whitelist, click **+ Add IP**. A menu on the right will open.
   * To **buy** more than 10 Whitelisted IP slots, please contact our 24/7 customer support by clicking the chat widget on the bottom right or by using this [**link**](https://direct.lc.chat/12092754/1).

<img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/ee1a50fbfba79d1b02a4033a9e2d9a0c5f5006cb6e3ec110a7e2dd1ab948f24d-Group_427322951.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=b5d37c9c2693309502e8f06299f4b424" alt="" width="3448" height="744" data-path="images/docs/ee1a50fbfba79d1b02a4033a9e2d9a0c5f5006cb6e3ec110a7e2dd1ab948f24d-Group_427322951.png" />

3. Enter your desired **IP address**, and click **+ Add** to whitelist it.
   * You can only add IPs that are in **IPv4** format (xx.xx.xx.xx). The **IPv6** format is not supported.
   * Ensure that the IP you are adding is yours, only accessible by you, and that you are not using a Proxy or VPN service at the time.

<img src="https://mintcdn.com/decodo/7ZKpc3GV1DKO_XQr/images/docs/0486ca6bbfc924fbc518ffdfd4c5d3012e657e3d6928d4169f1bad4fcffed8f9-Group_427322952.png?fit=max&auto=format&n=7ZKpc3GV1DKO_XQr&q=85&s=541a1beef1cb14da48f073044e5622fb" alt="" width="3448" height="608" data-path="images/docs/0486ca6bbfc924fbc518ffdfd4c5d3012e657e3d6928d4169f1bad4fcffed8f9-Group_427322952.png" />

### Editing Whitelisted IPs

* To **edit** a whitelisted IP, click the **three dots** and then **Edit IP**. A menu on the right will open.
* Alternatively, you can **add** or **edit** **whitelisted IPs** directly in the [**Proxy setup**](https://dashboard.decodo.com/residential-proxies/proxy-setup) section.

<img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/ca67c08790841b06594b4938ae6429c5db9851ce9a363e3cfa7d27a617a0dfee-Group_427322954.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=893f7d09028a5ab2c157b3a5564e6955" alt="" width="3448" height="640" data-path="images/docs/ca67c08790841b06594b4938ae6429c5db9851ce9a363e3cfa7d27a617a0dfee-Group_427322954.png" />

<img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/a0666311b1105dbdfdac1fcf1c2da501b9431991978d3b81c077e17227f29ef8-Group_427322956.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=b80921fdd6e5ed8c65faa5f9187355d5" style={{ width:"46%" }} className="mx-auto" width="1600" height="1592" data-path="images/docs/a0666311b1105dbdfdac1fcf1c2da501b9431991978d3b81c077e17227f29ef8-Group_427322956.png" />

### Naming Whitelisted IPs

* To **name** your whitelisted IP, click **Edit** and type in the name you want. Click **Save** to finalize.
* Leave the entry field blank to remove a name.

### Whitelisted IP Removal

* To **remove** a whitelisted IP, click **Remove Whitelisted IP** and then **Confirm**.

<img src="https://mintcdn.com/decodo/eRLuBYAbadfvmqDE/images/docs/1dcb5fc4e6cfbe3bbd84bf1f69b343a8556b3329b66d5f04a85ac3f7e1d7cb7d-Group_427322958.png?fit=max&auto=format&n=eRLuBYAbadfvmqDE&q=85&s=ef91d9ac564973aba9508cc94164b848" className="mx-auto" width="3448" height="1324" data-path="images/docs/1dcb5fc4e6cfbe3bbd84bf1f69b343a8556b3329b66d5f04a85ac3f7e1d7cb7d-Group_427322958.png" />

<Warning>
  If you’re using services such as **Amazon Web Services**, we highly recommend using the traditional `username:password` authentication instead.
</Warning>

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    Need help or just want to say hello? Our support is available 24/7. \
    You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>
