> ## 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.

# Bóveda

> Cómo guardar contraseñas y claves cifradas en Flexxible KB, enlazarlas desde las páginas, auditar cada uso y decidir cuáles pueden utilizar los agentes.

La Bóveda guarda cifradas las contraseñas, las claves y otros secretos que necesitan tus procedimientos. Las páginas no contienen el secreto: lo enlazan. Las personas lo copian o lo muestran cuando lo necesitan, y queda registro de cada vez. Los agentes solo utilizan las credenciales que tú les permitas, y nunca reciben su valor.

La Bóveda está activada de forma predeterminada. Se abre desde **Bóveda**, en la barra lateral.

![Lista de la Bóveda: nombre, tipo, páginas en las que se usa, último uso y si los agentes pueden usar cada credencial.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-vault-list.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=d872d4e43eac1dc95c7734476cf0ece8)

## Tipos de credencial

| Tipo | Para qué |
| - | - |
| **Inicio de sesión** | Un usuario y su contraseña en un host. |
| **Clave de API** | La clave de un servicio. |
| **Clave SSH** | Una clave privada. Solo la usan las personas. |
| **Secreto** | Cualquier otro valor que deba guardarse cifrado, como una clave de licencia. |

## Crear una credencial

1. En la **Bóveda**, selecciona **Nueva credencial**.
2. Rellena el formulario:
   * **Nombre.** Cómo la verán las personas y los agentes. Por ejemplo, "Contraseña de admin del gateway".
   * **Tipo.**
   * **Host** y **Usuario** (opcionales). Dónde y con qué usuario se utiliza.
   * **Valor.** El secreto. **Generar** crea una contraseña aleatoria.
   * **Notas** (opcionales). Para qué sirve y cuándo usarla.
3. Selecciona **Guardar credencial**.

> [!WARNING]
>
> El secreto va solo en **Valor**. Los agentes ven el nombre, el host y el usuario de una credencial, por lo que la Bóveda rechaza una credencial cuyo nombre, host o usuario contenga el propio secreto.

## Usar una credencial en una página

En el editor, escribe `/` y elige **Contraseña o clave de la bóveda**. Selecciona una credencial existente o crea una nueva. La página guarda únicamente una referencia.

![Una credencial dentro de una página: su nombre, el valor oculto y los botones Copiar y Mostrar.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-credential-block.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=d6a0165bf3bdb343c4c626c91725a64a)

En la página, la credencial aparece como un bloque con su nombre y el valor oculto:

* **Copiar** copia el valor al portapapeles.
* **Mostrar** lo enseña durante unos segundos y lo vuelve a ocultar.
* El nombre del bloque abre la credencial en la Bóveda.

Copiar o mostrar un valor queda siempre registrado. El valor no forma parte del texto de la página, de su Historial ni de nada que lean los agentes.

## Detalle de una credencial

![Detalle de una credencial: valor oculto, host y usuario, el interruptor Los agentes pueden usarla, las páginas en las que se usa y su actividad.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-vault-credential.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=f8e4b66c09070a95ec4becbcbabc3c01)

Al abrir una credencial se muestran su valor (oculto), su host y su usuario, y además:

| Elemento | Qué permite |
| - | - |
| **Rotar valor** | Sustituir el valor por uno nuevo. Las páginas siguen apuntando a la misma credencial y, desde ese momento, las copias reciben el valor nuevo. |
| **Restaurar el valor anterior** | Volver al valor que tenía antes de la última rotación. |
| **Editar datos** | Cambiar el nombre, el tipo, el host, el usuario o las notas. El valor no cambia. |
| **Notas** | Leer las notas. Abrirlas queda registrado, igual que mostrar el valor. |
| **Se usa en** | Las páginas que enlazan la credencial. |
| **Actividad** | Quién la creó, la copió, la mostró, la rotó o leyó sus notas, y cada uso por parte de un agente. |
| **Eliminar credencial** | Eliminarla. Las páginas que la usan la mostrarán como eliminada. No se puede deshacer. |

## Permitir que los agentes usen una credencial

El interruptor **Los agentes pueden usarla** permite que Teammate y Solve utilicen la credencial en las sesiones de Flexxible Assist. Por ejemplo, para descargar un instalador desde un servidor que requiere usuario y contraseña.

* **Nunca reciben el valor.** El agente pide permiso para usar la credencial y obtiene una autorización de un solo uso. Es Flexxible Assist, en el dispositivo, quien canjea esa autorización y utiliza el valor. El valor no llega al modelo de IA ni al navegador del ingeniero.
* **Lo dicen.** Antes de usarla, Teammate indica al ingeniero qué credencial va a utilizar y dónde.
* **Queda registrado.** La **Actividad** de la credencial muestra qué agente la usó, para quién, en qué dispositivo y con qué motivo.
* **Solo las marcadas.** Una credencial sin el interruptor activado no se puede usar: la petición del agente se rechaza.

Solo los propietarios y los administradores deciden qué credenciales pueden usar los agentes. Ten en cuenta que:

* Los agentes solo usan inicios de sesión, claves de API y secretos. Las claves SSH son para las personas.
* Si alguien cambia el host, el usuario o el tipo de una credencial, el permiso se desactiva solo y hay que volver a concederlo.
* Bot no puede usar credenciales ni consultar la Bóveda.

Consulta [Agentes de Flexxible Assist](https://docs.flexxible.com/features/flexxible-kb/assist-agents.md).

## Buscar y filtrar

La lista de la Bóveda se puede filtrar por nombre, host o usuario (tecla `/`), por **Tipo** y por **Quién puede usarla**: **Agentes y personas** o **Solo personas**.

La [paleta de comandos](https://docs.flexxible.com/features/flexxible-kb/search.md) también encuentra credenciales por su nombre o su host.

## Credenciales y páginas compartidas

Las credenciales no salen de tu organización. Cuando compartes una página con otra organización, quien la recibe ve que la credencial pertenece a tu Bóveda y que no se comparte.

## Desactivar la Bóveda

En **Ajustes** → **Bóveda**, **Activar la bóveda** controla la función para toda la organización. Con la Bóveda desactivada:

* Nadie la ve, y las páginas muestran sus credenciales como no disponibles.
* Los agentes no pueden usar ninguna credencial.
* No se elimina nada: las credenciales se conservan cifradas y vuelven tal como estaban al activarla de nuevo.

## Siguientes pasos

* [Escribir y editar páginas](https://docs.flexxible.com/features/flexxible-kb/editor.md#credenciales-y-secretos)
* [Agentes de Flexxible Assist](https://docs.flexxible.com/features/flexxible-kb/assist-agents.md)
* [Compartir páginas entre organizaciones](https://docs.flexxible.com/features/flexxible-kb/sharing.md)
