> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecotrust.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalar o Connect

> Instale os sensores na sua rede interna para mapear os ativos e encontrar vulnerabilidades de dentro da rede.

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](https://docs.ecotrust.io/connect/visao-geral.md).

> [!TIP]
>
> 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.

```mermaid theme={"dark"}
flowchart TB
  P["Plataforma EcoTrust<br/>na nuvem"]
  subgraph R["Sua rede interna"]
    H["Máquina dos sensores (Docker)<br/>Connect-AI · Infra · Network"]
    A["Subnet A<br/>servidores"]
    B["Subnet B<br/>estações"]
    C["Subnet C<br/>infra e rede"]
    D["DMZ<br/>aplicações"]
  end
  H -- "saída criptografada pela porta 443" --> P
  H --> A
  H --> B
  H --> C
  H --> D
```

Na máquina, cada sensor tem um papel:

| Sensor | Para que serve |
| - | - |
| **Connect-AI** | É a ponte dos módulos agênticos, como Radar, Inventory, VulScan e AutoPatch. Recebe as tarefas dos serviços que você aprova e as executa dentro da sua rede. |
| **Infra** | Faz testes de vulnerabilidade em servidores, estações de trabalho, switches, firewalls, roteadores e outros dispositivos de infraestrutura. Analisa serviços, aplicações e sistemas operacionais em busca de vulnerabilidades e configurações inseguras. Com uma credencial de acesso, como SMB, SSH, SNMP ou VMware ESXi, faz o scan autenticado. |
| **Network** | Faz a varredura da rede para descobrir ativos, portas abertas e serviços em execução. Identifica a versão de cada serviço e aponta as vulnerabilidades conhecidas (CVEs) e os possíveis exploits desses serviços. |

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](https://docs.ecotrust.io/connect/requisitos.md#soluções-de-segurança).

## 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](https://docs.ecotrust.io/connect/requisitos.md#máquina).
* 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](https://docs.ecotrust.io/connect/requisitos.md#rede) e [Soluções de segurança](https://docs.ecotrust.io/connect/requisitos.md#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](#pré-requisitos) e aplique as liberações de [rede](https://docs.ecotrust.io/connect/requisitos.md#rede) e das [soluções de segurança](https://docs.ecotrust.io/connect/requisitos.md#soluções-de-segurança).

> [!TIP]
>
> **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.](https://mintcdn.com/eco-trust/l-a9SBmIe14YlqVm/images/connect/sensores/01-conectar-novo-ambiente.png?fit=max\&auto=format\&n=l-a9SBmIe14YlqVm\&q=85\&s=441f7b7750b4ece344a8d0deef1357f4)

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.

```bash Linux theme={"dark"}
mkdir connect && cd connect && pwd
```

```powershell Windows theme={"dark"}
mkdir connect; cd connect; pwd
```

**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.](https://mintcdn.com/eco-trust/l-a9SBmIe14YlqVm/images/connect/sensores/02-todos-os-ambientes.png?fit=max\&auto=format\&n=l-a9SBmIe14YlqVm\&q=85\&s=4df82ab9405ebfe58f08b4e8651c3b37)

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á:

```bash theme={"dark"}
ls *.key
```

Deixe só uma licença na pasta. O container lê a pasta inteira, e duas licenças juntas entram em conflito.

> [!NOTE]
>
> 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.](https://mintcdn.com/eco-trust/l-a9SBmIe14YlqVm/images/connect/sensores/03-comandos-ativacao-sensores.png?fit=max\&auto=format\&n=l-a9SBmIe14YlqVm\&q=85\&s=56554cce2b13ed5169690fd21a76acd0)

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.](https://mintcdn.com/eco-trust/l-a9SBmIe14YlqVm/images/connect/sensores/04-sensores-de-scan.png?fit=max\&auto=format\&n=l-a9SBmIe14YlqVm\&q=85\&s=cab9446a703eeabfac0d5de6ed881134)

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

| Mensagem no log | Causa | O que fazer |
| - | - | - |
| `Missing key file at …` | O comando rodou fora da pasta da licença | Rode o comando na pasta onde está o arquivo `.key` |
| `Key file at … is empty` | A licença está vazia | Baixe uma licença nova |
| `License file at … is corrupted` | A licença está corrompida | Baixe uma licença nova |
| `License already registered for another machine` | A licença já foi ativada em outra máquina | Baixe uma licença nova para esta máquina |
| `Something went wrong...` | Falha genérica | Reinicie com `docker restart` seguido do identificador, ou [atualize o sensor](https://docs.ecotrust.io/connect/atualizar-sensor.md) |

> [accordion] O container não aparece no docker ps ou para logo depois de subir
>
> 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.

> [accordion] O agente avisa que o Connect-AI não respondeu ao teste de conexão
>
> 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**.

> [accordion] O sensor não fica On
>
> 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](https://docs.ecotrust.io/connect/requisitos.md#máquina). Leia o log com `docker logs` e reinicie o container com `docker restart`. Se continuar Off, [atualize o sensor](https://docs.ecotrust.io/connect/atualizar-sensor.md).

> [accordion] O Windows não reconhece o comando docker
>
> 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.

> [accordion] O sensor para depois de reiniciar o Windows
>
> 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.

> [accordion] O sensor reinicia o tempo todo no Linux
>
> 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`.

> [accordion] O scan fica na fila e não começa
>
> 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.

> [accordion] O scan termina sem encontrar ativos
>
> 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](mailto: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

* [Atualizar um sensor](https://docs.ecotrust.io/connect/atualizar-sensor.md)
* [Executar um serviço](https://docs.ecotrust.io/ecotrust-os/executar-um-servico.md)
* [Executar o Inventário de Ativos](https://docs.ecotrust.io/modulos/inventory/inventario-de-ativos.md)
* [Segurança do Connect](https://docs.ecotrust.io/connect/seguranca.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.