
speakeasy v2.0.0b6
Framework de emulación de malware para Windows que ejecuta binarios, controladores y shellcode en un runtime modelado, emulando APIs, comportamiento de procesos/hilos, sistema de archivos, registro y actividad de red para generar informes JSON estructurados.
Speakeasy
Speakeasy es un framework de emulación de malware de Windows que ejecuta binarios, controladores y shellcode en un entorno de ejecución de Windows modelado en lugar de una VM completa. Emula las API de Windows, los procesos, los hilos, el sistema de archivos, el registro y la red que utiliza una muestra, de modo que la muestra se ejecuta más allá de lo que lo haría en un emulador de CPU básico. La CLI speakeasy escribe el informe como JSON para el triaje, y la biblioteca de Python devuelve el mismo informe a tu código.
Para más contexto, consulta la introducción a Speakeasy de Mandiant.
Inicio rápido
Instala desde PyPI:
python3 -m pip install speakeasy-emulator
Emula una muestra e imprime algunos campos del informe. Sustituye sample.dll por tu archivo:
speakeasy -t sample.dll --no-mp -o report.json 2>/dev/null
jq '{sha256, arch, file_type, runs: (.runs | length)}' report.json
Los valores dependen de la muestra:
{
"sha256": "…",
"arch": "x86",
"file_type": "dll",
"runs": 3
}
De forma predeterminada, Speakeasy activa todas sus funciones: ejecuta las exportaciones y los procesos hijos, y el informe incluye la cobertura, los recuentos de accesos a memoria y el contenido final de la memoria. Cada función tiene un indicador --no- que la desactiva, por ejemplo --no-code-coverage. Una ejecución con menos funciones es más rápida y genera un informe más pequeño. La referencia de la CLI enumera los indicadores.
Documentación
Empieza por la instalación, el uso de la biblioteca de Python y la referencia de la CLI. El índice de documentación enumera todas las páginas.
Para obtener ayuda, consulta doc/help.md o abre una incidencia en github.com/mandiant/speakeasy/issues.