♧ Godown 安全知识树

SRDI RDI2 Header 协议:用户参数随载荷传递并直接调用 DLL 指定导出函数

pentest/c2 · verified

一句话结论

在 SRDI 载荷前放置一个 0x20 字节的 RDI2_HEADER,用偏移字段描述 raw PE 与用户数据的相对位置,并用 Flags + ExportHash 请求直接调用目标 DLL 的指定导出函数(导出分支不经过 DllMain);这样生成器与 loader 解耦,同一份 shellcode 可以携带任意字节参数并在内存中执行自定义业务入口。

原理

  • Header 是 payload 协议:RDI2_HEADER 固定 0x20 字节:Magic(0x32494452,小端即 "RDI2")、Version(当前 2)、Flags(bit0 RDI_FLAG_EXPORT)、PeOffset(raw PE 相对 header 起始的偏移,当前 0x20)、PeSize、UserOffset、UserSize、ExportHash(目标导出函数名的 ROR13 hash)、Reserved。生成器只负责拼接并填 header,loader 入口只从 RCX/ECX 拿到 header 指针,再按偏移解析。
  • 为什么用相对偏移:PeOffset/UserOffset 都相对于 header,而不是相对 shellcode 起始。front 布局 [bootstrap][RDI .text][header][raw PE][user data] 与 post 布局 [bootstrap][header][raw PE][user data][RDI .text] 因此可以共享同一套 loader 逻辑,只要 bootstrap 把 header 地址传给 loader。
  • 用户参数的编码与布局:--user-data 读取文件原始字节,--user-data-hex 解析十六进制串;进入拼接阶段后统一为 uint8_t* user + size。有用户数据时 UserOffset = sizeof(RDI2_HEADER) + PeSize,UserSize = 数据长度;无数据时两者为 0。loader 计算 user_ptr = header + UserOffset,不关心参数来自文件还是命令行。
  • 导出调用的判定:只看 Flags 是否含 RDI_FLAG_EXPORT 且 ExportHash != 0,不看 UserOffset/UserSize。用户参数只提供数据,标志位决定“这次不走默认入口,而调用指定导出函数”。生成器支持 --export-name <name>(自动计算 ROR13)或 --export-hash <value>。
  • 调用顺序:loader 完成 TLS data 初始化与 TLS callback 后按分支执行。Entry_Dll 分支调用 DllMain(DLL_PROCESS_ATTACH);导出分支(Flags 含 RDI_FLAG_EXPORT 且 ExportHash != 0)为 ResolveExportByHash → ScrubMappedPeHeaders → 直接 call 导出函数 → ret,全程不调用 DllMain(原文图3 汇编所示)。导出函数如需依赖 DllMain 的初始化状态,必须自行完成。
  • 调用约定:x64 下导出函数原型为 void (*)(void* image_base, void* user_data, uint32_t user_size),对应 RCX = mapped image base、RDX = user data、R8D = user size;x86 下使用 __cdecl,由调用方压栈 user_len、user_ptr、dst_base 并在返回后 add esp, 0Ch。若 x86 导出误用 __stdcall,被调函数与 loader 都会清栈,导致栈不平衡。
  • 为什么有用:DllMain 的签名固定,不适合作为通用参数入口;把参数塞进 lpReserved 会破坏语义。指定导出函数让 DLL 保持轻量 DllMain,业务初始化(解析 JSON/TLV/配置块、启动任务)通过独立入口完成。
  • 查找方式:按导出名的 ROR13 hash 在映射后 DLL 的导出表中匹配,适用于按名称导出的函数;名称大小写影响 hash,生成器与目标 DLL 必须一致。

触发条件

  • Windows 目标,已具备 shellcode 投递/执行能力(C2 shinject、脚本或宏加载器、钓鱼落地器等)。
  • 使用支持 RDI2 Header 的 SRDI 生成器把目标 DLL/EXE 转为 shellcode;目标 DLL 导出了期望的入口函数(或使用已知 ROR13 hash)。
  • 需要向载荷传递配置、密钥、JSON/TLV 或二进制结构,且不希望依赖文件落地或环境变量。
  • loader 与目标 PE 架构匹配(x64 或 x86);x86 导出函数必须显式 __cdecl。

利用步骤

  1. 在目标 DLL 中实现 DllMain 与业务导出函数,例如 extern "C" __declspec(dllexport) void Start(void* image_base, void* user_data, uint32_t user_size)。
  2. 准备用户参数:文件(--user-data)或十六进制串(--user-data-hex),内容可以是字符串、JSON、TLV 或加密配置块。
  3. 生成 shellcode:指定输入 PE、输出路径、--arch x64 --type front|post,用 --export-name 或 --export-hash 指定目标导出函数,并附加用户数据。
  4. loader 执行时从 RCX/ECX 取 RDI2_HEADER,按 PeOffset/PeSize 映射 raw PE;按 UserOffset/UserSize 计算参数地址与长度。
  5. 若 RDI_FLAG_EXPORT 置位且 ExportHash != 0,在映射后的导出表中按 ROR13 匹配函数地址;完成 TLS 与 DllMain 后,按平台调用约定调用 export(image_base, user_data, user_size)。
  6. 目标导出函数消费参数;示例用 | 分隔多个参数,在堆上拷贝后切分,弹窗显示标题、内容和映射基址。

PoC

原文给出了完整的测试 DLL 与生成命令。最小可复现要点:

// 目标 DLL 的导出入口(x86 必须加 __cdecl)
#ifdef _M_IX86
extern "C" __declspec(dllexport) void __cdecl Start(void* image_base, void* user_data, uint32_t user_size)
#else
extern "C" __declspec(dllexport) void Start(void* image_base, void* user_data, uint32_t user_size)
#endif
{
    char* buf = (char*)HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, user_size + 1);
    CopyMemory(buf, user_data, user_size);
    // 按业务格式解析 buf,例如以 '|' 分隔多个参数
}
Convert2Shellcode.exe --arch x64 --type front --input messagebox_export.x64.dll \
  --output msgbox_x64_front.bin --export-name TestMessageBox \
  --user-data-hex 546573745469746c657c48656c6c6f2046726f6d2053524449207632
# hex 解码为 "TestTitle|Hello From SRDI v2"

原文验证:生成的 shellcode 由 loader 执行后弹出 TestTitle [ImageBase: 0x...] / Hello From SRDI v2;不传用户数据时弹出“未检测到用户参数!”的提示(其中乱码是字符集问题)。

变体与关联

  • front/post 布局:两者只在 bootstrap 与 RDI 代码位置不同,header 相对偏移不变;RCX/ECX 始终指向 header。
  • 仅导出模式与默认入口:未设置 RDI_FLAG_EXPORT 时走 EXE OEP 或 DLL DllMain;设置后仍先调用 DllMain,再调用导出函数。
  • x86 差异:PE32 使用 IMAGE_NT_OPTIONAL_HDR32_MAGIC (0x10B),仅支持 32 位 loader 映射 32 位 PE32;导出函数调用约定为 __cdecl。详见 [[pentest-c2-srdi-pe32-x86-adaptation]]。
  • 关联:基础 sRDI 流程见 [[pentest-c2-srdi-reflective-dll-injection-shellcode-loader]];加载器/映射细节见 [[pentest-c2-udrl-prepended-reflective-dll-injection]]。
  • ROR13:与常见 Windows API 哈希解析算法相同,可用模块名/函数名统一计算,便于在 loader 与生成器之间传递。

检测与防御

  • 内存检测:shellcode 载荷在前段含有 RDI2 魔数与 0x20 字节结构化 header,随后是 MZ/PE;查找私有可执行内存中出现 "RDI2" 与紧邻 PE 头的组合,可作为 SRDI 变种的特征。
  • 行为检测:监控 VirtualAlloc 大块可执行内存、PE 映射、DllMain 调用后紧接导出函数调用;关注参数缓冲区(用户数据)在内存中的传递与解析。
  • 防御:对可执行内存实施 EDR 扫描与代码完整性策略;限制未知 shellcode 执行;对 C2 载荷投递链做网络与终端联动检测。
  • 取证:若捕获到载荷,可按 header 偏移解析 raw PE 与用户数据,提取配置、回连地址与业务入口,辅助归因与阻断。