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

# Secret Vaults

> Enterprise-grade credential management for your Sessions

> [!TIP]
>
> Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

## Overview

Notte provides a secure vault system that lets sessions authenticate using credential placeholders. Secrets are encrypted at rest and in transit. During supported credential-fill actions, the vault substitutes real credentials for placeholders outside the model context. The target website receives the credentials needed to authenticate. Treat browser access, screenshots, page content, and downloaded files as sensitive; placeholder substitution is not a guarantee that a website cannot reveal a submitted value.

## Secure your credentials

* **Encryption**: Secrets are encrypted at rest and in transit.
* **Credential substitution**: Supported fill actions resolve placeholders outside the model context.
* **Access control**: Authorized API clients and sessions can use the vault.
* **2FA Support**: Support for two-factor authentication credentials.

## How it works

![vault-fill-action](https://mintcdn.com/notte/FewygNQL9LWqZVN9/images/vault-fill-action.png?fit=max\&auto=format\&n=FewygNQL9LWqZVN9\&q=85\&s=9ca76e2b373b8ed3111752d3ab177441)

The Vault acts as an intermediary between your code and the browser session.
Attach a vault to a session with `client.Session(vault_id=...)`, then fill forms with placeholder values (`EMAIL`, `PASSWORD`, `MFA`, ... from `notte_core.credentials`).
When a `fill` or `form_fill` action contains a placeholder, the vault takes over the execution and replaces the dummy value with the actual
credential for the current website, directly inside the browser.

This avoids including the real credential in the placeholder fill action.

## Vault Management

### Python SDK

The following snippet shows how to manage your vault using the Notte Python SDK.

```python session_with_vault.py theme={null}
from notte_core.credentials import EMAIL, PASSWORD
from notte_sdk import NotteClient

client = NotteClient()
# Get your vault id from the Notte dashboard
vault = client.Vault(vault_id="my_vault_id")
# Add your credentials securely
vault.add_credentials(
    url="https://github.com/",
    email="my_cool_email@gmail.com",
    password="my_cool_password",
)
# Attach the vault to a session: EMAIL / PASSWORD placeholders are replaced
# by the real credentials inside the browser, never in your code
with client.Session(vault_id=vault.vault_id) as session:
    session.execute(type="goto", url="https://github.com/login")
    session.execute(type="form_fill", value={"email": EMAIL, "current_password": PASSWORD})
```

## Handling credentials

Use vault placeholders instead of putting real passwords in prompts or source code. Credential substitution happens outside the model context, but the browser still interacts with the destination website. Avoid logging secrets and review what your automation captures or shares.

To keep real credentials out of Notte entirely, use a [secret proxy](https://docs.notte.cc/features/sessions/secret-proxies/overview.md) instead. See [Secret proxy or vault](https://docs.notte.cc/features/sessions/secret-proxies/credentials.md#secret-proxy-or-vault).


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