# Gather accounts

Consulte nesse documento:

* Requerimentos
* Step by Step
* Troubleshooting
* [Erros comuns](#erros-comuns)

***

## [**Requerimentos**](/integracoes/windows/automacao.md)

Para que a coleta de contas funcione corretamente, verifique os seguintes pré-requisitos:

O host deve estar cadastrado em Enviroment >> Assets e acessível via SSH (Linux) ou WinRM (Windows).

A conta administrator/administrador do host deve estar ativa no PAM e com permissão suficiente para listar contas do sistema (ver Persistência da execução).

Para Windows: WinRM deve estar habilitado e a porta 5985 liberada no firewall.

Para Linux: Python deve estar instalado no host alvo (Python 3 preferencialmente).

***

## Step by Step

{% stepper %}
{% step %}

#### Crie o JOB de automação

SYSADMIN >> ACCOUNTS >> AUTOMATIONS >> GATHER ACCOUNTS

<div align="left"><figure><img src="/files/iYLaJxnf4VxCPuLubVDG" alt="" width="189"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Gather account tasks

Função Creat: Clique em + Create para criar uma nova tarefa de coleta de conta

<figure><img src="/files/vwnnH9uYGz4e1LUHnwdu" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Preencha as configurações básicas

Preencha os campos do formulário Configurações Básicas:

Nome (obrigatório): Identificação da operação de coleta.

Nó: Define em qual nó do ambiente a operação será executada.

Dispositivos: Seleciona os dispositivos alvo da coleta de contas.

Execução periódica: Quando ativado, exibe os campos de agendamento — Operações programadas (crontab) e Intervalo (padrão: 24 horas). Se ambos estiverem configurados, o crontab tem prioridade.

Sincronizar com ativo: Quando ativado, as contas coletadas serão sincronizadas automaticamente com os ativos do PAM.

Ativação: Habilita ou desabilita a operação (habilitado por padrão).

Custodiante: Usuário responsável pela operação — utilizado apenas para envio de notificações por email.

Observação: Campo livre para anotações sobre a operação.
{% endstep %}

{% step %}

#### Persistência da execução:

Enviroment >> Assets >> Click no host >> Accounts >> Administrator >> Quick update >> Active

Por padrão o PAM sempre utilizará a conta administrator/administrador para se conectar aos ambientes, se essa conta tem permissão reduzida, não tem a senha imputada no DataDike ou está desabilitada no S.O., **desative** essa conta no PAM.
{% endstep %}

{% step %}

#### Retorno de uma execução bem sucedida:

<figure><img src="/files/gHkg98A3EdvtxIEyq6Xw" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Troubleshooting

Se a coleta não executar corretamente, verifique os seguintes pontos antes de consultar os erros comuns:

Confirme que o host está acessível na rede e que a porta SSH (22) ou WinRM (5985) está aberta.

Verifique se a conta administrator/administrador está ativa e com a senha cadastrada corretamente no PAM (Enviroment >> Assets >> host >> Accounts >> Administrator >> Quick update >> Active).

Para Windows: confirme que o protocolo WinRM está habilitado no host e que a autenticação NTLM ou Kerberos está configurada corretamente.

Para Linux: confirme que Python 3 está instalado e disponível em /usr/bin/python3.

Consulte a aba Executions do JOB para visualizar o log completo da última execução e identificar o erro específico.

***

## Erros comuns

Esse seguimento se trata de #Advanced knowledge (consulte seu Partner)

### **MODULE FAILURE**

<mark style="color:$warning;">FAILED! => {"changed": false, "module\_stderr": "Warning: Permanently added '17</mark>~~<mark style="color:$warning;">2.168.168.10</mark>~~<mark style="color:$warning;">' (ECDSA) to the list of known hosts.\r\n", "module\_stdout": "", "msg": "MODULE FAILURE\nSee stdout/stderr for the exact error", "rc": 0}</mark>

Estruturando a mensagem para melhor entendimento:

```
FAILED! => {
"changed": false,
"module_stderr": "Warning: Permanently added '172.168.168.10' (ECDSA) to the list of known hosts.\r\n",
"module_stdout": "",
"msg": "MODULE FAILURE\nSee stdout/stderr for the exact error",
"rc": 0
}
```

Causas:

1. O DataDike conseguiu **se conectar via SSH/WinRM** ao host `172.168.168.10`.
   * A prova é que ele adicionou a chave ECDSA no `known_hosts`.
2. Porém, quando ele tenta rodar o **módulo Python/PowerShell** dentro da máquina alvo, a execução falha.
   * O `rc: 0` é enganoso — o processo de transporte não deu erro, mas o módulo não conseguiu inicializar corretamente.
   * Como o `module_stdout` veio vazio, não houve retorno útil do script.
3. Esse tipo de erro costuma estar ligado a:
   * **Windows**:
     * Problema com **WinRM** (falta de permissão, autenticação incompleta, ou configuração incorreta).
     * **Python não disponível** no Windows (quando se usa `connection: ssh` em vez de `winrm`).
     * Execução do módulo do Ansible sem privilégios suficientes.
   * **Linux**:
     * Python não instalado ou em local inesperado (`/usr/bin/python3` ausente).
     * Falta de bibliotecas necessárias para o módulo.

***

### Data could not be sent to remote host

<mark style="color:$warning;">fatal: \[]: UNREACHABLE! => {"changed": false, "msg": "Data could not be sent to remote host "10.0.30.111". Make sure this host can be reached over ssh: Warning: Permanently added '10.0.30.111' (ECDSA) to the list of known hosts.\r\nConnection reset by 10.0.30.111 port 22\r\n", "unreachable": true}</mark>

Estruturando a mensagem para melhor entendimento:

```
UNREACHABLE! => {
"msg": "Data could not be sent to remote host "10.0.30.111".
Make sure this host can be reached over ssh:
Warning: Permanently added '10.0.30.111' (ECDSA) to the list of known hosts.\r\n
Connection reset by 10.0.30.111 port 22\r\n",
"unreachable": true
}
```

Causas:

1. Serviço SSH não ativo ou caiu no servidor
2. Firewall bloqueando depois do handshake inicial.
3. Política de segurança (IDS/IPS) fechando a conexão após tentativa de autenticação.
4. Usuário incorreto

***

### The connection plugin 'rdp' was not found

<figure><img src="/files/ieXnKwFTFHaq0Uxuffr3" alt=""><figcaption></figcaption></figure>

Correção: Adicione no cadastro do HOST a porta 22 em protocols

***

### ntlm: the specified credentials were rejected by the server

fatal: \[DEMO-WIN03]: UNREACHABLE! => {"changed": false, "msg": "ntlm: the specified credentials were rejected by the server", "unreachable": true}

<figure><img src="/files/u3ujMTtHZwSvsyUV8pYw" alt=""><figcaption></figcaption></figure>

Consulte no Windows pelo ID 4624, ele comprava que teve a comunicacao mas o bloqueio ocorreu devido a incompatibilidade NTLM

<figure><img src="/files/uZF8JFnWQPCI0XFAwZnw" alt=""><figcaption></figcaption></figure>

***

### ntlm: HTTPConnectionPool(host='192.168.30.112', port=5985): Max retries exceeded

ntlm: HTTPConnectionPool(host='192.168.30.112', port=5985): <mark style="color:orange;">Max retries exceeded</mark> with url: /wsman (Caused by ConnectTimeoutError(\<urllib3.connection.HTTPConnection object at 0x7f410155d4d0>, 'Connection to 192.168.30.112 timed out. (connect timeout=121)'))", "unreachable": true}

<figure><img src="/files/8qotxrAMh5yTsbs4eLw7" alt=""><figcaption></figcaption></figure>

Verifique o firewall do Windows e crie as devidas exceções de regra.

Verifique se o serviço WINRM está executando

<figure><img src="/files/w5mg3Q63um3ggCQMJ2Lh" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.datadike.com/product-guide/configuracoes/pam/sysadmin/accounts/automations/gather-accounts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.