> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/pam/administration/accounts/vault.md).

# O cofre de credenciais

O que o cofre guarda, as três formas de um segredo sair dele, como cada leitura é registrada e como o backup é feito com custódia dividida.

## O que é e quando usar

O cofre guarda os segredos de todas as contas gerenciadas: a senha, a chave SSH, o token, a chave de acesso ou a chave de API que autentica no alvo. Ele é o centro do produto, e a razão de ser das outras páginas. Os ativos dizem onde conectar, as autorizações dizem quem pode, a rotação diz com que frequência o segredo muda, e o cofre é o que as três protegem.

O princípio de funcionamento é que **um segredo é usado muito mais vezes do que é visto**. O caminho padrão abre uma sessão sem que o segredo chegue à pessoa que a usa, e os caminhos que o revelam são permitidos à parte e registrados à parte.

## O que o cofre guarda

Um segredo por conta gerenciada, de um destes tipos:

| Tipo de segredo | Uso típico                                            |
| --------------- | ----------------------------------------------------- |
| Senha           | Windows, Linux, dispositivos de rede, bancos de dados |
| Chave SSH       | Hosts Linux e Unix, dispositivos de rede              |
| Token           | APIs e serviços                                       |
| Chave de acesso | Contas de provedores de nuvem                         |
| Chave de API    | Integrações de aplicações                             |

Cada segredo tem uma **versão**. Rotacionar uma conta não apaga o histórico dela: os valores anteriores ficam guardados, e é isso que permite responder, meses depois, "qual credencial era válida no dia do incidente". Veja [Rotacionar credenciais](https://wiki.datadike.com/pt/pam/administration/accounts/rotation.md).

O inventário de contas informa quais contas têm de fato um segredo, junto com se cada uma é privilegiada e se a rotação automática a alcança. Esse relatório é a resposta mais curta para "o cofre está completo?", e ele expõe as contas que foram cadastradas mas nunca tiveram uma credencial guardada. Veja [Relatórios](https://wiki.datadike.com/pt/pam/administration/audit/reports.md).

## As três formas de um segredo sair do cofre

| Caminho    | O que o usuário recebe                                                                      | Quando permitir                                                               |
| ---------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| **Usar**   | Uma sessão se abre, autenticada com o segredo. O usuário nunca o vê e não consegue copiá-lo | O padrão. Deve cobrir quase todos os casos                                    |
| **Copiar** | O segredo vai para a área de transferência sem ser exibido                                  | Um cliente que o console não consegue conduzir                                |
| **Ver**    | O segredo é exibido na tela                                                                 | A exceção. Uma emergência, ou uma ferramenta que exige o valor digitado à mão |

Qual das três o usuário recebe é decidido na autorização, não na conta, então a mesma conta pode ser utilizável sem ser visível para uma equipe e totalmente visível para outra. Veja [Autorizações](https://wiki.datadike.com/pt/pam/administration/access/authorizations.md).

{% hint style="info" %}
Uma autorização também pode conceder uma conta que o usuário nem deve conhecer. **Conta manual** pede as credenciais ao usuário no momento da conexão e não guarda nada; **Conta anônima** conecta sem credencial. Nenhuma das duas envolve o cofre, e ambas servem para ativos cujas credenciais precisam ficar fora dele.
{% endhint %}

Credenciais que não pertencem a nenhum ativo, como portais de fornecedores ou contas de licença, ficam em outro armazenamento, pessoal e compartilhado à mão: veja [Credenciais e pastas do Cofre](https://wiki.datadike.com/pt/pam/administration/accounts/vault-entries.md).

## Toda leitura é registrada

Ler um segredo é um evento auditado por si só, separado da abertura da sessão. O registro traz a data, quem ou o que pediu, qual conta foi lida, o endereço de origem e a ação.

O mesmo registro cobre as aplicações: quando um script ou um scanner busca uma credencial pelo [acesso aplicação para aplicação](https://wiki.datadike.com/pt/pam/administration/integrations/application-to-application.md), a leitura cai na mesma trilha de uma pessoa clicando em *ver*. É isso que faz de "quem já leu esta credencial" uma pergunta com resposta completa.

**Recuperação de credenciais** é um dos relatórios operacionais, e é citado como evidência por seis dos sete pacotes de conformidade. Veja [Compliance mappings](https://wiki.datadike.com/pt/pam/reference/compliance-mappings.md).

## Backup do cofre

![A tela Backup de contas, com uma tarefa agendada e os seus dois custodiantes](https://2577774576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmW94amWe62SEQe4f16Vs%2Fuploads%2Fgit-blob-bdd2616640400ec243cd05f861732e43820c8b67%2Fvault-backup.png?alt=media)

**1** A tarefa, com o nome do que ela produz. **2** O agendamento, como expressão crontab. **3** O Custodiante A. **4** O Custodiante B. Com os dois definidos, a chave é dividida e nenhuma das metades abre o backup sozinha.

A operação de backup exporta as credenciais criptografadas e as entrega por e-mail, SFTP ou webhook.

| Aspecto          | Detalhe                       |
| ---------------- | ----------------------------- |
| Algoritmo        | AES-256-CBC                   |
| Divisão da chave | Shamir Secret Sharing, 2 de 2 |
| Formato          | ZIP criptografado ou JSON     |

### Antes de começar

* Um servidor de e-mail configurado, se a entrega for por e-mail.
* Uma senha mestra definida para abrir o cofre.

### Passos

1. Abra **Contas › Automações › Backup de contas**.
2. Clique em **Criar** e defina o **Nome** e o **Tipo**.
3. Escolha o tipo de backup: **E-mail**, **SFTP** ou **Webhook**.
4. Em **Senha dividida**, defina o **Custodiante A** e o **Custodiante B**.
5. Defina o agendamento.
6. Salve e acompanhe as execuções no histórico.

{% hint style="warning" %}
**A divisão só acontece com dois custodiantes.** Se os destinatários A e B estiverem definidos, o texto cifrado é dividido em duas partes e as duas são necessárias para descriptografar. Se apenas um destinatário estiver definido, **a chave não é dividida**, e esse destinatário sozinho abre o cofre inteiro.

É a configuração que as pessoas erram, e a falha é silenciosa: o backup funciona das duas formas.
{% endhint %}

### Como verificar se funcionou

1. Abra o histórico de execuções da operação e confirme que a execução teve sucesso.
2. Confirme que cada custodiante recebeu a sua parte: duas partes, se você configurou duas.
3. Restaure em uma instância de teste. Um backup que nunca foi restaurado é uma hipótese, não um backup.

## Acesso de emergência (break-glass)

A solução permite uma conta de acesso de emergência para contingência: um custodiante autorizado, após a autenticação de dois fatores, pode ler qualquer credencial do cofre.

**Como funciona**

* O acesso de emergência exige autenticação de dois fatores, separada do login normal, antes de qualquer credencial ser revelada.
* Uma vez autenticado, o custodiante consegue recuperar qualquer credencial do cofre, mantendo a operação em pé quando os aprovadores estão indisponíveis, durante um incidente, ou em recuperação de desastre.
* Ele se combina com o modelo de custódia dupla, em que as partes da chave ficam com pessoas diferentes, apertando o controle sobre o uso emergencial.

**Auditoria e alertas**

Todo uso da conta de emergência é escrito na trilha de auditoria, com quem, quando e quais credenciais foram acessadas, e pode gerar alertas específicos, para que qualquer uso de break-glass seja revisado imediatamente.

{% hint style="danger" %}
Mantenha a conta de emergência fora do alcance da rotação automática de credenciais. Uma automação que rotaciona justamente a credencial da qual você depende durante um incidente anula o propósito dela.
{% endhint %}

## Como verificar se o cofre está cumprindo o papel dele

Quatro verificações, na ordem que encontra problemas mais depressa:

1. **Abra uma sessão numa conta gerenciada e confirme que nada foi revelado.** A sessão deve se autenticar sem que o segredo apareça em lugar nenhum da interface. É desse comportamento que todo o resto depende.
2. **Gere o relatório de inventário de contas** e olhe a coluna *Has secret*. Uma conta cadastrada sem credencial parece gerenciada na lista de ativos, e não está.
3. **Leia um segredo de propósito** e depois encontre essa leitura no relatório de recuperação de credenciais. Se a leitura não estiver no relatório, a trilha está incompleta e nenhum outro controle merece confiança.
4. **Rotacione uma conta e confirme que a versão anterior continua guardada.** É a retenção das versões anteriores que responde, depois do fato, a uma pergunta sobre um incidente.

## Erros comuns

| Sintoma                                               | Causa                                                                 | Correção                                                                  |
| ----------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| Um usuário vê o segredo quando não deveria            | A autorização concede *ver*, e não só *usar*                          | Retire a permissão de ver na autorização, não na conta                    |
| Uma conta está no inventário mas as sessões falham    | Ela não tem segredo                                                   | Confira a coluna *Has secret* e guarde a credencial                       |
| O backup chega como um único arquivo que abre sozinho | Apenas um custodiante foi configurado, então a chave não foi dividida | Defina o Custodiante A e o Custodiante B                                  |
| O backup não pode ser descriptografado                | Uma das duas partes está faltando                                     | As duas partes são necessárias. Recupere a parte do custodiante que falta |
| O backup por e-mail nunca chega                       | O servidor de e-mail não está configurado                             | Configure primeiro as notificações                                        |
| Um segredo não pode ser revelado no console           | O MFA não está habilitado na conta                                    | Habilite o MFA                                                            |

## Páginas relacionadas

* [Contas gerenciadas](https://wiki.datadike.com/pt/pam/administration/accounts/managed-accounts.md): as contas cujos segredos ficam aqui
* [Credenciais e pastas do Cofre](https://wiki.datadike.com/pt/pam/administration/accounts/vault-entries.md): credenciais guardadas e compartilhadas à mão, que nenhuma automação gerencia
* [Rotacionar credenciais](https://wiki.datadike.com/pt/pam/administration/accounts/rotation.md): como um segredo guardado é trocado, e o que acontece com o anterior
* [Autorizações](https://wiki.datadike.com/pt/pam/administration/access/authorizations.md): onde se decide entre usar, copiar e ver
* [Acesso aplicação para aplicação](https://wiki.datadike.com/pt/pam/administration/integrations/application-to-application.md): como um script obtém um segredo sem uma pessoa
* [Autenticação multifator](https://wiki.datadike.com/pt/pam/administration/identities/mfa.md): o segundo fator que a revelação e o break-glass exigem
* [Trilha de auditoria](https://wiki.datadike.com/pt/pam/administration/audit/audit-trail.md): onde cada leitura é registrada
