> 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/rotation.md).

# Rotacionar credenciais

Rotacione senhas e chaves SSH automaticamente ou sob demanda, e saiba o que observar quando a credencial é uma conta de domínio.

## O que é e quando usar

Uma operação de rotação troca o segredo de uma ou mais contas em um ou mais ativos, guarda o novo valor no cofre e, no caso das chaves SSH, redistribui a nova chave pública para os alvos.

A rotação é executada por agendamento, sob demanda, ou das duas formas. Use-a para atender a uma política de rotação, e logo depois de qualquer evento que possa ter exposto uma credencial.

{% hint style="info" %}
Quando uma senha muda, a solução também a aplica às **dependências** cadastradas para aquela credencial, ou seja, serviços, tarefas agendadas e aplicações que usam a mesma conta, para que a rotação não quebre integrações. As dependências são declaradas na configuração da conta ou da operação e são atualizadas na mesma execução.
{% endhint %}

## Antes de começar

* O ativo cadastrado em **Ambiente › Ativos**.
* A credencial cadastrada, seja descoberta por uma automação, seja adicionada à mão: tanto faz.
* A credencial vinculada ao host, direto ou por um modelo de conta.
* Um protocolo de gerenciamento alcançável no alvo:
  * **Windows**: WinRM ou OpenSSH
  * **Linux**: SSH
* Firewall liberado, tanto o de rede quanto o do host.
* Para WinRM, o IP da solução adicionado como host confiável no alvo.

A solução precisa conseguir alcançar **cada** alvo para confirmar a troca. Os hosts que ela não alcança ficam com a senha antiga.

## Passos

1. Abra **Contas › Automações › Rotação de senhas**.
2. Clique em **Criar**.
3. Preencha os campos; veja a referência de campos abaixo. Os dois que definem o raio de alcance são **Contas** e **Ativos ou Nodes**.
4. Em **Política de senhas**, defina o tamanho e a complexidade do segredo gerado. Ajuste-a à política mais rígida entre os alvos, não à mais frouxa.
5. Em **Executar regularmente**, defina o agendamento, ou deixe desligado e execute a operação à mão.
6. Defina **Custodiante** se alguém deve receber o resultado por e-mail.
7. Salve e execute a operação uma vez manualmente antes de confiar no agendamento.

## O que você deve ver

![A tela de Rotação de senhas, listando as operações de rotação](https://2577774576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmW94amWe62SEQe4f16Vs%2Fuploads%2Fgit-blob-ef02a06c9d7871c068989567649927d011d8893c%2Frotation.png?alt=media)

**1** Quantas operações de rotação existem. **2** Uma operação, com as contas e as pastas que ela cobre.

A operação aparece na lista com um contador de execuções. Depois de uma execução, o log mostra uma linha por ativo, com sucesso ou falha por host.

## Como verificar se funcionou

Salvar, e até mesmo executar a operação, não prova nada. Verifique se o segredo realmente mudou:

1. Abra a conta em **Contas › Contas**.
2. Abra o **Histórico de senhas** dela. Uma nova versão precisa aparecer, com a data da execução.
3. Abra uma sessão para o ativo usando essa conta. Se o login funcionar, o cofre e o alvo concordam.

O terceiro passo é o que mais importa. Uma execução pode reportar sucesso e ainda assim deixar um host para trás: confira o log de execuções host por host, e não apenas o status da operação.

## Rotacionar uma conta de domínio

As credenciais de domínio se comportam de forma diferente das locais, e é aqui que acontecem os maiores enganos.

* A conta de domínio precisa estar cadastrada como **modelo de conta**, e o modelo precisa estar associado aos hosts que se autenticam contra ela. Essa associação é necessária para a credencial ser utilizável, não só para a rotação.
* Ao rotacionar, você especifica tanto o **host onde a troca é executada** quanto os **hosts que devem receber a nova credencial**.
* A nova senha fica visível na conta, mas **o modelo de conta mantém a senha original**. O modelo de conta nunca é atualizado pela rotação; alterá-lo é uma ação manual.
* Se mais tarde você associar o modelo de conta a um **novo host**, esse host precisa ser adicionado à operação de rotação. Caso contrário, ele fica com a senha guardada no modelo de conta, que, para uma conta de domínio já rotacionada, não funciona mais.

Esse último ponto é a causa de sempre do "funcionou em tudo, menos no servidor novo".

## Rotacionar chaves SSH

A mesma operação rotaciona chaves SSH, por agendamento ou sob demanda. A cada execução, a solução gera um novo par de chaves, atualiza a chave no cofre e redistribui a chave pública para os ativos alvo associados, de modo que o acesso continua sem intervenção manual.

## Erros comuns

| Sintoma                                                       | Causa                                                                                                | Correção                                                                                             |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `The password does not meet the password policy requirements` | O segredo gerado não satisfaz a política do próprio alvo, seja em tamanho, complexidade ou histórico | Aumente a complexidade em **Política de senhas** na operação, para atender ao alvo mais rígido       |
| Alguns hosts tiveram sucesso, outros falharam                 | A solução não conseguiu alcançar esses hosts                                                         | Confira a conectividade e o protocolo de gerenciamento. Hosts inalcançáveis ficam com a senha antiga |
| Um servidor novo continua com a senha de domínio antiga       | Ele foi adicionado ao modelo de conta, mas não à operação de rotação                                 | Adicione o host à operação e execute-a de novo                                                       |
| O modelo de conta mostra uma senha antiga                     | É o esperado. A rotação nunca atualiza o modelo de conta                                             | Altere o modelo de conta à mão se precisar que ele corresponda                                       |
| Conexão WinRM recusada                                        | Porta 5985 bloqueada, ou o IP da solução não é um host confiável                                     | Libere a porta e adicione o IP aos hosts confiáveis do WinRM                                         |

## Referência de campos

| Campo                   | O que faz                                                                                                                                                            |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nome                    | Identifica a operação. Obrigatório                                                                                                                                   |
| Contas                  | Os logins cuja senha vai mudar. Diferencia maiúsculas de minúsculas. Várias contas podem ser listadas, mas todas recebem o mesmo segredo gerado em uma dada execução |
| Ativos ou Nodes         | Os hosts alvo, individualmente ou por pasta                                                                                                                          |
| Política de senhas      | A estratégia de geração e a complexidade do novo segredo                                                                                                             |
| Automações › Parâmetros | Comportamento adicional, como os grupos aos quais a conta pertence. Use-o para que nenhuma conta seja alterada sem o seu conhecimento                                |
| Executar regularmente   | O agendamento. A execução manual continua disponível de qualquer forma                                                                                               |
| Ativo                   | Habilita ou desabilita a operação sem excluí-la                                                                                                                      |
| Custodiante             | Endereço de e-mail notificado com o resultado da execução                                                                                                            |

## Páginas relacionadas

* [Contas gerenciadas](https://wiki.datadike.com/pt/pam/administration/accounts/managed-accounts.md)
* [Modelos de conta](https://wiki.datadike.com/pt/pam/administration/accounts/account-templates.md): por que o modelo de conta mantém o segredo original
* [Política de geração de senhas](https://wiki.datadike.com/pt/pam/administration/accounts/password-policy.md)
* [Coletar contas de um ativo](https://wiki.datadike.com/pt/pam/administration/accounts/discovery-of-accounts.md)
* [Política de detecção e mitigação](https://wiki.datadike.com/pt/pam/administration/ueba/policy.md): rotação disparada por um score de risco
