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

# Manual do Baseline

> O manual completo do Baseline, aba por aba: Agent Work, Dashboard, Artefatos, Catálogo de Serviços, Observabilidade e Config, com as telas do módulo, como ler os números e o glossário.

O Baseline mede o desvio de configuração em relação ao padrão declarado pela organização. Na nuvem, a postura apurada pelo Prowler entra no painel: cada conta vira um ativo, cada verificação vira uma ocorrência, e a postura é relida a cada nova importação.

**Índice**

1. [O que o Baseline faz](#o-que-o-baseline-faz)
   * [O que isso acelera](#o-que-isso-acelera)
   * [Qual problema resolve](#qual-problema-resolve)
   * [Por que esse problema é relevante](#por-que-esse-problema-é-relevante)
   * [Principais capacidades](#principais-capacidades)
   * [O que faz e o que não faz](#o-que-faz-e-o-que-não-faz)
   * [Antes da primeira execução](#antes-da-primeira-execução)
2. [Como acessar o módulo](#como-acessar-o-módulo)
3. [Onde fica cada coisa](#onde-fica-cada-coisa)
4. [Agent Work](#agent-work)
   * [Executar um serviço](#executar-um-serviço)
   * [Agendar e criar recorrência](#agendar-e-criar-recorrência)
   * [Frequência personalizada (expressão cron)](#frequência-personalizada-expressão-cron)
   * [Pedir um card visual](#pedir-um-card-visual)
5. [Dashboard](#dashboard)
   * [A coluna da esquerda](#a-coluna-da-esquerda)
   * [Escopo licenciado](#escopo-licenciado)
   * [A Linha de Base](#a-linha-de-base)
   * [Abrir um padrão](#abrir-um-padrão)
   * [Por onde começar e Listas](#por-onde-começar-e-listas)
   * [Governança](#governança)
   * [A faixa de rodapé](#a-faixa-de-rodapé)
   * [Navegar pelos níveis](#navegar-pelos-níveis)
6. [Artefatos](#artefatos)
   * [O Relatório de Baseline](#o-relatório-de-baseline)
7. [Catálogo de Serviços](#catálogo-de-serviços)
8. [Observabilidade](#observabilidade)
9. [Config](#config)
   * [Controles](#controles)
   * [Limiares](#limiares)
   * [MCP](#mcp)
   * [Conectar o Prowler](#conectar-o-prowler)
   * [Pré-requisitos do Prowler](#pré-requisitos-do-prowler)
   * [Comandos de conexão no chat](#comandos-de-conexão-no-chat)
   * [Passo a passo da conexão](#passo-a-passo-da-conexão)
   * [Licenças](#licenças)
10. [Como ler os números](#como-ler-os-números)
11. [Glossário](#glossário)

## O que o Baseline faz

O Baseline aponta o **desvio de configuração**: onde a configuração de um ativo se afasta do padrão que a organização declarou como esperado. O serviço tratado neste manual é *Importar postura de nuvem (Prowler)*, que leva a postura apurada pelo Prowler até o painel.

O que entra aqui é a **postura dos recursos de nuvem**: política de acesso, criptografia, retenção e identidade. É a conta de nuvem que o Prowler apura, e é ela que passa a viver no painel como ativo.

> [card] O sujeito: A conta
>
> Cada conta de nuvem entra como um ativo do painel, com identificador, provedor e nota própria.

> [card] O critério: Postura de nuvem
>
> É o critério que avalia a conta, e é o que a importação do Prowler alimenta.

> [card] A origem: Prowler
>
> A seção *Conectores* do Dashboard mostra a fonte que trouxe a postura de nuvem, com a data da última coleta.

### O que isso acelera

Com o resultado do Prowler dentro do painel, quatro partes do trabalho passam a ser feitas aqui.

**O que você consegue fazer**

| Etapa | O que muda, com exemplo |
| - | - |
| **Análise com o agente** | Em vez de ler as verificações linha a linha (no ambiente de exemplo deste manual, são 4.881), peça a leitura ao agente: o botão `Analisar aderência com IA`, na coluna *Por onde começar*, resume o conjunto em texto, e o chat aceita o pedido em linguagem corrente. O agente cruza severidade, conta e critério de uma vez. |
| **Priorização com o agente** | A fila da semana sai da própria tela: a coluna *Por onde começar* traz os ativos não conformes, a conta não conforme e os ativos com verificação vencida, e cada linha abre a lista já filtrada. Para um corte que a tela não faz, peça ao agente um card com o recorte pronto, como na seção 04. |
| **Mais fontes, análise mais rica** | Cada servidor MCP externo aprovado no Config entra como **fonte a mais** para o módulo. Isso importa porque controle sem resultado não conta como aprovado: fica fora da aderência. Quanto mais fonte conectada, mais controles com veredito e mais assunto para o agente cruzar. No painel, a coluna *Conectores* do Dashboard mostra quais fontes falaram do parque e quando. |
| **Relatório para cada público** | O **Relatório de Baseline** sai em três formatos na aba Artefatos, um por público: **operacional**, **tático** e **estratégico**. Cada um fica guardado como artefato, com autor e data, pronto para compartilhar com quem precisa. |

### Qual problema resolve

A postura de nuvem nasce fora do painel, no Prowler. Sem integração, alguém exporta o resultado, trata à mão e importa: trabalho que se repete a cada ciclo e que envelhece entre um ciclo e outro. Aqui a etapa manual sai: a conta de nuvem passa a ser um **ativo do painel**, as verificações do Prowler entram como **ocorrências**, e o resultado é relido a cada nova execução.

### Por que esse problema é relevante

> [card] Escala: Milhares de verificações por conta
>
> No ambiente de exemplo deste manual, uma única conta de nuvem trouxe 1.631 pendências em 4.881 verificações. É volume que não se trata em planilha.

> [card] Cobertura: Raramente tem CVE
>
> Desvio de configuração raramente tem CVE, por isso escapa do scanner de vulnerabilidade. É neste módulo que ele aparece no painel.

### Principais capacidades

> [card] Conexão: Por MCP
>
> O Prowler entra como servidor MCP, com autenticação por chave de API.

> [card] Execução: Por chat
>
> O serviço é pedido em linguagem corrente, com plano aprovado antes de rodar, e aceita agendamento.

> [card] Avaliação: Por conta
>
> A conta de nuvem entra como ativo e é avaliada pelo critério *Postura de nuvem*.

> [card] Leitura: Por padrão
>
> A Linha de Base mostra a aderência de cada padrão no tempo; cada padrão abre os seus controles, no tempo ou por conta e grupo.

> [card] Saída: Relatório
>
> O Relatório de Baseline sai em três formatos na aba Artefatos: operacional, tático e estratégico.

> [card] Rastro: Execuções
>
> Cada execução fica registrada em Observabilidade, com filtro e detalhe por linha.

### O que faz e o que não faz

> [card] Faz: Mede e organiza
>
> Traz o desvio de configuração de nuvem para o painel, agrega a postura por conta, gera relatório e registra cada execução.

> [card] Não faz: Não substitui vizinho
>
> Não mostra o que está exposto: isso é o Surface. Não traz vulnerabilidade com CVE: isso é o VulScan. E o que não foi verificado fica fora da conta: ausência de resultado não é aprovação.

> [!NOTE]
>
> **Fronteira com os módulos vizinhos**
>
> **Surface** mostra o que está exposto. **VulScan** traz a vulnerabilidade com CVE. **Baseline** traz o desvio de configuração, que raramente tem CVE.

### Antes da primeira execução

* **O Prowler conectado ao módulo por MCP** e a conexão aprovada na aba Config. O passo a passo está em [Conectar o Prowler](#conectar-o-prowler), na seção 09.
* **Um scan de postura de nuvem já concluído no Prowler.** O Baseline lê o resultado pronto; ele não dispara a varredura.

## Como acessar o módulo

**Step 1**

**Abra o seu painel no endereço que a EcoTrust forneceu e autentique-se com o seu usuário.**

**Step 2**

**Clique em `Gestão de Riscos`**, na barra superior.

**Step 3**

**Clique em `Baseline`**, a primeira entrada do menu que abriu.

> [!NOTE]
>
> **Antes da primeira coleta**
>
> Na primeira entrada, com o módulo ainda sem dado nenhum, o **Dashboard** mostra os indicadores zerados e a área central vazia, sem mensagem. Isso indica **ausência de dados**, não falha do módulo nem do painel: os indicadores não têm o que somar antes da primeira importação. O conteúdo aparece quando a primeira execução termina. Se o painel não responder, a área central mostra o botão **Tentar novamente**.

![Menu do pilar Gestão de Riscos aberto, listando os módulos Baseline, Verify e Quantify, cada um com uma linha cinza de descrição.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/01-menu-pilar.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=2c6cc6a9ba4cf1632520553465790397)

O menu do pilar, aberto a partir da barra superior. O Baseline é a primeira entrada.

## Onde fica cada coisa

Dentro do módulo, a tela tem três regiões fixas.

> [card] Região 1 · topo: Tira de abas
>
> Logo abaixo do nome do módulo. A aba ativa fica com o nome em destaque e um traço laranja embaixo.

> [card] Região 2 · esquerda: Chat do agente
>
> A coluna estreita. Conversa com o agente e formulários dos serviços.

> [card] Região 3 · direita: Canvas
>
> A área larga, onde o conteúdo da aba é desenhado.

![Tira de abas do módulo: Dashboard, Agent Work, Artefatos, Catálogo de Serviços, Observabilidade e Config, com Dashboard ativa.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/02-abas.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=c3265714cc6d4556a2695b8c0affaa50)

A tira de abas, com a primeira aba, Dashboard, ativa: o traço laranja embaixo do nome marca a aba em que você está.

**As seis abas, na ordem da tela**

| Posição | Aba | Para que serve |
| - | - | - |
| 1ª | `Dashboard` | Aderência ao baseline, a Linha de Base por padrão e por onde começar. |
| 2ª | `Agent Work` | Onde se executa um serviço, pelo chat com o agente. |
| 3ª | `Artefatos` | Relatórios e páginas geradas pelo agente. |
| 4ª | `Catálogo de Serviços` | Os serviços disponíveis, com ficha técnica e custo. |
| 5ª | `Observabilidade` | Histórico de execuções e de conversas. |
| 6ª | `Config` | As metas dos controles, os limiares e os servidores MCP externos conectáveis ao agente. |

## Agent Work

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

É a aba de execução. Todo serviço do catálogo roda aqui, por um formulário passo a passo dentro do chat, e **nada é criado até você aprovar o plano**.

**Controles da aba**

| Controle | Onde está | O que faz |
| - | - | - |
| **Nova** | Topo da coluna do chat | Abre uma sessão limpa. Comece por aqui cada serviço novo. |
| **Campo de mensagem** | Ao pé da coluna do chat | Pede o serviço em linguagem natural, ou responde ao agente. |
| **Formulário do serviço** | Dentro do fio da conversa | Um passo por vez. O passo ativo é sempre o mais abaixo no fio. |
| **Aprovar** | Último bloco do fio, depois da revisão | Libera a execução. É a partir daqui que o serviço roda e consome AWU. |

### Executar um serviço

O exemplo é *Importar postura de nuvem*. O procedimento vale para qualquer serviço; só mudam os campos do formulário.

**Step 1**

**Abra a aba `Catálogo de Serviços`** e ache o cartão *Importar postura de nuvem (Prowler)*.

**Step 2**

**Clique em `Ver detalhes`** para abrir a ficha, confira o bloco **PRECISA TER** e **clique em `Executar`**, na ficha. O painel abre o `Agent Work` numa sessão nova, com o formulário do serviço já no fio da conversa.

> [!TIP]
>
> Também dá para começar pelo chat: no `Agent Work`, clique em `Nova` e descreva o serviço no campo de mensagem.

**Step 3**

**Responda os cinco passos de escopo**, confirmando um a um. O rótulo acima do campo diz o que está sendo pedido; o asterisco laranja marca campo obrigatório.

**Step 4**

**Escolha quando executar**, no passo *Quando rodar*. `Executar agora` leva direto ao plano; `Agendar` abre a data, a hora e a recorrência antes.

> [!TIP]
>
> Nada é criado enquanto o plano não for aprovado.

**Step 5**

**Revise o plano** e **clique em `Aprovar`**. O serviço passa a rodar em segundo plano.

**Step 6**

**Acompanhe até o fim.** O próprio `Agent Work` avisa no fio da conversa quando a execução termina. Para ver o registro depois, ou quando a sessão já foi fechada, a aba `Observabilidade` lista os *Serviços realizados* com o desfecho de cada um.

**Step 7**

**Leia o resultado** no `Dashboard`: a conta importada passa a aparecer no padrão *Postura da nuvem*, na visão *Por conta* (seção 05).

![Passo do formulário: rótulo Severidades a importar com asterisco laranja e, abaixo, o campo de seleção.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/03-form-passo.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=9f3738fe60d0eff8f3a9d639a3245039)

Um passo do formulário. O rótulo vem acima do campo; o asterisco laranja marca campo obrigatório.

![Passo Quando rodar, com o botão Agendar, e abaixo o formulário de agendamento: Quando executar, Com que frequência, Horário, Fuso horário, A partir de e Encerrar em.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/04-agendamento.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=e1d67eec6b62fd4fc24a0853bacded34)

O passo de agendamento, aberto pelo botão Agendar. A linha destacada abaixo dos campos resume a recorrência antes de confirmar.

**Campos do formulário · Importar postura de nuvem**

| Passo | Campo | Opções | O que a escolha determina |
| - | - | - | - |
| 1 | `Ambiente*` | Lista dos ambientes do painel, mais **Criar novo ambiente** | Onde as ocorrências entram. É o que separa nuvem de parque interno. |
| 2 | `Provedor de nuvem*` | AWS · Azure · Google Cloud · Kubernetes | O conjunto de checagens que a origem produziu. |
| 3 | `Conta / subscription / projeto` | Texto livre, ou o botão `Pular` | `Pular` traz todas as contas do provedor; preencher restringe a uma. |
| 4 | `Severidades a importar*` | Todas as severidades · Crítica, alta e média · Só crítica e alta · Só crítica | O filtro de entrada. O que ficar de fora não entra no painel. |
| 5 | `Controles aprovados*` | Só os reprovados · Reprovados e aprovados | O volume importado e, com ele, o custo da execução. |
| 6 | `Quando executar*` | Executar agora, uma vez · Agendar para uma data e hora · Agendar recorrência · Criar recorrência e rodar agora | Quando o serviço roda. A recorrência mantém a postura atualizada sozinha; a última opção deixa a recorrência de pé e já faz a primeira importação. |

### Agendar e criar recorrência

No passo *Quando rodar*, o botão `Agendar` abre um formulário próprio. O escopo é o mesmo que você acabou de revisar: ambiente, provedor, conta, severidades e controles seguem como estão; muda só **quando** o serviço roda. Uma recorrência mantém a postura atualizada sem ninguém precisar lembrar de importar.

**Campos do agendamento**

| Campo | Opções | O que a escolha determina |
| - | - | - |
| `Quando executar*` | Executar agora, uma vez · Agendar para uma data e hora · Agendar recorrência · Criar recorrência e rodar agora | Uma execução só, uma execução marcada, ou uma rotina que se repete. A última opção cria a rotina e já roda a primeira vez. |
| `Com que frequência*` | Todos os dias · Toda semana, em dias escolhidos · Todo mês, num dia fixo · Todo mês, num dia da semana · Personalizado (expressão cron) | O ritmo da rotina. As quatro primeiras são guiadas; a última aceita uma expressão escrita à mão. |
| `Horário*` | Hora e minuto. O formulário abre em `03:00` | A hora do disparo nas frequências guiadas. |
| `Fuso horário*` | Brasília / São Paulo (GMT-3) · Fortaleza (GMT-3) · Manaus (GMT-4) · Rio Branco (GMT-5) · UTC | O fuso em que o horário acima é lido. |
| `A partir de*` | Data. O formulário abre no dia de hoje | O primeiro dia em que a rotina passa a valer. |
| `Encerrar em` | Data, opcional | O último dia. Em branco, a rotina segue sem prazo para acabar. |

Abaixo dos campos, uma linha destacada resume em português o que foi montado (*Todo dia às 03:00.*), e o plano repete esse mesmo resumo na linha **AGENDAMENTO**. São as duas frases para conferir antes de aprovar: é nelas que se vê, em palavras, a rotina que vai passar a existir.

### Frequência personalizada (expressão cron)

A opção *Personalizado (expressão cron)* troca a escolha guiada por um campo de expressão, para ritmos que as quatro frequências prontas não cobrem. A expressão tem **seis campos**, nesta ordem: minuto, hora, dia do mês, mês, dia da semana e ano. Um dos dois campos de dia recebe `?`, indicando que quem manda é o outro.

Para repetições em intervalo regular, **liste os valores** no campo de minuto. E note que a expressão é lida em **UTC**: para chegar a um horário de Brasília, some três horas ao escrever: 6h em Brasília é `9` no campo de hora.

**Exemplos de expressão**

| Expressão | Quando roda |
| - | - |
| `0 6 ? * SUN *` | Todo domingo, às 06:00 UTC, ou 03:00 em Brasília. É o exemplo que o próprio campo mostra. |
| `0,10,20,30,40,50 * * * ? *` | A cada dez minutos, o tempo todo. Útil para acompanhar de perto uma janela curta. |

> [!NOTE]
>
> **Ver e encerrar o que está agendado**
>
> No `Agent Work`, peça ao agente a lista dos agendamentos do painel: ele responde com a frequência, o fuso e o status de cada um, únicos e recorrentes. Para encerrar uma rotina, peça a remoção ao mesmo agente e responda à pergunta de confirmação que ele faz: a remoção é definitiva. Se preferir deixar o fim já marcado desde o início, use o campo `Encerrar em` na hora de criar.

### Pedir um card visual

Além de executar serviços, o agente desenha no canvas a visualização que você pedir, a partir dos dados do painel. Peça em linguagem natural, diga que quer **no canvas** e nomeie as colunas que precisa.

> [!NOTE]
>
> **Exemplo de pedido**
>
> Renderize no canvas um card com os 10 controles de postura de nuvem com mais reprovações, mostrando o nome do controle, a severidade e a quantidade de recursos reprovados.

![Card renderizado no canvas: o título com os controles de nuvem que mais reprovam, o resumo em uma linha, e uma tabela com o controle, o selo de severidade e a quantidade de recursos reprovados, com barra proporcional.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/aw-01-card.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=b4d44edf2129ee424ba8fa2ac4431fc8)

O card no canvas. Você define as colunas no pedido; o agente resume o conjunto na linha abaixo do título.

**Controles do card, no topo do widget**

| Controle | O que faz |
| - | - |
| **Salvar como artefato** | Guarda o card na aba *Artefatos*, como um arquivo `.html` nomeado a partir do assunto, por exemplo `ui_controles-mais-reprovados.html`. |
| **Referenciar no chat** | Usa o card como contexto da próxima mensagem, para pedir um recorte ou uma variação. |
| **Remover do canvas** | Tira o card da tela. O que já foi salvo em Artefatos permanece. |

## Dashboard

> [!NOTE]
>
> **Onde fica:** Tira de abas, **primeira posição**. O módulo já abre nela.

O canvas tem três colunas e uma faixa de rodapé. A coluna estreita da **esquerda** traz a régua do ciclo de gestão contínua de exposição a ameaças (CTEM, do inglês *Continuous Threat Exposure Management*) e os indicadores do parque. A área larga do **centro** é a **Linha de Base**, com a aderência de cada padrão ao longo do tempo. A coluna da **direita** diz por onde começar e abre as listas de ativos. Cada tarefa do Dashboard tem um guia passo a passo, a partir de [Encontrar os ativos e as contas fora do padrão](https://docs.ecotrust.io/modulos/baseline/encontrar-o-que-reprova.md).

![Dashboard do Baseline: à esquerda o ciclo CTEM e os indicadores Aderência ao baseline, Destaques, Controles na meta, Verificação em dia e Conectores; ao centro a Linha de Base com os padrões Cobertura de controle, Hardening do ativo, Regras da empresa e Postura da nuvem; à direita Por onde começar, Listas e o botão Analisar aderência com IA.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/painel-visao.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=f8d43c4c9bdfac8a760b8b7fa20b435d)

O Dashboard inteiro, com as três colunas.

### A coluna da esquerda

No topo, a régua do **ciclo CTEM**, com as cinco fases: *Escopo*, *Descoberta*, *Priorização*, *Validação* e *Mobilização*. As fases que o módulo cobre têm o traço violeta; a que ele não cobre fica em cinza. Abaixo da régua vêm cinco indicadores, cada um com um ícone `i` que explica o cálculo.

![Coluna da esquerda: ciclo CTEM, Aderência ao baseline como média dos padrões, Destaques, Controles na meta com uma grade de quadradinhos, Verificação em dia e a lista de conectores.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/painel-coluna.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=ac47a3e0d9d5d15862afc7e0f3e5c99d)

Os indicadores, de cima para baixo. Passe o mouse sobre um texto sublinhado para ver o que ele conta.

### Escopo licenciado

Quando há quantidade contratada para o Baseline, o Dashboard considera somente os ativos e as contas de nuvem licenciados nos indicadores e na aderência. O mesmo escopo vale para a importação de postura de nuvem. Itens fora dele não entram nos resultados do módulo. Veja [como funciona o escopo licenciado](https://docs.ecotrust.io/modulos/baseline/entender-o-escopo-licenciado.md).

### A Linha de Base

Um bloco por **padrão**, na ordem da Config: *Cobertura de controle*, *Hardening do ativo*, *Regras da empresa* e *Postura da nuvem*, este último com o selo `Prowler`. Cada linha mostra só o nome do padrão e, ao lado do desenho, a aderência de hoje e a meta, como *91%* e *meta 95%*. Quando há verificações suficientes, a linha desenha o gráfico no tempo. Quando há poucas, a tela não calcula taxa: mostra um quadradinho por verificação e só a contagem, como *3 de 6*. Um padrão sem dado mostra só o estado, como *sem fonte* ou *sem verificação*.

Ao passar o mouse sobre uma linha, a linha de leitura sob o desenho diz a aderência, a distância até a meta e a contagem de verificados. Num dia com anotação, ela diz o que mudou, como a meta que subiu.

Clique numa linha (ou use `Espaço`) para selecioná-la. A coluna da direita passa a mostrar o padrão selecionado:

* quantos controles ele tem;
* **Hoje**: a aderência e a distância até a meta;
* **Verificados**: a contagem, como *91 de 100 ativos conformes*;
* **Variação**: a mudança desde a data de comparação, com seta e sinal. Fica verde quando a aderência subiu, vermelha quando caiu e sem cor quando está *estável*;
* **Fora da conta**: as exceções e os riscos aceitos que não entram na taxa;
* **No período**: as anotações do período, como uma mudança de meta.

Um segundo clique, ou `Esc`, solta a seleção.

![Linha de Base com os quatro padrões, cada um com o gráfico da aderência no tempo, a meta e a aderência de hoje à direita.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/painel-linha-de-base.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=1f84a2090a9e34af189b1886bcabcdb6)

A Linha de Base com os quatro padrões. Um padrão com poucas verificações mostra a contagem no lugar do gráfico.

O botão `Todo o período`, no topo da Linha de Base, abre o filtro de **Grupo** e **Período** (todo o período ou os últimos 30, 90, 180 ou 365 dias), e também de **Ambiente** quando o painel tem mais de um. Ao lado dele, o campo `buscar padrão…` aceita o atalho `Ctrl K`.

![Filtro aberto abaixo do botão Todo o período, com as listas Grupo e Período.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/painel-filtro.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=649cf3917f6e61b3148115c73fa3b65b)

O filtro da Linha de Base. Vale para todo o canvas central.

A busca deixa no canvas só os padrões cujo nome tem o texto digitado.

![Busca do Baseline com “Hardening” e o resultado na área central.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/encontrar-o-que-reprova-busca.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=afa0d8836d8b17ebda8c414b81719603)

A busca por um padrão. Ambiente de exemplo.

### Abrir um padrão

Dê um duplo clique na linha do padrão, aperte `Enter` com ela selecionada ou use `Abrir o padrão →` na coluna da direita. O canvas passa a mostrar **uma linha por controle**, com a mesma leitura e a mesma seleção da linha do padrão (`Abrir o controle →` abre o controle), e o caminho no topo (`Linha de Base / Postura da nuvem`); a seta `←` volta. Duas visões, nos botões logo abaixo do título:

* **No tempo**: a aderência de cada controle ao longo do período.
* **Por conta**, em *Postura da nuvem*, ou **Por grupo**, nos outros padrões: uma linha por conta ou grupo e uma coluna por controle. Por conta, cada célula diz quantos checks da conta foram aprovados entre os avaliados no controle; por grupo, a taxa de aprovação do controle entre os ativos verificados do grupo, com a cor comparada à meta. Com 10 verificados ou menos, a célula de grupo mostra quantos estão não conformes, como *2 de 6*. O nome de um grupo abre a lista **Ativos** daquele grupo, e o nome de uma conta abre a conta.

Um controle sem fonte neste painel informa em **Última verificação** que nunca foi verificado. Como não há resultado para agrupar, ele não aparece na visão **Por grupo**.

![Padrão Postura da nuvem aberto na visão No tempo, com uma linha por categoria de check do Prowler.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/painel-padrao.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=37bfb6fd028732b03d8825cc9f3d2d7b)

O padrão Postura da nuvem aberto, na visão No tempo: uma linha por categoria de check do Prowler.

![Visão Por conta: uma linha por conta de nuvem e uma coluna por categoria, com os checks aprovados entre os avaliados em cada célula.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/painel-por-conta.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=9b1114a6d5b10ea7e212b60932c15416)

A visão Por conta. Os botões à direita (Todos e um por provedor, como AWS e Azure) filtram por provedor. Contas de exemplo.

**Controles do canvas central**

| Controle | Onde está | O que faz |
| - | - | - |
| **Ver como lista · Ver como desenho** | Barra ao pé do canvas, com um padrão aberto | Troca o desenho por uma lista de controles com a contagem de hoje e a descrição de cada um. |
| **− · + · encaixar · tela cheia** | Barra ao pé do canvas | Afasta, aproxima, ajusta o desenho à área e abre em tela cheia. O último é o ícone de tela cheia. |
| **?** | Ponta direita da barra | Mostra os atalhos: clique seleciona e mostra o contexto, duplo clique ou `Enter` abre o item, `Esc` volta um nível, `Ctrl` + rolagem aproxima no cursor, arrastar move o desenho. |

### Por onde começar e Listas

Na coluna da direita, **Por onde começar** traz o que merece olhar primeiro, em ordem de prioridade: ativos não conformes, conta não conforme, controles abaixo da meta e ativos com verificação vencida. Abaixo, **Listas** abre as máquinas (**Ativos**) ou as contas de nuvem. A seta `→` de cada linha abre a lista **Ativos** já recortada, menos em **Controles abaixo da meta**, que abre um nível da Linha de Base com esses controles; linha com zero não tem seta. Onde cada porta abre o nível está em [Navegar pelos níveis](#navegar-pelos-níveis). Ao pé da coluna, o botão `Analisar aderência com IA` pede ao agente a leitura do conjunto.

![Coluna da direita: Por onde começar com ativos não conformes, contas não conformes, controles abaixo da meta e ativos com verificação vencida; Listas com ativos e contas de nuvem; botão Analisar aderência com IA.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/painel-comecar.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=e15e1c781ec3c8c318782823a2741bac)

A coluna da direita. Os contadores mudam a cada coleta.

![Lista Ativos, Não conformes: abas Todos, Ativos e Contas de nuvem, os filtros da lista e a tabela com ativo, sistema, ambiente, cobertura e controles.](https://mintcdn.com/eco-trust/knUhWVz7np-0ibFK/images/baseline/painel-ativos.png?fit=max\&auto=format\&n=knUhWVz7np-0ibFK\&q=85\&s=5572c563a93a48c9908d62dbe502a2ae)

A lista aberta por Ativos não conformes. O caminho no topo mostra o filtro aplicado.

A lista ocupa o canvas central. As abas `Todos`, `Ativos` e `Contas de nuvem` trocam o tipo de ativo; filtros como `Não conformes`, `Com verificação vencida`, `Vistos por uma só fonte` e `Sinais divergentes` recortam a lista; `Mostrar colunas de hardware` acrescenta colunas. Cada linha traz o ativo, com o endereço logo abaixo, o ambiente, o grupo, o sistema ou provedor, as fontes, quando foi visto por último, a cobertura (*em dia* ou *vencida*) e os controles que reprovam. Quando a tela é estreita, as colunas que não cabem saem, e a linha acima da tabela diz quais.

### Governança

O botão **Governança · Baseline**, no canto inferior direito, mostra a **prontidão para auditoria**: quantos requisitos estão cumpridos, de quantos (os sem dado contam no total). Ao abrir, a coluna da direita lista cada requisito com a referência de norma (ISO 27001:2022, CIS v8, NIST CSF 2.0, CIS Benchmark), o estado *Atendido*, *Pendente* ou *Sem fonte*, quantos controles estão na meta e o link `detalhes`. `Fechar governança` volta à coluna anterior.

### A faixa de rodapé

Ao pé da tela ficam: o botão **Agente de IA**, que abre a conversa com o agente do Baseline numa coluna à esquerda, sem sair do Dashboard; a legenda do desenho (*Meta*, *Aderência*, *Abaixo da meta*, *Dia sem captura*); a faixa **Ao vivo**, que alterna frases curtas sobre o parque; e a linha de **base**, que diz de onde vêm os números e com que data a comparação é feita.

![Rodapé do Dashboard: barra de zoom, botão Agente de IA, legenda Meta, Aderência, Abaixo da meta e Dia sem captura, botão Governança Baseline 1 de 8, faixa Ao vivo e a linha de base.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/dash-10-rodape.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=52bdc354bddc7f8e530e5052959020d4)

O rodapé. A linha de base, à direita, avisa quando a comparação com uma data anterior não vale porque os padrões medidos mudaram.

### Navegar pelos níveis

O Dashboard se lê em níveis. A **Linha de Base** é o primeiro, e abrir um item desce um nível: do padrão ao controle, do controle aos ativos, da conta de nuvem às ocorrências dela. Cada nível responde uma pergunta diferente, e a trilha no topo da área central mostra em qual você está.

#### O mapa dos níveis

Cada nível da árvore abre os que estão abaixo dele.

* **Linha de Base**: a aderência de cada padrão no tempo.
  * **Um padrão**, como *Hardening do ativo*: os controles do padrão, **No tempo**, **Por grupo** ou **Por conta**.
    * **Um controle**, como *Firewall*: a regra, a meta e quem está fora.
      * **Ativos · Não conformes em Firewall**, por um bloco de estado do controle.
      * **Conta de nuvem**, por uma linha do painel **Por conta** do controle.
    * **Ativos · Grupo** e o nome do grupo, pelo nome de um grupo em **Por grupo**.
    * **Conta de nuvem**, pelo nome de uma conta em **Por conta**.
  * **Controles abaixo da meta**, por **Por onde começar**: os controles abaixo da meta, agrupados por padrão.
    * **Um controle**.
  * **Ativos**, por **Por onde começar** ou **Listas**: as máquinas e as contas de nuvem, com o recorte de quem abriu a lista.
    * **Inventário detalhado** de uma máquina.
    * **Conta de nuvem**: os controles, os checks e os serviços da conta.
      * **Ocorrências** da conta.

#### Entrar e voltar

* **Selecionar:** um clique, ou `Espaço`, seleciona uma linha. A coluna da direita mostra o resumo dela e o botão que a abre, como **Abrir o padrão →**, **Abrir o controle →** ou **Abrir o ativo →**.
* **Abrir:** um duplo clique, ou `Enter`, abre o item e desce um nível.
* **Ver onde você está:** a trilha no topo da área central mostra o caminho, como *Linha de Base / Hardening do ativo / Firewall*. Clique num nível da trilha para voltar direto a ele. Quando o caminho não cabe, os níveis do meio viram **…**, que abre a lista deles.
* **Subir um nível:** a seta **←**, no começo da trilha, sobe um nível. Pare o cursor sobre ela para ver para onde ela leva, como *Voltar para Linha de Base* · `Esc`.
* **Usar o `Esc`:** cada `Esc` fecha uma coisa, nesta ordem: o painel aberto por **Todo o período**, o detalhe da **Governança**, a seleção e, por fim, o nível, que sobe um.
* **Voltar sem perder o lugar:** o nível volta como você deixou, com a busca, a seleção, a visão escolhida e a página da lista.

> [!WARNING]
>
> **A coluna da direita pode pular níveis.** **Por onde começar** e **Listas** aparecem na Linha de Base, num padrão, em **Controles abaixo da meta**, na lista **Ativos** e em **Ocorrências**, mas não abrem sempre no mesmo lugar:
>
> * Na Linha de Base, num padrão ou em **Controles abaixo da meta**, a lista **Ativos** abre um nível abaixo de onde você está, e a seta **←** volta para lá.
> * Na lista **Ativos**, a lista nova toma o lugar da atual.
> * Em **Ocorrências**, a lista **Ativos** abre logo abaixo da Linha de Base: a seta **←** leva à Linha de Base, e não à conta.
> * **Controles abaixo da meta** e um padrão sempre abrem logo abaixo da Linha de Base.

#### Linha de Base

O primeiro nível, e o nome que abre a trilha. Responde qual padrão está longe da meta: um bloco por padrão, *Cobertura de controle*, *Hardening do ativo*, *Regras da empresa* e *Postura da nuvem*, com a aderência no período, a de hoje e a meta. Um clique seleciona o padrão e mostra o resumo dele na coluna da direita; um duplo clique abre o padrão. Na coluna da direita, **Por onde começar** e **Listas** abrem os outros níveis. O nome **Linha de Base**, na trilha, volta aqui de qualquer nível.

#### Um padrão

A trilha mostra *Linha de Base / Hardening do ativo*. Responde qual controle puxa o padrão para baixo. A visão **No tempo** traz uma linha por controle; o botão ao lado troca para **Por grupo**, uma linha por grupo de ativos, ou **Por conta**, em *Postura da nuvem*, uma linha por conta de nuvem, as duas com uma coluna por controle. A segunda visão só aparece quando o painel tem grupos ou contas de nuvem. Um duplo clique numa linha de controle, ou uma célula de **Por grupo** ou **Por conta**, abre o controle; o nome de um grupo abre a lista **Ativos** daquele grupo, e o nome de uma conta abre a conta. O passo a passo está em [Abrir um padrão e ver onde ele reprova](https://docs.ecotrust.io/modulos/baseline/abrir-um-padrao.md).

#### Controles abaixo da meta

Só se chega por **Por onde começar**, e o nível abre logo abaixo da Linha de Base, mesmo que você esteja num padrão. Responde o que está abaixo da meta em todo o baseline: cada controle abaixo da meta, inclusive os que estão a até 5 pontos percentuais dela, agrupado pelo padrão e do mais longe da meta para o mais perto. Um controle com 10 verificações ou menos não entra, porque não tem taxa. A leitura e os gestos são os de um padrão, e um duplo clique abre o controle, com a trilha *Linha de Base / Controles abaixo da meta / Firewall*.

#### Um controle

A trilha termina no nome do controle. Responde quem está fora do controle e como corrigir. O cartão traz **Regra**, **Meta**, **Avalia**, **Fonte do dado** e **Última verificação**, e ao lado a taxa: **Conformes** num controle de ativos ou de contas, **Checks aprovados** num controle da *Postura da nuvem*. Abaixo vêm quantos estão sob o controle e um bloco por estado: **Não conformes**, **Não verificados**, **Exceções** e **Conformes**. Cada bloco com número abre a lista **Ativos** daquele estado, como *Ativos · Não conformes em Firewall*. Os painéis embaixo são **Linha de base do controle**, **Por grupo** num controle de ativos (cada linha abre os ativos do grupo fora do controle) ou **Por conta** num controle de nuvem (cada linha abre a conta), **O que mais reprova** e **Como corrigir**. O passo a passo está em [Abrir um controle e ver como corrigir](https://docs.ecotrust.io/modulos/baseline/abrir-um-controle.md).

#### Ativos

A trilha mostra a lista e o recorte, como *Ativos · Não conformes*, *Ativos · Contas de nuvem* ou *Ativos · Não conformes em Firewall*. Responde quais ativos e contas estão no recorte. As abas **Todos**, **Ativos** e **Contas de nuvem** trocam o tipo; **Listas › Ativos** abre só as máquinas, na aba **Ativos**. Um clique seleciona a linha e mostra a ficha na coluna da direita; um duplo clique numa máquina abre o **Inventário detalhado**, e numa conta abre a **Conta de nuvem**. Veja [Encontrar os ativos e as contas fora do padrão](https://docs.ecotrust.io/modulos/baseline/encontrar-o-que-reprova.md) e [Ler a ficha de um ativo no Baseline](https://docs.ecotrust.io/modulos/baseline/ler-a-ficha-de-um-ativo.md).

#### Inventário detalhado

O inventário completo de uma máquina, com a trilha terminando no nome dela. Abre por **Abrir o ativo →**, na ficha da coluna da direita, ou por um duplo clique na máquina, na lista **Ativos**. As abas **Inventário** e **Fontes** mostram o que a coleta trouxe e de onde. É o fim do caminho: a seta **←** volta ao nível anterior.

#### Conta de nuvem

A trilha termina no nome da conta. Responde como está a postura da conta inteira. No topo, **Controles aprovados** diz quantos controles a conta cumpre, como *6 de 8*, e embaixo quantos checks passaram na última coleta. As abas **Controles**, **Checks** e **Serviços** detalham a conta; uma linha de qualquer aba abre as ocorrências da conta já recortadas por ela, e **Ver ocorrências →** abre todas. O passo a passo está em [Analisar uma conta de nuvem](https://docs.ecotrust.io/modulos/baseline/analisar-uma-conta-de-nuvem.md).

#### Ocorrências

As ocorrências de uma conta de nuvem, abertas a partir dela. A lista começa nas **Abertas**, e os filtros recortam por severidade, por status e pela categoria do controle. Um clique numa ocorrência mostra o detalhe dela na coluna da direita, e `Esc` solta a seleção antes de subir de nível.

#### Os números mudam quando você desce

Cada nível conta uma coisa diferente, então o número de um nível não é a soma nem a média dos números do nível de baixo.

| Onde está o número | O que ele conta |
| - | - |
| **Aderência ao baseline**, na coluna da esquerda | A média simples dos padrões que têm resultado. É o mesmo número em todos os níveis. |
| Linha de um padrão | As verificações aprovadas sobre as verificadas, somando todos os controles do padrão. |
| Linha de um controle | Os ativos ou as contas de nuvem conformes sobre os verificados. Num controle da *Postura da nuvem*, os checks aprovados sobre os avaliados. |
| Célula de **Por grupo**, num padrão | A taxa de aprovação do controle entre os ativos verificados do grupo, com a cor comparada à meta. |
| Célula de **Por conta**, num padrão | Os checks daquele controle aprovados na conta, entre os avaliados, como *29 de 41*. Quando a importação trouxe só os reprovados, as reprovações pendentes. |
| **Controles aprovados**, na conta de nuvem | Controles, e não checks: quantos a conta cumpre entre os que se aplicam a ela. |

Como a linha de um padrão soma as verificações, ela não é a média dos controles: um controle com 90 de 100 ativos conformes e outro com 6 de 20 dão 96 de 120, ou 80%, e não a média de 60%. As outras regras valem em todos os níveis:

* **Poucas verificações:** com 10 verificações ou menos, a tela não calcula taxa. A linha mostra um quadrado por verificação e a contagem, como *3 de 6*, e a célula de **Por grupo** mostra quantos estão não conformes, como *2 de 6*.
* **Não verificado fica fora:** o que nenhuma fonte verificou não aprova nem reprova, e fica fora da taxa. As exceções aceitas também ficam fora.
* **Período:** o **Período**, em **Todo o período**, muda as linhas e a data com que cada variação compara. O número de hoje não muda.
* **Ambiente e Grupo:** o recorte por **Ambiente** ou **Grupo** muda todos os números da tela, e as linhas passam a mostrar só a leitura de hoje, porque o histórico é do painel inteiro.
* **Licenças:** com quantidade de licenças contratada, os números contam só as máquinas e as contas de nuvem licenciadas.

## Artefatos

> [!NOTE]
>
> **Onde fica:** Tira de abas, **terceira posição**, entre *Agent Work* e *Catálogo de Serviços*.

Guarda o que o agente produziu para ser lido fora do painel: relatórios em PDF e páginas HTML. Cada artefato é um cartão com nome, autor e data.

**Controles da aba**

| Controle | Onde está | O que faz |
| - | - | - |
| **Novo artefato** | Cabeçalho da aba | Inicia uma geração: você escolhe o tipo de relatório, o formato e a abrangência. |
| **Cartão do artefato** | Grade central da aba | Abre a prévia, com autor e data de emissão. |
| **Baixar** | No cartão do artefato | Salva o arquivo na sua máquina. O link é temporário: guarde o arquivo, não o endereço. |

### O Relatório de Baseline

No formulário *Selecione o tipo, o formato e a abrangência do relatório*, você escolhe o **Tipo de Relatório**, o **Formato de Relatório** e a **Abrangência**: **Todos**, para a aderência ao baseline, ou um padrão com controles no painel (**Cobertura de controle**, **Hardening do ativo**, **Regras da empresa** ou **Postura da nuvem**). O título de cada relatório diz o tipo, e o operacional, o tático e o estratégico partem dos mesmos números, um por público.

| Tipo | Para quem | O que traz |
| - | - | - |
| **Operacional** | Analista, sysadmin | Detalhe técnico e a ação imediata de cada ocorrência. |
| **Tático** | Coordenador, gestor | Risco priorizado e plano de remediação. |
| **Estratégico** | CISO, board | Postura consolidada e recomendações, em poucas páginas. |
| **ISO 27001** | Quem prepara a auditoria | Cada controle avaliado, com o status, a evidência e a ação de adequação. |

Para um relatório de parte do painel, diga o recorte no pedido, pelo nome: um ambiente, um grupo de ativos ou uma conta de nuvem. O relatório de uma conta traz só a postura dessa conta, e o formulário deixa de mostrar a **Abrangência**. Se o nome não existir no Baseline do painel, o agente lista os que existem.

O relatório usa os mesmos números do [Dashboard](#dashboard): a **Aderência ao baseline**, a de cada padrão e de cada controle contra a meta, os ativos fora do esperado e a postura de cada conta de nuvem. A capa abre com a aderência da abrangência escolhida, ou com a postura da conta, e diz a abrangência e o recorte aplicados. Em PDF e em HTML, a página mostra no máximo 300 linhas: 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.

## Catálogo de Serviços

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

Lista tudo o que o módulo sabe executar. Cada serviço é um cartão, e cada cartão abre uma ficha com o que o serviço entrega, o que precisa antes e quanto custa.

![Cartão de serviço no catálogo: título, selo Playbook à direita do título, descrição e o botão Ver detalhes ao pé.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/09-catalogo-card.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=8ff02de0cacdbfe9fee791534e399996)

O cartão do serviço. O selo Playbook fica à direita do título; o botão Ver detalhes, ao pé do cartão.

![Ficha do serviço: selos Playbook e Público, objetivo, chip preço não publicado, bloco Tarefas com o custo de cada tarefa, bloco Precisa ter e o link Ver ficha completa ao pé.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/10-ficha.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=0549795bcecf5f0f0b25c10a1286efb1)

A ficha. TAREFAS traz o que o serviço entrega e o custo de cada tarefa; PRECISA TER, os pré-requisitos.

**Controles da aba**

| Controle | Onde está | O que faz |
| - | - | - |
| **Todos · Público · Privado · Comunidade** | Topo da lista | Separa os serviços por origem. |
| **Ver detalhes** | Ao pé de cada cartão | Abre a ficha do serviço. |
| **Ver ficha completa** | Ao pé da ficha | Mostra identificador, versão, tarefas e pré-requisitos detalhados. |
| **Executar** | Na ficha do serviço | Leva para *Agent Work* com o formulário já aberto. |

## Observabilidade

> [!NOTE]
>
> **Onde fica:** Tira de abas, **quinta posição**, entre *Catálogo de Serviços* e *Config*.

É onde se confirma o que aconteceu. Duas listas: **Serviços**, com as execuções, e **Threads**, com as conversas.

![Cabeçalho da lista Serviços realizados e a barra de filtros: status, serviço, ordenação, período e usuário.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/11a-filtros.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=ce2ae47e9e9bd0279450587f381abaf2)

A barra de filtros, logo abaixo do título da lista.

![Linhas de execução: seta de expandir, ícone de desfecho, nome do serviço, identificador e, na ponta direita, a data e a hora local.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/11b-linhas.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=9ae20227be93eb354000417b6b429cab)

Uma linha de execução. A seta à esquerda expande o registro; a data e a hora ficam na ponta direita. O espaço vazio do meio da linha foi comprimido nesta figura.

**A barra de filtros, da esquerda para a direita**

| Posição | Filtro | O que faz |
| - | - | - |
| 1º | `Todos os status` | Separa *Em andamento*, *Sucesso*, *Erro* e *Cancelado*. |
| 2º | `Todos os serviços` | Deixa na tela só as execuções de um serviço. |
| 3º | `Mais recentes` | Ordena a lista. |
| 4º | `dd/mm/yyyy até dd/mm/yyyy` | Recorta o período. |
| 5º | `Todos os usuários` | Mostra o que uma pessoa executou. |

> [!NOTE]
>
> **Achar uma execução pelo horário**
>
> O sufixo `MMDD-HHMM` do identificador está em **UTC**; a hora na ponta direita da linha está no **horário local**. Uma execução das `16:01` aparece como `#caasm-0902-1901`. Some três horas ao horário que você lembra para chegar ao código.

Na lista **Threads**, o identificador da sessão aparece no **cabeçalho da conversa aberta**. É ele que se cita ao pedir apoio.

## Config

> [!NOTE]
>
> **Onde fica:** Tira de abas, **sexta e última posição**, à direita de *Observabilidade*.

A aba tem **Operação**, **Baseline** e **MCP**, nesta ordem. **Operação** guarda o prazo da coleta do Prowler; **Baseline** reúne *Metas e limiares* e define a régua da avaliação; **MCP** controla os servidores MCP externos. Com quantidade de licenças contratada, **Licenças** aparece por último.

### Operação

O prazo da coleta do Prowler, **Coleta do Prowler em dia**, em dias. Ele alimenta o controle *Conta de nuvem com coleta em dia*. Ao mudar o valor, a barra do pé da tela mostra **Salvar** e **Descartar**.

### Baseline

#### Controles

A seção que abre primeiro. Os controles avaliados ficam em **quatro grupos**, cada um com uma **meta** em porcentagem na ponta direita do cabeçalho. Dentro do grupo, cada controle tem uma linha com o nome, a fonte que o mede e a **meta padrão** dele. Cada grupo e cada controle têm uma caixa de seleção à esquerda. Ao mudar uma meta ou uma caixa de seleção, a barra do pé da tela mostra **Salvar** e **Descartar**.

![Aba Baseline, com o título Metas e limiares e o grupo Cobertura de controle com meta de 98%, quatro controles, a fonte, a meta padrão e o botão + recorte.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/config-02-controles.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=71541578c9c4885639a63b43ed571a4c)

O grupo Cobertura de controle. A linha cinza de cada controle diz quem mede: o Inventory, o Prowler ou o padrão da plataforma.

**Os quatro grupos, na ordem da tela**

| Grupo | O que reúne (texto do ícone `i`) | Controles |
| - | - | - |
| **Cobertura de controle** | Todo ativo visto pelas ferramentas e com a coleta em dia. | Inventário atualizado · Visto por ferramenta de endpoint · Visto por scanner de rede · Conta de nuvem com coleta em dia |
| **Hardening do ativo** | A configuração de segurança de cada ativo. | Antivírus / EDR · Firewall · Criptografia de disco · Controle de conta (UAC) · Sistema operacional com suporte |
| **Regras da empresa** | O que a empresa proíbe e os prazos de correção que ela dá. | Software proibido · Porta proibida · Correção dentro do SLA |
| **Postura da nuvem** | Os checks do Prowler em cada conta de nuvem, pelo padrão do provedor. | Identidade e acesso · Criptografia · Registro e auditoria · Rede · Exposição · Backup e retenção · IA · Sem categoria |

![Grupo Postura da nuvem, com meta de 91%, e oito categorias do Prowler, cada uma com a meta padrão e o botão + recorte.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/config-04-postura.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=d63e4a02b456af82e5c44b77506ff368)

O grupo Postura da nuvem, que a importação do Prowler alimenta: uma linha por categoria de check, cada uma com a sua meta.

**Meta para um recorte.** O botão `+ recorte`, na ponta direita de cada controle, abre uma linha logo abaixo dele, com uma lista para escolher o recorte, o campo da meta e os botões `Adicionar` e `Cancelar`. A lista traz os ambientes e os grupos de ativos cadastrados no painel. Serve para cobrar de uma parte do parque uma meta diferente da meta padrão. Uma meta para um ambiente ou grupo com nome longo também continua cadastrada depois de salvar.

![Linha do controle Inventário atualizado com a linha de recorte aberta: lista escolha, campo de meta com 100%, e os botões Adicionar e Cancelar.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/config-03-recorte.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=5b8fe55349c7d7adee378f2448a2b5dc)

A linha que o + recorte abre. A meta do recorte vale só para a parte escolhida na lista.

#### Limiares

Os prazos e as listas de outros módulos que os controles usam para decidir. Os quatro **são a mesma configuração** do módulo de origem, mostrada para consulta, com o botão que leva até ela. O prazo da coleta do Prowler, que é do Baseline, fica na aba **Operação**.

**Os limiares, na ordem da tela**

| Limiar | Onde se edita | O que alimenta |
| - | - | - |
| **Coleta desatualizada dos ativos** | `Editar no Inventory →` (Inventory › Config › Operação › Escopo › Coleta desatualizada) | O controle *Inventário atualizado*. |
| **SLA de correção por severidade** | `Editar no AutoPatch →` (AutoPatch › Config › Baseline › SLA por severidade) | O controle *Correção dentro do SLA*. |
| **Portas proibidas** | `Editar no Radar →` (Radar › Config › Baseline de portas) | O controle *Porta proibida*. |
| **Software proibido** | `Editar no Inventory →` (Inventory › Config › Baseline de software) | O controle *Software proibido*. |

### MCP

Os servidores MCP externos conectáveis ao agente, numa lista com estado. É aqui que um gestor decide sobre as solicitações abertas pelo comando `/mcp` (ver [Conectar o Prowler](#conectar-o-prowler), nesta seção).

![Tela Config MCP: filtros Todos, Solicitado, Autorizado e Não autorizado com as contagens, o botão Novo MCP e, abaixo, um cartão por servidor com estado, escopo, URL, quem solicitou e os botões Aprovar, Rejeitar e Detalhes.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/config-01-mcp.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=1616f5f60a8b05a8e40a509076634137)

A tela MCP. Os filtros do topo trazem a contagem de cada estado. Os servidores desta figura são de laboratório e um deles está sem TLS; para o Prowler, o requisito 1 vale.

> [card] Estado 1: Solicitado
>
> Pedido aberto, à espera de decisão. O cartão traz **Aprovar** e **Rejeitar**.

> [card] Estado 2: Autorizado
>
> Conexão liberada. O cartão diz se vale *aqui* ou *fora deste módulo*.

> [card] Estado 3: Não autorizado
>
> Pedido recusado. O cartão mantém o botão **Aprovar**, para rever a decisão.

**O que cada cartão traz**

| Campo | O que diz |
| - | - |
| **Servidor** | O host do MCP, em destaque, com a URL ao lado. URL longa aparece abreviada no cartão; o endereço inteiro fica em **Detalhes**. |
| **Estado** | Solicitado, Autorizado ou Não autorizado. |
| **Escopo** | *somente \<módulo>* ou *todos os módulos*. É o que define onde a conexão vale. |
| **Origem do pedido** | Quem solicitou e em que data. |
| **Detalhes** | Abre o registro completo da solicitação. |

**Controles da tela**

| Controle | Onde está | O que faz |
| - | - | - |
| **Todos · Solicitado · Autorizado · Não autorizado** | Topo da tela | Filtra a lista pelo estado. Cada filtro mostra a contagem. |
| **+ Novo MCP** | Topo, à direita | Cadastra um servidor pela URL, sem passar pelo chat. |
| **Aprovar · Rejeitar** | No cartão do servidor | Decide a solicitação. É o passo 5 de *Conectar o Prowler*, nesta seção. |
| **+ Adicionar** | Bloco *MCPs pré-aprovados* | Inclui uma URL na lista de pré-aprovados. |

> [!NOTE]
>
> **MCPs pré-aprovados**
>
> Lista à parte, ao pé da tela. Uma conexão de qualquer membro para uma URL desta lista **nasce aprovada**, sem passar por um gestor. A autenticação continua sendo a de cada usuário. Solicitações, decisões e autorizações ficam registradas com trilha de auditoria.

### Conectar o Prowler

> [!NOTE]
>
> **Onde fica:** Antes da primeira execução do serviço *Importar postura de nuvem*. A conexão é declarada pelo campo de mensagem do **Agent Work**.

O Baseline lê, pelo MCP do cliente, um scan de postura de nuvem que já terminou no Prowler, e registra o resultado como um scan importado no ambiente escolhido: um ativo por conta de nuvem e uma ocorrência por recurso e controle. Por padrão entram apenas os controles reprovados; o passo **Controles aprovados** do formulário permite trazer também os aprovados, e a seção 10 explica como cada um é classificado. A conexão é o primeiro pré-requisito da ficha do serviço.

![Bloco PRECISA TER da ficha do serviço, com quatro itens; o primeiro é a conexão MCP com o Prowler do cliente.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/mcp-01-precisa-ter.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=b9e9087e5547d3e03bc3381ba395188f)

O bloco PRECISA TER, na ficha completa do serviço.

### Pré-requisitos do Prowler

**Pré-requisitos da conexão**

| # | Requisito | O que precisa estar pronto |
| - | - | - |
| 1 | **Endpoint MCP sob TLS** | `https://<host>/mcp`, servido pelo Local MCP (`prowlercloud/prowler-mcp`). |
| 2 | **API\_BASE\_URL no container do MCP** | Apontando para a API REST interna, **com o sufixo** `/api/v1`. Exemplo: `https://prowler-api.interno/api/v1`. São dois serviços e duas portas: o MCP responde em `/mcp` (8000) e a REST em `/api/v1` (8080). |
| 3 | **API key** | No formato `pk_…`, com expiração definida, gerada por um **usuário de serviço dedicado**, com papel de *Unlimited Visibility* e nenhuma permissão administrativa. |
| 4 | **Prowler 5.13.0 ou superior** | API key existe a partir dessa versão. |
| 5 | **Liberação de rede** | Entrada: do IP de origem da EcoTrust `3.228.110.28` até o `/mcp`. Saída, a partir do host do MCP: `hub.prowler.com` e `docs.prowler.com`. |

> [!NOTE]
>
> **Se for Prowler Cloud, e não instalação local**
>
> Os requisitos **1, 2 e 5 caem**. O endpoint passa a ser `https://mcp.prowler.com/mcp` e basta a API key.

### Comandos de conexão no chat

Digite `/` no campo de mensagem do Agent Work para ver a lista.

**Comandos de conexão**

| Comando | O que faz |
| - | - |
| `/mcp <url>` | Solicita a conexão de um MCP externo pela URL. |
| `/mcp-list` | Lista os MCPs aprovados neste módulo, com a contagem de ferramentas de cada um. |

### Passo a passo da conexão

**Step 1**

**Abra a aba `Agent Work`** e clique em `Nova`.

**Step 2**

**Envie `/mcp` seguido da URL do endpoint.**

> [!TIP]
>
> Exemplo: `/mcp https://mcp.prowler.com/mcp`. O agente analisa o servidor e responde com a pergunta do passo seguinte.

**Step 3**

**Escolha como o servidor faz a autenticação**: *Chave de API*, *Sem autenticação* ou *OAuth*.

![Pergunta do agente: como o servidor MCP faz a autenticação, com as opções Chave de API, Sem autenticação, OAuth e o botão Cancelar.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/mcp-04-auth.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=e329c3cb486d72de2ceb115c3b1dec91)

Passo 3. Cada opção descreve o que o servidor espera receber.

**Step 4**

**Em *Chave de API*, escolha o tipo**: *Bearer Token*, enviado no cabeçalho HTTP `Authorization`, ou *Cabeçalho personalizado*, em que você informa o nome do cabeçalho e o valor do token. Informe a chave em seguida.

> [!TIP]
>
> A API key do Prowler é a do requisito 3, no formato `pk_…`.

![Pergunta do agente: qual o tipo da chave de API, com as opções Bearer Token e Cabeçalho personalizado.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/mcp-05-chave.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=e35bedce92676854e21c5d36a6236fdc)

Passo 4, quando a escolha é Chave de API.

**Step 5**

**Peça a aprovação.** A solicitação fica pendente até que um usuário com perfil de **gestor** a aprove em *Config › MCP*.

**Step 6**

**Confirme com `/mcp-list`.** Depois de aprovado, o servidor aparece na lista com a URL e o número de ferramentas que expõe.

![Resposta do comando barra mcp-list: lista dos MCPs aprovados no módulo, cada um com a URL e a contagem de ferramentas.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/mcp-06-list.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=493050ec8d9fdc799ce9541ef1133b6a)

Passo 6. A contagem de ferramentas confirma que o painel enxerga o servidor.

### Licenças

A aba **Licenças** aparece por último, só quando o Baseline tem quantidade de licenças contratada. Ela mostra **Contratadas**, **Licenciados**, **Com dados no módulo** e **Fora do escopo**, e um gestor escolhe ali, uma vez por mês, quais máquinas e contas de nuvem ocupam as licenças. O módulo considera somente as máquinas e contas de nuvem licenciadas e informa quantos ficaram fora do escopo. Veja o passo a passo em [Gerenciar uso de licenças](https://docs.ecotrust.io/console/gerenciar-uso-de-licencas.md).

## Como ler os números

> [card] A aderência é a média dos padrões com veredito
>
> **01 · Média de padrões**
>
> A aderência de cada padrão é a parte das verificações aprovadas; a do baseline é a média dos padrões que têm veredito. Um padrão sem nenhuma verificação fica de fora da média, em vez de contar como zero.

> [card] Sem resultado não é aprovado
>
> **02 · Sem resultado**
>
> Controle sem resultado não aprova nem reprova: fica fora da conta. Com poucas verificações, a tela não calcula taxa e mostra a contagem (*3 de 6*). Ao citar a aderência, cite junto a *Verificação em dia*, que diz quanto do parque foi de fato verificado.

> [card] Controle aprovado entra como Informativa
>
> **03 · Importação de postura**
>
> Na importação de postura de nuvem, um controle reprovado na origem entra como **Confirmada**; um aprovado entra como **Informativa**, já com status **Corrigida**. É registro de conformidade, não remediação do período.

> [card] A ocorrência pertence ao primeiro scan que a trouxe
>
> **04 · Deduplicação**
>
> A mesma ocorrência vinda de vários scans vira um registro único, atribuído ao primeiro scan que a importou. Para saber se ela persiste, compare as listas dos dois scans.

O que o número conta em cada nível do Dashboard, do padrão à conta de nuvem, está em [Os números mudam quando você desce](#os-números-mudam-quando-você-desce).

## Glossário

| Termo | Significado no módulo |
| - | - |
| **Baseline declarado** | O padrão de configuração que a organização definiu como esperado. Numa conta de nuvem, é o que os controles da Postura da nuvem verificam: política de acesso, criptografia, retenção e identidade. |
| **Severidade** | Faixa de gravidade de uma ocorrência isolada: crítica, alta, média, baixa ou informativa. Não é a nota de 0 a 10, que é o CVSS. |
| **Aderência** | Parte das verificações aprovadas. Por padrão, e para o baseline, a média dos padrões com veredito. |
| **Padrão** | Grupo de controles avaliados juntos: Cobertura de controle, Hardening do ativo, Regras da empresa e Postura da nuvem. |
| **Meta** | Porcentagem que um grupo ou um controle precisa atingir, definida em Config › Controles. |
| **Recorte** | Parte do parque, como um ambiente ou grupo de ativos, que recebe uma meta própria, diferente da meta padrão do controle. |
| **Ativo apurado** | Ativo que entrou no cálculo de conformidade. É o denominador do percentual. |
| **Playbook** | Serviço com sequência definida, formulário de escopo e aprovação humana antes de agir. |
| **AWU** | Agent Work Unit. Unidade de cobrança do trabalho do agente. A ficha de cada serviço mostra o custo de cada tarefa. |
| **Artefato** | Saída persistida de uma execução: relatório em PDF ou página HTML, com autor e data. |
| **Scan importado** | O pacote de ocorrências que uma execução criou dentro de um ambiente. |
| **Ciclo CTEM** | Ciclo de gestão contínua de exposição. A régua no topo do Dashboard marca com traço violeta as fases que este módulo cobre: Escopo, Descoberta, Validação e Mobilização. |


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