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/是否对齐”理解一致。
利用步骤
- 确认 BOF 的参数消费顺序(读源码或反汇编
go),列出每个参数是 int 还是 string。 - 打包:为每个参数写 4 字节长度(int 为 4,string 为
strlen+1),再写内容;最后在最前面写总长度。 - 将打包后的缓冲区与长度传给 BOF 入口(
go(args, alen))。 - BOF 内部
BeaconDataParse(&parser, args, alen)跳过总长;按顺序BeaconDataInt/BeaconDataExtract取值。 - 验证:用原文的
Output %d %sBOF 测试,命令行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 可能越界读取或错位解析。