> 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/sonar/deploy-operate/network-requirements.md).

# Requisitos de rede

As conexões de saída que um endpoint gerenciado abre: o endereço da API do SONAR e o de acesso remoto na 443, além dos destinos de terceiros do agente.

## O que esta página cobre

As regras de firewall e de proxy de que um **endpoint gerenciado** precisa. Todas as conexões abaixo são **de saída a partir do endpoint**: nada se conecta ao dispositivo, e nenhuma porta de entrada precisa ser aberta nele ou na rede dele.

O próprio servidor do SONAR é operado pela DataDike. Os endereços dele são fornecidos pela DataDike para a sua instância, e nada nesta página é configurado nele.

## Os dois endereços do SONAR

Cada instância tem dois endereços que os endpoints precisam alcançar. A DataDike fornece os dois na entrega da instância. Nesta página, eles aparecem como valores de exemplo:

| Valor de exemplo     | O que é                                                                                                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `api.example.com`    | O **endereço da API**. O agente se registra, envia os seus dados e recebe comandos por ele. É o endereço embutido em todo instalador que o console gera                  |
| `remote.example.com` | O **endereço de acesso remoto**. O agente de acesso remoto mantém a conexão com ele, e o controle remoto, o terminal remoto e a transferência de arquivos passam por ele |

## Conexões que o endpoint abre

| Origem                            | Destino              | Protocolo e porta                                 | Para quê                                                                                                                                                                                         |
| --------------------------------- | -------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Agente do SONAR                   | `api.example.com`    | HTTPS, 443/tcp                                    | Instalação (verificação do token, registro), relatórios periódicos (inventário de software, geolocalização, resultados de checks e de tarefas), downloads do agente e do módulo de produtividade |
| Agente do SONAR                   | `api.example.com`    | WebSocket seguro (WSS), 443/tcp, de longa duração | Sinal de vida (heartbeat), inventário e todos os comandos enviados pelo console. É essa conexão que mantém o dispositivo **online**                                                              |
| Agente de acesso remoto           | `remote.example.com` | WebSocket seguro (WSS), 443/tcp, de longa duração | Controle remoto, terminal remoto, transferência de arquivos e o status **Remote Offline**                                                                                                        |
| Módulo de produtividade (Windows) | `api.example.com`    | HTTPS, 443/tcp                                    | Relatórios de atividade e de sessões, pedidos de extensão                                                                                                                                        |
| Módulo de produtividade (Windows) | `api.example.com`    | WebSocket seguro (WSS), 443/tcp, de longa duração | Políticas de acesso enviadas ao dispositivo                                                                                                                                                      |
| Script de instalação para Linux   | `api.example.com`    | HTTPS, 443/tcp                                    | Download do agente                                                                                                                                                                               |
| Script de instalação para Linux   | `remote.example.com` | HTTPS, 443/tcp                                    | Download do agente de acesso remoto                                                                                                                                                              |

No Windows e no macOS, o agente de acesso remoto é baixado pelo endereço da API durante a instalação; o script para Linux o baixa diretamente do endereço de acesso remoto.

## Destinos de terceiros usados pelo agente

Estes não são endereços do SONAR. O agente os contata para funções específicas; bloquear um deles desativa apenas a função correspondente.

| Destino                                                                                         | Plataforma | Quando                                                                                                                                           | O que acontece se for bloqueado                                           |
| ----------------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
| `checkip.amazonaws.com`, `icanhazip.com`, `ifconfig.co`, `ifconfig.me` (HTTPS)                  | Todas      | A cada 5 a 8 minutos, um após o outro até que um responda                                                                                        | O **Public IP** do dispositivo fica vazio ou desatualizado                |
| `github.com` (HTTPS, downloads de versões publicadas no GitHub)                                 | Windows    | Na primeira inicialização do agente, quando o ambiente de execução do Python ainda não está presente                                             | Scripts Python não podem ser executados no dispositivo                    |
| `github.com` (HTTPS, downloads de versões publicadas no GitHub)                                 | Todas      | Apenas onde os ambientes de execução de scripts Nushell ou Deno estão habilitados para a sua instância, com o suporte de implantação da DataDike | Esses tipos de script não podem ser executados                            |
| `chocolatey.org`, `community.chocolatey.org` (HTTPS)                                            | Windows    | Na inicialização do serviço, enquanto o Chocolatey não está instalado, e quando um software é instalado pelo console                             | A instalação de software pelo console não funciona                        |
| A origem do Windows Update configurada no dispositivo (Microsoft Update ou o seu servidor WSUS) | Windows    | Verificações e instalações de atualizações                                                                                                       | As verificações do Windows Update e as instalações de atualizações falham |

O tráfego do Windows Update segue a configuração do próprio Windows Update do dispositivo: o agente comanda o cliente do Windows Update no dispositivo, e o cliente baixa de onde quer que o Windows esteja configurado para baixar.

## Proxies

O agente aceita um proxy HTTP no momento da instalação com o argumento `-proxy` (`-proxy "http://proxyserver:port"`), listado em **Optional Arguments** nas instruções de instalação manual. O proxy fica gravado na configuração do agente e é usado para:

* as requisições de instalação e os downloads que o agente faz, inclusive as atualizações do agente;
* as requisições HTTPS do agente ao endereço da API;
* no Windows, a instalação do agente de acesso remoto.

A conexão WebSocket de longa duração com `api.example.com` é aberta diretamente, e não por esse proxy. Um dispositivo atrás de um proxy, portanto, ainda precisa de uma rota de saída direta para `api.example.com` na 443/tcp. O módulo de produtividade também se conecta diretamente.

## Inspeção TLS e filtragem web

Os dois endereços do SONAR carregam conexões WebSocket de longa duração. Proxies, firewalls e filtros web que inspecionam TLS, encerram rapidamente conexões ociosas ou não permitem o upgrade para WebSocket interrompem essas conexões, e o dispositivo aparece offline ou com **Remote Offline** mesmo que as requisições HTTPS continuem funcionando.

* Exclua `api.example.com` e `remote.example.com` da inspeção TLS.
* Permita o upgrade para WebSocket nos dois endereços.
* Permita que as conexões fiquem abertas indefinidamente. O agente envia um keepalive a cada 35 a 45 segundos, aproximadamente, e se reconecta automaticamente depois de uma queda.

## Como verificar se funcionou

A partir do endpoint, antes ou depois da instalação:

* **Windows**, no PowerShell: `Test-NetConnection api.example.com -Port 443` e `Test-NetConnection remote.example.com -Port 443` precisam, os dois, retornar `TcpTestSucceeded : True`. O instalador PowerShell executa o mesmo teste contra o endereço da API e exibe *Unable to connect to server* quando ele falha.
* **Linux e macOS:** `curl -sS -o /dev/null -w "%{http_code}\n" https://api.example.com/` e o mesmo comando para `https://remote.example.com/` precisam retornar um código de status HTTP, e não um erro de conexão.

Depois da instalação, o dispositivo aparece em **Dashboard › Sysadmin** com **Agent Status** **Online**, e o painel de detalhes dele não mostra o indicador **Remote Offline** depois que o agente de acesso remoto se conecta.

## Erros comuns

| Sintoma                                                                                               | Causa                                                                                       | Correção                                                                                             |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| O instalador PowerShell exibe *Waiting for network* três vezes e depois *Unable to connect to server* | O endpoint não consegue abrir a 443/tcp para o endereço da API                              | Libere a saída 443/tcp para `api.example.com` e confira a resolução de nomes                         |
| O dispositivo se registra, mas nunca aparece como **Online**, ou fica offline repetidamente           | A conexão WebSocket com o endereço da API é bloqueada, inspecionada ou cortada por um proxy | Permita uma conexão 443/tcp direta, sem inspeção e com upgrade para WebSocket, até `api.example.com` |
| O dispositivo está online, mas mostra **Remote Offline**, e o controle remoto não abre                | O agente de acesso remoto não consegue alcançar o endereço de acesso remoto                 | Libere a saída 443/tcp com upgrade para WebSocket até `remote.example.com`                           |
| **Public IP** está vazio                                                                              | Todos os serviços de consulta de IP público estão bloqueados                                | Libere pelo menos um deles, ou aceite a coluna vazia                                                 |
| Scripts Python falham em um dispositivo Windows novo                                                  | O ambiente de execução do Python não pôde ser baixado do GitHub                             | Libere os downloads de `github.com` e depois reinicie o serviço do agente                            |
| Instalações de software pelo console falham                                                           | O Chocolatey não pode ser alcançado                                                         | Libere `chocolatey.org` e `community.chocolatey.org`                                                 |

## Páginas relacionadas

* [Requisitos dos dispositivos](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md)
* [Instalar o agente no Windows](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-windows.md)
* [Implantar agentes em escala](https://wiki.datadike.com/pt/sonar/deploy-operate/mass-deployment.md)
* [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md)
* [Acesso remoto](https://wiki.datadike.com/pt/sonar/administration/remote-access.md)
