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

# Cofre

> Como guardar senhas e chaves criptografadas no Flexxible KB, vinculá-las a partir das páginas, auditar cada uso e decidir quais os agentes podem utilizar.

O Cofre guarda criptografados as senhas, as chaves e outros segredos de que os seus procedimentos precisam. As páginas não contêm o segredo: elas o vinculam. As pessoas o copiam ou o exibem quando precisam, e cada vez fica registrada. Os agentes só utilizam as credenciais que você permitir, e nunca recebem o valor delas.

O Cofre vem ativado por padrão. Ele é aberto em **Cofre**, na barra lateral.

![Lista do Cofre: nome, tipo, páginas em que é usada, último uso e se os agentes podem 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ê |
| - | - |
| **Login** | Um usuário e a sua senha em um host. |
| **Chave de API** | A chave de um serviço. |
| **Chave SSH** | Uma chave privada. Só é usada pelas pessoas. |
| **Segredo** | Qualquer outro valor que deva ser guardado criptografado, como uma chave de licença. |

## Criar uma credencial

1. No **Cofre**, selecione **Nova credencial**.
2. Preencha o formulário:
   * **Nome.** Como as pessoas e os agentes a verão. Por exemplo, "Senha de admin do gateway".
   * **Tipo.**
   * **Host** e **Usuário** (opcionais). Onde e com qual usuário ela é utilizada.
   * **Valor.** O segredo. **Gerar** cria uma senha aleatória.
   * **Notas** (opcionais). Para que serve e quando usá-la.
3. Selecione **Salvar credencial**.

> [!WARNING]
>
> O segredo vai somente em **Valor**. Os agentes veem o nome, o host e o usuário de uma credencial, por isso o Cofre rejeita uma credencial cujo nome, host ou usuário contenha o próprio segredo.

## Usar uma credencial em uma página

No editor, digite `/` e escolha **Senha ou chave do cofre**. Selecione uma credencial existente ou crie uma nova. A página guarda apenas uma referência.

![Uma credencial dentro de uma página: o seu nome, o valor oculto e os botões Copiar e Mostrar.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-credential-block.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=d6a0165bf3bdb343c4c626c91725a64a)

Na página, a credencial aparece como um bloco com o seu nome e o valor oculto:

* **Copiar** copia o valor para a área de transferência.
* **Mostrar** o exibe durante alguns segundos e volta a ocultá-lo.
* O nome do bloco abre a credencial no Cofre.

Copiar ou mostrar um valor sempre fica registrado. O valor não faz parte do texto da página, do seu Histórico nem de nada que os agentes leiam.

## Detalhes de uma credencial

![Detalhes de uma credencial: valor oculto, host e usuário, o interruptor Os agentes podem usá-la, as páginas em que é usada e a sua atividade.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-vault-credential.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=f8e4b66c09070a95ec4becbcbabc3c01)

Ao abrir uma credencial, são exibidos o seu valor (oculto), o seu host e o seu usuário, e também:

| Elemento | O que permite |
| - | - |
| **Rotacionar valor** | Substituir o valor por um novo. As páginas continuam apontando para a mesma credencial e, a partir desse momento, as cópias recebem o valor novo. |
| **Restaurar o valor anterior** | Voltar ao valor que ela tinha antes da última rotação. |
| **Editar dados** | Alterar o nome, o tipo, o host, o usuário ou as notas. O valor não muda. |
| **Notas** | Ler as notas. Abri-las fica registrado, assim como mostrar o valor. |
| **Usada em** | As páginas que vinculam a credencial. |
| **Atividade** | Quem a criou, copiou, mostrou, rotacionou ou leu as suas notas, e cada uso por parte de um agente. |
| **Excluir credencial** | Excluí-la. As páginas que a usam a mostrarão como excluída. Não pode ser desfeito. |

## Permitir que os agentes usem uma credencial

O interruptor **Os agentes podem usá-la** permite que o Teammate e o Solve utilizem a credencial nas sessões do Flexxible Assist. Por exemplo, para baixar um instalador de um servidor que exige usuário e senha.

* **Nunca recebem o valor.** O agente pede permissão para usar a credencial e obtém uma autorização de uso único. É o Flexxible Assist, no dispositivo, que resgata essa autorização e utiliza o valor. O valor não chega ao modelo de IA nem ao navegador do engenheiro.
* **Eles avisam.** Antes de usá-la, o Teammate indica ao engenheiro qual credencial vai utilizar e onde.
* **Fica registrado.** A **Atividade** da credencial mostra qual agente a usou, para quem, em qual dispositivo e com qual motivo.
* **Somente as marcadas.** Uma credencial sem o interruptor ativado não pode ser usada: o pedido do agente é rejeitado.

Somente os proprietários e os administradores decidem quais credenciais os agentes podem usar. Tenha em mente que:

* Os agentes só usam logins, chaves de API e segredos. As chaves SSH são para as pessoas.
* Se alguém alterar o host, o usuário ou o tipo de uma credencial, a permissão é desativada automaticamente e é preciso concedê-la novamente.
* O Bot não pode usar credenciais nem consultar o Cofre.

Consulte [Agentes do Flexxible Assist](https://docs.flexxible.com/pt-BR/features/flexxible-kb/assist-agents.md).

## Buscar e filtrar

A lista do Cofre pode ser filtrada por nome, host ou usuário (tecla `/`), por **Tipo** e por **Quem pode usá-la**: **Agentes e pessoas** ou **Somente pessoas**.

A [paleta de comandos](https://docs.flexxible.com/pt-BR/features/flexxible-kb/search.md) também encontra credenciais pelo nome ou pelo host.

## Credenciais e páginas compartilhadas

As credenciais não saem da sua organização. Quando você compartilha uma página com outra organização, quem a recebe vê que a credencial pertence ao seu Cofre e que não é compartilhada.

## Desativar o Cofre

Em **Configurações** → **Cofre**, **Ativar o cofre** controla a função para toda a organização. Com o Cofre desativado:

* Ninguém o vê, e as páginas mostram as suas credenciais como indisponíveis.
* Os agentes não podem usar nenhuma credencial.
* Nada é excluído: as credenciais são preservadas criptografadas e voltam tal como estavam ao ativá-lo novamente.

## Próximos passos

* [Escrever e editar páginas](https://docs.flexxible.com/pt-BR/features/flexxible-kb/editor.md#credenciales-y-secretos)
* [Agentes do Flexxible Assist](https://docs.flexxible.com/pt-BR/features/flexxible-kb/assist-agents.md)
* [Compartilhar páginas entre organizações](https://docs.flexxible.com/pt-BR/features/flexxible-kb/sharing.md)
