> 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/register-network-device.md).

# Cadastrar um dispositivo de rede

Coloque um firewall, switch ou roteador sob acesso privilegiado, da plataforma à primeira sessão gravada, com um firewall Hillstone via SSH como exemplo.

## O que é isto e quando usar

Um dispositivo de rede é cadastrado como um ativo comum. Feito isso, a senha de administrador fica no cofre e deixa de ser compartilhada com quem quer que seja, todo acesso passa pela solução, e a sessão é gravada: quem entrou, quando e o que digitou.

Esta página percorre o cadastro de um **firewall Hillstone** acessado por SSH, por ser um caso comum de fornecedor sem plataforma nativa própria. Os mesmos passos valem para qualquer switch, roteador ou firewall; para Cisco, Huawei, H3C e Fortinet, escolha no passo 1 a plataforma nativa do fornecedor em vez de criar uma.

## Antes de começar

* A função **SYSADMIN** no console.
* O endereço de gerência do dispositivo, por exemplo `10.0.0.1`.
* Uma conta de administrador no dispositivo, com a senha. Prefira uma conta própria à conta de administrador padrão de fábrica.
* O gerenciamento por SSH habilitado no dispositivo para essa conta, na interface que a solução alcança.
* O caminho de rede da solução até o dispositivo. Pergunte a quem cuida da rede se a solução alcança o dispositivo **diretamente** ou **por um proxy** e, se for por proxy, o nome dele. Se ninguém souber, comece pelo acesso direto: uma falha no teste de conectividade do passo 6 é o sinal de que o proxy é necessário.

## Passos

### 1. Escolher a plataforma

1. Abra **Ambiente › Plataformas** e procure na categoria **Dispositivo**.
2. Não existe plataforma nativa para Hillstone. Duplique a **General** e dê à cópia um nome fácil de reconhecer, por exemplo `Hillstone SSH`. Mantenha o **SSH** na porta 22 e desligue o Telnet, a não ser que precise dele.
3. Se o dispositivo for alcançado por um proxy, ligue **Ativar domínio** em **Atualização rápida** nessa plataforma. É o interruptor que libera a passagem por gateway.

Duplicar, em vez de usar a **General** diretamente, mantém os seus ajustes fora da plataforma genérica que os outros dispositivos compartilham. Veja [Plataformas](https://wiki.datadike.com/pt/pam/administration/assets/platforms.md).

### 2. Conferir o proxy (só se o acesso for por proxy)

Abra **Console › Gateway › Proxy**, selecione o proxy informado e confira a aba **Gateways**: pelo menos um host de salto precisa estar listado. Não há nada a criar aqui. Se o acesso for direto, pule este passo.

### 3. Cadastrar o dispositivo

1. Abra **Ambiente › Ativos**, clique em **Criar** e selecione a plataforma do passo 1.
2. Preencha um **Nome** que identifique o dispositivo, por exemplo `FW-SEDE-01`, o **Endereço** (só o IP ou o nome do host, por exemplo `10.0.0.1`) e o **Node**, a pasta em que o ativo fica arquivado.
3. Em **Protocolo**, confirme o SSH na porta 22, ou na porta que o dispositivo de fato usa.

### 4. Guardar a credencial

1. Na etapa **Contas** do mesmo formulário, clique em **Adicionar**.
2. Preencha o **Nome** da credencial no console, o **Nome de usuário** da conta de administrador do dispositivo e a senha, com **Tipo de segredo** em **Senha**.
3. Ligue **Privilegiada**, já que é uma conta de administrador.
4. Clique em **Confirmar**.

Não é preciso configurar elevação de privilégio para uma conta de administrador do Hillstone: ela já entra com permissão total. Nos dispositivos que exigem o passo `enable`, ligue **Ativar troca de conta** na plataforma e escolha o método de elevação.

Depois de salva, a senha deixa de ser exibida aos operadores. A solução passa a usá-la por eles. Veja [Contas gerenciadas](https://wiki.datadike.com/pt/pam/administration/accounts/managed-accounts.md).

### 5. Escolher o caminho e salvar

1. Em **Outras configurações**, se o dispositivo for alcançado por um proxy, selecione-o em **Proxy**. Para acesso direto, deixe **Proxy** e **Gateway (Broker)** vazios.
2. Deixe **Ativar** ligado e clique em **Confirmar**.

### 6. Liberar o acesso

1. Abra **Políticas › Autorizações** e clique em **Criar**.
2. Escolha os usuários ou grupos que podem acessar o dispositivo, o próprio dispositivo e a conta do passo 4.
3. Selecione o protocolo **SSH** e pelo menos a ação **Conectar**, e clique em **Salvar**.

É este passo que de fato libera o acesso. Sem ele, ninguém consegue abrir sessão no dispositivo. Veja [Autorizações](https://wiki.datadike.com/pt/pam/administration/access/authorizations.md).

## Pela interface web

Se a equipe administra o firewall pela interface web em vez da linha de comando, cadastre-o como ativo **Website** apontando para a tela de login HTTPS, por exemplo `https://10.0.0.1/`. A solução então abre o console web do dispositivo num navegador controlado e preenche a senha, e a sessão é gravada em vídeo. Sessões web exigem uma máquina Windows adicional para rodar o navegador. Veja [Sessões web](https://wiki.datadike.com/pt/pam/administration/sessions/web.md).

## O que você deve ver

O dispositivo aparece em **Ambiente › Ativos** com a plataforma do passo 1, o endereço e o estado `ACTIVE`. A aba **Contas** lista a conta de administrador, sem mostrar a senha. Quando um usuário autorizado abre a sessão, surge um terminal já conectado à linha de comando do firewall.

## Como verificar se funcionou

1. No dispositivo, rode **Testar conectividade do ativo** no bloco **Atualização rápida**. Um resultado positivo significa que a solução alcançou o dispositivo e autenticou.
2. Entre com um usuário coberto pela autorização, e não com o administrador que cadastrou o dispositivo, e abra uma sessão SSH nele. O terminal precisa abrir no prompt do firewall sem pedir senha.
3. Abra **Auditoria › Sessões** e confira o registro, com o usuário, a conta usada e o protocolo **SSH**. A aba **Comandos** da sessão lista o que foi digitado.

## Erros comuns

| Sintoma                                                                                          | Causa                                                                                                                       | Correção                                                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| O teste de conectividade falha                                                                   | Usuário ou senha errados, SSH não habilitado no dispositivo para essa conta, ou um proxy necessário que não foi selecionado | Confira, nesta ordem: a credencial, o gerenciamento por SSH no dispositivo, e o campo **Proxy** junto com o **Ativar domínio** da plataforma                                               |
| O dispositivo recusa logins por alguns minutos, com mensagem de bloqueio ou de tentativas demais | O Hillstone bloqueia o endereço de origem por cerca de dois minutos depois de três logins errados em um minuto              | Espere o bloqueio expirar e corrija a senha antes de tentar de novo. O endereço de origem é o da solução, ou do host de salto, então o bloqueio vale para todos os usuários enquanto durar |
| A conexão ignora o proxy e vai direto ao dispositivo                                             | **Ativar domínio** está desligado na plataforma do dispositivo                                                              | Ligue-o em **Atualização rápida**                                                                                                                                                          |
| A sessão abre, mas a auditoria ou a inspeção de comandos se comporta de forma estranha           | O ativo está numa plataforma cujo tratamento de prompt não corresponde à CLI do dispositivo                                 | Ajuste a plataforma duplicada, ou use a plataforma do fornecedor quando ela existir                                                                                                        |
| O dispositivo está cadastrado, mas nenhum usuário consegue abri-lo                               | Nenhuma autorização o cobre, ou a regra está inativa ou fora da validade                                                    | Crie ou corrija a regra em **Políticas › Autorizações** e confira a coluna **Válido**                                                                                                      |

## Referência de campos

| Campo                        | Significado                                                                               |
| ---------------------------- | ----------------------------------------------------------------------------------------- |
| **Nome**                     | Como o dispositivo é identificado no console                                              |
| **Endereço**                 | IP ou nome do host da interface de gerência. A porta vai em **Protocolo**, não aqui       |
| **Plataforma**               | Define os protocolos e o tratamento do terminal. Para Hillstone, uma cópia da **General** |
| **Node**                     | A pasta da árvore de ativos em que o dispositivo fica arquivado                           |
| **Protocolo**                | SSH e a porta, herdados da plataforma                                                     |
| **Contas › Nome de usuário** | A conta de administrador do dispositivo                                                   |
| **Contas › Tipo de segredo** | **Senha**                                                                                 |
| **Contas › Privilegiada**    | Ligado para uma conta de administrador                                                    |
| **Proxy**                    | A zona pela qual o dispositivo é alcançado. Vazio no acesso direto                        |
| **Gateway (Broker)**         | Um gateway de broker, o caminho alternativo ao **Proxy**. Nunca preenchido junto com ele  |
| **Ativar**                   | Precisa ficar ligado para o dispositivo ser alcançável                                    |

## Páginas relacionadas

* [Plataformas](https://wiki.datadike.com/pt/pam/administration/assets/platforms.md): a categoria **Dispositivo** e como duplicar uma plataforma
* [Gateways](https://wiki.datadike.com/pt/pam/administration/connectivity/gateways.md): descoberta, fornecedores e bloqueio de comandos em equipamentos de rede
* [Proxy](https://wiki.datadike.com/pt/pam/administration/connectivity/proxy.md): alcançar um dispositivo por um host de salto
* [Sessões SSH](https://wiki.datadike.com/pt/pam/administration/sessions/ssh.md): a sessão que os usuários abrem
* [Acesso just-in-time](https://wiki.datadike.com/pt/pam/administration/access/just-in-time.md): acesso concedido por tempo limitado e revogado automaticamente
