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

# Gerar um relatório do VulScan

> Como gerar um relatório do VulScan, escolher o tipo pelo leitor (Operacional, Tático, Estratégico, ISO 27001, SSVC (Stakeholder-Specific Vulnerability Categorization) ou Executivo), o formato e o período, recortar por ambiente, e o que vem no executivo.

Use este guia para levar a exposição a vulnerabilidades para fora do painel, num relatório escrito para quem vai lê-lo. O caminho até a aba **Artefatos** e o download são os mesmos em todos os módulos e estão em [Gerar e baixar um artefato](https://docs.ecotrust.io/ecotrust-os/artefatos.md). Esta página traz o que é próprio do VulScan.

## Pré-requisitos

* Ocorrências no VulScan. Veja [Executar o Scan de vulnerabilidades completo](https://docs.ecotrust.io/modulos/vulscan/scan-de-vulnerabilidades.md).

## Passos

**1. Escolher o formato**

Na aba **Artefatos**, terceira posição da tira, clique em **Novo artefato**, no canto superior direito, e escolha o formato no menu. O painel abre o **Agent Work** com o pedido já escrito. Você também pode pedir o relatório direto na conversa do **Agent Work**.

**2. Definir o tipo e o formato**

No formulário *Selecione o tipo, o formato e o período do relatório*, escolha o **Tipo de Relatório** (Operacional, Tático, Estratégico, ISO 27001, SSVC ou Executivo), o **Formato de Relatório** (PDF, DOCX, XLSX, HTML de página única ou CSV) e o **Período** (últimos 30 dias, 90 dias, 6 meses, 12 meses ou **Todo o período**, o padrão), e clique em **Confirmar**. O tipo define o leitor do relatório; o formato, o arquivo; o período, a janela das ocorrências, como no botão de período da Mesa de Triagem.

O formulário abre mesmo quando você já citou um tipo no pedido. Confira o tipo antes de confirmar.

**3. Receber o arquivo**

O agente gera o arquivo com os dados atuais do VulScan e avisa na conversa quando ele fica pronto. Depois da entrega, não é preciso repetir o pedido para receber o mesmo relatório.

## Qual tipo escolher

O tipo define o recorte e o leitor do relatório:

* **Executivo**: para a diretoria. A exposição aberta, a priorização SSVC, o que corrigir primeiro e a evolução das ocorrências. Veja [O relatório executivo](#o-relatório-executivo).
* **SSVC**: a priorização pela árvore SSVC, com as faixas de ação da sua [política SSVC](https://docs.ecotrust.io/modulos/vulscan/configurar-a-politica-ssvc.md).
* **Operacional**: para quem corrige. Em XLSX ou CSV, vira a planilha de trabalho com as ocorrências.
* **Tático**: para coordenadores e gestores. O risco priorizado e o plano de remediação.
* **Estratégico**: para CISO e diretoria. A postura consolidada e as recomendações, em poucas páginas.
* **ISO 27001**: para quem prepara a auditoria. As vulnerabilidades no recorte dos requisitos da norma.

## Recortar o relatório

Para o relatório de um ambiente só, diga o ambiente no pedido, pelo nome ("o relatório tático do ambiente Produção"). Se o nome não existir no painel, o agente lista os ambientes que existem.

## Os números do relatório

Todo tipo usa os mesmos números do [painel do VulScan](https://docs.ecotrust.io/modulos/vulscan/painel.md), como a Mesa de Triagem os mostra: as ocorrências dos scanners do VulScan e as do Surface ou do Verify que têm uma CVE, no período e no recorte escolhidos. As partes do ciclo de vida, como **Ocorrências por origem**, usam esse mesmo recorte. No Operacional, no Tático e no Estratégico, a capa abre com **Ocorrências totais**, igual nos três, e diz o período e o recorte aplicados. Quando a exposição aberta e o ciclo de vida usam bases diferentes, o relatório explica a base de cada número.

Fora o Executivo e o SSVC, todo tipo em PDF ou em HTML mostra no máximo 300 linhas na página. Quando a lista passa disso, o quadro diz o que ficou de fora, e a lista completa vem num anexo CSV entregue junto do relatório. Veja [Gerar um relatório de um módulo](https://docs.ecotrust.io/ecotrust-os/gerar-um-relatorio.md).

## O relatório operacional

O relatório **Operacional** ajuda a organizar a correção das vulnerabilidades. A **Fila de vulnerabilidades** reúne as referências que pedem tratamento. Em seguida, **Contexto das vulnerabilidades** mostra uma linha por CVE, com a severidade, o CVSS, o EPSS, a presença no [CISA KEV](https://docs.ecotrust.io/conhecimento/glossario.md#cisa-kev), os ativos afetados e a descrição.

Quando a descrição do scanner inclui código ou uma tabela, o relatório mostra o texto em formato simples e indica o trecho que não entra nessa visualização. Se o conteúdo ficar longo demais para a página, o anexo CSV mantém o texto completo.

## O relatório SSVC

O relatório **SSVC** organiza a fila pela faixa de ação da sua política. A tabela mostra as 100 referências mais urgentes e o plano de ação agrupa os produtos por faixa. Em PDF, DOCX ou HTML, ele vem acompanhado da relação completa da fila em um arquivo CSV chamado `VulScan_SSVC_<data>_fila.csv`.

## O relatório executivo

O executivo segue o modelo do relatório de vulnerabilidades da EcoTrust em **PDF** e em **HTML de página única**. O HTML abre sem internet. Em DOCX, XLSX ou CSV, o executivo sai no layout genérico de relatório.

O PDF e o HTML trazem:

* **Capa e Resumo**, com **Por onde começar**: até cinco fatos que apontam a primeira ação, como o produto usado por ransomware ou o ativo que concentra as críticas abertas.
* **Exposição aberta**: as ocorrências abertas por severidade, os ativos afetados e as referências no catálogo [CISA KEV](https://docs.ecotrust.io/conhecimento/glossario.md#cisa-kev) ou usadas por ransomware.
* **Priorização SSVC**: as referências e as ocorrências por faixa de ação, com os nomes e prazos da sua política, e as ocorrências em atraso.
* **Produtos**: os produtos mais urgentes, cada um com a referência prioritária, os critérios que levaram à faixa e como tratar.
* **Ativos mais expostos**: as ocorrências de cada ativo por severidade e os produtos nele.
* **Evolução**: o ciclo de vida das ocorrências nas últimas doze semanas, com o tempo para corrigir por severidade.

Os números são os mesmos do [painel do VulScan](https://docs.ecotrust.io/modulos/vulscan/painel.md). O executivo vem acompanhado de uma planilha de CVEs por ativo, em CSV, com uma linha por referência e ativo. Ela abre no Excel.

## Verificar o resultado

O arquivo aparece na grade da aba **Artefatos**, num cartão com a capa ou o formato, o nome, quem gerou e há quanto tempo.

O PDF do relatório ISO 27001 aparece com o nome `VulScan_ISO27001_<data>.pdf`.

## Problemas comuns

> [accordion] O relatório executivo saiu sem a priorização ou a evolução
>
> Quando os dados do ciclo de vida das ocorrências não estão disponíveis no momento da geração, o executivo deixa de fora as seções que dependem deles e avisa na capa. Gere o relatório de novo mais tarde.

> [accordion] O executivo em DOCX não segue o modelo do PDF
>
> O modelo do executivo existe só em PDF e HTML. Nos outros formatos, o executivo sai no layout genérico de relatório.

> [accordion] O link que eu enviei parou de funcionar
>
> O link de download de um artefato é temporário. Para compartilhar um relatório, baixe o arquivo e envie o arquivo, não o endereço.

## Próximos passos

* [Painel do VulScan](https://docs.ecotrust.io/modulos/vulscan/painel.md)
* [Como ler os números do VulScan](https://docs.ecotrust.io/modulos/vulscan/como-ler-os-numeros.md)
* [Gerar e baixar um artefato](https://docs.ecotrust.io/ecotrust-os/artefatos.md)


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