
speakeasy v2.0.0b4
Windows-Malware-Emulationsframework, das Binärdateien, Treiber und Shellcode in einer modellierten Laufzeitumgebung ausführt und APIs, Prozess-/Thread-Verhalten, Dateisystem, Registry und Netzwerkaktivität für strukturierte JSON-Berichterstellung emuliert.
Speakeasy
Speakeasy ist ein Framework zur Emulation von Windows-Malware, das Binärdateien, Treiber und Shellcode in einer modellierten Windows-Laufzeitumgebung anstelle einer vollständigen VM ausführt. Es emuliert die Windows-APIs, Prozesse, Threads, das Dateisystem, die Registry und das Netzwerk, die ein Sample verwendet, sodass das Sample weiter läuft als in einem reinen CPU-Emulator. Die speakeasy-CLI schreibt den Bericht als JSON für das Triage, und die Python-Bibliothek liefert denselben Bericht an Ihren Code zurück.
Hintergrundinformationen finden Sie in Mandiants Einführung in Speakeasy.
Schnellstart
Installation von PyPI:
python3 -m pip install speakeasy-emulator
Emulieren Sie ein Sample und geben Sie einige Felder des Berichts aus. Ersetzen Sie sample.dll durch Ihre Datei:
speakeasy -t sample.dll --no-mp -o report.json 2>/dev/null
jq '{sha256, arch, file_type, runs: (.runs | length)}' report.json
Die Werte hängen vom Sample ab:
{
"sha256": "…",
"arch": "x86",
"file_type": "dll",
"runs": 3
}
Standardmäßig aktiviert Speakeasy alle seine Funktionen: Es führt die Exporte und die untergeordneten Prozesse aus, und der Bericht enthält die Abdeckung, die Anzahl der Speicherzugriffe und den endgültigen Speicherinhalt. Jede Funktion hat ein --no--Flag, das sie deaktiviert, zum Beispiel --no-code-coverage. Ein Lauf mit weniger Funktionen ist schneller und liefert einen kleineren Bericht. Die CLI-Referenz listet die Flags auf.
Dokumentation
Beginnen Sie mit der Installation, der Verwendung der Python-Bibliothek und der CLI-Referenz. Der Dokumentationsindex listet alle Seiten auf.
Hilfe finden Sie in doc/help.md oder indem Sie ein Issue unter github.com/mandiant/speakeasy/issues eröffnen.