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

# Descobrir ativos na rede

Encontre ativos automaticamente, a partir de uma conta de provedor de nuvem ou pela varredura de uma faixa de IP, e deixe as políticas de sincronização arquivarem tudo no inventário.

## O que é isto e quando usar

A descoberta registra uma **conta de descoberta**, que pode ser um provedor de nuvem, uma plataforma de virtualização ou um segmento de rede local, e então encontra os ativos por trás dela. As **políticas de sincronização** decidem o que acontece com cada ativo encontrado: que plataforma ele recebe, em que pasta do inventário ele cai e como é nomeado.

Use a descoberta ao integrar um ambiente e mantenha-a agendada depois disso, para que máquinas criadas fora da solução não fiquem fora do inventário.

A tela tem três abas:

| Aba                      | O que faz                                                     |
| ------------------------ | ------------------------------------------------------------- |
| **Contas**               | Lista e gerencia as contas de descoberta já registradas       |
| **Sincronizar política** | As regras que classificam os ativos descobertos               |
| **Escolha a plataforma** | O catálogo de provedores, usado para registrar uma conta nova |

## Antes de começar

* Para um provedor de nuvem, credenciais com permissão para listar instâncias.
* Para uma varredura de LAN, a faixa de IP e uma porta que os hosts que respondem tenham aberta.
* Uma ideia de como você quer os ativos arquivados. Ao menos uma política de sincronização deve existir antes da primeira sincronização, ou tudo cai no padrão.

## Provedores suportados

| Provedor                                                                       | Tipo                                        |
| ------------------------------------------------------------------------------ | ------------------------------------------- |
| [AWS](https://wiki.datadike.com/pt/pam/administration/assets/discovery-aws.md) | Nuvem pública                               |
| Azure                                                                          | Nuvem pública                               |
| Google Cloud                                                                   | Nuvem pública                               |
| Volcengine                                                                     | Nuvem pública                               |
| Ucloud uhost                                                                   | Nuvem pública                               |
| Huawei Cloud                                                                   | Nuvem pública                               |
| Huawei Private Cloud                                                           | Nuvem privada                               |
| VMware                                                                         | Virtualização                               |
| OpenStack                                                                      | Nuvem privada                               |
| Nutanix                                                                        | Infraestrutura hiperconvergente             |
| **LAN**                                                                        | Rede local, por varredura de segmento de IP |

## Passos para varrer uma faixa de IP

1. Abra **Ambiente › Descoberta em Nuvem** e vá para **Escolha a plataforma**.
2. Clique em **+** em **LAN**. Um assistente de três etapas abre em um painel lateral.
3. **Configurações básicas**: dê um **Nome** à conta. A **Plataforma** já vem preenchida como *LAN* e é somente leitura.
4. **LAN**: preencha os atributos.
   * **Segmento de IP**, a faixa em notação CIDR, por exemplo `10.0.30.0/24`. Pressione Enter para adicionar mais de um segmento
   * **Porta de teste**, a porta usada para confirmar que um endereço responde, `22` para SSH
   * **Tempo limite de teste**, quanto esperar por cada endereço, em segundos
   * **Prefixo de nome do host**, acrescentado ao início do nome de cada ativo encontrado
5. **Outro**: uma **Descrição** opcional.
6. Clique em **Confirmar**.
7. De volta a **Contas**, selecione o novo card e clique em **Sincronizar**.

## O que você deve ver

![A tela Descoberta em Nuvem, listando as contas de descoberta registradas](https://2577774576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmW94amWe62SEQe4f16Vs%2Fuploads%2Fgit-blob-b55964a35e46df218bcc5d854266ca552918bba9%2Fdiscover.png?alt=media)

**1** Quantas contas de descoberta existem. **2** O catálogo de provedores, onde uma conta nova é registrada.

O card da conta mostra dois contadores: **REGION**, quantas regiões a sincronização cobre, e **ASSET**, quantos ativos foram encontrados. Depois de uma execução, a aba **Sincronizar lista de histórico** registra a execução e **Sincronizar lista de instâncias** lista as instâncias encontradas.

## Como verificar se funcionou

1. Abra **Ambiente › Ativos**.
2. Os hosts descobertos precisam estar lá, na pasta que a política de sincronização atribuiu, na plataforma que ela atribuiu e com o nome que a política de hostname determina.
3. Se ativos foram encontrados mas não chegaram ao inventário, confira **Sincronizar liberação de ativos** na **Atualização rápida** da conta: com a opção desligada, os ativos sincronizados não são liberados automaticamente.

Encontrar instâncias e arquivá-las são duas coisas distintas. Os contadores provam a primeira; só a lista de ativos prova a segunda.

## Políticas de sincronização

As políticas são avaliadas **por ordem de prioridade** e agem sobre os ativos que atendem às suas condições.

{% hint style="warning" %}
A prioridade vai de **1 a 100**, com padrão **50**, e **quanto menor o número, maior a prioridade**. A política com o menor número é avaliada primeiro.
{% endhint %}

### Criando uma política

Na aba **Sincronizar política**, clique em **Criar**. O assistente tem quatro etapas.

**1. Configurações básicas**: o **Nome** e a **Prioridade**.

**2. Condições**: quais ativos a política alcança.

* **Relações de condição**: **And** aplica a ação apenas quando todas as condições coincidem; **Or** aplica assim que uma coincidir
* **Condições**: cada linha combina três campos, adicionados com **Adicionar**
  * **Nome do atributo**: *Nome da instância*, *Nome da plataforma da instância* ou *Endereço da instância*
  * **Correspondência**: o operador de comparação
  * **Valor de Propriedade**: o valor com que se compara

**3. Ação**: o que se aplica aos ativos correspondentes.

* **Tipo de recurso**: o que atribuir, entre *Plataforma*, *Node* ou a política de nomenclatura
* **Recursos**: o valor específico para aquele tipo

A política nativa mostra o formato típico: ela define a **Plataforma**, o **Node** de destino no inventário e a política de hostname, que decide se o ativo recebe o nome da instância ou o nome da instância combinado com parte do seu endereço IP.

**4. Outro**: uma **Descrição** em texto livre.

## Referência de campos

### Conta de descoberta, bloco Atualização rápida

| Campo                           | O que faz                                                                                 |
| ------------------------------- | ----------------------------------------------------------------------------------------- |
| Tipo de IP                      | Se a sincronização usa o IP privado ou o público do ativo                                 |
| Sincronizar liberação de ativos | Se os ativos sincronizados são liberados automaticamente no inventário                    |
| Execução manual                 | Executa uma sincronização sob demanda (**Executar**) ou ajusta o agendamento (**Editar**) |

### Conta LAN

| Campo                   | O que faz                                                               |
| ----------------------- | ----------------------------------------------------------------------- |
| Segmento de IP          | A faixa a varrer, em CIDR. Obrigatório. Vários segmentos são permitidos |
| Porta de teste          | A porta usada para confirmar que um endereço responde. Obrigatório      |
| Tempo limite de teste   | Segundos de espera por endereço. Obrigatório                            |
| Prefixo de nome do host | Prefixo aplicado ao nome de cada ativo descoberto. Obrigatório          |

### Política de sincronização

| Campo                | O que faz                                                                         |
| -------------------- | --------------------------------------------------------------------------------- |
| Prioridade           | De 1 a 100, padrão 50. O menor é avaliado primeiro                                |
| Relações de condição | **And** exige todas as condições; **Or** exige apenas uma                         |
| Nome do atributo     | *Nome da instância*, *Nome da plataforma da instância* ou *Endereço da instância* |
| Tipo de recurso      | *Plataforma*, *Node* ou a política de nomenclatura                                |

## Páginas relacionadas

* [Inventário de ativos](https://wiki.datadike.com/pt/pam/administration/assets/inventory.md)
* [Descobrir ativos na AWS](https://wiki.datadike.com/pt/pam/administration/assets/discovery-aws.md): credenciais, regiões e sincronização de contas AWS
* [Plataformas](https://wiki.datadike.com/pt/pam/administration/assets/platforms.md): o que a política atribui a cada ativo descoberto
* [Pastas e tags](https://wiki.datadike.com/pt/pam/administration/assets/folders-and-tags.md)
* [Coletar contas de um ativo](https://wiki.datadike.com/pt/pam/administration/accounts/discovery-of-accounts.md): o passo seguinte depois de encontrar o host
