LitterBox

Un sandbox d'analyse de charges utiles auto-hébergé pour les équipes rouges. Téléchargez un échantillon, lancez une analyse statique / dynamique / EDR, obtenez un score de détection et un détail des indicateurs déclencheurs — déterminez si la charge utile est prête pour le terrain avant de quitter le laboratoire.

LitterBox peut également envoyer des charges utiles vers une VM Windows distincte équipée d'un EDR (Elastic Defend ou Fibratus) et récupérer les alertes de détection corrélées dans la page de résultats.

Bien que conçu principalement pour les équipes rouges, LitterBox est tout aussi utile pour les équipes bleues utilisant les mêmes outils dans leurs workflows d'analyse de logiciels malveillants.

Documentation

La documentation destinée aux opérateurs et aux développeurs se trouve dans le Wiki LitterBox.

Installation

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            # ajoutez --debug pour des logs détaillés

Ouvrez http://127.0.0.1:1337. Nécessite Python 3.11+ et un shell administrateur.

Linux (Docker)

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

Le script d’installation provisionne un conteneur Windows 10 avec KVM et exécute LitterBox à l’intérieur. La construction initiale prend environ 1 heure.

• Moniteur d’installation : http://localhost:8006
• RDP : localhost:3389 (identifiants dans le fichier docker compose)
• Interface LitterBox : http://127.0.0.1:1337 une fois l’installation terminée

Configuration EDR (facultatif)

Déposez un ou plusieurs fichiers YAML de profil dans Config/edr_profiles/ et la page de téléchargement les détecte au démarrage. Guides complets dans le wiki : Agent Whiskers → Configuration Elastic Defend ou Configuration Fibratus.

Analyseurs

Binaires fournis sous Scanners/. Les versions et les dates de dernière mise à jour sont suivies ici afin que les opérateurs puissent voir en un coup d’œil si un analyseur est à jour.

Format de version : <version> ou <version> (release) lorsque le binaire provient d’une version amont ; <version> (\`)ou simplement``` lorsqu’il est compilé depuis le code source. La date de dernière mise à jour est la date du commit / de la version amont, pas la date de construction locale.

Lorsque vous mettez à jour un analyseur : remplacez le binaire dans son répertoire Scanners/<Nom>/ et mettez à jour la ligne ci-dessus (version + date).

Contribution

Consultez CONTRIBUTING.md. Travaillez dans des branches de fonctionnalités sur des forks personnels.

Soutien 🍺

Avis de sécurité

• Usage développement uniquement. Cette plateforme est conçue pour des environnements de test. Le déploiement en production présente des risques de sécurité importants.
• Isolation requise. Exécutez-la uniquement dans des machines virtuelles isolées ou des environnements de test dédiés.
• Aucune garantie. Fournie sans garanties ; utilisation à vos propres risques.
• Conformité légale. Les utilisateurs sont responsables de s’assurer que l’utilisation respecte les lois applicables.

Remerciements

LitterBox repose sur le travail de ces projets et de leurs auteurs :

Interface