O INVENTORY é a solução definitiva para a gestão centralizada do inventário de máquinas corporativas, desenvolvida para ambientes que exigem alta visibilidade, rastreabilidade e segurança. O sistema transforma os dados de telemetria brutos coletados pela sua plataforma Wazuh (via SysCollector) em uma Interface Web Segura e Moderna.

O objetivo principal do INVENTORY é eliminar a "cegueira" sobre os ativos de TI, fornecendo às equipes de segurança, operações e compliance uma fonte única e confiável de informação sobre o estado, hardware, software e segurança de cada dispositivo.

A principal vantagem reside na utilização dos agentes nativos do Wazuh, eliminando a necessidade de instalar softwares adicionais nos endpoints e, consequentemente, reduzindo a superfície de ataque e o overhead operacional.

Os principais objetivos do sistema INVENTORY são: Centralizar informações de inventário de TI de dispositivos corporativos. • Garantir rastreabilidade e auditoria completa dos ativos. • Oferecer dashboards interativos para equipes de segurança e TI. • Permitir a integração com outros sistemas corporativos (CMDB, SIEM, DLP). • Agrupar Informações do Host como Processos, Serviços, Portas Abertas, Programas Instalados. • Suportar ambientes heterogêneos (Linux, Windows, servidores e estações de trabalho) em empresas de pequeno e médio porte.

A arquitetura do INVENTORY foi concebida em um modelo de três camadas, coleta, armazenamento e apresentação. Este desacoplamento permite que o coletor e a aplicação web sejam mantidos e escalados de forma independente. Adicionalmente, o uso de arquivos JSON locais como camada de armazenamento provê um repositório de dados simples e auditável, eliminando a complexidade e as dependências associadas a um banco de dados tradicional.

1. Coleta de Dados (Wazuh Collector): O processo se inicia com o componente coletor, que se conecta de forma segura à API REST do Wazuh Manager. Utilizando o módulo SysCollector, ele extrai informações dos agentes, incluindo detalhes de hardware, sistema operacional, configurações de rede, portas abertas, pacotes de software e processos em execução.

2. Armazenamento (JSON Data): Os dados coletados são processados, estruturados e armazenados localmente em arquivos no formato JSON. Cada arquivo corresponde a um dispositivo específico, sendo nomeado pelo seu hostname, o que facilita o consumo posterior pela aplicação web e permite a fácil manutenção.

3. Apresentação e Análise (Flask App): A aplicação web, desenvolvida em Flask, consome os arquivos JSON para exibir as informações em uma interface interativa. Os dados são apresentados em dashboards estatísticos, painéis de listagem de máquinas e relatórios detalhados, permitindo que as equipes de TI e segurança analisem, inspecionem e auditem o inventário de forma centralizada.

A arquitetura é materializada por dois componentes de software principais que trabalham em conjunto: o Módulo Coletor e a Aplicação Web. A solução adota o padrão de arquitetura MVC (Model-View-Controller), uma prática recomendada de segurança que impõe a separação de interesses. Ao isolar a lógica de manipulação de dados da camada de apresentação, o padrão MVC reduz a superfície de ataque e facilita a manutenção e o desenvolvimento seguro.

O Coletor de Dados é o principal responsável pela extração de informações, atuando como a interface de comunicação entre o sistema INVENTORY e o ambiente WAZUH. Sua função é automatizar a coleta e a estruturação dos dados de inventário.

Interage com a API do Wazuh seguindo os passos abaixo:

• JWT Authentication: Obtém um token de acesso para requisições autenticadas.
• Listagem de Agentes: Recupera os dispositivos monitorados via API.
• Inventory Collection: Extrai especificações de hardware, detalhes do sistema operacional, informações de rede e portas abertas para cada agente.
• Classificação de Status: Marca os dispositivos de acordo com status da última sincronização, entre ativos e inativos.
• Local Storage: Grava arquivos JSON estruturados, nomeados de acordo com o hostname de cada dispositivo.

Dados Coletados:

Informações Básicas
    Hostname
    Agent ID
    Sistema Operacional
    Arquitetura
    Serial da placa
    Última varredura
Hardware
    CPU
    Núcleos
    Memória RAM
Rede
    Interfaces de rede
    Portas de rede abertas
    Configurações de rede
Software
    Pacotes instalados
    Processos em execução
Classificação de Atividade
    Dispositivos classificados como ativos ou inativos conforme a última sincronização.
Grupos do WAZUH

A Aplicação Web é a camada de processamento, gerenciamento, visualização e gestão da solução, fornecendo a interface com a qual os usuários interagem para analisar o inventário.

Acessível via navegador, com as seguintes funcionalidades:

• Autenticação Segura
  • Senhas protegidas com hash bcrypt
  • Bloqueio de IP após tentativas falhas configuráveis
  • Expiração automática da sessão (ex: 30 minutos)
  • MFA TOTP
• Statistical Dashboard
  • Total de máquinas cadastradas, ativas e inativas
  • Distribuição de Sistemas Operacionais
  • Tipos de processadores e memória RAM
  • Portas de Rede mais comun
  • Serviços
  • Processos com maior repetição
• Painel de Máquinas
  • Lista completa de dispositivos com filtros avançados
• Busca Avançada
  • Pesquisa por IP, sistema operacional, hardware ou outros critérios
• Detalhes da Máquina
  • Visão detalhada dos dados coletados para cada host

A organização lógica do sistema se reflete em uma estrutura de diretórios clara e bem definida, projetada para separar a aplicação, os dados, os recursos estáticos e os utilitários. Essa separação facilita a manutenção, a escalabilidade e a aplicação de controles de segurança.

A estrutura do projeto separa a aplicação, os dados e os utilitários de gestão:

INVENTORY/                        # Diretório raiz do projeto
├── app.py                        # Ponto de entrada principal da aplicação Flask
├── data/                         # Dados persistentes da aplicação
│   ├── auth/
│   │   └── logins.json           # Credenciais de usuários e registros de login
│   └── inventory/                # Inventário de agentes/máquinas
│       ├── agent_1.json
│       ├── agent_2.json
│       └── agent_3.json
├── ssl/                          # Certificados TLS/SSL para habilitar HTTPS
│   ├── cert.pem
│   └── key.pem
├── static/                       # Arquivos estáticos usados na interface
│   ├── css/                      # Estilos globais e específicos
│   │   ├── all.min.css
│   │   ├── base.css
│   │   ├── components.css
│   │   ├── dashboard.css
│   │   ├── error.css
│   │   ├── login.css
│   │   ├── machine_details.css
│   │   ├── painel.css
│   │   ├── search.css
│   │   ├── settings.css
│   │   └── styles.css
│   ├── favicon.png               # Ícone do site
│   ├── js/                       # Scripts JavaScript da aplicação
│   │   ├── base.js
│   │   ├── chart.js
│   │   ├── common.js
│   │   ├── dashboard.js
│   │   ├── machine_details.js
│   │   ├── painel.js
│   │   └── search.js
│   ├── logo.svg
│   └── mlogo.svg
├── templates/                     # Templates HTML renderizados pelo Flask
│   ├── base.html                  # Template base (layout principal)
│   ├── dashboard.html             # Painel principal
│   ├── error.html                 # Página de erro
│   ├── login.html                 # Tela de autenticação
│   ├── machine_details.html       # Detalhes de uma máquina/agente
│   ├── painel.html                # Painel geral das máquinas
│   ├── search.html                # Tela de busca
│   ├── settings.html              # Configurações do sistema
│   └── verify_mfa.html            # Verificação de MFA
└── utils/                         # Scripts utilitários de apoio
    ├── create_machines.py         # Criação de inventário de máquinas
    ├── get_data.py                # Coletor de dados do sistema
    ├── get_groups.py              # Manipulação de grupos de agentes
    ├── language.py                # Suporte a internacionalização/idiomas
    ├── man_users.py               # Gerenciamento de usuários
    ├── mfa_utils.py               # Funções auxiliares para MFA
    └── pdf_export.py              # Exportação de relatórios em PDF

A interface web do INVENTORY foi desenvolvida para transformar os dados brutos coletados em inteligência acionável, fornecendo ferramentas poderosas para as equipes de TI e segurança.

O dashboard é a visão centralizada e estatística do inventário, projetado para oferecer uma compreensão imediata do ambiente de TI.

• Métricas (KPIs): Apresenta indicadores chave de desempenho, como o número total de máquinas, a quantidade de ativos online (ativos) e offline (inativos).

• Gráficos Interativos: Exibe visualizações gráficas da distribuição de sistemas operacionais, tipos de processadores, faixas de memória RAM, portas de rede mais comuns e processos com maior recorrência, além da evolução temporal do status dos agentes, permitindo a análise de tendências. O clique em um gráfico redireciona para a busca avançada com o filtro correspondente aplicado.

Este painel fornece uma listagem de todos os dispositivos inventariados, exibindo informações resumidas e o status de atividade em tempo real. A partir desta lista, é possível navegar para uma página de detalhes completa para cada ativo, que consolida todas as informações extraídas do Wazuh, incluindo hardware, rede, software instalado e processos em execução.

A funcionalidade de busca avançada é uma ferramenta para atividades de threat hunting, auditoria, ou até mesmo uma simples pesquisa, permitindo consultas precisas com uma sintaxe baseada em tags.

Exemplos de Sintaxe de Busca: • ports:445 - Localiza máquinas com uma porta específica aberta. • inventory:os:Windows - Filtra dispositivos por sistema operacional. • inventory:packages:chrome - Busca por máquinas com um pacote de software específico instalado. • agent_info:10.7.6.20 - Pesquisa por hostname, IP, status ou ID do agente. • inventory:processes:python - Busca por processos em execução em um ativo. • ram_gb:9-12gb - Filtra ativos por uma faixa específica de memória RAM.

O sistema permite a exportação de relatórios completos do inventário em formatos PDF e CSV, facilitando a criação de documentação para auditorias de conformidade. Adicionalmente, oferece uma funcionalidade de_ sincronização manual_, que aciona o coletor para atualizar os dados do inventário diretamente do Wazuh, garantindo que as informações estejam sempre atualizadas.

A segurança é uma prioridade no design do sistema INVENTORY. A arquitetura emprega uma estratégia de "defesa em profundidade", com controles implementados nas camadas de autenticação, sessão, rede e transporte para proteger de forma abrangente o acesso aos dados centralizados de inventário.

A proteção de credenciais e o controle de acesso são realizados por meio de um conjunto robusto de medidas:

• Hash bcrypt: As senhas dos usuários são armazenadas utilizando o algoritmo bcrypt, um padrão forte que protege contra ataques de quebra de senha offline, como rainbow table e força bruta. • Controle de Força Bruta: O sistema implementa um mecanismo de bloqueio de IP após um número configurável de tentativas de login falhas. • Verificação de IP de Origem: Cada login é validado contra o endereço IP de origem para mitigar o risco de sequestro de sessão ou uso de credenciais roubadas de locais não autorizados. • Timeout Automático: As sessões de usuário expiram automaticamente após um período de inatividade (padrão de 15 minutos), mitigando o risco de acesso não autorizado a estações de trabalho desatendidas.

Para reforçar a segurança do login, o sistema suporta Autenticação Multifator (MFA) baseada no padrão TOTP (Time-based One-Time Password). Esta funcionalidade é compatível com aplicativos autenticadores populares, como o Google Authenticator, pode ser configurada de forma simples através da leitura de um QR code e oferece suporte a backup de códigos de recuperação.

O acesso à interface web pode ser restrito a faixas de rede específicas. Essa configuração é controlada pela variável de ambiente ALLOWED_IP_RANGES, permitindo que apenas usuários de redes confiáveis (como a rede corporativa interna) possam acessar a aplicação.

A comunicação entre o cliente e o servidor é protegida com TLS/SSL, garantindo a criptografia de todo o tráfego via HTTPS. A aplicação também implementa Headers de Segurança HTTP para mitigar ataques comuns a aplicações web. Além disso, o sistema mantém logs detalhados de segurança (security.log) e auditoria (audit.log), registrando eventos relevantes para garantir a rastreabilidade completa das ações.

O sistema realiza o inventário dos dispositivos com agentes Wazuh em duas camadas principais:

• Coletor de Dados: Responsável por se conectar à API do Wazuh e coletar informações detalhadas de cada agente monitorado, incluindo dados de hardware, sistema operacional, rede e portas abertas. As informações são processadas e armazenadas em arquivos JSON, organizados por hostname, de forma estruturada e padronizada para consumo posterior pela interface web.
• Aplicação Web (Flask): Consome os arquivos JSON gerados pelo coletor e apresenta os dados por meio de uma interface web segura e interativa. A aplicação disponibiliza dashboards estatísticos, visualizações individuais por máquina, filtros dinâmicos, busca avançada e consultas personalizadas. Essa interface facilita a análise, inspeção e auditoria do inventário de forma eficiente e centralizada.

Operation Flow:

Wazuh Collector → JSON Data → Flask App → Dashboard / Panel
       │               │              │             └─ Visualização por máquina
       │               │              └─ Leitura e parsing dos arquivos
       │               └─ Armazenamento estruturado por hostname
       └─ Coleta via API: hardware, SO, rede, portas abertas, programas e processos.

Criar usuários:

# Aplicação
sudo useradd -r -s /usr/sbin/nologin inventory

O inventory serve como uma solução para centralizar os dados de OSCollector do WAZUH. Ao invés de acessar maquina por maquina, é possivel ter uma visão geral e abrangente dos ativos.

Criar e configurar a pasta:

cd /opt
sudo mkdir Inventory
chown -R inventory:inventory ./Inventory

Clonar o repositório:

git clone https://github.com/Maarckz/Inventory.git

Criar o .env dentro de Inventory e colar o conteúdo abaixo

cd Inventory && nano .env

# Configurações de segurança
SECRET_KEY=suachavesupersecreta_altere_esta_chave!
SESSION_SALT=suachavesupersecreta_altere_esta_chave_salt!
INVENTORY_DIR=data/inventory
GROUPS_DIR=data/groups
AUTH_FILE=data/auth/logins.json
LOG_DIR=logs

# Configurações de rede
HOST=0.0.0.0
PORT=7000
DEBUG=False

# Configurações de HTTPS
USE_HTTPS=True
SSL_CERT_PATH=ssl/cert.pem
SSL_KEY_PATH=ssl/key.pem

# Permitir apenas IPs de uma faixa específica
ALLOWED_IP_RANGES=192.168.0.0/16

WAZUH_PROTOCOL=https
WAZUH_HOST=192.168.56.101
WAZUH_PORT=55000
WAZUH_USER=wazuh-wui
WAZUH_PASSWORD=ma?Pt3XvLxQzpU8.J3rIQ8.dYhxzV?pT

As credenciais de API, devem ser consultadas dentro da pasta de instalaçao do WAZUH

sudo tar -O -xvf wazuh-install-files.tar wazuh-install-files/wazuh-passwords.txt

Instalar o PIP3:

sudo apt install python3-pip python3-venv

Criar o ambiente virtual e de permissões novamente

sudo -u inventory python3 -m venv /opt/Inventory/venv
sudo chown -R inventory:inventory ./Inventory

Abra um shell como usuário inventory

sudo -u inventory -s

Dentro do shell

source /opt/Inventory/venv/bin/activate

Instalar dependências com o usuário Inventory:

pip3 install flask flask_session bcrypt requests python-dotenv qrcode pyotp reportlab --break-system-packages

Rodar o coletor (via Painel do Sistema ou Manualmente):

python3 utils/get_data.py

Criar TLS/SSL Cert:

openssl req -x509 -newkey rsa:4096 -nodes -out ssl/cert.pem -keyout ssl/key.pem -days 365 

Teste da aplicação WEB:

python3 app.py

Login e Password padrão:

Login: admin
Password: Meuadmin123

Para manter os serviço disponivel mesmo após o reboot, sugiro a criação abaixo no diretório:

/etc/systemd/system/inventory.service

[Unit]
Description=Inventory Application
After=network.target
Wants=network-online.target

[Service]
# Exec
Type=simple
WorkingDirectory=/opt/Inventory
ExecStart=/opt/Inventory/venv/bin/python3 /opt/Inventory/app.py

# Run as unprivileged account (or use DynamicUser=yes, ver abaixo)
User=inventory
Group=inventory

# Restart policy
Restart=always
RestartSec=5

# Basic sandboxing
NoNewPrivileges=yes          # impede elevação de privilégios
PrivateTmp=yes               # /tmp isolado
PrivateDevices=yes           # sem acesso direto a /dev
ProtectSystem=full           # /usr e /boot readonly; 'full' protege /etc também
ProtectHome=yes              # /home e /root inacessíveis
ProtectKernelTunables=yes
ProtectKernelModules=yes
ProtectKernelLogs=yes
ProtectControlGroups=yes

# Filesystem allowlist: deixa somente o que precisa escrever
ReadOnlyPaths=/
ReadWritePaths=/opt/Inventory

# Network restrictions: permita só famílias necessárias (web usa AF_INET/AF_INET6)
RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6

# Capabilities: remove tudo por padrão (adicione só o que for imprescindível)
CapabilityBoundingSet=
AmbientCapabilities=

# Limits
LimitNOFILE=65536
LimitNPROC=1024

# Memory exec protections
MemoryDenyWriteExecute=yes
LockPersonality=yes

# Logging
StandardOutput=journal
StandardError=journal

# Extra: make sure service cannot create new users/suid escalation
RestrictSUIDSGID=yes

[Install]
WantedBy=multi-user.target

Para verificar o usuário do serviço / processo:

systemctl show -p MainPID --value inventory.service 
ps -o user,pid,cmd -p <PID>

Recarregue o daemon do sistema:

sudo systemctl daemon-reload

Habilite e inicie o Inventory.service:

sudo systemctl enable inventory.service && sudo systemctl start inventory.service

Rotinas de manutenção e monitoramento são essenciais para garantir a integridade, a atualização e a segurança contínua dos dados gerenciados pelo INVENTORY.

• Diária: Executar o script coletor de dados (python3 utils/get_data.py) para garantir que o inventário de ativos permaneça atualizado. • Semanal: Realizar o backup dos arquivos JSON de inventário localizados no diretório data/inventory/. • Mensal: Conduzir uma auditoria dos usuários e acessos registrados para garantir a conformidade com as políticas de segurança. • Anual: Renovar os certificados TLS/SSL para manter a segurança da comunicação HTTPS.

Os logs são ferramentas críticas para o monitoramento da saúde do sistema e para a solução de problemas.

• info.log: Registra informações gerais sobre a execução da aplicação. • warning.log: Armazena alertas e avisos que não são erros críticos, mas que podem requerer atenção. • error.log: Armazena erros e exceções que ocorrem durante a operação. • security.log: Registra eventos de segurança, como tentativas de login (bem-sucedidas e falhas), ativação de MFA e bloqueios de IP. • audit.log: Fornece uma trilha de auditoria de acessos e atividades realizadas pelos usuários na plataforma.

O INVENTORY é um projeto em desenvolvimento ativo, com um roadmap claro para aprimoramentos focados em escalabilidade, integração e segurança, garantindo sua relevância e robustez a longo prazo.

O sistema INVENTORY preenche uma lacuna estratégica ao eliminar a cegueira sobre os ativos de TI, transformando os dados brutos de telemetria coletados pelo Wazuh em uma plataforma centralizada de visualização, busca e auditoria. Ele oferece uma solução leve e segura que se integra de forma transparente a infraestruturas existentes, sem a necessidade de agentes adicionais.