> 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/discovery-of-accounts.md).

# Coletar contas de um ativo

Colete as contas que já existem em um ativo, classifique as privilegiadas e traga-as para dentro do gerenciamento.

## O que é e quando usar

Uma operação de coleta se conecta a um ativo, lista as contas que existem no sistema operacional dele, registra os atributos delas e classifica quais possuem privilégio administrativo.

Execute-a ao integrar um ambiente, para descobrir o que realmente existe em vez do que o inventário afirma, e execute-a periodicamente depois disso, para que as contas criadas fora da solução não fiquem invisíveis.

## Antes de começar

* O host cadastrado em **Ambiente › Ativos** e alcançável por SSH (Linux) ou WinRM (Windows).
* Uma conta administrativa no host, ativa na solução e com permissão suficiente para listar as contas do sistema.
* **Windows**: WinRM habilitado e porta 5985 liberada no firewall.
* **Linux**: Python 3 instalado no alvo, normalmente em `/usr/bin/python3`.

{% hint style="warning" %}
**A conta com que a solução se conecta.** Por padrão, a solução usa a conta `administrator` do ativo para executar a coleta. Se essa conta tiver permissão reduzida, não tiver senha guardada na solução, ou estiver desabilitada no sistema operacional, **desabilite-a na solução**, senão toda execução falha nela.

Ajuste em **Ambiente › Ativos › \<host> › Contas › Administrator › Atualização rápida › Ativo**.
{% endhint %}

## Passos

1. Abra **Contas › Automações › Coletar contas**.
2. Clique em **Criar**.
3. Preencha a configuração básica; veja a referência de campos abaixo.
4. Decida se vai ligar o **Sincronizar com ativo**. Com ele ligado, as contas coletadas são cadastradas automaticamente no ativo.
5. Defina **Executar regularmente** se a coleta deve se repetir.
6. Salve e execute uma vez à mão.

## O que você deve ver

![A tela de Coletar contas](https://2577774576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmW94amWe62SEQe4f16Vs%2Fuploads%2Fgit-blob-012e985d553b1296590ffc8e04a72163186498c2%2Faccount-collection.png?alt=media)

**1** Quantas operações de coleta existem.

A execução termina e a aba **Registro de execuções** da operação mostra um log por host. As contas coletadas aparecem em cada ativo, cada uma com a data da coleta que a encontrou.

## Como verificar se funcionou

1. Abra **Ambiente › Ativos** e selecione um dos alvos.
2. Abra a aba **Contas** dele. As contas encontradas no sistema operacional precisam estar listadas ali, com a data da coleta.
3. Confirme que uma conta que você sabe ser privilegiada naquele host carrega a marcação **Privilegiada**. A classificação é produzida pela própria coleta, não digitada por um operador: se ela estiver faltando, a coleta não leu os grupos aos quais a conta pertence no host.

## O que é coletado

Para cada conta encontrada, a operação registra:

| Grupo          | O que ela coleta                                                                                                                                                                          |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Atributos**  | Nome de usuário, UID ou identificador, shell, diretório home e grupos aos quais pertence                                                                                                  |
| **Privilégio** | `root` e contas com privilégio administrativo: membros de `root`, `wheel` ou `sudo` e contas listadas no sudoers no Linux; `Administrator` e membros de grupos administrativos no Windows |
| **Uso**        | Último login, que separa as contas realmente em uso das contas que existem mas estão paradas. É a base para revisar e desabilitar contas órfãs                                            |

## Erros comuns

| Sintoma                                                       | Causa                                                                                                                                                                              | Correção                                                                                                          |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `MODULE FAILURE` com `module_stdout` vazio                    | A conexão funcionou mas o módulo não conseguiu iniciar no alvo. No Linux, Python ausente ou fora do caminho esperado; no Windows, WinRM mal configurado ou privilégio insuficiente | Instale o Python 3 no Linux; confira a autenticação e o privilégio do WinRM no Windows                            |
| `Data could not be sent to remote host` / `Connection reset`  | SSH não está rodando, um firewall fecha a conexão depois do handshake, um IDS ou IPS a derruba, ou o usuário está errado                                                           | Confirme o serviço SSH, o firewall e a conta usada                                                                |
| `The connection plugin 'rdp' was not found`                   | O host não tem protocolo SSH cadastrado, então a operação não tem canal de gerenciamento                                                                                           | Adicione a porta 22 em **protocolos** no cadastro do host                                                         |
| `ntlm: the specified credentials were rejected by the server` | Incompatibilidade de NTLM, e não senha errada                                                                                                                                      | Verifique o evento Windows de ID 4624 no alvo: ele mostra que a conexão chegou e foi bloqueada na negociação NTLM |
| Todos os hosts falham na mesma conta                          | A conta `administrator` está desabilitada, sem privilégio, ou sem senha guardada                                                                                                   | Desabilite essa conta na solução, conforme descrito acima                                                         |

{% hint style="info" %}
`rc: 0` dentro de um `MODULE FAILURE` engana. Isso significa que o transporte funcionou; a falha aconteceu dentro do alvo, ao iniciar o módulo.
{% endhint %}

## Referência de campos

| Campo                 | O que faz                                                                                                                            |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Nome                  | Identifica a coleta. Obrigatório                                                                                                     |
| Node                  | A pasta do ambiente onde a operação é executada                                                                                      |
| Dispositivos          | Os ativos alvo                                                                                                                       |
| Executar regularmente | Exibe os campos de agendamento, **crontab** e intervalo, com padrão de 24 horas. Se os dois estiverem definidos, **o crontab vence** |
| Sincronizar com ativo | Cadastra as contas coletadas nos ativos automaticamente                                                                              |
| Ativo                 | Habilita ou desabilita a operação. Ligado por padrão                                                                                 |
| Custodiante           | O usuário responsável. Usado apenas para notificação por e-mail                                                                      |
| Comentário            | Texto livre                                                                                                                          |

## Páginas relacionadas

* [Contas gerenciadas](https://wiki.datadike.com/pt/pam/administration/accounts/managed-accounts.md)
* [Rotacionar credenciais](https://wiki.datadike.com/pt/pam/administration/accounts/rotation.md)
* [Descobrir ativos na rede](https://wiki.datadike.com/pt/pam/administration/assets/discovery.md): encontrar os hosts, antes de encontrar as contas deles
* [Inventário de ativos](https://wiki.datadike.com/pt/pam/administration/assets/inventory.md)
