一个用于攻击性工程和 C2 研究的 Windows 植入物开发框架。
一个面向攻击性工程与 C2 研究的现代 Windows 植入体开发框架。
Suture 使用 Crystal Palace 构建一个扁平二进制文件,将位置无关加载器(PIC)与模块化 PICO 载荷配对。项目在链接时通过 mergelib 组合能力库。该演示在启动时注册模块,并按名称分派传入的命令。一个小型 Go 服务器记录 TCP 和 HTTP 流量以供检查。
实验状态。 已编译并链接了七个变体。运行时行为尚未验证。静态反汇编显示,该演示的解析器在尝试解析
GetModuleHandleA时调用了自身。WinHTTP HTTPS 路径会针对若干服务器证书错误请求异常。请在隔离的授权实验环境中使用此项目。
loader.spec 控制库的组合。外层二进制文件是扁平的,并包含一个带有自身导入元数据的嵌入 PE stub。| 路径 | 内容 |
|---|---|
agent/src/ | 加载器、stub、入口点和模块分派器 |
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 以及 agent/libs/cp-dfr-defs/ 下的重映射文件,包括项目专用的 dfr_agent.spec。
从项目根目录开始,首先构建 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,请将 import zipfile; 紧接在 python3 -c 命令的开引号之后。这样可以消除由行续接引入的前导空白。构建审计在其临时副本中使用了该调整。
| 命令 | 输出 |
|---|---|
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 个实用工具测试和八个模块分派测试。失败的断言是非致命的,并通过 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 角色艺术作品。