**Source URL:** https://general.veevavault.dev/vault-toolbox/browser-extension/guides/authenticating-to-vault-toolbox.md

# Authenticating to Vault Toolbox

There are multiple ways to authenticate to Vault using the Vault Toolbox browser extension. On the Vault Toolbox login page, you can select one of the following authentication methods:

* **Basic**: Prompts for the Vault DNS and a combination of your username and password.

* **Session**: Prompts for the Vault DNS and an active session ID.

* **Integrated**: Accesses Vault Toolbox from an active Vault tab where the user is logged in.

This guide explains how to log into Vault using any authentication method and save Vault credentials to expedite the process.

### Basic Login {#basic-login}

To authenticate using basic login:

<Steps>
1. From the login page, enter the **Vault DNS**. For example, `myvault.veevavault`.com. If you launch Vault Toolbox from a browser tab where you are logged into Vault, this will autofill.

2. Select the **Basic** tab.

3. Enter your Vault **User Name** and **Password**.

4. Click **Log In**.

</Steps>

### Saving Vaults {#saving-vaults}

Vault Toolbox allows you to save up to 100 Vault environments and designate one as the default. When a Vault environment is saved, Vault Toolbox stores the Vault DNS and user name, excluding the password.

<ThemeImage srcLight="/images/toolbox/browser-extension/vault_toolbox_saved_vaults_light.png" srcDark="/images/toolbox/browser-extension/vault_toolbox_saved_vaults_dark.png" alt="Vault Toolbox browser extension saved Vaults"></ThemeImage>
To add a saved Vault:

<Steps>
1. From the login page, click the <Icon name="ph:caret-down"></Icon> icon to open the **Saved Vaults** dialog.

2. Click the <Icon name="ph:note-pencil"></Icon> icon, then click **+ Add Row**.

3. Enter the **Vault DNS** and **Username**.

4. Optional: Select the **Default?** checkbox to make this your default environment. This unsets any previously set default environment.

5. Click **+ Add Row** to add another Vault, or click **Save** to save your changes.

6. Click the <Icon name="ph:x"></Icon> icon to close the dialog.

</Steps>
To select a saved Vault, click the <Icon name="ph:caret-down"></Icon> icon from the login page to open the **Saved Vaults** dialog. In the dialog, select a saved Vault and automatically populates the **Vault DNS** and **User Name** fields required for basic login. Provide a **Password**, then you can proceed to **Log In**.

### Session Login {#session-login}

To log in using an active Vault session ID:

<Steps>
1. From the login page, enter the **Vault DNS**. For example, `myvault.veevavault.com`. If you launch Vault Toolbox from a browser tab where you are logged in to Vault, this will autofill.

2. Select the **Session** tab.

3. Enter a valid **Session ID**. You can generate session IDs using [Vault API](/vault-api/api-reference/26.1/authentication).

4. Click **Log In**.

</Steps>

### Integrated Login {#integrated-login}

This option allows you to log in by opening Vault Toolbox from a browser tab with an active Vault UI session.

<Aside>By enabling auto-integrated login, you authorize Vault Toolbox to automatically authenticate and read Vault data using your existing Vault session.</Aside>
To log in using integrated login:

<Steps>
1. From a browser tab with an active Vault UI session, select the *Vault Toolbox* extension from your browser's top navigation bar. The Vault Toolbox login page appears in a new tab. The *Integrated* tab has already been selected.

2. Confirm the **Vault DNS**. For example, `myvault.veevavault.com`. It should be automatically populated.

3. Optional: Select the **Enable Auto-Integrated Login (All Vaults)** toggle. When enabled, Vault Toolbox automatically logs you in when you select the extension from an active Vault UI session, skipping the login page.

4. Click **Log in with Existing Vault Session**.

</Steps>
Alternatively, you can enable or disable auto-integrated login by navigating to **Settings (<Icon name="ph:gear"></Icon>) > General** in Vault Toolbox and selecting the **Integrated Login** toggle. When enabled, you can log in to Vault Toolbox automatically from a browser tab with an active Vault UI session.



---

**Previous:** [Guides](/vault-toolbox/browser-extension/guides)  
**Next:** [Navigating Vault Toolbox](/vault-toolbox/browser-extension/guides/navigating-vault-toolbox)