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

# Vault

> How to store encrypted passwords and keys in Flexxible KB, link them from pages, audit every use and decide which ones agents can use.

The Vault stores, encrypted, the passwords, keys and other secrets your procedures need. Pages don't contain the secret: they link to it. People copy or reveal it when they need it, and every time is logged. Agents only use the credentials you allow them to, and never receive their value.

The Vault is turned on by default. Open it from **Vault**, in the sidebar.

![Vault list: name, type, pages where it's used, last use and whether agents can use each credential.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-vault-list.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=d872d4e43eac1dc95c7734476cf0ece8)

## Credential types

| Type | What for |
| - | - |
| **Login** | A user and their password on a host. |
| **API key** | A service's key. |
| **SSH key** | A private key. Only people use it. |
| **Secret** | Any other value that must be stored encrypted, such as a license key. |

## Create a credential

1. In the **Vault**, select **New credential**.
2. Fill in the form:
   * **Name.** How people and agents will see it. For example, "Gateway admin password".
   * **Type.**
   * **Host** and **User** (optional). Where and with which user it's used.
   * **Value.** The secret. **Generate** creates a random password.
   * **Notes** (optional). What it's for and when to use it.
3. Select **Save credential**.

> [!WARNING]
>
> The secret only goes in **Value**. Agents see a credential's name, host and user, so the Vault rejects a credential whose name, host or user contains the secret itself.

## Use a credential in a page

In the editor, type `/` and choose **Password or key from the vault**. Select an existing credential or create a new one. The page only stores a reference.

![A credential inside a page: its name, the hidden value and the Copy and Reveal buttons.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-credential-block.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=d6a0165bf3bdb343c4c626c91725a64a)

On the page, the credential appears as a block with its name and the hidden value:

* **Copy** copies the value to the clipboard.
* **Reveal** shows it for a few seconds and hides it again.
* The block's name opens the credential in the Vault.

Copying or revealing a value is always logged. The value isn't part of the page's text, its History or anything agents read.

## Credential details

![Credential details: hidden value, host and user, the Agents can use it toggle, the pages where it's used and its activity.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-vault-credential.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=f8e4b66c09070a95ec4becbcbabc3c01)

When you open a credential, its value (hidden), host and user are shown, as well as:

| Item | What it lets you do |
| - | - |
| **Rotate value** | Replace the value with a new one. Pages keep pointing to the same credential and, from that moment, copies get the new value. |
| **Restore previous value** | Go back to the value it had before the last rotation. |
| **Edit details** | Change the name, type, host, user or notes. The value doesn't change. |
| **Notes** | Read the notes. Opening them is logged, just like revealing the value. |
| **Used in** | The pages that link to the credential. |
| **Activity** | Who created, copied, revealed or rotated it or read its notes, and each use by an agent. |
| **Delete credential** | Delete it. Pages that use it will show it as deleted. This can't be undone. |

## Allow agents to use a credential

The **Agents can use it** toggle allows Teammate and Solve to use the credential in Flexxible Assist sessions. For example, to download an installer from a server that requires a user and password.

* **They never receive the value.** The agent asks for permission to use the credential and gets a single-use authorization. It's Flexxible Assist, on the device, that redeems that authorization and uses the value. The value never reaches the AI model or the engineer's browser.
* **They say so.** Before using it, Teammate tells the engineer which credential it's going to use and where.
* **It's logged.** The credential's **Activity** shows which agent used it, for whom, on which device and for what reason.
* **Only the marked ones.** A credential without the toggle turned on can't be used: the agent's request is rejected.

Only owners and administrators decide which credentials agents can use. Keep in mind that:

* Agents only use logins, API keys and secrets. SSH keys are for people.
* If someone changes a credential's host, user or type, the permission turns off automatically and must be granted again.
* Bot can't use credentials or query the Vault.

See [Flexxible Assist agents](https://docs.flexxible.com/en/features/flexxible-kb/assist-agents.md).

## Search and filter

The Vault list can be filtered by name, host or user (`/` key), by **Type** and by **Who can use it**: **Agents and people** or **People only**.

The [command palette](https://docs.flexxible.com/en/features/flexxible-kb/search.md) also finds credentials by their name or host.

## Credentials and shared pages

Credentials don't leave your organization. When you share a page with another organization, the recipient sees that the credential belongs to your Vault and isn't shared.

## Turn off the Vault

In **Settings** → **Vault**, **Turn on the vault** controls the feature for the whole organization. With the Vault turned off:

* Nobody sees it, and pages show their credentials as unavailable.
* Agents can't use any credential.
* Nothing is deleted: credentials are kept encrypted and come back as they were when it's turned on again.

## Next steps

* [Write and edit pages](https://docs.flexxible.com/en/features/flexxible-kb/editor.md#credenciales-y-secretos)
* [Flexxible Assist agents](https://docs.flexxible.com/en/features/flexxible-kb/assist-agents.md)
* [Share pages between organizations](https://docs.flexxible.com/en/features/flexxible-kb/sharing.md)
