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

# Inventário de ativos

Registre, organize, teste e remova os dispositivos que a solução protege, e saiba ler o que o painel de detalhes informa.

## O que é isto e quando usar

O inventário reúne todos os dispositivos que a solução protege: servidores, equipamentos de rede, bancos de dados, aplicações web e recursos de nuvem. É onde um ativo é registrado, arquivado, testado e removido.

{% hint style="info" %}
O menu chama de **Ativos**; o título da própria tela é **Dispositivos**. São a mesma coisa.
{% endhint %}

## Antes de começar

* A plataforma à qual o ativo pertence. É a plataforma que define quais protocolos e portas ficam disponíveis (veja [Plataformas](https://wiki.datadike.com/pt/pam/administration/assets/platforms.md)).
* A estrutura de pastas desejada, ao menos em linhas gerais. Arquivar os ativos já na criação custa muito menos do que reorganizar depois.

## Passos

1. Abra **Ambiente › Ativos**.
2. Clique em **Criar**.
3. Preencha o **Nome** e o **Endereço**, que pode ser IP ou hostname.
4. Escolha a **Plataforma**. Os protocolos e as portas vêm dela.
5. Salve.
6. Selecione o ativo e execute **Testar conexão**.
7. No painel de detalhes, use **Node** para arquivá-lo em uma pasta e **Tags** para rotulá-lo.

{% hint style="info" %}
Uma aplicação web é cadastrada de outro jeito: ela recebe a **URL** da sua tela de login em vez de um endereço, e um modo de preenchimento automático para a credencial. Veja [Sessões web](https://wiki.datadike.com/pt/pam/administration/sessions/web.md).
{% endhint %}

{% hint style="info" %}
Firewalls, switches e roteadores têm um passo a passo próprio, da escolha da plataforma à primeira sessão gravada. Veja [Cadastrar um dispositivo de rede](https://wiki.datadike.com/pt/pam/administration/assets/register-network-device.md).
{% endhint %}

## O que você deve ver

![A tela Dispositivos, com os ativos agrupados por categoria e o painel de pastas](https://2577774576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmW94amWe62SEQe4f16Vs%2Fuploads%2Fgit-blob-50ffc238b22c4f2949f1cd44628f0347d2a512a5%2Fasset-inventory.png?alt=media)

**1** Quantos ativos o filtro atual retorna. **2** Um card de ativo: tipo de plataforma, nome, endereço e estado. **3** O painel de pastas, com Pastas de ativos e Pastas por tipo como duas visões do mesmo inventário.

Os ativos aparecem como **cards agrupados por categoria**: **HOST**, **DATABASE**, **WEB** e **CLOUD**, as mesmas categorias das plataformas. Um grupo só aparece quando ao menos um ativo pertence a ele, e o cabeçalho de cada grupo traz o próprio botão **Carregar**, para importar ativos daquela categoria a partir de um arquivo.

Cada card mostra o tipo de plataforma, o nome, o endereço e os selos da plataforma e do estado, com `ACTIVE` quando o ativo está habilitado.

## Como verificar se funcionou

1. Execute **Testar conexão** a partir do card. Registro e alcançabilidade são coisas diferentes, e o card fica idêntico nos dois casos.
2. Abra os detalhes do ativo e confira a linha **Protocolos**, em **Configurações básicas**. As portas efetivas precisam ser as esperadas: `rdp:3389`, `winrm:5985`. Se estiverem erradas, o problema é a plataforma, não o ativo.
3. Confirme que o ativo aparece na pasta em que você o arquivou.

## Ações em um card

| Ação                | O que faz                                                                      |
| ------------------- | ------------------------------------------------------------------------------ |
| Detalhes do ativo   | Abre o painel de detalhes                                                      |
| Testar conexão      | Testa a conectividade com o dispositivo                                        |
| Editar              | Abre o formulário de edição                                                    |
| Duplicar            | Cria uma cópia do registro                                                     |
| Desvincular gateway | Desassocia o ativo de um gateway de broker. Indisponível quando não há vínculo |
| Excluir             | Remove o ativo                                                                 |

O ícone de seta expande o card para mostrar informações adicionais.

## Pastas

O painel da direita organiza os ativos em duas visões:

| Visão                | O que é                                                                                                                                        |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pastas de ativos** | A estrutura que você constrói, a partir da raiz `DEFAULT`. Agrupe por finalidade, ambiente, cliente ou qualquer critério usado na sua operação |
| **Pastas por tipo**  | Agrupamento automático por tipo de plataforma, útil para achar um dispositivo pela tecnologia                                                  |

Clicar em uma pasta **filtra a lista**. O filtro ativo aparece como um marcador acima da lista, por exemplo `Folder: DEMO`, com um `x` para removê-lo e **Limpar tudo** para descartar todos os filtros de uma vez.

## O painel de detalhes

Cinco abas:

| Aba                       | Conteúdo                                        |
| ------------------------- | ----------------------------------------------- |
| **Configurações básicas** | Os dados de registro do ativo                   |
| **Logins**                | Credenciais associadas ao ativo                 |
| **Usuário autorizado**    | Usuários e grupos com permissão para alcançá-lo |
| **Sessões no ativo**      | Histórico de sessões neste ativo                |
| **Comandos**              | Comandos executados nessas sessões              |

**Configurações básicas** traz: Nome, Tipo (categoria e plataforma, como `Host/Windows`), Endereço, Plataforma, Protocolos com as portas efetivas, Domínio, Ativo, datas de criação e de atualização, Criador e Descrição.

{% hint style="warning" %}
Os protocolos e as portas mostrados aqui vêm da **plataforma** do ativo. Para mudar o padrão de todos os ativos de uma plataforma, use **Sincronizar protocolo para ativos** na tela de plataformas: editar um ativo não move os demais.
{% endhint %}

Abaixo das abas ficam três blocos de ação rápida:

* **Atualização rápida**, com a chave **Ativo**, **Atualize as informações do hardware**, que atualiza o inventário de hardware, e **Testar conectividade**
* **Node**, que arquiva o ativo em uma pasta
* **Tags**, os rótulos usados depois para filtrar a lista

## Erros comuns

| Sintoma                                        | Causa                                                       | Solução                                                         |
| ---------------------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------- |
| O ativo está registrado, mas as sessões falham | A plataforma não oferece o protocolo que você está tentando | Confira **Protocolos** em Configurações básicas, e a plataforma |
| Falta uma categoria na lista                   | Nenhum ativo pertence a ela                                 | Os grupos só aparecem quando têm conteúdo                       |
| Testar conexão falha em um host alcançável     | Porta errada, ou nenhuma credencial para testar             | Compare a porta efetiva com a do host e depois confira a conta  |
| **Desvincular gateway** está esmaecido         | O ativo não tem vínculo com gateway                         | É o esperado. Não há o que desfazer                             |

## Páginas relacionadas

* [Plataformas](https://wiki.datadike.com/pt/pam/administration/assets/platforms.md): de onde vêm os protocolos e as portas
* [Pastas e tags](https://wiki.datadike.com/pt/pam/administration/assets/folders-and-tags.md)
* [Descobrir ativos na rede](https://wiki.datadike.com/pt/pam/administration/assets/discovery.md)
* [Contas gerenciadas](https://wiki.datadike.com/pt/pam/administration/accounts/managed-accounts.md)
