SentinelThread-Forensics

🛡️ Sentinel Thread Pro

हाई-स्पीड विंडोज फोरेंसिक ट्राइएज प्लेटफॉर्म

📋 मिशन

आधुनिक SOC संचालनों में, मैनुअल EVTX विश्लेषण आपके MTTR (प्रतिक्रिया का औसत समय) के लिए मृत्युदंड है। Sentinel Thread Pro बड़े पैमाने पर कच्चे इवेंट लॉग और कार्रवाई योग्य फोरेंसिक इंटेलिजेंस के बीच की खाई को पाटने के लिए बनाया गया है। Hayabusa इंजन (Rust-आधारित) और एक Pythonic डेटा पाइपलाइन को ऑर्केस्ट्रेट करके, यह टूल सेकंडों में हजारों शोर-भरी घटनाओं को एक साफ, प्राथमिकता वाली खतरे की समयरेखा में बदल देता है।

🚀 मुख्य इंजीनियरिंग विशेषताएं

• ब्लिट्ज-फास्ट ट्राइएज: Hayabusa कोर का उपयोग करके बड़े .evtx फाइलों को लगभग तुरंत विश्लेषण के लिए प्रोसेस करता है।
• सिग्मा-संचालित डिटेक्शन: प्रतिकूल व्यवहार की खोज के लिए सिग्मा नियमों और Yamato Security की डिटेक्शन लॉजिक के लिए मूल समर्थन।
• ATT&CK मैपिंग: स्वचालित रूप से पहचानी गई घटनाओं को MITRE ATT&CK® रणनीतियों और तकनीकों से मैप करता है।
• इंटेलिजेंस-संचालित UI: विश्लेषकों के लिए बनाया गया एक रिएक्टिव Streamlit डैशबोर्ड, जो गंभीरता, होस्टनाम या विशिष्ट नियम IDs द्वारा गहन फ़िल्टरिंग की अनुमति देता है।
• स्वच्छ डेटा सामान्यीकरण: एक कस्टम सामान्यीकरण परत जो विभिन्न फोरेंसिक इंजन संस्करणों के बीच स्कीमा विविधताओं को संभालती है।

🏗️ यह कैसे काम करता है (आर्किटेक्चर)

1. अंतर्ग्रहण: उपयोगकर्ता UI के माध्यम से एक आर्टिफैक्ट अपलोड करता है।
2. निष्पादन: Python बैकएंड सख्त --no-wizard और --json-timeline फ़्लैग के साथ एक गैर-इंटरैक्टिव Hayabusa सबप्रोसेस को ट्रिगर करता है।
3. परिष्करण: एक Pandas-आधारित प्रोसेसर कच्चे JSON आउटपुट को साफ करता है, फील्ड नामकरण विरोधों को हल करता है और खतरे के स्कोर की गणना करता है।
4. विज़ुअलाइज़ेशन: राज्य-प्रबंधित डैशबोर्ड डेटा को एक इंटरैक्टिव फोरेंसिक टाइमलाइन में प्रस्तुत करता है।

🛠️ सेटअप और तैनाती

1. पूर्वापेक्षाएँ

• Python 3.10 या उच्चतर।
• Hayabusa बाइनरी। इसे डाउनलोड करें और bin/ डायरेक्टरी में रखें।

2. इंस्टॉलेशन

# 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. ऐप चलाना

पथ अखंडता सुनिश्चित करने के लिए हमेशा src डायरेक्टरी से चलाएं:

cd src
streamlit run app.py

📂 प्रोजेक्ट संरचना

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