♧ Godown 安全知识树

BOF 参数打包与 BeaconDataParse 兼容:4 字节总长 + {ArgSize}{Arg} 序列

pentest/c2 · verified

一句话结论

BOF 的 go(char *args, int alen) 解析的是 Cobalt Strike 私有参数格式:整个缓冲区前 4 字节是总长度,之后每个参数由 {4 字节长度}{参数内容} 组成;BeaconDataParse 会先 buffer += 4 跳过总长,BeaconDataInt 从 buffer+4 读 4 字节并前进 8,BeaconDataExtract 读长度后返回内容指针;自研 C2 的 BofPack 必须按同一格式打包(数字参数长度 4、字符串含 NUL 结尾),否则 BOF 参数错位。

原理

  • Cobalt Strike 的 BOF 参数不是普通的 argv,而是一个紧凑的 TLV 风格缓冲区。BeaconDataParse(PDATA parser, PCHAR buffer, INT size) 的实现:
VOID BeaconDataParse(PDATA parser, PCHAR buffer, INT size) {
    if (parser == NULL) return;
    parser->original = buffer;
    parser->buffer = buffer;
    parser->length = size - 4;
    parser->size   = size - 4;
    parser->buffer += 4;   // 跳过前 4 字节的总长度
}
  • 参数格式:${totalLength}${stringArgumentLength}${stringArgument}${intArgument}...。每个参数前都有 4 字节长度字段:
  • 字符串参数:长度包含结尾 \0,内容按字节存放;
  • 整数参数:长度为 4,内容是 32 位整数本身(不再额外编码)。
  • 读取函数的行为差异:
  • BeaconDataInt:_Memcpy(&Value, parser->buffer + 4, 4); parser->buffer += 8; parser->length -= 8;——先跳过本参数的 4 字节长度字段,再读 4 字节值,整体前进 8。
  • BeaconDataExtract:读 parser->buffer 处的 4 字节长度,返回 parser->buffer + 4 的指针,并按 4 + 长度 前进。
  • BeaconDataLength:只读长度字段,不移动指针。
  • 打包侧(BofPack)的算法:遍历命令行参数,若 IsDigit 为真,按 sizeof(UINT32) 存整数;否则按 strlen + 1 存字符串;每项累加 长度 + sizeof(UINT32);最后在最前面写入整个缓冲区的总长度(*pdwBofArgSize += sizeof(UINT32))。
  • 为什么容易错:如果把参数直接按 C 结构体/argv 传给 BOF,BeaconDataInt 会把参数内容当成“长度字段 + 值”解析,导致后续所有参数错位;如果总长度字段未写入或写错,BeaconDataParse 的 length = size - 4 也会偏差 4 字节。

触发条件

  • 加载器需要在 Beacon/自研 C2 中执行带参数的 BOF(如目标主机、端口、命令、凭据等)。
  • BOF 使用 BeaconDataParse/BeaconDataInt/BeaconDataExtract/BeaconDataLength 解析参数。
  • 攻击者能控制参数的顺序、类型(数字/字符串)与总长度。
  • 自研 C2 的打包端与 BOF 解析端对“长度字段是否包含 NUL/是否对齐”理解一致。

利用步骤

  1. 确认 BOF 的参数消费顺序(读源码或反汇编 go),列出每个参数是 int 还是 string。
  2. 打包:为每个参数写 4 字节长度(int 为 4,string 为 strlen+1),再写内容;最后在最前面写总长度。
  3. 将打包后的缓冲区与长度传给 BOF 入口(go(args, alen))。
  4. BOF 内部 BeaconDataParse(&parser, args, alen) 跳过总长;按顺序 BeaconDataInt/BeaconDataExtract 取值。
  5. 验证:用原文的 Output %d %s BOF 测试,命令行 123456 admin 应输出 123456 admin;若输出错位/乱码,检查长度字段与 NUL 结尾。

PoC

// BofPack 核心(原文截图逻辑)
for (DWORD i = 0; i < argc; i++) {
    if (IsDigit(argv[i])) {
        arg[i].length = sizeof(UINT32);
        arg[i].num = atoi(argv[i]);
        _Memcpy(arg[i].buffer, &arg[i].num, 4);
    } else {
        arg[i].length = StringLengthA(argv[i]) + 1;
        _Memcpy(arg[i].buffer, argv[i], arg[i].length);
    }
    *pdwBofArgSize += (arg[i].length + sizeof(UINT32));
}
*pdwBofArgSize += sizeof(UINT32);   // 总长度字段
// BOF 侧读取
datap parser;
BeaconDataParse(&parser, args, alen);
int num = BeaconDataInt(&parser);              // 读 4 字节值
char *s = BeaconDataExtract(&parser, NULL);    // 读长度 + 字符串
BeaconPrintf(CALLBACK_OUTPUT, "Output %d %s", num, s);

变体与关联

  • 与 pentest-c2-beacon-inline-execute-coff-relocation-loader 的关系:该卡提到 Beacon 侧用 BeaconDataParse 解析数据包,本卡细化了参数 TLV 格式与打包算法。
  • 变体:不同 C2 的 BOF 兼容层可能增加对齐/长度校验;字符串参数是否包含 NUL、整数是否允许负数(IsDigit 只识别数字字符)需要按实际实现调整。
  • 相关:COFF 加载器的 BSS/GOT 兼容卡(pentest-c2-coff-loader-bss-dynamic-got-compat)解决符号/重定位,本卡解决参数数据面。

检测与防御

  • 检测:BOF 流量/命令中出现 {totalLength}{len}{arg} 结构的紧凑参数包;进程内 BeaconDataParse 特征调用与 BOF 代码页同时出现。
  • 防御:对 Beacon 进程做内存与 API 行为检测;限制动态代码执行;监控异常的参数解析模式。
  • 红队注意:打包长度必须与实际内容一致,字符串必须 NUL 结尾,否则 BOF 可能越界读取或错位解析。