공격적 엔지니어링 및 C2 연구를 위한 Windows 임플란트 개발 프레임워크입니다.
공격적 엔지니어링 및 C2 연구를 위한 현대적인 Windows 임플란트 개발 프레임워크.
Suture는 Crystal Palace를 사용하여 위치 독립적 로더(PIC)와 모듈식 PICO 페이로드를 결합한 플랫 바이너리를 빌드합니다. 프로젝트는 mergelib을 통해 링크 시점에 기능 라이브러리를 구성합니다. 데모는 시작 시 모듈을 등록하고 이름으로 들어오는 명령을 디스패치합니다. 작은 Go 서버가 검사를 위해 TCP 및 HTTP 트래픽을 기록합니다.
랩 상태. 일곱 개의 변형이 컴파일되고 링크되었습니다. 런타임 동작은 아직 검증되지 않았습니다. 정적 디스어셈블리 결과 데모의 리졸버가
GetModuleHandleA를 해석하려고 시도하는 동안 자기 자신을 호출하는 것으로 나타났습니다. WinHTTP HTTPS 경로는 여러 서버 인증서 오류에 대해 예외를 요청합니다. 이 프로젝트는 격리된, 승인된 랩에서 사용하십시오.
loader.spec은 라이브러리 구성을 제어합니다. 외부 바이너리는 플랫이며 자체 임포트 메타데이터를 가진 임베디드 PE 스텁을 포함합니다.| 경로 | 내용 |
|---|---|
agent/src/ | 로더, 스텁, 진입점, 모듈 디스패처 |
agent/libs/ | 디버그, 유틸리티, 전송 라이브러리, 테스트 지원, 리맵 정의, 헤더 전용 기능 인터페이스 |
basic/ 및 demo/ | 최소 예제 및 모듈 디스패치 예제 |
tests/ | LibUtils 및 디스패처 테스트 소스 |
tools/ 및 server/ | 로컬 러너 및 선택적 Go 테스트 서버 |
검증된 빌드는 Windows 11 x64에서 MSYS2 UCRT64 툴체인, MinGW-w64 GCC 16.1.0, Temurin JDK 25.0.4.1을 사용했습니다. PATH에 Bash, GNU Make, x86_64-w64-mingw32-gcc, Python 3, zip, java가 있어야 합니다. 빌드는 또한 crystal-palace/crystalpalace.jar와 프로젝트별 dfr_agent.spec을 포함한 agent/libs/cp-dfr-defs/ 아래의 리맵 파일들을 필요로 합니다.
프로젝트 루트에서 먼저 LibTCG 아카이브를 빌드하십시오. 프로젝트 링커 스펙은 라이브러리 디렉터리 옆에 이 아카이브가 있기를 기대합니다.
make -C agent/libs/libtcg x64
cp agent/libs/libtcg/libtcg.x64.zip agent/libs/libtcg.x64.zip
make -C basic shellcode
common.mk의 아카이브 레시피가 MSYS2에서 IndentationError를 발생시키는 경우, python3 -c 명령의 여는 따옴표 바로 뒤에 import zipfile;을 배치하십시오. 이렇게 하면 줄 연속으로 인해 도입된 선행 공백이 제거됩니다. 빌드 감사에서는 스크래치 복사본에 해당 조정을 적용했습니다.
| 명령 | 출력 |
|---|---|
make basic | 기본 TCP 빌드 및 러너 |
make demo | 데모 TCP 빌드 및 러너 |
make -C basic http 또는 make -C demo http | HTTP 변형 및 러너 |
make basic-debug 또는 make demo-debug | TCP 디버그 변형 및 러너 |
make test | 테스트 PICO 페이로드 및 러너 |
출력물은 bin/에 생성됩니다. 빌드 변형은 순차적으로 수행하고, 보관하려는 산출물은 다른 변형을 빌드하기 전에 복사하십시오. 프로젝트들이 출력 파일 이름을 공유합니다.
| 빌드 | 바이트 |
|---|---|
| 기본 TCP | 6,769 |
| 기본 HTTP | 7,922 |
| 기본 TCP 디버그 | 9,086 |
| 데모 TCP | 13,311 |
| 데모 HTTP | 14,464 |
| 데모 TCP 디버그 | 15,524 |
| 테스트 스위트 | 18,460 |
이 크기들은 사용 가능한 LibTCG 아카이브를 사용하여 재현되었습니다. 포함된 소스에서 아카이브를 다시 생성한 깨끗한 스크래치 빌드는 6,830바이트의 기본 TCP 페이로드를 생성했습니다. 테스트 PICO는 배너 이름이 Suture로 변경된 후 18,444바이트로 측정되었습니다.
테스트 소스는 LibCPLTest를 통해 17개의 유틸리티 테스트와 8개의 모듈 디스패치 테스트를 등록합니다. 실패한 어서션은 치명적이지 않으며 Windows 디버거 스트림을 통해 기록됩니다. make test가 성공하면 빌드가 확인됩니다. 테스트 결과를 확인하려면 격리된 런타임 세션의 디버거 출력이 필요합니다.
scaffold.sh를 사용하여 기본 템플릿에서 프로젝트를 생성하십시오. 라이브러리 레이아웃과 mergelib 규칙은 라이브러리 템플릿을 참조하십시오.
포함된 고지 사항은 LICENSE.txt를 참조하십시오. 이 트리에는 Crystal Palace, LibTCG, cp-dfr-defs의 코드가 포함되어 있습니다. LibCPLTest 및 LibWinHttp 래퍼에 대한 포함된 업스트림 고지 사항을 참조하십시오. 벤더링된 cp-dfr-defs 파일은 업스트림 커밋 202473b를 기반으로 하며 로컬 dfr_agent.spec 오버레이를 포함합니다.
이 프로젝트를 위해 생성된 마스코트 일러스트입니다. 참고 자료로는 BingusLdr 마스코트 리믹스와 공식 Cobalt Strike 캐릭터 아트워크가 있습니다.