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

# Monitorar a exposição externa de um domínio

> Como executar o Monitoramento de Exposição Externa do Surface para um domínio, ler os painéis que o agente monta no canvas e repetir a medição com recorrência.

O **Monitoramento de Exposição Externa** mede o que um domínio expõe na internet e recalcula a nota CRS dele. 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 Surface. Quando há quantidade contratada, os novos ativos descobertos entram no grupo de superfície somente enquanto houver licenças livres. O resultado informa quantos ficaram fora do escopo. Veja [como funciona o escopo licenciado](https://docs.ecotrust.io/modulos/surface/entender-o-escopo-licenciado.md).

## Pré-requisitos

* O domínio cadastrado como ativo no inventário do ambiente.
* O **Impacto Negócio** do domínio decidido: Alta, Média ou Baixa (veja o passo 3).

## O Agent Work no Surface

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

É onde o monitoramento é configurado, aprovado e acompanhado. A tela tem duas 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.
* **Coluna da direita**: o canvas, onde ficam o plano antes da aprovação e os painéis que o agente monta durante a execução.

![Agent Work do Surface, com a conversa com o agente à esquerda e o canvas à direita.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/19-agent-work.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=8c5a8075190bdbd0adf6bbe95c0c89aa)

O cabeçalho traz o nome da execução e o identificador da sessão. À direita dele ficam os botões de agendamentos, histórico e Nova.

Os botões do cabeçalho e os comandos do campo de mensagem são os mesmos em todos os módulos e estão em [Paleta de comandos](https://docs.ecotrust.io/ecotrust-os/paleta-de-comandos.md). O selo **plan mode**, ao lado do nome do agente, indica que um plano está montado e aguarda a sua aprovação.

## Passos

O serviço segue o padrão dos playbooks do painel: o agente coleta os parâmetros em formulários curtos, monta o plano, você aprova e a execução começa. **Nenhuma coleta é feita antes do Aprovar.**

**1. Abrir o serviço**

Vá ao **Catálogo de Serviços**, clique em **Ver detalhes** no cartão *Monitoramento de Exposição Externa* e, na ficha, no botão laranja **Executar**, no canto inferior direito. O painel volta ao **Agent Work** e o agente abre o plano. Escrever no chat **"Quero monitorar a exposição externa de um domínio"** tem o mesmo efeito.

**2. Escolher o domínio monitorado**

Marque o domínio na lista dos ativos do ambiente e clique em **Confirmar**. O campo **Buscar ativos...**, no topo da lista, filtra pelo nome. É um domínio por execução: escolher um domínio já monitorado atualiza o mesmo grupo de superfície.

![Formulário Domínio monitorado com a lista de ativos do ambiente e o campo de busca.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/20-form-dominio.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=b7703a0c08c9b738f10415edb68b3910)

Antes do formulário, o agente explica os dois campos que vai pedir.

**3. Definir o Impacto Negócio**

Escolha **Alta**, **Média** ou **Baixa** e clique em **Confirmar**. Quando o domínio já tem grupo, o valor dele vem preenchido.

Este é o campo que só a sua equipe sabe responder: **quanto a operação depende daquele domínio**. Ele pesa no cálculo da nota, e a mesma exposição custa mais pontos num domínio de impacto alto. Como referência:

* **Alta**: o domínio onde a empresa vende, atende ou autentica clientes, como a loja virtual, o portal do cliente ou o login do produto.
* **Média**: o site institucional, o blog, a base de conhecimento.
* **Baixa**: domínios de campanha, páginas temporárias e domínios defensivos registrados só para proteger a marca.

**4. Escolher quando rodar**

Clique em **Executar agora** para uma execução única, ou em **Agendar** para definir data, hora e recorrência antes de ver o plano. O agendamento está em [Agendar um serviço](https://docs.ecotrust.io/ecotrust-os/agendar-um-servico.md).

![Passo Quando rodar com os botões Executar agora e Agendar.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/21-quando-rodar.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=19b0f546875e07a62f4dab2496060c3b)

Os dois botões ocupam a largura do formulário. Executar agora leva direto ao plano.

**5. Revisar o plano**

No canvas, o bloco **Escopo selecionado** traz o ambiente de destino (*Externo*, escolhido automaticamente), o domínio, o impacto e o agendamento, cada um com o botão **Editar**. Abaixo vêm as etapas do playbook, cada uma com o número de ações; clique numa etapa para abri-la.

![Plano no canvas com o bloco Escopo selecionado e as etapas do playbook.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/22-plano.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=39ac1daba8e3f1673c253f3b6814a484)

Confira a linha Agendamento: ela diz se a execução é única ou recorrente.

**6. Aprovar**

Na conversa, clique em **Aprovar**. **Revisar** volta aos formulários e **Cancelar** descarta o plano.

![Botões Aprovar, Revisar e Cancelar no fim da conversa.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/23-aprovar.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=11897c980d468e175dc3e0c2397d7578)

O Aprovar ocupa a largura da coluna. Revisar e Cancelar ficam abaixo dele.

**7. Acompanhar**

O agente narra o progresso em mensagens *acompanhamento da execução*, com o número de passos concluídos, e avisa cada painel que montou no canvas. A execução leva alguns minutos e termina com a mensagem de que todos os passos foram concluídos sem falhas e com a nota CRS do domínio.

![Mensagens de acompanhamento da execução na conversa.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/24-acompanhamento.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=1a3ad83f17ffa027071298f3ddf62b02)

As mensagens de acompanhamento ficam em quadros tracejados. As do agente trazem o ícone laranja.

## Verificar o resultado

Durante a execução, o agente monta no canvas um painel por frente medida:

| Painel | O que mostra |
| - | - |
| Superfície encontrada | Subdomínios encontrados, nomes que respondem, nomes que só o DNS curinga responde e endereços IP. |
| Exposição e vulnerabilidades | Endereços com serviço exposto, portas abertas, serviços de administração expostos, endereços compartilhados com outros clientes, CVEs descartadas como falso positivo e as CVEs por severidade. |
| O que mudou desde a última execução | Ativos novos, os que deixaram de responder e os que voltaram. |
| Proteção de e-mail | SPF e DMARC por domínio, com os controles ausentes. A barra de cada controle mostra quantos domínios estão sem ele. |
| Aplicações web | Total de exposições e checagens limpas: nomes servidos, cabeçalhos de segurança, TLS e credenciais capturadas. |
| Cobertura da varredura | Cada área medida com o estado *Completa*, *Parcial*, *Incompleta* ou *Indeterminada*. A barra no topo resume a cobertura. |
| Nota CRS do domínio | A nota de 0 a 1.000, a letra de A a F e o Impacto Negócio usado no cálculo. |

![Painéis Proteção de e-mail e Aplicações web no canvas.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/25-canvas-email-web.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=3e35c3ea96760e7856abf8944bfdcdcb)

Em Proteção de e-mail, a barra de cada controle mostra quantos domínios estão sem ele.

![Painel Cobertura da varredura com o estado de cada área medida.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/26-canvas-cobertura.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=620e16a631c91422ba6901642ca7335d)

A barra no topo resume a cobertura. Cada linha abaixo é uma área, com o estado à direita.

![Painel Nota CRS do domínio com a nota, a letra e o Impacto Negócio.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/27-canvas-nota.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=a820bb17a8e76023488f76f495ad342a)

A posição na escala de A a F fica destacada abaixo da barra de pontuação.

Cada painel tem três controles: **Salvar como artefato** (o painel vai para a aba **Artefatos**), **Referenciar no chat** (leva o painel para a conversa) e **Remover do canvas**. As ocorrências importadas aparecem no [painel do Surface](https://docs.ecotrust.io/modulos/surface/painel.md).

## Repetir com recorrência

A recorrência é o uso natural do módulo: cada execução atualiza o grupo de superfície, e o painel *O que mudou desde a última execução* passa a mostrar o que entrou e o que saiu da superfície entre uma rodada e outra. Escolha **Agendar** no passo 4, ou veja [Agendar um serviço](https://docs.ecotrust.io/ecotrust-os/agendar-um-servico.md) para pausar, editar ou encerrar um agendamento.

## Perguntar sobre o resultado

O agente também consulta a web, e não há comando para isso: basta perguntar em português. Durante a consulta, a página consultada aparece num quadro no topo do canvas; ao terminar, ele cruza o que encontrou com as ocorrências do painel e monta a tabela no canvas. O funcionamento geral está em [Perguntar ao agente](https://docs.ecotrust.io/ecotrust-os/perguntar-ao-agente.md).

![Resultado da pesquisa na web cruzado com as ocorrências do painel.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/31-web-cruzamento.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=909cb7e461a14579fb30a7566b63de3f)

Resposta à pergunta sobre exploit público para o jQuery 2.2.3: em cima, as CVEs com a coluna POC; embaixo, os ativos do painel afetados, com os expostos à internet destacados.

| Para que serve | Pergunta pronta para copiar |
| - | - |
| Planejar a correção de proteção de e-mail com segurança | Pesquise na web como publicar DMARC com p=reject sem bloquear os e-mails legítimos do meu domínio. |
| Confirmar a atribuição de um endereço antes de abrir chamado com o fornecedor | Pesquise na web quem é o dono do bloco de endereços `<IP>` e se ele é de nuvem ou de operadora. |
| Confirmar a versão de destino antes de pedir a atualização ao time da aplicação | Pesquise na web se a biblioteca `<nome e versão>` tem CVE conhecida e qual a versão corrigida. |

## A ficha do serviço

A ficha traz no topo o tipo, a visibilidade e a versão. Abaixo vem o objetivo e a lista das tarefas, cada uma com o nível (*junior* ou *pleno*), o custo da tarefa e a forma de verificar o resultado por conta própria. O pé da ficha lista o que é preciso ter antes da execução. **Executar** inicia o serviço e **Fechar** volta ao catálogo.

![Ficha do serviço Monitoramento de Exposição Externa com a lista de tarefas e os botões Fechar e Executar.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/51-ficha.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=4dd9a0c89ae48069178ed3d0c4b29366)

A ficha lista as tarefas do playbook, cada uma com o nível e o custo. O Executar fica no rodapé.

## Próximos passos

* [Dashboard do Surface](https://docs.ecotrust.io/modulos/surface/painel.md)
* [Gerar um relatório do Surface](https://docs.ecotrust.io/modulos/surface/gerar-um-relatorio.md)
* [Agendar um serviço](https://docs.ecotrust.io/ecotrust-os/agendar-um-servico.md)


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