🛡 AegisMon — Advanced Security Scanner Toolkit 🔒

AegisMon é uma ferramenta de código aberto para cibersegurança projetada para realizar varreduras de integridade de arquivos (FIM - File Integrity Monitoring), detecção de malware por assinatura e avaliação heurística de risco. Desenvolvido para ser modular e extensível, utiliza uma interface de linha de comando robusta.

---

🟥 Live Demo

Explore a versão demo interativa do AegisMon em Streamlit Cloud:

• Upload de telemetria JSON
• Detecção de anomalias simulada
• Geração de relatório auditável

⚠️ Nota: Alguns testes automatizados ainda estão em revisão, mas a demo funciona e mostra o conceito principal.

---

✨ Funcionalidades Principais

• Detecção Multifacetada: Utiliza Assinaturas (Hashing), Heurísticas de Risco e Regras Personalizadas.
• Múltiplos Hashing: Suporte nativo para MD5, SHA1 e SHA256.
• Relatórios Estruturados: Exportação de resultados em formato JSON para fácil processamento e integração.
• Configurável: Suporte a arquivos de configuração externos (YAML/JSON) e carregamento de banco de dados de assinaturas personalizado.
• Arquitetura Modular: Código organizado em pacotes scanner, reports, logging e utils.

📂 Estrutura do Projeto

aegismon/
├── cli.py                   # Interface de linha de comando
├── .github/workflows/       # CI/CD (deploy e testes)
├── docs/assets/             # Logos e elementos visuais do projeto
├── examples/             	 # Dados fictícios de telemetria/políticas 
├── logging/                 # Configuração e utilitários de logging
├── reports/                 # Geração de relatórios (JSON, etc.)
├── scanner/                 # Núcleo de escaneamento e assinaturas
├── tests/                   # Testes automatizados
├── utils/                   # Funções auxiliares
├── LICENSE                  # Licença MIT
├── CHANGELOG.md             # Histórico de alterações
├── CONTRIBUTING.md          # Diretrizes de contribuição
├── README.md                # Documentação principal
├── setup.py                 # Instalação via setuptools
└── requirements.txt         # Dependências do projeto

---

⚙️ Instalação e Uso

Pré-requisitos

O AegisMon requer Python 3.8+ e as dependências listadas em requirements.txt.

# Clone o repositório
git clone https://github.com/augusto-mate/aegismon.git
cd aegismon

# Instale as dependências
pip install -r requirements.txt

# Instale o pacote localmente (modo editável para desenvolvimento)
pip install -e .

Uso da CLI

O comando principal é aegismon scan.

# 1. Scan básico em um diretório (exibe resultados verbose no terminal)
aegismon scan /caminho/para/analise --verbose

# 2. Scan e exportação do relatório JSON
aegismon scan /home/user/documentos --json ./report.json

# 3. Scan usando um arquivo de configuração externo (hashes e log level)
aegismon scan /var/www --config ./config/config.yaml

# 4. Scan carregando um banco de assinaturas personalizado
aegismon scan /etc --signatures ./config/signatures.json

---

🤝 Contribuindo

Cada contribuição fortalece o AegisMon como projeto de portfólio e aprendizado.
Antes de começar, leia o CONTRIBUTING.md para entender:

• Como propor melhorias
• Como relatar problemas
• Como enviar código seguindo o padrão do projeto

Sua participação é bem‑vinda e valorizada!

📜 Licença

Este projeto é distribuído sob a Licença MIT, permitindo uso, modificação e distribuição livre, desde que mantidos os créditos originais.
Consulte o arquivo LICENSE para mais detalhes.

👤 Autor

• Augusto Mate — Desenvolvedor e mantenedor principal do AegisMon
  • GitHub: @augusto-mate
  • LinkedIn: linkedin.com/in/augusto-mate/

---

🌟 AegisMon — monitorar, proteger e impressionar: um marco de inovação e showcase de excelência.