
speakeasy v2.0.0b6
Framework de emulação de malware do Windows que executa binários, drivers e shellcode em um runtime modelado, emulando APIs, comportamento de processos/threads, sistema de arquivos, registro e atividade de rede para relatórios JSON estruturados.
Speakeasy
Speakeasy é um framework de emulação de malware para Windows que executa binários, drivers e shellcode em um runtime Windows modelado, em vez de uma VM completa. Ele emula as APIs do Windows, processos, threads, sistema de arquivos, registro e rede que uma amostra utiliza, de modo que a amostra é executada de forma mais profunda do que em um emulador de CPU puro. A CLI speakeasy grava o relatório em JSON para triagem, e a biblioteca Python retorna o mesmo relatório para o seu código.
Para contexto, consulte a introdução ao Speakeasy da Mandiant.
Início rápido
Instale a partir do PyPI:
python3 -m pip install speakeasy-emulator
Emule uma amostra e imprima alguns campos do relatório. Substitua sample.dll pelo seu arquivo:
speakeasy -t sample.dll --no-mp -o report.json 2>/dev/null
jq '{sha256, arch, file_type, runs: (.runs | length)}' report.json
Os valores dependem da amostra:
{
"sha256": "…",
"arch": "x86",
"file_type": "dll",
"runs": 3
}
Por padrão, o Speakeasy ativa todos os seus recursos: ele executa as exportações e os processos filhos, e o relatório contém cobertura, contagens de acesso à memória e o conteúdo final da memória. Cada recurso tem uma flag --no- que o desativa, por exemplo --no-code-coverage. Uma execução com menos recursos é mais rápida e gera um relatório menor. A referência da CLI lista as flags.
Documentação
Comece pela instalação, pelo uso da biblioteca Python e pela referência da CLI. O índice da documentação lista todas as páginas.
Para obter ajuda, consulte doc/help.md ou abra uma issue em github.com/mandiant/speakeasy/issues.