SentinelThread-Forensics

🛡️ Sentinel Thread Pro

A Plataforma de Triagem Forense Windows de Alta Velocidade

📋 A Missão

Em operações modernas de SOC, a análise manual de EVTX é uma sentença de morte para o seu MTTR (Mean Time to Respond). O Sentinel Thread Pro foi criado para preencher a lacuna entre enormes logs de eventos brutos e inteligência forense acionável. Orquestrando o mecanismo Hayabusa (baseado em Rust) e um pipeline de dados Pythonic, esta ferramenta transforma milhares de eventos ruidosos em uma linha do tempo de ameaças limpa e priorizada em segundos.

🚀 Principais Funcionalidades de Engenharia

• Triagem Rápida como Relâmpago: Processa arquivos .evtx massivos usando o núcleo do Hayabusa para análise quase instantânea.
• Detecção Baseada em Sigma: Suporte nativo para regras Sigma e lógica de detecção da Yamato Security para caçar comportamentos adversários.
• Mapeamento ATT&CK: Mapeia automaticamente eventos detectados para táticas e técnicas MITRE ATT&CK®.
• UI Orientada por Inteligência: Um dashboard reativo do Streamlit construído para analistas, permitindo filtragem profunda por severidade, hostname ou IDs de Regra específicos.
• Normalização Limpa de Dados: Uma camada de normalização personalizada que lida com variações de esquema entre diferentes versões do mecanismo forense.

🏗️ Como Funciona (A Arquitetura)

1. Ingestão: O usuário faz upload de um artefato através da UI.
2. Execução: O backend Python aciona um subprocesso Hayabusa não interativo com as flags estritas --no-wizard e --json-timeline.
3. Refinamento: Um processador baseado em Pandas limpa a saída JSON bruta, resolvendo conflitos de nomenclatura de campos e calculando pontuações de ameaça.
4. Visualização: O dashboard gerenciado por estado renderiza os dados em uma linha do tempo forense interativa.

🛠️ Configuração & Implantação

1. Pré-requisitos

• Python 3.10 ou superior.
• O Binário Hayabusa. Baixe-o e coloque-o no diretório bin/.

2. Instalação

# Clone the repository
git clone https://github.com/Adham504/SentinelThread-Forensics.git
cd SentinelThread-Forensics

# Set up the environment
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install the stack
pip install -r requirements.txt

3. Executando o App

Sempre execute a partir do diretório src para garantir a integridade do caminho:

cd src
streamlit run app.py

📂 Estrutura do Projeto

SentinelThread/
├── bin/              # Forensic Binaries (Exempt from Git)
├── logs/             # Where you store the .evtx file to process
├── output/           # Generated JSON/CSV results
├── rules/            # Hayabusa/Sigma detection logic
├── sigma_repo/       # Extended community rules
├── src/              # The Core Logic
│   ├── app.py              # Main Entry & UI State
│   ├── engine_handler.py   # Subprocess Orchestrator
│   └── data_processor.py   # Pandas Normalization Logic
└── requirements.txt