> 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/product-guide/configuracoes/pam/sysadmin/enviroment/assets.md).

# Dispositivos

A tela reúne todos os dispositivos protegidos pelo PAM: servidores, equipamentos de rede, bancos de dados, aplicações web e recursos em nuvem. É a partir dela que se cadastra, organiza, testa e remove um dispositivo.

No menu ela aparece como **Assets**; o título da própria tela é **Devices**.

<figure><img src="/files/PQrsPKg9nG8ZdZQcrDAM" alt=""><figcaption><p>Listagem de dispositivos agrupada por categoria, com o painel de pastas à direita</p></figcaption></figure>

## Como a lista é organizada

Os dispositivos são exibidos em **cards agrupados por categoria**. Cada grupo tem um cabeçalho recolhível com o nome da categoria, a quantidade de dispositivos nela e um botão **Upload** próprio, que importa dispositivos daquela categoria a partir de arquivo.

As categorias são as mesmas das plataformas: **HOST**, **DATABASE**, **WEB** e **CLOUD**. Um grupo só aparece quando existe pelo menos um dispositivo naquela categoria.

## O card do dispositivo

Cada card apresenta:

* à esquerda, o ícone e o **tipo de plataforma** (por exemplo, `LINUX`, `WINDOWS`, `ORACLE`)
* o **nome** do dispositivo, que abre o painel de detalhes
* o **endereço** (IP ou nome de host)
* selos com a **plataforma** e o **estado** (`ACTIVE` quando o dispositivo está habilitado)

À direita ficam as ações individuais:

| Ação                | O que faz                                                                                         |
| ------------------- | ------------------------------------------------------------------------------------------------- |
| **Asset details**   | Abre os detalhes do dispositivo                                                                   |
| **Test Connection** | Testa a conectividade com o dispositivo                                                           |
| **Edit**            | Abre o formulário de edição                                                                       |
| **Duplicate**       | Cria uma cópia do cadastro                                                                        |
| **Unbind gateway**  | Desfaz o vínculo do dispositivo com um gateway de broker. Fica indisponível quando não há vínculo |
| **Delete**          | Remove o dispositivo                                                                              |

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

## Barra de ferramentas

* **Search**: localiza dispositivos pelo nome ou endereço
* **Create**: cadastra um novo dispositivo
* **Refresh**: recarrega a listagem
* **Export**: exporta os dispositivos listados
* **Sort**: define o critério de ordenação
* **Filters**: escolhe quais informações aparecem nos cards

No rodapé ficam a paginação e o seletor de itens por página, com as opções 10, 15, 20, 50 e 100.

## Pastas de dispositivos

O painel da direita organiza os dispositivos em duas visões, selecionáveis por aba:

* **Asset Folders**: estrutura de pastas criada pelo administrador, partindo da raiz `DEFAULT`. Serve para agrupar dispositivos por finalidade, ambiente, cliente ou qualquer critério próprio da operação
* **Type Folders**: agrupamento automático por tipo de plataforma, útil para localizar um dispositivo pela tecnologia

Clicar em uma pasta **filtra a listagem**. O filtro aplicado aparece como um marcador acima da lista (por exemplo, `Folder: DEMO`), com um `x` para removê-lo e a opção **Clear all** para limpar todos os filtros de uma vez. O painel de pastas também mostra o filtro ativo, com a sua própria opção de limpar.

O contador no topo do painel informa quantas pastas existem, e o cabeçalho da lista passa a refletir o subconjunto filtrado.

## Painel de detalhes

Clicar no nome do dispositivo, ou em **Asset details**, abre o painel de detalhes, organizado em cinco guias:

| Guia                 | Conteúdo                                       |
| -------------------- | ---------------------------------------------- |
| **Basic**            | Dados cadastrais do dispositivo                |
| **Logins**           | Credenciais associadas ao dispositivo          |
| **Authorized users** | Usuários e grupos com permissão de acesso      |
| **Asset sessions**   | Histórico de sessões realizadas no dispositivo |
| **Commands**         | Comandos executados nas sessões do dispositivo |

A guia **Basic** traz: **Name**, **Type** (categoria e plataforma, por exemplo `Host/Windows`), **Address**, **Platform**, **Protocols** com as portas efetivas (por exemplo, `rdp:3389` e `winrm:5985`), **Domain**, **Active**, **Date created**, **Update date**, **Creator** e **Description**.

> Os protocolos e portas exibidos aqui vêm da **plataforma** do dispositivo. Para alterar o padrão de todos os dispositivos de uma plataforma, use *Sync protocols to assets* na tela Platforms.

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

* **Quick update**: liga ou desliga o dispositivo com a chave **Active**, atualiza o inventário de hardware em **Refresh hardware info** e testa a conexão em **Test connectivity**
* **Node**: associa o dispositivo a uma pasta da árvore
* **Tags**: associa etiquetas ao dispositivo, usadas depois para filtrar a listagem
