LitterBox

صندوق رمل لتحليل الحمولات مُستضاف ذاتياً لفرق الاختراق الأحمر. ارفع عينة، وشغّل التحليل الساكن / الديناميكي / تحليل EDR عليها، واحصل على درجة الاكتشاف وتفصيلاً للمؤشرات المُطلِقة للتنبيهات — وقرر ما إذا كانت الحمولة جاهزة للميدان قبل أن تغادر المختبر.

يمكن لـ LitterBox أيضاً إرسال الحمولات إلى جهاز Windows افتراضي منفصل مزوّد بأدوات EDR (Elastic Defend أو Fibratus) واسترجاع تنبيهات الكشف المرتبطة إلى صفحة النتائج.

صُمم في المقام الأول لفرق الاختراق الأحمر، لكنه مفيد بنفس القدر لفرق الدفاع الأزرق التي تشغّل الأدوات نفسها في سير عمل تحليل البرمجيات الخبيثة.

التوثيق

توجد وثائق المشغّل والمطوّر في ويكي LitterBox.

التثبيت

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

يقوم سكربت الإعداد بتجهيز حاوية Windows 10 مع KVM وتشغيل LitterBox داخلها. يستغرق البناء الأولي نحو ساعة واحدة.

• شاشة التثبيت: http://localhost:8006
• RDP: localhost:3389 (بيانات الاعتماد في ملف docker compose)
• واجهة LitterBox: http://127.0.0.1:1337 بمجرد اكتمال الإعداد

إعداد EDR (اختياري)

ضع ملف YAML واحداً أو أكثر في Config/edr_profiles/ وستلتقطها صفحة الرفع عند الإقلاع. الأدلة الكاملة في الويكي: وكيل Whiskers → إعداد Elastic Defend أو إعداد Fibratus.

الماسحات الضوئية

ملفات ثنائية مرفقة تحت Scanners/. تُسجَّل هنا الإصدارات وتواريخ آخر تحديث حتى يستطيع المشغّلون معرفة ما إذا كان الماسح محدثاً من نظرة واحدة.

تنسيق الإصدار: <release-version> أو <release-version> (release) عندما يكون الملف الثنائي مسحوباً من إصدار منبع (upstream release)؛ أو <release-version> (\`)أو``` فقط عندما يكون مبنياً من المصدر. تاريخ آخر تحديث هو تاريخ الالتزام / الإصدار في المنبع، وليس تاريخ البناء المحلي.

عند تحديث ماسح ضوئي: استبدل الملف الثنائي في دليله Scanners/<Name>/ وحدّث الصف أعلاه (الإصدار + التاريخ).

المساهمة

راجع CONTRIBUTING.md. اعمل في فروع الميزات (feature branches) على نسخك الشخصية (forks).

الدعم 🍺

التنبيه الأمني

• للاستخدام التطويري فقط. صُممت هذه المنصة لبيئات الاختبار. النشر في بيئة الإنتاج ينطوي على مخاطر أمنية كبيرة.
• العزل مطلوب. شغّلها فقط في أجهزة افتراضية معزولة أو بيئات اختبار مخصصة.
• بدون ضمان. تُقدَّم دون أي ضمانات؛ استخدمها على مسؤوليتك الخاصة.
• الامتثال القانوني. يتحمل المستخدمون مسؤولية ضمان توافق الاستخدام مع القوانين المعمول بها.

شكر وتقدير

يعتمد LitterBox على أعمال هذه المشاريع ومؤلفيها:

الواجهة