
speakeasy v2.0.0b4
Windows 악성코드 에뮬레이션 프레임워크로, 모델링된 런타임 환경에서 바이너리, 드라이버 및 셸코드를 실행하며, API, 프로세스/스레드 동작, 파일 시스템, 레지스트리 및 네트워크 활동을 에뮬레이션하여 구조화된 JSON 보고서를 생성합니다.
Speakeasy
Speakeasy는 전체 VM 대신 모델링된 Windows 런타임에서 바이너리, 드라이버, 셸코드를 실행하는 Windows 악성코드 에뮬레이션 프레임워크입니다. 샘플이 사용하는 Windows API, 프로세스, 스레드, 파일 시스템, 레지스트리, 네트워크를 에뮬레이션하므로, 샘플이 단순 CPU 에뮬레이터에서보다 더 멀리 실행됩니다. speakeasy CLI는 트리아지를 위해 보고서를 JSON으로 작성하며, Python 라이브러리는 동일한 보고서를 코드에 반환합니다.
배경 정보는 Mandiant의 Speakeasy 소개를 참조하세요.
빠른 시작
PyPI에서 설치합니다:
python3 -m pip install speakeasy-emulator
샘플을 에뮬레이션하고 보고서의 일부 필드를 출력합니다. sample.dll을 자신의 파일로 바꾸세요:
speakeasy -t sample.dll --no-mp -o report.json 2>/dev/null
jq '{sha256, arch, file_type, runs: (.runs | length)}' report.json
값은 샘플에 따라 달라집니다:
{
"sha256": "…",
"arch": "x86",
"file_type": "dll",
"runs": 3
}
기본적으로 Speakeasy는 모든 기능을 켭니다. 내보내기(export)와 자식 프로세스를 실행하며, 보고서에는 커버리지, 메모리 접근 횟수, 최종 메모리 내용이 포함됩니다. 각 기능에는 이를 끄는 --no- 플래그가 있으며, 예를 들어 --no-code-coverage가 있습니다. 기능을 적게 켜고 실행하면 더 빠르고 보고서도 더 작아집니다. CLI 레퍼런스에 플래그가 나열되어 있습니다.
문서
설치, Python 라이브러리 사용법, CLI 레퍼런스부터 시작하세요. 문서 색인에 모든 페이지가 나열되어 있습니다.
도움이 필요하면 doc/help.md를 참조하거나 github.com/mandiant/speakeasy/issues에 이슈를 열어 주세요.