Pular para o conteúdo principal
Use este guia para instalar o Connect e os sensores em uma máquina da sua rede. Ao final, eles ficam online na plataforma, prontos para os serviços dos módulos e para as varreduras. Se é o seu primeiro contato com o Connect, comece por O que é o EcoTrust Connect.
Este guia não traz os comandos de ativação, para que você use sempre a versão atualizada. Pegue o comando de um destes jeitos:
  • No painel: em Ativos > Todos os Ambientes, no botão Comandos para ativação de sensores.
  • Pelo agente: no Agent Work do módulo, peça para provisionar o sensor. O agente passa o comando e conduz cada passo.

Como os sensores se conectam à sua rede interna

Os sensores ficam em uma máquina dentro da sua rede. Eles alcançam os seus ativos pela rede, sem instalar nada neles, e mandam os resultados para a plataforma por uma conexão que sai da sua rede. Nenhuma porta de entrada é aberta. Na máquina, cada sensor tem um papel: Para isso, a máquina precisa de dois caminhos:
  • Para fora, até a internet: falar com a plataforma, baixar as imagens Docker e atualizar os motores de varredura.
  • Para dentro, na sua rede: rota até todos os ativos das subnets que serão analisadas.
As varreduras saem do IP da máquina. É esse IP que os seus firewalls e o seu EDR vão ver. O que liberar em cada um está em Requisitos do Connect.

Pré-requisitos

  • Uma máquina na rede que você quer cobrir, de preferência dedicada aos sensores, com processador x86-64 de 4 núcleos, 8 GB de RAM e 100 GB livres. O detalhe está em Requisitos do Connect.
  • Docker instalado: Docker Engine no Linux ou Docker Desktop com WSL2 no Windows. Confira com docker --version.
  • A saída pela porta 443 para o endereço da sua instância EcoTrust e para o Docker Hub, e a máquina liberada no firewall, no proxy, no SIEM e no EDR. Cada liberação está em Rede e Soluções de segurança.
  • Um ambiente cadastrado na plataforma e o perfil de gestor ou de analista, para baixar a licença.

Passos

1

Preparar a máquina

Confira os pré-requisitos e aplique as liberações de rede e das soluções de segurança.
Vai usar um módulo agêntico? Com a máquina pronta, você não precisa seguir os próximos passos: abra o Agent Work do módulo e diga que quer provisionar o sensor. O agente orienta cada passo, um comando por vez, e confere no fim se o sensor ficou online.
2

Criar o ambiente

Se o ambiente ainda não existe, em Ativos > Conectar Novo Ambiente, preencha o Nome e a Descrição e clique em Conectar ambiente.
Formulário Conectar Novo Ambiente, com os campos Nome e Descrição e o botão Conectar ambiente.

Tela Conectar Novo Ambiente.

3

Abrir o terminal e criar a pasta

No Linux, abra o terminal da distribuição. No Windows, abra o PowerShell: no menu Iniciar, digite PowerShell e tecle Enter. Use a mesma janela até o fim.Crie uma pasta vazia e entre nela.
4

Baixar a licença

Baixe a licença do ambiente, de um destes jeitos:
  • Pelo agente: no Agent Work, peça para baixar a licença, escolha o ambiente e clique em Baixar licença. O link vale por 1 hora.
  • Pela lista de ambientes: em Ativos > Todos os Ambientes, clique no ícone de download na coluna Licença do ambiente.
Lista Todos os Ambientes, com as colunas Conexão Ambiente e Licença e o botão Comandos para ativação de sensores.

Ambiente de exemplo. Tela Todos os Ambientes: a licença fica na coluna Licença, e o botão Comandos para ativação de sensores, no canto superior direito.

Cada download gera uma licença nova. Use a licença em até 7 dias: depois disso, ela expira e você precisa baixar outra.
5

Mover a licença para a pasta

O navegador salva o arquivo .key na pasta Downloads. Mova o arquivo para a pasta que você criou e confira se ele está lá:
Deixe só uma licença na pasta. O container lê a pasta inteira, e duas licenças juntas entram em conflito.
Uma pasta com uma licença ativa todos os sensores que você quiser daquele ambiente. Só crie outra pasta, com outra licença, quando a mesma máquina também for rodar sensores de outro painel, por exemplo, um segundo Connect-AI ligado a outro painel. Esse cenário, com dois painéis em uma única máquina, não é recomendado: prefira uma máquina para cada painel.
6

Subir os sensores

Em Ativos > Todos os Ambientes, clique em Comandos para ativação de sensores. A janela mostra os comandos em duas abas, Windows PowerShell e GNU/Linux. Escolha a aba do sistema da máquina e copie o comando de cada sensor que você quer ativar, sem alterar nenhuma opção.
Janela com os comandos de ativação de cada sensor, nas abas Windows PowerShell e GNU/Linux.

Janela Comandos para ativação dos sensores locais. O ícone ao lado de cada comando copia o texto.

No terminal, ainda na pasta da licença, cole e rode o comando de cada sensor. Na primeira vez, o Docker baixa a imagem, o que pode levar alguns minutos. No fim, o comando mostra uma linha longa de letras e números: é o identificador do container, sinal de que ele subiu.

Verificar o resultado

  • No terminal, docker ps lista um container para cada sensor, com o estado Up.
  • Na plataforma, em Ativos > Todos os Ambientes, a coluna Conexão Ambiente do ambiente passa para On. Isso pode levar alguns segundos.
  • Em Sensores > Sensores de Scan, a coluna Estado Operacional de cada sensor fica On.
Lista Sensores de Scan, com as colunas Tipo, Nome, Status Funcional, Estado Operacional e Ambiente.

Ambiente de exemplo. Tela Sensores de Scan: o sensor pronto aparece com o Estado Operacional On.

  • Ao executar um serviço que precisa do Connect-AI, ele aparece na lista de escolha, com o nome do ambiente.

Problemas comuns

Para ler as mensagens de um sensor, liste os containers com docker ps -a e rode docker logs seguido do identificador do container.

Mensagens no log do sensor

Confira se a licença está na pasta onde você rodou o comando e se ela é o único arquivo .key ali. Se a licença foi baixada há mais de 7 dias, ela expirou: baixe outra. Para ver também os containers parados, use docker ps -a, e para ler as mensagens de um deles, docker logs seguido do identificador.
Confira se a máquina está ligada, com acesso à internet e com o Docker em execução. Rode docker ps -a e procure a imagem do Connect-AI. Se ele estiver parado, inicie com docker start seguido do identificador do container. Depois, volte à conversa e clique em Testar novamente.
Confira se o firewall libera a saída pela porta 443 para o endereço da sua instância EcoTrust e se a máquina tem os 4 núcleos, os 8 GB de RAM e os 100 GB livres dos requisitos. Leia o log com docker logs e reinicie o container com docker restart. Se continuar Off, atualize o sensor.
O Docker Desktop não está instalado ou ainda não terminou de iniciar. Instale o Docker Desktop com WSL2, abra o aplicativo e espere ele ficar pronto antes de rodar o comando.
No Windows, o Docker Desktop só inicia quando um usuário entra no sistema. Ative nas configurações dele a opção de iniciar junto com o login, ou instale os sensores em um servidor Linux, que volta sozinho.
O SELinux pode estar bloqueando o container. Rode getenforce: se a resposta for Enforcing, desative com sudo setenforce 0 e, para manter a mudança, defina SELINUX=disabled em /etc/selinux/config.
O sensor está ocupado com outra varredura ou travado. Confira com docker stats seguido do identificador: consumo alto indica outra varredura em andamento, e consumo parado por muito tempo indica travamento. Nesse caso, reinicie o container.
A máquina provavelmente não tem rota até a subnet analisada, ou o firewall interno bloqueia o tráfego. Teste o alcance a partir da máquina e libere o caminho até a subnet.
Se o problema continuar, escreva para suporte@ecotrust.io com o log do container, a saída de free -h, df -h e docker version e o sistema operacional da máquina.

Próximos passos

Última modificação em 29 de outubro de 2026