> ## 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 DAST de aplicação web

> Como testar uma aplicação web em execução com o Scan DAST do AppSec, pelo sensor WEBAPP, e perguntar ao agente sobre o resultado.

O **Scan DAST de aplicação web** testa endpoints em execução procurando XSS, SQLi, CSRF e outras vulnerabilidades exploráveis. 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 AppSec.

## O Agent Work no AppSec

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

É onde o Scan DAST é disparado, 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 o agente monta os painéis do que encontrou.

![Agent Work do AppSec, com a conversa à esquerda e o painel do Scan DAST no canvas à direita.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/20-agent-work.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=744376c080505b9d070f410ac6c6b360)

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.

## Passos

O serviço segue o padrão dos playbooks do painel. O agente coleta os parâmetros em formulários curtos, monta um plano, você aprova e a execução começa. **Nenhum teste chega à aplicação antes do Aprovar.**

**Step 1**

Vá ao **Catálogo de Serviços**, clique em **Ver detalhes** no cartão *Scan DAST de aplicação web* e, na ficha, no botão laranja **Executar**. O painel volta ao *Agent Work*. O agente confirma o pedido e lista o que será preciso definir: as aplicações alvo, o sensor e a janela.

![Mensagem de abertura do agente, explicando o que será configurado no formulário do scan DAST.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/21-aw-abertura.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=fe2107623190a68ce175c55321515912)

Antes do primeiro formulário, o agente lembra que o teste gera carga sobre a aplicação e pede que você confirme a janela.

**Step 2**

Em **Sensor WEBAPP**, escolha o sensor que vai executar o scan e clique em **Confirmar**. A lista traz só sensores WEBAPP, cada um com o tipo e o ambiente.

![Formulário do sensor WEBAPP, com o seletor e o botão Confirmar.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/22-form-sensor.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=ae213ba80cde32bee9cfde47097bf718)

Com um sensor Connect, o agente fala com ele pelo conector do ambiente. Com um sensor Nuvem, o scan roda na nuvem da plataforma.

**Step 3**

Em **Política do scan**, escolha o perfil da varredura e confirme. A lista mostra só as políticas compatíveis com o sensor escolhido.

![Formulário da política do scan, com o seletor e o botão Confirmar.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/23-form-politica.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=a878dcc668f3e7ac151444cc56ad2ae7)

As políticas vão do Scan passivo ao Scan agressivo. Também há modelos autenticados (por senha, cookie ou JWT) e verificações dirigidas a uma URL ou a uma CVE específica.

| Política | Quando usar |
| - | - |
| Scan passivo | Observa as respostas sem enviar ataques. É o menor impacto sobre a aplicação. |
| Scan de url específica (PASSIVO) | A observação passiva restrita a um endereço. |
| Scan padrão | O teste ativo de referência para uma primeira leitura da aplicação. |
| Scan padrão (+ AjaxSpider) | O padrão, rastreando também a navegação gerada por JavaScript. Numa aplicação de página única ou ASP.NET, qualquer política já navega com um navegador. |
| Scan agressivo | A maior cobertura de ataques. Use em homologação ou numa janela combinada. |
| Scan Padrão · Autenticado | Modelos por senha, por cookie ou por JWT, para testar além do login. |
| Scan log4shell (CVE-2021-44228) | A verificação dirigida àquela vulnerabilidade. |

Numa aplicação de página única (SPA), feita em React, Angular, Vue, Next.js e outros, ou numa aplicação ASP.NET, o sensor reconhece o tipo da aplicação e a percorre com um navegador, clicando como um usuário, em qualquer política. Numa política autenticada, o navegador faz o login, mantém a sessão e não aciona botões como **Sair** ou **Excluir**.

**Step 4**

Em **Alvos do scan**, marque as aplicações que serão testadas. A lista vem com os ativos do ambiente do sensor e tem busca no topo. Você pode marcar mais de uma. O agente confirma cada inclusão, e o **Confirmar** fecha a seleção.

![Seleção dos alvos do scan, com a busca de ativos e a lista de aplicações do ambiente.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/24-form-alvos.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=92cfaf6c3d683a118feb7b3084084cc3)

O rótulo do campo traz o ambiente de onde vêm os alvos, neste caso Externo. Endereços de exemplo.

**Step 5**

Em **Autenticação do scan**, escolha como o scan faz login na aplicação: **Sem autenticação**, uma credencial já salva no painel ou **Nova credencial**. Numa credencial nova, escolha o login por formulário ou por cabeçalho, dê um nome e preencha os dados de acesso. Ela fica salva no painel quando você clica em **Aprovar**, e o usuário, a senha e o valor do cabeçalho não aparecem no plano.

**Nova credencial** só aparece para quem tem permissão para editar as configurações do painel. Sem ela, escolha uma credencial salva ou peça a quem tem a permissão.

**Step 6**

Em **Quando rodar**, escolha **Executar agora** para ir direto ao plano, ou **Agendar** para definir a data, a hora e a recorrência antes. Depois, em **Revisar e aprovar**, confira o plano ao lado, incluindo a linha *Agendamento*, e clique em **Aprovar**.

![Passos Quando rodar e Revisar e aprovar, com os botões Executar agora e Aprovar.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/25-quando-rodar.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=26231656b94558aefbb0cf0cee4fb32a)

Os dois últimos passos. O agente só monta o plano depois que você decide quando rodar.

**Step 7**

Acompanhe pela conversa. O agente confirma com *Plano aceito* e registra o avanço a cada passo. O serviço tem quatro passos: começa por *Iniciar Scan WEBAPP*, espera o scan terminar e importa as vulnerabilidades. Quando a importação termina, o cartão informa em **Autenticação** se o scan teve **Sucesso**, **Não autenticou**, **Não se aplica** ou está **Sem informação**. O selo *concluído* encerra a execução.

![Mensagens de acompanhamento da execução, do início até todos os passos concluídos.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/26-acompanhamento.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=76565761bd209455120af0ec668356cc)

Cada mensagem de acompanhamento da execução diz em que passo o serviço está. A última avisa que o resultado já está disponível no painel.

**Step 8**

Peça a leitura do resultado. Por exemplo: `Monte um card visual do que foi encontrado`. O agente busca as vulnerabilidades importadas, monta o painel no canvas e resume na conversa o que merece atenção primeiro, com a correção de cada item.

![Painel do Scan DAST no canvas, com o total de ocorrências, a divisão por severidade e as ocorrências médias.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/28-canvas.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=bb9f82a960fff73b7ccf63c4bd69ae1c)

O painel abre com o total da aplicação e a divisão por severidade, e desce para as ocorrências de maior severidade com a classe de cada uma. Endereço de exemplo.

![Resumo do agente ordenado por severidade, com a correção de cada vulnerabilidade, e a reorganização pelo OWASP Top 10.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/27-leitura-agente.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=25e9a2b280aaf9a9e698edeba9551d2b)

A leitura ordenada por severidade e, logo abaixo, a mesma lista reorganizada pelo OWASP Top 10 a pedido do usuário.

## Perguntar sobre o resultado

Além de executar o scan, o agente responde perguntas escritas em português sobre os dados do painel. Para receber o resultado como painel, e não como texto, peça que ele **monte no canvas**. Exemplos prontos para copiar:

| Para que serve | Pergunta |
| - | - |
| Ler o resultado do último scan | `Monte um card visual do que foi encontrado no último scan, ordenado por severidade.` |
| Verificar a autenticação | `O scan 123 autenticou?` |
| Preparar um relatório de conformidade | `Reorganize as vulnerabilidades pela categoria do OWASP Top 10 e diga qual frente de correção resolve mais itens.` |
| Comparar aplicações | `Compare as aplicações testadas e diga em qual delas está o maior risco e por quê.` |
| Detalhar uma correção | `Detalhe a remediação de Missing Anti-clickjacking Header para um servidor nginx.` |
| Gerar um arquivo | `Gere um relatório em PDF com os dois scans consolidados, organizado por OWASP.` |

Os atalhos do campo de mensagem e os botões do cabeçalho estão em [Paleta de comandos](https://docs.ecotrust.io/ecotrust-os/paleta-de-comandos.md), e o jeito de pedir um card no canvas, em [Perguntar ao agente](https://docs.ecotrust.io/ecotrust-os/perguntar-ao-agente.md).

## A ficha do serviço

Testa endpoints em execução procurando XSS, SQLi, CSRF e outras vulnerabilidades exploráveis. A ficha mostra a visibilidade do serviço, a descrição e, no bloco **O QUE SERÁ ENVIADO AO AGENTE APPSEC**, o pedido exato que o botão **Executar** envia para iniciar a conversa.

![Ficha do serviço Scan DAST de aplicação web, com os selos Playbook e Público, a descrição, o pedido enviado ao agente e os botões Fechar e Executar.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/appsec/34-ficha-dast.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=52d2ee110de4f8ba5c053aac97fda1b5)

Executar leva ao Agent Work e abre o primeiro formulário. O passo a passo está em Passos, nesta página.

## Próximos passos

* [Agendar um serviço](https://docs.ecotrust.io/ecotrust-os/agendar-um-servico.md)
* [Dashboard do AppSec](https://docs.ecotrust.io/modulos/appsec/painel.md)


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