Merged
fix(http): strictly validate MCP and A2A content lengths #384
fix(http): strictly validate MCP and A2A content lengths #384
Merged
Yiyang ShaoAdd on 16 days ago
Yiyang ShaoCollaborators
16 days ago

Paired: GitHub #188 ↔ GitCode !384

问题与修复

MCP/A2A 的公共 HTTP 解析器通过 std::stoul 读取 Content-Length,转换失败后按零长度继续解析;带尾随字符的值也可能被部分接受。重复长度头在写入 map 时被覆盖,无法识别消息边界歧义。

  • 使用 std::from_chars 严格解析完整的非负十进制 size_t 长度,拒绝空值、符号、尾随字符及溢出,同时保留合法的首尾 SP/HTAB 和前导零。

  • 按不区分大小写的字段名识别并拒绝重复 Content-Length(包括相同值)、逗号列表,以及所有带 Transfer-Encoding 的报文(当前不支持传输编码解码,避免把 chunked 正文静默当作空响应)。

  • 新增可选 HttpParseStatus 输出,区分 COMPLETE、INCOMPLETE 和 INVALID;保留原 bool 调用方式,失败时 consumedBytes 为零。

  • 通过减法进行头部边界检查,避免 headerEnd 加法溢出。

  • MCP 同步客户端对非法报文立即返回失败;读回调和关闭回调共用解析过程,关闭时先排空 socket 缓冲区,避免响应数据与 FIN 同批到达时误判失败。正文未收齐即关闭仍返回失败。

  • 静态检查整改:将两套解析器拆分为头字段校验与消息完整性解析,相关函数均少于 50 行;测试端口、超时和成功状态码使用命名常量;测试日志使用内联函数;补充测试替身的默认析构函数;接收缓冲区结构与真实 TcpSocket 的公开 inBuf_ 接口保持一致。

两套现有 HTTP 公共测试均补充相同的长度边界用例,并将原先把非法长度视为成功的预期改为拒绝。

验证

使用 GoogleTest v1.16.0 和 C++17,直接编译两套真实公共 HTTP 源码及对应测试文件:

  • MCP HTTP 公共测试:34 passed。
  • A2A HTTP 公共测试:47 passed。
  • 覆盖非法十进制、重复字段、传输编码冲突、合法空白、分段接收重试、size_t 上界和头部偏移溢出。
  • git -c core.whitespace=cr-at-eol diff --cached --check:通过,测试文件保留原有换行格式。
  • gitcode precommit check --run --yes:仓库没有 pre-commit 配置。
  • 新增真实 SendRequest + 脚本化 socket/event loop 测试:10 passed,覆盖正常收齐、分段、EOF 先于 OnRead、提前关闭、非法长度和 TE-only 立即失败。修改前的客户端在同一组测试中稳定复现 2 项失败,修改后通过。
  • 新增 CMake 测试目标已在独立构建环境编译并经 CTest 验证:10/10 passed。公共解析与客户端测试合计 91 项通过。
  • 未执行完整 SDK 构建或真实网络集成测试,回调顺序由脚本化 socket/event loop 控制。

兼容性与范围

合法单一长度头及未收全报文的重试行为保留。非法长度、重复长度和长度/传输编码冲突不再作为成功报文接受。状态参数位于 src 内部公共头文件,已有源码调用可省略它;涉及该实现的目标需要重新编译。

本次明确拒绝所有 Transfer-Encoding(含 chunked、identity 和空值),未增加解码能力。无 Content-Length 且无 Transfer-Encoding 时的消息定界行为维持原状。A2A src 内没有 ParseHeadersAndBody 的生产调用点,其客户端走独立解析路径,因此无需为该 helper 适配额外 A2A 调用方。

参考:RFC 9110 §8.6、RFC 9112 §6.3。

likedislike
Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for Yiyang Shao's contribution.)
atomgit-bot
atomgit-bot
16 days ago Comments:

变更摘要

本 PR 聚焦 MCP 与 A2A 两套 C++ SDK 共用的 HTTP 报文解析逻辑,将 Content-Length 的处理从原先基于 std::stoul 的宽松解析改为严格校验:新增 HttpParseStatus 枚举并通过 ParseHeadersAndBody 的可选输出参数区分 COMPLETE、INCOMPLETE 与 INVALID,拒绝非法十进制长度、重复长度头、逗号列表以及与 Transfer-Encoding 并存的歧义报文,同时修复头部边界检查的加法溢出问题,并让 MCP 同步客户端在收到非法报文或连接提前关闭时立即返回失败。两套公共 HTTP 测试同步补充了长度边界用例,并把原先把非法长度视为解析成功的预期改为拒绝。

主要改动

  • 新增解析状态输出接口: 在 MCP 与 A2A 的 http_common.h 中新增 enum class HttpParseStatus { COMPLETE, INCOMPLETE, INVALID },ParseHeadersAndBody 增加默认值为 nullptr 的 HttpParseStatus* status 参数,保持原有 bool 调用方式兼容,失败时 consumedBytes 保持为零。
  • 严格解析 Content-Length: 使用 std::from_chars 解析完整非负十进制 size_t,要求解析指针到达字符串末尾,拒绝空值、符号、小数、内嵌空格、尾随字符及溢出,同时保留合法首尾空白与前导零;头部字段名统一小写化后按 content-length 匹配。
  • 拒绝歧义消息定界: 解析过程中记录 hasContentLength 与 hasTransferEncoding,重复 Content-Length(含大小写不同但同名)直接判为 INVALID,Content-Length 与 Transfer-Encoding 同时出现同样拒绝,避免头部 map 覆盖导致的边界歧义。
  • 头部边界溢出修复: 将 headerEnd + HTTP_HEADER_BODY_SEPARATOR_LENGTH > buffer.size() 改为 headerEnd > buffer.size() || buffer.size() - headerEnd < HTTP_HEADER_BODY_SEPARATOR_LENGTH,通过减法比较避免加法回绕。
  • MCP 同步客户端失败语义: ParseHttpResponse 增加 HttpParseStatus& 参数透传解析结果,SendRequest 在 INVALID 时立即置 error 并结束接收;OnClose 回调在响应未完成时补充 error = true,连接提前关闭不再产生成功响应;测试侧将非法长度用例预期改为 EXPECT_FALSE 并新增非法十进制、重复/冲突字段、合法空白、分段重试、size_t 上界与头部偏移溢出等用例。
likedislike
Incorrect?
atomgit-bot
atomgit-bot
16 days ago Comments:

代码审查

全部检查已完成,两处问题已上报,进入总结。

审查结论

已上报问题

# 优先级 文件:行 问题
1 P1 MCP/cpp-sdk/src/client/http_client.cpp:122-129 OnClose 中新增的 error = true 在响应数据尚未解析前就判定失败,导致"响应数据与 FIN 同批到达"时丢弃完全合法的响应(Connection: close 下高频触发),属本次引入的行为回归
2 P3 MCP/cpp-sdk/src/client/http_client.cpp:138-149 新增的 HttpParseStatus 三分支状态机及 OnClose 失败判定没有任何回调路径测试,上述回归无测试拦截

逐文件确认

  • A2A/cpp-sdk/src/shared/http_common.cpp — 无问题。长度解析改用 std::from_chars 并校验 ec/ptr,空值、符号、尾随字符、溢出均被拒;重复 Content-Length、CL+TE 并存被拒;头边界检查改为减法形式,headerEnd > buffer.size() + size() - headerEnd < 4 无溢出,consumedBytes = bodyStart + contentLength 仅在 size() - bodyStart >= contentLength 时执行,不会溢出。
  • A2A/cpp-sdk/src/shared/http_common.h — 无问题。新增 HttpParseStatus 与可选尾参 status = nullptr,注释同步更新;该文件 ParseHeadersAndBody 在 A2A src/ 内无生产调用方(服务端走 nodejs http_parser),风险面仅限测试。
  • A2A/cpp-sdk/tests/ut/shared/test_http_common.cpp — 无问题(仅一处可选清理:文件末尾仍无换行,属既有风格,未报)。新增用例覆盖非法十进制、重复/传输编码冲突、合法空白、分段重试、size_t 上界与头偏移回绕;InvalidContentLength 的预期已由"成功"改为"拒绝",与实现一致。
  • MCP/cpp-sdk/src/client/http_client.cpp — 发现 2 处(见上)。
  • MCP/cpp-sdk/src/shared/http_common.cpp — 无问题。除与 A2A 相同的严格化逻辑外,headers[normalizedKey] 保持了原 std::transform(...::tolower) 后存小写键的既有契约(CONTENT_LENGTH_HEADER 等常量为小写),未改变 getContentType 等消费方行为。
  • MCP/cpp-sdk/src/shared/http_common.h — 无问题。声明与实现一致,默认参数保持源码兼容。
  • MCP/cpp-sdk/tests/ut/shared/http_common_test.cpp — 无问题。与 A2A 侧用例对称,ParseHeadersAndBody_InvalidContentLength 的预期同步更新为 false / body 为空 / consumedBytes == 0。

总体风险判断

解析层严格化本身实现正确、边界处理到位(溢出、回绕、重复头均有防护并有测试),A2A 侧因无生产调用方风险很低。主要风险集中在 MCP 同步客户端的错误判定顺序:本次为修复"连接早关闭被误判成功"而引入的 error = true 走向了另一个极端,会把已收齐的响应误判为失败,建议按 finding 1 的方式在 OnClose 中先尝试解析残留缓冲再判定失败。

合计:P1 × 1,P3 × 1。

类型 数量
🔴 阻塞 1
🟡 建议 1

⛔ 需要修改

likedislike
Incorrect?
atomgit-bot
atomgit-bot
16 days ago Comments:

AtomGit AI 助手使用指南

在 PR 评论中使用命令即可触发。支持在普通评论和代码行评论中使用。

功能 命令 说明
代码审查 /ai review 检查代码质量、潜在问题、安全风险
PR 摘要 /ai summary 生成 PR 变更内容的结构化摘要
代码解释 /ai explain 解释代码变更的逻辑和意图
自由提问 @atomgit-bot <问题> 询问关于本 PR 的任何问题
帮助 /ai help 显示此帮助信息

免责声明

AI 助手可能存在误判,请结合自身判断。可以对评论点 👍 或 👎 帮助我们改进。

likedislike
Incorrect?
OopenJiuwen-botCollaborators
16 days ago Added label: sig/sig-agent-protocol
openJiuwen-botCollaborators
16 days ago Comments:

欢迎来到 openJiuwen 社区

Hey @YiyangShao , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。

联系指引

有疑问可以联系 SIG: sig-agent-protocol ,
维护者是: @YiyangShao, @xinyu-jiuwen ,
审核者是: @gcw_hx9prznZ, @mingo007 .

likedislike
44 messages are collapsed here。 See more
maoqiming
maoqimingCollaborators
6 days ago Comments:

/lgtm
/approve

likedislike
OopenJiuwen-botCollaborators
6 days ago Added label: approvedlgtm-mingo007
openJiuwen-botCollaborators
6 days ago Comments:

Review Code Feedback

  • The label lgtm-mingo007, approved was added to this pull request. It means that mingo007 reviewed the code changes. 👋
Tips
  • If this pull request is not merged while all conditions are met, comment /check-pr to try again. 😄
likedislike
OopenJiuwen-botCollaborators
6 days ago Merged pull request
OopenJiuwen-botCollaborators
6 days ago Removed label: ci-successful