LitterBox

Um sandbox de análise de payload auto-hospedado para red teams. Envie uma amostra, execute análise estática / dinâmica / EDR nela, obtenha um Detection Score e um detalhamento dos indicadores de acionamento — decida se o payload está pronto para uso em campo antes de sair do laboratório.

O LitterBox também pode enviar payloads para uma VM Windows separada com instrumentação EDR (Elastic Defend ou Fibratus) e trazer os alertas de detecção correlacionados de volta para a página de resultados.

Embora projetado principalmente para red teams, o LitterBox é igualmente útil para blue teams que usam as mesmas ferramentas em seus fluxos de trabalho de análise de malware.

Documentação

A documentação para operadores e desenvolvedores está na Wiki do LitterBox.

Instalação

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

Abra http://127.0.0.1:1337. Requer Python 3.11+ e um shell de administrador.

Linux (Docker)

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

O script de configuração provisiona um contêiner Windows 10 com KVM e executa o LitterBox dentro dele. A compilação inicial leva cerca de 1 hora.

• Monitor de instalação: http://localhost:8006
• RDP: localhost:3389 (credenciais no arquivo docker compose)
• Interface do LitterBox: http://127.0.0.1:1337 quando a configuração for concluída

Configuração de EDR (opcional)

Coloque um ou mais YAMLs de perfil em Config/edr_profiles/ e a página de upload os detecta na inicialização. Tutoriais completos na wiki: Whiskers Agent → Elastic Defend Setup ou Fibratus Setup.

Scanners

Binários empacotados em Scanners/. Versões e datas da última atualização são rastreadas aqui para que os operadores possam ver rapidamente se um scanner está atualizado.

Formato da versão: <release-version> ou <release-version> (release) quando o binário é obtido de um release upstream; <release-version> (\`)ou apenas``` quando compilado a partir do código-fonte. A data da última atualização é a data do commit / release upstream, não a data da compilação local.

Ao atualizar um scanner: substitua o binário no diretório Scanners/<Name>/ e atualize a linha acima (versão + data).

Contribuindo

Veja CONTRIBUTING.md. Trabalhe em branches de funcionalidade em forks pessoais.

Suporte 🍺

Aviso de Segurança

• Somente para uso em desenvolvimento. Esta plataforma foi projetada para ambientes de teste. A implantação em produção apresenta riscos de segurança significativos.
• Isolamento necessário. Execute apenas em VMs isoladas ou ambientes de teste dedicados.
• Sem garantia. Fornecido sem garantias; use por sua conta e risco.
• Conformidade legal. Os usuários são responsáveis por garantir que o uso esteja em conformidade com as leis aplicáveis.

Agradecimentos

O LitterBox se apoia no trabalho destes projetos e de seus autores:

Interface