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

> O manual completo do Inventory, 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 Inventory mantém o inventário detalhado dos seus ativos: o que cada servidor e cada estação tem instalado, em que versão, com que hardware e com que controles de segurança. A coleta é feita pelo CONNECT, o conector da EcoTrust instalado no seu ambiente, sem agente no host, por SSH (*Secure Shell*) no Linux e por WinRM e WMI (*Windows Remote Management* e *Windows Management Instrumentation*) no Windows. Sobre esse inventário o módulo mostra o ciclo de vida das versões de sistema, a baseline de software e a prontidão do parque para auditoria, medida por requisitos do NIST CSF (*Cybersecurity Framework* do *National Institute of Standards and Technology*) e dos CIS Controls (*Center for Internet Security*).

**Índice**

1. [O que o Inventory faz](#o-que-o-inventory-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 o Inventário de Ativos](#executar-o-inventário-de-ativos)
   * [O inventário de host no canvas](#o-inventário-de-host-no-canvas)
   * [A paleta de comandos](#a-paleta-de-comandos)
5. [Dashboard](#dashboard)
   * [A coluna de indicadores](#a-coluna-de-indicadores)
   * [Horizonte do Parque](#horizonte-do-parque)
   * [Por onde começar e Listas](#por-onde-começar-e-listas)
   * [Ativos e o dossiê](#ativos-e-o-dossiê)
   * [Cobertura da coleta](#cobertura-da-coleta)
   * [Baseline de software](#baseline-de-software)
   * [Governança](#governança)
6. [Artefatos](#artefatos)
   * [Gerar um artefato](#gerar-um-artefato)
7. [Catálogo de Serviços](#catálogo-de-serviços)
   * [Inventário de Ativos](#inventário-de-ativos)
8. [Observabilidade](#observabilidade)
   * [Serviços](#serviços)
   * [Threads](#threads)
9. [Config](#config)
   * [Operação](#operação)
   * [Baseline](#baseline)
   * [MCP](#mcp)
   * [Licenças](#licenças)
10. [Como ler os números](#como-ler-os-números)
11. [Glossário](#glossário)

## O que o Inventory faz

O módulo trabalha em quatro frentes, na ordem em que o trabalho acontece:

> [card] Coleta
>
> Entra em cada host pelo CONNECT, com a credencial que você escolhe, e levanta hardware, sistema, rede, segurança, usuários, serviços, atualizações e pacotes instalados.

> [card] Dossiê
>
> Organiza o que foi coletado de cada ativo em até 15 categorias, com a data de cada coleta, e mostra quais categorias ainda faltam naquele ativo.

> [card] Ciclo de vida
>
> Cruza a versão de sistema de cada ativo com o catálogo público endoflife.date e separa o que já saiu de suporte, o que vai sair e o que não tem data.

> [card] Governança
>
> Compara o parque com a baseline de software que você define e com cinco requisitos de inventário do NIST CSF 2.0 e do CIS Controls v8, um a um.

Um ativo passa a contar como **inventariado** quando tem ao menos uma coleta registrada no painel. Cada nova coleta do mesmo host atualiza o mesmo ativo, e é a data da última coleta que o módulo compara com o prazo definido na aba Baseline da Config.

### Antes da primeira execução

Os requisitos para colocar o Inventory em operação estão no artigo [Requisitos do Inventory](https://ecotrust.desk.ms/?LoginPortal#:eyJBcHAiOiJQb3J0YWwiLCAiSXRlbSI6IkJhc2VDb25oZWNpbWVudG8iLCAiRGFkb3MiOiB7IlAiOiB7IlBlc3F1aXNhIjogIjAwMDExMiJ9fX0=), número `000112` da base de conhecimento do portal de atendimento EcoTrust. O portal pede login. Consulte-o antes da primeira execução e sempre que um ambiente novo entrar no escopo.

Em resumo, o que precisa estar pronto:

* **CONNECT instalado e operacional** no ambiente dos hosts. O ambiente em que os ativos ficam cadastrados é o ambiente desse CONNECT.
* **Credencial de acesso aos hosts**: usuário e senha ou chave SSH para Linux, usuário e senha do Windows para WinRM-WMI. A credencial pode estar salva no painel ou ser digitada no formulário. Para instâncias da AWS (*Amazon Web Services*) existe também o transporte SSM (*AWS Systems Manager*).
* **Prazo de coleta** conferido em [Config, aba Baseline](#metas-e-limiares). O padrão do painel é de 7 dias, com exceção por ambiente quando precisar.

## Como acessar o módulo

**Step 1**

Na barra superior do painel, clique em **Gestão de Ativos**, o primeiro grupo depois de *EcoTrust Core*.

**Step 2**

No menu que abre, clique em **Inventory**, a segunda entrada, com a descrição *Inventário detalhado, com SBOM* (*Software Bill of Materials*, a lista de componentes de software de cada ativo).

![Menu Gestão de Ativos aberto na barra superior, com as entradas Radar e Inventory.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/01-menu.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=25ae103ea97b50bde868cc565a8b3d45)

O menu do grupo Gestão de Ativos traz o Radar e o Inventory.

**Step 3**

O módulo abre na última aba usada. Para começar pelo panorama, clique em **Dashboard**, na tira de abas logo abaixo da barra superior.

## Onde fica cada coisa

A tela do módulo tem três regiões fixas: a barra superior do painel, a **tira de abas** do módulo logo abaixo dela e a área de trabalho, que muda com a aba escolhida. No pé da tela fica a barra de estado, com o selo *AO VIVO*, a data da última coleta, o limiar de coleta em vigor e a fonte do ciclo de vida.

![Tira de abas do Inventory com Dashboard, Agent Work, Artefatos, Catálogo de Serviços, Observabilidade e Config.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/02-tira-abas.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=7474e41e6079537218794185ada9e8a5)

A aba aberta fica sublinhada em laranja. O ponto antes de Agent Work indica uma conversa em andamento.

![Área de trabalho do Dashboard em três colunas, com a barra de estado no pé.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/02b-panorama.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=c8fc04882b7948171d06551d9782ec3a)

No Dashboard, a área de trabalho tem três colunas: indicadores, Horizonte do Parque e atalhos. A barra de estado fica no pé.

| Aba | Posição na tira | Para que serve |
| - | - | - |
| Dashboard | Primeira | O parque inteiro: composição, ciclo de vida, listas de ativos, cobertura da coleta, baseline de software e governança. |
| Agent Work | Segunda | A conversa com o agente do módulo, onde o inventário é configurado, aprovado e acompanhado. |
| Artefatos | Terceira | Os relatórios e arquivos gerados pelo agente. |
| Catálogo de Serviços | Quarta | A ficha do serviço Inventário de Ativos. |
| Observabilidade | Quinta | O histórico das execuções e das conversas com o agente. |
| Config | Sexta | Ambientes alvo, prazo de coleta, baseline de software e MCPs do agente. |

## Agent Work

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

É onde o inventário é pedido, configurado, aprovado e acompanhado. Numa conversa nova, o campo de mensagem fica no centro da tela, com o atalho *Inventário de Ativos* logo abaixo. Quando o agente monta o plano, a tela se divide: a conversa vai para a coluna da esquerda e o canvas ocupa a direita.

| Controle | Onde está | O que faz |
| - | - | - |
| Agendamentos | Cabeçalho da conversa, primeiro ícone (calendário) | Abre as execuções agendadas do módulo. |
| Histórico | Cabeçalho, segundo ícone (relógio) | Lista as conversas anteriores. |
| Nova | Cabeçalho, à direita dos ícones | Abre uma conversa nova, sem os formulários da anterior. |
| plan mode | Selo abaixo do nome do agente | Indica que há um plano montado aguardando a sua aprovação. |
| Campo de mensagem | Pé da conversa | Recebe pedidos em português. Digitando `/`, abre a paleta de comandos. |

### Executar o Inventário de Ativos

O agente pede os parâmetros em formulários curtos, um por vez, monta o plano e só coleta depois do **Aprovar**. São sete passos:

**Step 1**

Clique em **Nova**, no cabeçalho da conversa, e escreva *"Quero fazer um inventário de ativos"*, ou clique no atalho **Inventário de Ativos**, abaixo do campo de mensagem. Antes, confira os [requisitos do módulo](#antes-da-primeira-execução) (artigo `000112`). O botão **Executar** da ficha do serviço, no [Catálogo de Serviços](#catálogo-de-serviços), leva ao mesmo ponto.

**Step 2**

**CONNECT.** Escolha o conector na lista e clique em **Confirmar**. O agente testa a conexão e avisa quando o CONNECT respondeu. Escolha com atenção: o ambiente dos ativos é o ambiente desse CONNECT.

![Mensagem do agente explicando o formulário e o passo Selecione um CONNECT com a lista e o botão Confirmar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/25-connect.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=7af18db7ab6c3041477265c6ed9b8962)

Antes do primeiro formulário o agente resume o que vai pedir. O Confirmar fica abaixo da lista.

**Step 3**

**Alvos.** Marque os hosts na lista dos ativos do ambiente e clique em **Confirmar**. O campo *Buscar ativos...*, no topo da lista, filtra pelo nome. O alvo pode ser uma faixa (subnet ou IP-range), um IP, um nome de host ou um grupo de ativos. Quando todos os alvos são hosts definidos, o agente pula a fase de descoberta e segue direto para a coleta.

![Passo de alvos com a lista de hosts do ambiente, um deles marcado, e os botões Cancelar e Confirmar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/26-alvos.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=da1b7b0cefb086e7fd65aaa3b11d6964)

Cada linha é um ativo do ambiente do CONNECT escolhido. O nome do ambiente aparece ao lado do título do campo.

**Step 4**

**Credencial.** Em *Credencial*, escolha uma credencial salva ou *Inserir manualmente*. Com credencial salva, o formulário pede só a porta. Inserindo manualmente, ele pede o *Transporte* (SSH, WinRM-WMI ou SSM), o usuário, o tipo de autenticação (usuário e senha ou chave privada SSH), a senha ou a chave e a porta. A porta padrão do SSH é a 22. Clique em **Confirmar**.

![Passo Quais credenciais usar para acessar os hosts, com Credencial em Inserir manualmente e os campos de transporte, usuário, tipo de autenticação, senha e porta.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/27-credencial.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=aae48bc510cf95bed6fe01f5f678eddd)

Com Inserir manualmente, os campos do transporte aparecem abaixo da lista. A senha não é exibida depois de confirmada.

**Step 5**

**Quando rodar.** Clique em **Executar agora** para uma execução única, ou em **Agendar**, ao lado, para escolher data, hora e recorrência antes do plano.

![Mensagem do agente e o passo Quando rodar com os botões Executar agora e Agendar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/28-quando.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=92e14d515cb8282dfb260d37fd4464ac)

Executar agora leva direto ao plano. Agendar abre a data, a hora e a recorrência.

**Step 6**

**Revise o plano**, que aparece no canvas, à direita. Ele mostra o escopo selecionado (CONNECT, ambiente dos ativos, alvos, título do inventário, credenciais e agendamento), cada linha com o botão **Editar**, e as duas etapas da execução: *Execução do Inventário* e *Importar do Inventário*.

![Plano do serviço Inventário de Ativos no canvas, com o escopo selecionado, os botões Editar e as etapas do plano.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/29-plano.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=7566ede9c3426615932e4715bbef53fc)

Confira a linha Agendamento antes de aprovar. Editar volta ao formulário daquela linha.

**Step 7**

**Aprove.** Clique em **Aprovar**, na coluna da conversa. **Revisar** reabre os formulários e **Cancelar** descarta o plano sem coletar nada.

![Bloco Revisar e aprovar com os botões Aprovar, Revisar e Cancelar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/29b-aprovar.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=889fc7f1ff2cb6b7ab3feacf38bd17d2)

O Aprovar fica no pé da conversa, acima de Revisar e Cancelar.

Depois do Aprovar, o agente acompanha a execução na conversa, com um bloco *acompanhamento da execução* a cada etapa. A execução termina quando ele informa que os passos foram concluídos sem falhas e marca o serviço como *concluído*, no pé da conversa. O registro fica na [Observabilidade](#observabilidade) e o ativo aparece atualizado no [Dashboard](#dashboard).

![Coluna da conversa com os blocos de acompanhamento da execução e a mensagem de conclusão sem falhas.](https://mintcdn.com/eco-trust/j6nVO8DyNWKUzEk8/images/inventory/31-acompanhamento.png?fit=max\&auto=format\&n=j6nVO8DyNWKUzEk8\&q=85\&s=8b5480cb5fef9e32535e7bf2e4d541af)

A última mensagem confirma os passos concluídos e o selo concluído fecha a execução.

### O inventário de host no canvas

Ao fim da coleta, o agente monta no canvas o painel do host coletado:

![Painel do host no canvas, com endereço, sistema, total de pacotes, contadores, especificação do sistema, superfície de rede e itens de inicialização.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/30-canvas-host.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=f4bb634061834e3d080bdccf3a7e07f1)

O cabeçalho traz o endereço, o nome e o sistema. À direita, o total de pacotes inventariados e o selo de atenção.

| Bloco | O que mostra |
| - | - |
| Pacotes | O total de pacotes instalados, com os pacotes pip à parte. |
| RAM / CPU | A memória total e os núcleos e threads do processador. |
| Portas escuta | As portas em que o host aceita conexões e quantos endereços IP ele tem. |
| Patches falta | As atualizações disponíveis ainda não aplicadas, com as críticas à parte. |
| Contas | As contas locais do host, com as administrativas à parte. |
| Serviços | Os serviços do host, com os que estão em execução à parte. |
| Persistência | Os itens que iniciam junto com o sistema, como serviços e tarefas agendadas. |
| Achados | Os pontos que a coleta marcou para atenção, com a contagem por severidade. |
| Especificação do sistema | Sistema, versão, kernel, arquitetura, processador, disco, fabricante, modelo, BIOS e último boot. |
| Superfície de rede | As portas e interfaces de rede do host e o servidor DNS (*Domain Name System*) que ele usa. |
| Itens de inicialização | Os primeiros itens que iniciam com o sistema e a contagem dos demais. |

Depois da coleta, a conversa continua aberta para perguntas sobre o resultado, como *"que tipo de autenticação foi usado nesse host?"*. O agente responde com o que ficou registrado na execução.

### A paleta de comandos

Digite `/` no campo de mensagem para abrir a paleta. A lista filtra à medida que você digita.

![Paleta de comandos aberta sobre o campo de mensagem, com gerar-csv, gerar-pdf, gerar-docx, insight e primeira-acao.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/24-paleta.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=2c6f6a2857434396dcd9160fc647be58)

A paleta abre acima do campo de mensagem.

| Comando | O que faz |
| - | - |
| `/gerar-csv, /gerar-pdf, /gerar-docx` | Geram um arquivo no formato pedido, que vai para a aba Artefatos. |
| `/insight` | Um resumo da situação atual do parque. |
| `/primeira-acao` | A primeira ação de alto impacto a tomar. |
| `/listar-skills` | Lista as skills disponíveis no módulo. |
| `/usar-skill &lt;nome&gt;` | Executa uma skill do módulo pelo nome. |
| `/mcp &lt;url&gt;` | Solicita a conexão de um MCP externo pela URL. Ver [MCP](#mcp). |
| `/mcp-list` | Lista os MCPs aprovados neste módulo. |
| `/clear` | Limpa o chat e inicia uma conversa nova. |

## Dashboard

> [!NOTE]
>
> **Onde fica:** Tira de abas, **primeira posição**, à esquerda de *Agent Work*.

É o panorama do parque. A tela tem três colunas: à esquerda, os indicadores; no centro, o **Horizonte do Parque**; à direita, **Por onde começar**, as listas e o atalho para o agente. No pé da coluna da direita fica o selo de **Governança**. As colunas laterais recolhem pelos botões `«` e `»`, no topo de cada uma. Cada tarefa do Dashboard tem um guia passo a passo, a partir de [Encontrar os ativos que pedem atenção](https://docs.ecotrust.io/modulos/inventory/encontrar-ativos.md).

### A coluna de indicadores

![Coluna de indicadores com Ciclo CTEM, Ativos inventariados, Versões de sistema, Ciclo de vida, Impacto Negócio e Indicadores.](https://mintcdn.com/eco-trust/m1bv96smFGdLdCmY/images/inventory/painel-coluna-esquerda.png?fit=max\&auto=format\&n=m1bv96smFGdLdCmY\&q=85\&s=21a0d468f40a1b8ff60bd28b3871b027)

Os rótulos sublinhados abrem uma explicação ao passar o mouse.

| Bloco | O que mostra |
| - | - |
| Ciclo CTEM | As cinco fases do ciclo de gestão contínua da exposição (CTEM, *Continuous Threat Exposure Management*), com Escopo e Descoberta acesas: são as fases que o Inventory cobre. |
| Ativos inventariados | Os ativos com ao menos uma coleta registrada, em quantos ambientes e versões de sistema. Embaixo: quantos têm software proibido, quantos estão fora de suporte e quantos saem de suporte em 12 meses. |
| Versões de sistema | Os ativos por versão do sistema operacional: as cinco versões com mais ativos e as demais somadas em *Outros*. |
| Ciclo de vida | Os ativos pela situação do suporte da versão (fora, saem, com suporte, sem data) e, embaixo, quantos saem de suporte em cada semestre. |
| Impacto Negócio | Os ativos pelo impacto de negócio cadastrado em cada um: alto, médio e baixo. |
| Indicadores | *Dentro do limiar de coleta* (ativos coletados dentro do prazo), *Dossiê completo* (ativos com as 15 categorias coletadas), *Com data de fim de suporte* e *Divergem do grupo* (ativos com dois ou mais títulos que quase nenhum outro da mesma família e ambiente tem). |

### Horizonte do Parque

O centro da tela mostra o parque em duas visões, escolhidas pelos botões **Composição** e **Ciclo de vida**, no topo do bloco. No pé do bloco ficam os controles de zoom (`−`, a porcentagem, `+`), o **encaixar**, que ajusta o conteúdo à área, o botão de tela cheia e a ajuda (`?`).

**Composição** é o parque pelo que ele é, um gráfico por informação. Cada marca abre os ativos que ela conta.

![Visão Composição com os gráficos Sistemas do parque, Físico ou virtual, Memória e Coletados por SNMP.](https://mintcdn.com/eco-trust/m1bv96smFGdLdCmY/images/inventory/painel-composicao.png?fit=max\&auto=format\&n=m1bv96smFGdLdCmY\&q=85\&s=5818dd3682f2e863802dfd79be7593b9)

Em Sistemas do parque, a área de cada bloco é o número de ativos daquela versão, numa faixa por família.

| Gráfico | O que mostra |
| - | - |
| Sistemas do parque | As versões de sistema, numa faixa por família (Linux, Windows). A área de cada bloco é o número de ativos. |
| Físico ou virtual | Uma célula por ativo, físico ou virtual, inferido pelo modelo que a coleta trouxe. |
| Memória e Disco | A memória total e o tamanho do primeiro disco de cada ativo, em faixas. |
| Processador | O fabricante do processador. |
| Coletados por SNMP | Os equipamentos de rede coletados por SNMP: o fabricante, as interfaces ativas e as categorias que a coleta trouxe. Memória, disco e processador não se aplicam a eles. |
| Proteção | Antivírus, firewall e BitLocker: em quantos ativos a coleta trouxe cada controle. |
| Baseline de software | Os ativos com algum título proibido e os títulos do parque por decisão: aprovados, proibidos e sem decisão, com os nomes dos proibidos. |
| Modelo e Arquitetura | Os modelos de equipamento mais frequentes e a arquitetura que o sistema informa. |
| Software mais presente | Os títulos instalados em mais ativos, com a contagem de cada um. |
| Domínio | O domínio ou grupo de trabalho de cada ativo. |

**Ciclo de vida** põe cada versão de sistema numa linha do tempo, com a marca *HOJE*. As versões ficam agrupadas por situação: *Fora de suporte*, com há quanto tempo o suporte acabou, *Saem de suporte em 12 meses*, *Com suporte* e *Sem data de fim de suporte*, para as versões fora do catálogo. A legenda, no pé do bloco, marca os ativos com software proibido, com coleta vencida, sem data de coleta e sem sinal, e o suporte gratuito.

![Visão Ciclo de vida com a linha do tempo das versões de sistema, a marca Hoje e as versões agrupadas pela situação do suporte.](https://mintcdn.com/eco-trust/I5_MnfEoDqtB3QcV/images/inventory/painel-ciclo-de-vida.png?fit=max\&auto=format\&n=I5_MnfEoDqtB3QcV\&q=85\&s=f8f74928ea1f3e115e656958123ee3a0)

A barra de cada versão termina no fim do suporte. O texto à direita diz há quanto tempo ele acabou.

### Por onde começar e Listas

A coluna da direita traz os atalhos de trabalho. **Por onde começar** lista os grupos de ativos que pedem atenção, do mais urgente para o menos urgente. Clicar num item abre a lista de Ativos já filtrada por ele.

![Coluna da direita com Por onde começar, Listas e o botão Pedir ao agente sobre o parque.](https://mintcdn.com/eco-trust/m1bv96smFGdLdCmY/images/inventory/painel-coluna-direita.png?fit=max\&auto=format\&n=m1bv96smFGdLdCmY\&q=85\&s=c5eb74f596dd2583203f6b7696ae7d40)

Cada linha traz o número à esquerda e a seta de abrir à direita.

| Item | O que reúne |
| - | - |
| Com software proibido | Ativos com ao menos um título que a baseline de software marca como proibido. |
| Fora de suporte | Ativos numa versão cujo suporte de segurança gratuito do fabricante já acabou. Extensão paga não conta: ESU (*Extended Security Updates*), ESM (*Expanded Security Maintenance*) ou ELS (*Extended Lifecycle Support*). |
| Saem de suporte em 30 dias | Ativos cuja versão perde o suporte no próximo mês. |
| Com coleta vencida | Ativos com a última coleta além do limiar de coleta da Config. |
| Sem data de coleta | Ativos sem data de coleta registrada. |
| Divergem do grupo | Ativos com títulos que quase nenhum outro da mesma família e ambiente tem. |

Abaixo, **Listas** abre as tabelas do parque: [Ativos](#ativos-e-o-dossiê), *Coletados por SNMP* (a mesma lista, só com os equipamentos de rede), [Cobertura da coleta](#cobertura-da-coleta) e [Baseline de software](#baseline-de-software). Por último, **Pedir ao agente sobre o parque** oferece dois pedidos prontos à inteligência artificial (IA) do módulo: *Analisar o parque com IA* e *Plano para o que sai de suporte*.

Nas listas Ativos, *Coletados por SNMP* e Cobertura da coleta, a coluna Ativo mostra o endereço abaixo do nome, e Sistema e Ambiente ficam em colunas próprias. Quando falta largura, as colunas menos importantes saem primeiro e a contagem informa quais não cabem, sem rolagem horizontal.

### Ativos e o dossiê

A lista de Ativos ordena o parque pelo fim do suporte, o mais antigo primeiro, com os sem data no fim. Acima da tabela ficam o filtro de ambiente e os filtros *Coleta vencida*, *Fora de suporte*, *Software proibido* e *Sem dono*, cada um com a contagem. O campo de busca, no topo, procura por ativo, endereço, modelo ou sistema (atalho *Ctrl K*), e **Exportar CSV**, à direita, baixa a lista como planilha em valores separados por vírgula. A seta à esquerda do título volta ao Horizonte do Parque.

Clicar numa linha abre o resumo do ativo na coluna da direita: sistema, suporte, coleta, impacto, modelo, quantas categorias foram coletadas, o software proibido encontrado e o desvio do grupo. Dali, **Analisar o ativo com IA** pede ao agente uma análise daquele ativo e **Abrir o ativo** abre o dossiê completo.

![Lista de Ativos com o filtro de ambiente, os filtros, a tabela e, à direita, o resumo do ativo selecionado com os botões Analisar o ativo com IA e Abrir o ativo.](https://mintcdn.com/eco-trust/I5_MnfEoDqtB3QcV/images/inventory/painel-lista-ativos.png?fit=max\&auto=format\&n=I5_MnfEoDqtB3QcV\&q=85\&s=3805eff23822f6eb07ed6c51fe0d829b)

O selo EOL (End of Life, fim de vida) ao lado da versão marca o sistema fora de suporte. O resumo do ativo abre à direita.

O **dossiê** reúne tudo o que a coleta trouxe do ativo. No topo ficam o nome, o endereço e o ambiente, o selo da situação do suporte e o seletor de categorias (*13 de 15 categorias*, por exemplo). Embaixo, os campos Sistema, Suporte, Coleta, Impacto e Modelo e uma aba por categoria coletada. Cada aba diz quando aquela categoria foi coletada. O campo *buscar no ativo*, no topo, procura em todas as categorias.

Quando o dossiê não tem uma análise disponível, a coluna da direita fica recolhida no trilho **Contexto** para o ativo ocupar mais espaço. Clique no trilho para abrir a coluna. Quando há uma análise disponível, ela abre normalmente.

![Dossiê do ativo com o cabeçalho, os campos Sistema, Suporte, Coleta, Impacto e Modelo, as abas de categoria e a aba Hardware aberta.](https://mintcdn.com/eco-trust/I5_MnfEoDqtB3QcV/images/inventory/painel-dossie.png?fit=max\&auto=format\&n=I5_MnfEoDqtB3QcV\&q=85\&s=d8dbea6bc419297752a02ad2938a3a57)

Na linha Suporte, o dossiê mostra até quando vai a extensão paga, quando o fabricante oferece uma.

O seletor de categorias, no canto superior direito do dossiê, lista as 15 categorias que a coleta do Inventory busca. As que faltam naquele ativo aparecem com o quadrado vazado e explicam o número exibido.

![Seletor de categorias aberto com as 15 categorias que a coleta do Inventory busca.](https://mintcdn.com/eco-trust/I5_MnfEoDqtB3QcV/images/inventory/painel-categorias.png?fit=max\&auto=format\&n=I5_MnfEoDqtB3QcV\&q=85\&s=1e7f9b65fc04408fff2769d7957583e2)

Quando falta uma categoria, ela aparece com o quadrado vazado. Neste ativo de exemplo, as 15 foram coletadas.

As abas seguem as categorias: Hardware, Sistema, Identificação do Ativo, Rede, Segurança, Inventário Geral, KBs Instaladas (as atualizações do Windows, identificadas pelo número de KB, *Knowledge Base*), Usuários, Domínio, Serviços, Persistência, Ambiente, Pacotes e Bibliotecas, Drivers PnP e DLLs do Sistema. Em cada aba, os campos aparecem como fatos, com o rótulo acima do valor. A de **Segurança** traz os controles de proteção que a coleta encontrou no ativo, como o antivírus, o firewall e a criptografia de disco.

![Aba Segurança do dossiê com o antivírus e as informações de proteção que a coleta trouxe do ativo.](https://mintcdn.com/eco-trust/I5_MnfEoDqtB3QcV/images/inventory/painel-seguranca.png?fit=max\&auto=format\&n=I5_MnfEoDqtB3QcV\&q=85\&s=31efe42b5090dc11f3db34e041252d20)

Cada aba tem a data da coleta no canto superior direito.

### Cobertura da coleta

Mostra se cada ativo foi coletado dentro do prazo e com quantas categorias. Os filtros do topo separam *Além do limiar*, *Sem data*, *Parcial* e *Completa*. A tabela traz o ativo, o ambiente, a data da coleta, o limiar daquele ambiente, as categorias coletadas e o estado: *Completa* com as 15 categorias, *Parcial* com menos.

![Lista Cobertura da coleta com os filtros e a tabela de ativos, coleta, limiar, categorias e estado.](https://mintcdn.com/eco-trust/m1bv96smFGdLdCmY/images/inventory/painel-cobertura.png?fit=max\&auto=format\&n=m1bv96smFGdLdCmY\&q=85\&s=b563e08f692c3c46d063f7b3fe1125b8)

A coluna Limiar mostra o prazo do ambiente, que pode ter exceção na Config.

### Baseline de software

Lista todos os títulos de software encontrados no parque, do mais presente para o menos, com a marca do produto quando ela está disponível, o fornecedor, o número de versões, a decisão da baseline e em quantos ativos aparece. Os filtros do topo separam por tipo (títulos, pacotes pip, npm e jar, KBs) e por decisão (proibido, aprovado, sem decisão). Clicar num título abre, à direita, o fornecedor, a decisão, as versões encontradas, os ativos que o têm e o botão **Analisar o componente com IA**.

![Lista Baseline de software com os filtros por tipo e por decisão e a tabela de títulos.](https://mintcdn.com/eco-trust/I5_MnfEoDqtB3QcV/images/inventory/painel-baseline-de-software.png?fit=max\&auto=format\&n=I5_MnfEoDqtB3QcV\&q=85\&s=e4e931ee6882e6a9bcaaa5290054be71)

A coluna Baseline mostra a decisão de cada título. A decisão é tomada em Config, Baseline.

### Governança

O selo **Governança · Inventory**, no pé da coluna da direita, mostra quantos requisitos de inventário o parque cumpre, de quantos. Clicar nele abre o painel de prontidão para auditoria, com um requisito por linha, a referência do framework e o estado (*Atendido* ou *Pendente*). **detalhes** abre a regra e o que já foi verificado; a seta abre a lista dos itens pendentes. **Fechar governança**, no topo, volta ao Dashboard.

![Painel Governança Inventory com a prontidão para auditoria e os requisitos, cada um com a referência do framework e o estado.](https://mintcdn.com/eco-trust/m1bv96smFGdLdCmY/images/inventory/painel-governanca.png?fit=max\&auto=format\&n=m1bv96smFGdLdCmY\&q=85\&s=d9ea646cfa525bd9f4563aae6f5cef7b)

Requisitos sem dado contam no total, como pendentes.

| Requisito | Referência | Fica atendido quando |
| - | - | - |
| Inventário em dia | NIST CSF 2.0 ID.AM-01 | Todo o parque foi coletado dentro do limiar de cada ambiente. |
| Catálogo de software | NIST CSF 2.0 ID.AM-02 | Os títulos do parque têm versão e fornecedor. |
| Baseline de software | CIS v8 2.1 | Todos os títulos têm decisão, aprovado ou proibido. |
| Software não autorizado | CIS v8 2.3 | Nenhum título proibido está presente no parque. |
| Ativos com dono | CIS v8 1.1 | Todo ativo tem dono registrado. |

## Artefatos

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

Guarda os arquivos que o agente gerou no módulo: relatórios em PDF, planilhas, dados em JSON e os painéis do canvas salvos como HTML. Cada cartão traz a capa, o nome do arquivo, quem gerou e quando. O campo *Pesquisar artefatos...*, no topo, filtra pelo nome.

![Aba Artefatos com o botão Novo artefato no canto superior direito e a grade de arquivos gerados.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/23-artefatos.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=784e95a55b1145136d2ec9ce9683dd7c)

O botão Novo artefato fica no canto superior direito. As capas estão desfocadas nesta figura.

### Gerar um artefato

**Step 1**

Clique em **Novo artefato**, no canto superior direito.

**Step 2**

Escolha o formato no menu: **Gerar PDF**, **Gerar XLSX**, **Gerar CSV** ou **Gerar DOCX**.

**Step 3**

O agente monta o arquivo com os dados do módulo e ele aparece na grade quando fica pronto. O mesmo vale para os comandos `/gerar-pdf`, `/gerar-csv` e `/gerar-docx` do Agent Work.

Guarde o arquivo baixado, não o endereço do download: o link de download tem validade curta.

## Catálogo de Serviços

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

Mostra os serviços do módulo. O Inventory tem um, o **Inventário de Ativos**, um playbook público. Os filtros *Todos*, *Público*, *Privado* e *Comunidade* ficam acima dos cartões, e **Solicitar novo serviço**, no canto superior direito, pede um serviço que o catálogo ainda não tem.

### Inventário de Ativos

Coleta software, hardware e serviços de hosts Windows e Linux pelo CONNECT e importa o resultado na plataforma. Inclui a descoberta opcional dos ativos antes da coleta e a validação automática da qualidade do resultado ao final. **Ver detalhes**, no pé do cartão, abre a ficha:

![Ficha do serviço Inventário de Ativos com as tarefas Descoberta de Ativos e Inventário de Ativos, os pré-requisitos e os botões Fechar e Executar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/19-ficha-servico.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=5ab9d83c19b99b529f70c141f1adf725)

A ficha lista as tarefas e o que precisa ter antes. Executar fica no rodapé, à direita de Fechar.

| Tarefa | O que entrega |
| - | - |
| Descoberta de Ativos | Cada host que respondeu na faixa alvo, com portas TCP abertas, sistema operacional inferido, nome quando resolvível e classificação (servidor, estação ou dispositivo de rede). |
| Inventário de Ativos | Cada host alcançado com software, hardware e serviços coletados e importados, e cada host não alcançado registrado com o motivo. |

A ficha também mostra o nível do serviço, o custo da tarefa e os pré-requisitos: **CONNECT instalado e operacional** e **alvos** (subnet, IP-range, IP ou grupo de ativos). **Ver ficha completa** expande o restante. **Executar** leva ao Agent Work com o serviço já escolhido; o passo a passo está em [Executar o Inventário de Ativos](#executar-o-inventário-de-ativos).

## Observabilidade

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

É o histórico do módulo, em duas sub-abas no topo: **Serviços** e **Threads**.

### Serviços

Lista as execuções do serviço, da mais recente para a mais antiga, cada uma com o identificador da execução e a data. Os filtros, numa linha acima da lista, são: status (*Em andamento*, *Sucesso*, *Erro*, *Cancelado*), serviço, ordem, período e usuário. **Limpar** desfaz os filtros.

![Lista de serviços realizados filtrada por status Sucesso, com as execuções do Inventário de Ativos.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/20-obs-lista.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=a37aa9ef3f8f93d269f1f5ff48d15fa1)

Filtrada por Sucesso. A seta à esquerda de cada linha abre o registro.

O registro aberto mostra quem executou, quando, o status, os alvos e o resumo, e, em *Resultado*, os parâmetros usados (ambiente e alvos) e a configuração da execução, como a porta SSH e o título do inventário. Quando a coleta não autenticar nos hosts, o campo **Erro** informa quantos foram afetados e orienta a conferir o usuário, a senha ou a chave e se o acesso remoto está liberado antes de executar de novo.

![Registro de uma execução concluída com sucesso, com serviço, módulo, quem executou, status, alvos, parâmetros e configuração.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/21-obs-registro.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=0f7a5ff47d154bb00d42e9c487814aea)

O status Concluído com sucesso confirma a execução. Os parâmetros ficam em Resultado.

### Threads

Lista as conversas com o agente, cada uma com a data, o estado, o número de turnos e quem conversou. Clicar numa conversa abre, à direita, os contadores de agentes, chamadas ao modelo, ferramentas, ações e skills, e a linha do tempo de cada turno.

![Lista de threads do agente com data, estado Concluído, turnos e usuário.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/22-threads.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=312900a7fd318a7ebcab4447ff37cb68)

A conversa selecionada fica com a borda laranja.

## Config

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

A configuração do módulo tem as abas **Operação**, **Baseline** e **MCP**, nessa ordem. Com quantidade de licenças contratada, **Licenças** aparece por último.

Na aba **Baseline**, assim que um valor muda, a barra de salvar aparece no pé da tela, com **Descartar**, que volta aos valores salvos, e **Salvar**. Depois de salvar, a tela mostra **Configuração salva**. Só o gestor salva: o analista avançado vê os valores sem editar, com o aviso de somente leitura no topo.

### Operação

A aba tem um bloco, **Escopo**, com os **Ambientes alvo**: os ambientes do painel que o módulo acompanha. A lista vem do painel, e esta aba só a mostra.

### Baseline

A aba tem dois blocos, nesta ordem: **Metas e limiares**, com o prazo de coleta, e **Lista com estado**, com a baseline de software.

#### Metas e limiares

Em **Coleta desatualizada**, define em quanto tempo uma coleta passa a contar como desatualizada, no painel inteiro e em cada ambiente.

| Campo | Onde está | O que faz |
| - | - | - |
| Inventário desatualizado depois de | Bloco Metas e limiares, em Coleta desatualizada | O prazo, em dias, semanas ou meses, a partir do qual a coleta de um ativo conta como vencida. |
| Exceções por ambiente | Abaixo do prazo, uma linha por ambiente | Cada ambiente mostra o prazo herdado do painel. **Definir exceção** dá a ele um prazo próprio, e **Herdar** volta ao prazo do painel. |

Use a exceção para ambientes com ritmo próprio: um laboratório coletado uma vez por mês não deve aparecer como vencido no mesmo prazo de um ambiente de produção coletado toda semana.

#### Lista com estado

É onde a baseline de software é decidida, em **Baseline de software**. A lista traz todos os títulos coletados no parque, cada um com o fornecedor, em quantos ativos aparece e os botões **aprovar**, **proibir** e **limpar**, à direita da linha. Os contadores do topo (*aprovar*, *proibir*, *sem decisão*) filtram a lista ao clicar, e o campo *buscar título coletado...* procura pelo nome.

Ao proibir um título, escreva a justificativa no campo da linha, como *"Acesso remoto não autorizado"*. Ela aparece no dossiê de cada ativo que tem o título. A decisão vale para o parque inteiro e alimenta o Dashboard, a lista de Baseline de software e os requisitos de governança.

### MCP

Lista os MCPs (*Model Context Protocol*) externos que o agente pode consultar, com o estado de cada um. Os filtros *Todos*, *Solicitado*, *Autorizado* e *Não autorizado* ficam no topo, e o botão **+ Novo MCP**, à direita deles. Cada linha traz o nome, o estado, se está autorizado neste módulo, a URL, quem solicitou e quando, o escopo e os botões de decisão (**Aprovar** ou **Rejeitar**) e **Detalhes**.

![Aba MCP com os filtros por estado, o botão Novo MCP e a lista de MCPs externos, cada um com estado, URL, solicitante, escopo e os botões de decisão.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/16-cfg-mcp.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=28a5658af76bb769753ef397faf89cd7)

O selo ao lado do estado diz se o MCP está autorizado aqui ou só em outro módulo.

Embaixo da lista fica o bloco **MCPs pré-aprovados**, com o botão **+ Adicionar**: uma conexão de qualquer membro para uma URL desta lista nasce aprovada, sem passar por um gestor. Solicitações, decisões e autorizações ficam registradas com trilha de auditoria.

#### Conectar um MCP

**Step 1**

Clique em **+ Novo MCP**. O formulário *Novo MCP externo* abre no topo da lista. Preencha o nome, opcional, e a URL do MCP, obrigatória, e clique em **Solicitar MCP**. A solicitação entra como *Solicitado*.

![Formulário Novo MCP externo com os campos de nome e URL e os botões Solicitar MCP e Cancelar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/17-mcp-novo.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=069e88c5bb02a22e82f410cc022908a3)

O formulário abre acima da lista. Cancelar fecha sem solicitar.

**Step 2**

O mesmo pedido pode ser feito no Agent Work, com `/mcp <url>` no campo de mensagem. `/mcp-list` lista os aprovados.

**Step 3**

Um gestor abre a linha por **Detalhes** e decide. Na ficha ficam a **Decisão do gestor**, o **Escopo de autorização** (*Somente este módulo*, *Módulos selecionados* ou *Todos os módulos*) com o botão **Salvar escopo**, os **Usuários** e a lista de **Ferramentas** do MCP, cada uma com **autorizar** e **bloquear**.

![Ficha de um MCP com a decisão do gestor, o escopo de autorização, os usuários e as ferramentas com os botões autorizar e bloquear.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/18-mcp-ficha.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=88b7e1928c4567ab9bda5e50cfb05367)

O escopo passa a valer quando o MCP está autorizado. Salvar escopo fica abaixo das três opções.

**Step 4**

Autorizado o MCP e as ferramentas, o agente passa a usá-lo nas conversas do módulo, conforme o escopo escolhido. Um usuário só usa o MCP quando ele está autorizado, tem permissão e já autenticou.

### Licenças

A aba **Licenças** aparece por último, só quando o Inventory 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 ativos ocupam as licenças. O módulo considera somente os ativos licenciados 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] Inventariado é ter coleta
>
> Um ativo conta como inventariado quando tem ao menos uma coleta registrada. Ativo descoberto na rede e nunca coletado não entra no total.

> [card] Dossiê completo tem 15 categorias
>
> Coleta parcial é a que trouxe menos de 15 categorias. O seletor do dossiê mostra quais faltam, e o ativo continua inventariado.

> [card] O prazo é por ambiente
>
> A coleta vence pelo prazo da aba Baseline da Config, 7 dias por padrão. Um ambiente com exceção usa o próprio prazo, que aparece na coluna Limiar.

> [card] Fora de suporte é o gratuito
>
> Conta o fim do suporte gratuito do fabricante, pelo endoflife.date. Extensão paga, como ESU, ESM ou ELS, não tira o ativo dessa contagem.

> [card] Sem data não é com suporte
>
> Sem data é a versão que o catálogo do endoflife.date não tem. Ela fica numa faixa própria e não soma com as versões que têm suporte.

> [card] Informado não é ligado
>
> Em Proteção, informado diz que a coleta trouxe aquele controle do ativo, e não o estado dele. O estado está na aba Segurança do dossiê.

> [card] Sem decisão conta no total
>
> A baseline de software só fica atendida quando todo título tem decisão. Títulos sem decisão contam como pendência de governança.

> [card] Grupo pequeno não compara
>
> Divergem do grupo compara ativos da mesma família e ambiente. Num grupo de um ativo só, o indicador mostra sem fonte em vez de zero.

## Glossário

| Termo | No Inventory |
| - | - |
| Ativo inventariado | Ativo com ao menos uma coleta registrada no painel. |
| CONNECT | O conector da EcoTrust instalado no seu ambiente. É ele que entra nos hosts para coletar. |
| Coleta | Uma passagem do inventário por um host. Cada categoria coletada guarda a própria data. |
| Limiar de coleta | O prazo a partir do qual a última coleta de um ativo conta como vencida. Definido na aba Baseline da Config, com exceção por ambiente. |
| Dossiê | Tudo o que a coleta trouxe de um ativo, organizado em até 15 categorias. |
| Categoria | Um grupo de dados da coleta: Hardware, Rede, Segurança, Pacotes e Bibliotecas e as demais. |
| Título | Um software encontrado no parque, contado uma vez mesmo com várias versões instaladas. |
| Baseline de software | A decisão sobre cada título do parque: aprovado, proibido ou sem decisão. |
| Software proibido | Título que a baseline marca como proibido, com a justificativa escrita em Config. |
| EOL | *End of Life*, fim de vida: a versão já não recebe suporte de segurança gratuito do fabricante. |
| ESU, ESM, ELS | Extensões pagas de suporte de segurança: *Extended Security Updates* (Microsoft), *Expanded Security Maintenance* (Ubuntu) e *Extended Lifecycle Support* (Red Hat). |
| endoflife.date | O catálogo público de datas de fim de suporte que o módulo consulta. |
| Impacto Negócio | O peso que o ativo tem para o negócio, cadastrado em cada ativo: alto, médio ou baixo. |
| Dono | O responsável registrado por um ativo. Ativo sem dono é pendência de governança. |
| Divergem do grupo | Ativo com dois ou mais títulos que quase nenhum outro da mesma família e ambiente tem. |
| KB | *Knowledge Base*: o número que identifica uma atualização do Windows. |
| SBOM | *Software Bill of Materials*: a lista dos componentes de software de um ativo. |
| MCP | *Model Context Protocol*: o padrão de conexão de fontes externas ao agente. |
| CTEM | *Continuous Threat Exposure Management*: o ciclo de escopo, descoberta, priorização, validação e mobilização. |


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