> ## 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.

# Executar o Scan de vulnerabilidades completo

> Como descobrir os hosts vivos, coletar cada um pelo CONNECT e detectar as vulnerabilidades com o serviço Scan de vulnerabilidades completo.

O **Scan de vulnerabilidades completo** descobre os hosts vivos, coleta as informações de cada um pelo CONNECT e dispara a detecção de vulnerabilidades sobre o que foi coletado. Ele roda no **Agent Work**, como todo serviço: o passo a passo geral está em [Executar um serviço](https://docs.ecotrust.io/ecotrust-os/executar-um-servico.md), e esta página traz o que é próprio do VulScan.

## O Agent Work no VulScan

> [!NOTE]
>
> **Onde fica:** Tira de abas, **segunda posição**, entre *Dashboard* e *Artefatos*.

É onde os serviços são disparados, aprovados e acompanhados. A tela tem três regiões:

* **Coluna da esquerda**: a conversa com o agente, com o campo de mensagem no pé. *Enter* envia e *Shift+Enter* quebra a linha.
* **Centro**: o canvas, onde o agente monta os painéis do que apurou.
* **Canto superior direito**: o painel de etapas da execução em andamento.

O módulo tem dois serviços e a ordem entre eles importa: o scan produz as ocorrências, e o enriquecimento fecha o fator de exploração das ocorrências com CVE que chegam de outros sensores. Os dois seguem o mesmo padrão: o agente monta um plano, você aprova, e a execução começa. Nenhuma ação chega à rede antes do **Aprovar**.

## Passos

Antes de começar, tenha em mãos os três pré-requisitos declarados na ficha do serviço: CONNECT instalado e operacional, os alvos e o título da coleta. Os requisitos do módulo como um todo estão em [Primeiros passos](https://docs.ecotrust.io/modulos/vulscan/primeiros-passos.md#requisitos-do-módulo).

**Step 1**

Vá ao **Catálogo de Serviços**, clique em **Ver detalhes** no cartão *Scan de vulnerabilidades completo* e, na ficha, no botão laranja **Executar**. O painel retorna ao *Agent Work* e o agente abre o primeiro formulário.

**Step 2**

Em **Selecione um CONNECT**, escolha o conector do ambiente que será varrido e clique em **Confirmar**. Cada conector alcança apenas o próprio ambiente, então a escolha do conector define o ambiente do scan.

![Formulário do primeiro passo, com o seletor de CONNECT e os botões Cancelar e Confirmar.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/50-scan-connect.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=08dae84b66547bcf1be2d60c5ba805c5)

Antes de abrir o seletor, o agente testa a conexão do conector e informa se ele está online. Nomes de ambiente de exemplo.

**Step 3**

Em **Reaproveitar uma coleta de informações anterior**, escolha uma das coletas listadas para ir direto à detecção, ou mantenha **Fazer uma coleta nova** para levantar os dados agora. Confirme.

![Lista de coletas anteriores disponíveis para reaproveitamento, com data, ambiente e alvos de cada uma.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/51-scan-coleta.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=31bc0d6512ff0a195daed8eae8aebb97)

Cada linha traz a data, o ambiente e os alvos daquela coleta, que é o que permite decidir se ela ainda representa o parque. Identificadores de exemplo.

**Step 4**

Em **Alvos**, marque o que será varrido. A lista já vem com os ativos e grupos do ambiente, e aceita sub-rede, faixa de IP, IP, nome de host ou grupo. Confirme.

Informar apenas IPs ou hosts concretos dispensa a etapa de descoberta; informar uma sub-rede ou uma faixa inclui a descoberta no plano.

![Seleção de alvos com a busca de ativos e a lista de endereços e grupos do ambiente.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/52-scan-alvos.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=b1ac9eecdd4df48574397c3cf098af84)

A busca no topo filtra a lista, e os grupos aparecem marcados como tal, com a contagem de ativos. Endereços de exemplo.

**Step 5**

Em **Quais credenciais usar para acessar os hosts**, escolha uma credencial já cadastrada, ou selecione *Inserir manualmente* e preencha transporte (SSH, WinRM-WMI ou SSM), usuário, tipo de autenticação, senha e porta. Confirme.

![Formulário de credenciais com a lista de credenciais cadastradas e os campos de preenchimento manual.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/53-scan-credencial.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=a845999b6b8dd706efcfa55c46cdf0d0)

Escolher uma credencial da lista dispensa os campos abaixo dela. O asterisco marca o que é obrigatório no preenchimento manual. Nomes de credencial de exemplo.

**Step 6**

Confira o plano em **Revisar e aprovar** e clique em **Aprovar**. O agente confirma com *Plano aceito* e a execução começa.

![Tela de revisão do plano do scan, com o resumo das tarefas à direita e os botões de aprovação à esquerda.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/54-scan-revisao.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=7fc1ff3f2dc379d36dac35adbf7841dd)

O painel da direita lista as tarefas que serão executadas. Revisar permite remover os grupos opcionais antes de aprovar.

**Step 7**

Acompanhe pelo painel de etapas no canto superior direito. Conforme cada etapa fecha, o agente monta no canvas o painel do que encontrou.

Se o scan descobrir os hosts, mas nenhum aceitar a credencial escolhida, ele termina sem erro. O cartão e a mensagem final mostram **Autenticação: Não foi possível, confira as credenciais**, além de informar quantos hosts foram descobertos e quantos autenticaram. Corrija o acesso remoto antes de executar novamente. Uma coleta anterior escolhida por você que esteja vazia continua em erro.

Se alguma etapa não for concluída, ela fica cinza e mostra o motivo e o que corrigir logo abaixo de **Não concluído**. Quando a validação final não for atingida, a mensagem também informa o critério esperado e o valor apurado.

![Painel de etapas da execução, com o nome de cada etapa, a marca de concluída e a duração.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/33-exec-etapas.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=e9f50b7e26c92060ca6c338f4073410c)

Cada linha traz a marca de concluída e a duração medida daquela etapa.

![Painel de resultado do scan no canvas, com a distribuição por severidade e o software vulnerável.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/34-exec-canvas.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=ceb9388d1b8f9224bfec473d4141c915)

O painel do scan abre com a contagem de críticas que exigem ação e desce para a composição por severidade e o software vulnerável do ativo. Endereço de exemplo.

## A ficha do serviço

Descobre os hosts vivos, coleta as informações de cada um pelo CONNECT e dispara a detecção de vulnerabilidades sobre o que foi coletado. A ficha declara o código do serviço, a versão, as oito etapas de execução e os pré-requisitos.

![Ficha do serviço Scan de vulnerabilidades completo, com o código do serviço, as oito etapas da execução e a lista do que é preciso ter.](https://mintcdn.com/eco-trust/X5LRYurjEEu0V85A/images/vulscan/21-detalhe-scan.png?fit=max\&auto=format\&n=X5LRYurjEEu0V85A\&q=85\&s=a677d1fc094bcc7261a545222338b622)

O bloco PRECISA TER, no pé da ficha, é a lista de conferência antes de executar: CONNECT operacional, alvos e título da coleta.

## Próximos passos

* [Executar o Enriquecimento externo de ocorrências](https://docs.ecotrust.io/modulos/vulscan/enriquecimento-externo.md), para as ocorrências com CVE de outros sensores
* [Agendar um serviço](https://docs.ecotrust.io/ecotrust-os/agendar-um-servico.md)
* [Dashboard do VulScan](https://docs.ecotrust.io/modulos/vulscan/painel.md)


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