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

# Primeiros passos no Inventory

> O que o Inventory faz, o que preparar antes da primeira coleta, como entrar no módulo e onde fica cada coisa.

Este tutorial leva você do primeiro acesso à primeira coleta lida no painel.

## 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 na aba Baseline da [Config](https://docs.ecotrust.io/modulos/inventory/configurar-o-escopo.md). 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. |

## Rodar o primeiro inventário

Com os [requisitos](#antes-da-primeira-execução) do artigo `000112` conferidos e o CONNECT e a credencial prontos, siga [Executar o Inventário de Ativos](https://docs.ecotrust.io/modulos/inventory/inventario-de-ativos.md). O que funciona igual em todos os módulos (o Agent Work, o agendamento, a paleta de comandos, os artefatos e a observabilidade) está nas páginas do [EcoTrust OS](https://docs.ecotrust.io/ecotrust-os/executar-um-servico.md).

## Ler o resultado

Ao fim da coleta, o ativo aparece no [painel do Inventory](https://docs.ecotrust.io/modulos/inventory/painel.md). Para entender o que cada número conta, veja [Como ler os números do Inventory](https://docs.ecotrust.io/modulos/inventory/como-ler-os-numeros.md).


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