LitterBox

एक स्व-होस्टेड पेलोड-विश्लेषण सैंडबॉक्स जो रेड टीमों के लिए है। एक सैंपल अपलोड करें, उस पर स्टैटिक / डायनामिक / EDR विश्लेषण चलाएं, एक Detection Score और ट्रिगरिंग-इंडिकेटर्स का ब्रेकडाउन प्राप्त करें — तय करें कि पेलोड लैब छोड़ने से पहले फील्ड-रेडी है या नहीं।

LitterBox अलग EDR-इंस्ट्रूमेंटेड Windows VM (Elastic Defend या Fibratus) पर पेलोड भेज सकता है और सहसंबंधित डिटेक्शन अलर्ट को परिणाम पृष्ठ पर वापस खींच सकता है।

हालांकि मुख्य रूप से रेड टीमों के लिए डिज़ाइन किया गया है, LitterBox उन ब्लू टीमों के लिए भी उतना ही उपयोगी है जो अपने मैलवेयर-विश्लेषण वर्कफ़्लो में समान उपकरण चलाते हैं।

दस्तावेज़ीकरण

ऑपरेटर और डेवलपर दस्तावेज़ीकरण LitterBox Wiki में रहता है।

स्थापना

Windows

git clone https://github.com/BlackSnufkin/LitterBox.git
cd LitterBox
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
python litterbox.py            # add --debug for verbose logging

http://127.0.0.1:1337 खोलें। Python 3.11+ और एक एडमिन शेल आवश्यक है।

Linux (Docker)

git clone https://github.com/BlackSnufkin/LitterBox.git
cd LitterBox/Docker
chmod +x setup.sh
./setup.sh

सेटअप स्क्रिप्ट KVM के साथ एक Windows 10 कंटेनर तैयार करती है और उसके अंदर LitterBox चलाती है। प्रारंभिक बिल्ड में ~1 घंटा लगता है।

• मॉनिटर स्थापित करें: http://localhost:8006
• RDP: localhost:3389 (क्रेडेंशियल्स docker compose फ़ाइल में हैं)
• LitterBox UI: सेटअप पूरा होने पर http://127.0.0.1:1337

EDR सेटअप (वैकल्पिक)

एक या अधिक प्रोफ़ाइल YAML को Config/edr_profiles/ के अंतर्गत डालें और अपलोड पृष्ठ उन्हें बूट पर उठा लेता है। विकी में पूर्ण वॉकथ्रू: Whiskers Agent → Elastic Defend Setup या Fibratus Setup।

स्कैनर्स

Scanners/ के अंतर्गत बंडल बाइनरीज़। संस्करण और अंतिम-अपडेट तिथियाँ यहाँ ट्रैक की गई हैं ताकि ऑपरेटर एक नज़र में बता सकें कि स्कैनर वर्तमान है या नहीं।

संस्करण प्रारूप: <release-version> या <release-version> (release) जब बाइनरी अपस्ट्रीम रिलीज़ से ली गई हो; <release-version> (\`)या सिर्फ``` जब स्रोत से बनाया गया हो। अंतिम-अपडेट तिथि अपस्ट्रीम कमिट / रिलीज़ तिथि है, स्थानीय बिल्ड तिथि नहीं।

जब आप स्कैनर को रिफ्रेश करते हैं: इसके Scanners/<Name>/ निर्देशिका के अंतर्गत बाइनरी बदलें और ऊपर की पंक्ति (संस्करण + दिनांक) अपडेट करें।

योगदान

CONTRIBUTING.md देखें। व्यक्तिगत फोर्क पर फीचर ब्रांच में काम करें।

सहायता 🍺

सुरक्षा सलाह

• केवल विकास उपयोग। यह प्लेटफ़ॉर्म परीक्षण वातावरण के लिए डिज़ाइन किया गया है। उत्पादन तैनाती महत्वपूर्ण सुरक्षा जोखिम प्रस्तुत करती है।
• पृथक्करण आवश्यक। केवल पृथक VM या समर्पित परीक्षण वातावरण में चलाएं।
• कोई वारंटी नहीं। बिना गारंटी के प्रदान किया गया; अपने जोखिम पर उपयोग करें।
• कानूनी अनुपालन। उपयोगकर्ता यह सुनिश्चित करने के लिए जिम्मेदार हैं कि उपयोग लागू कानूनों का अनुपालन करता है।

आभार

LitterBox इन परियोजनाओं और उनके लेखकों के काम पर खड़ा है:

इंटरफ़ेस