♧ Godown 安全知识树

HTTP/3 服务端实现指纹:SETTINGS 三项与 QPACK 解码预算识别

pentest/recon · verified

一句话结论

HTTP/3 服务端在连接建立后于控制流发送 SETTINGS 帧,其中 SETTINGS_QPACK_MAX_TABLE_CAPACITY、SETTINGS_MAX_FIELD_SECTION_SIZE、SETTINGS_QPACK_BLOCKED_STREAMS 三项的取值与是否发送在不同实现间存在稳定差异;读取这三项即可区分 Bun、quic-go、aioquic 等服务端实现,并初筛其 QPACK 解码预算是否公告为 0(不限),用于资产测绘中定位未修复或弱配置的 HTTP/3 端点。

原理

  • HTTP/3 把头部压缩(QPACK)与连接配置拆成独立单向流:连接在 QUIC 握手完成后,由服务端在控制流(单向流类型 0x00)上发送 SETTINGS 帧,声明 QPACK 动态表容量、字段段上限与可阻塞流数等参数。
  • 三项关键参数:
  • SETTINGS_QPACK_MAX_TABLE_CAPACITY(0x01):QPACK 动态表容量,决定编码器可插入多少表项;
  • SETTINGS_MAX_FIELD_SECTION_SIZE(0x06):一个头部块解码后的最大尺寸,是端点向对端公告的解码预算。按 HTTP/3 语义,缺省或不发送即表示不限制;
  • SETTINGS_QPACK_BLOCKED_STREAMS(0x07):允许被动态表插入阻塞的请求流数量。
  • 不同语言/库在默认值取舍上不同,形成可复用的实现指纹。原文在隔离环境实测(probe 模式读取 SETTINGS):
实现版本 QPACK_MAX_TABLE_CAPACITY MAX_HEADER_LIST_SIZE QPACK_BLOCKED_STREAMS
Bun 1.4.3 4096 16384 100
aioquic 1.7.0 4096 0(不限) 16
quic-go 0.56.0 0(不限) 0(不限) 0
  • 指纹的价值不只在版本识别:MAX_FIELD_SECTION_SIZE 为 0 表示解码侧没有公告任何字段段预算;公告非 0 也不代表实现真的执行预算(原文实测 Bun 1.4.3 公告 16384 但未执行)。因此该指纹是资产初筛信号,不能替代对实现修复状态的版本核对。
  • QUIC 载荷全程加密,中间设备看不到 SETTINGS;识别只能发生在客户端/端点侧(持有 TLS 密钥日志可解密观察),或在主动探测客户端读取。

触发条件

  • 目标开放 UDP 端口并支持 HTTP/3:HTTP 响应头出现 Alt-Svc: h3=":443"(或 h3-29 等旧版本),或已知资产运行 Bun、quic-go、aioquic、quiche 等服务端;
  • 探测端具备可完成 QUIC 握手的 HTTP/3 客户端(或可访问端点侧抓包与 TLS 密钥日志);
  • 目标实现使用稳定默认配置;若位于 CDN/反向代理之后,读到的是边缘节点实现而非源站;
  • 主动探测会产生一次真实 QUIC 连接,需在授权范围内进行。

利用步骤

  1. 确认 HTTP/3 可达:对目标域名发起 HTTPS 请求,检查 Alt-Svc 是否通告 h3;也可直接向 UDP 443 发送 QUIC Initial 判断是否响应。
  2. 用支持 HTTP/3 的客户端完成握手,读取服务端控制流(单向流类型 0x00)的第一个 SETTINGS 帧;若客户端不直接暴露,开启 qlog/keylog 记录握手。
  3. 记录三项参数值:0x01、0x06、0x07。缺失的参数按 HTTP/3 语义记为该参数未公告(如 MAX_FIELD_SECTION_SIZE 缺省为不限)。
  4. 与已知指纹表比对,判断实现类型: - 4096 / 16384 / 100 对应 Bun 1.4.x 系列; - 4096 / 0 / 16 对应 aioquic 1.7.x; - 0 / 0 / 0 对应 quic-go 0.56.x 等旧版 Go 实现。
  5. 对 MAX_FIELD_SECTION_SIZE 为 0 的端点标记为“无解码预算公告”,再结合实现版本与官方修复公告核对是否仍存在预算缺失;公告非 0 的端点也需核对实现是否真的执行该预算。
  6. 资产测绘时可用 JA4Scan-QUIC 这类工程化指纹工具批量采集同类握手参数,文章给出的 aioquic 1.7.0 示例指纹形如 0310000ss000_2a673bc4abf8_db4d1fe4882a_sr1s0seb0750(字段含义与版本以工具文档为准)。

PoC

原文无独立 PoC,仅有作者自建探测脚本的实测结果。最小验证方法是读取 SETTINGS 三项,不涉及任何放大/DoS 载荷:

# 方式一:端点侧持有 TLS 密钥日志时,用 Wireshark/tshark 解密 HTTP/3 控制面
# 在 Wireshark 的首选项 TLS 中设置 (Pre)-Master-Secret log filename,
# 过滤 http3 后查看 Control Stream -> SETTINGS,记录 0x01/0x06/0x07 参数
tshark -r h3.pcap -o tls.keylog_file:keys.log -Y "http3" -V

# 方式二:主动探测(需授权)
# 使用支持 HTTP/3 的客户端连接目标,打印握手后的 SETTINGS;
# 不同客户端 API 不同,例如 aioquic 的 H3Connection 会在连接对象中保存
# 对端 SETTINGS,读取后与上表比对。

说明:原文使用的探测客户端来自其开源 PoC 的 probe 模式,本卡不复述其代码与仓库地址。

变体与关联

  • 关联 [[pentest-recon-http2-client-fingerprint]]:同一思路的另一侧——HTTP/2 用 SETTINGS/WINDOW_UPDATE/PRIORITY 识别客户端,本卡用 HTTP/3 服务端 SETTINGS 识别服务端实现与预算配置。
  • 变体:与 TLS JA3/JA4、QUIC 版本协商、Alt-Svc 组合,形成“UDP 可达 + QUIC 版本 + HTTP/3 SETTINGS”的多层资产指纹;JA4Scan-QUIC 是这类组合指纹的工程化形态。
  • 变体:被动识别。端点侧记录每个入站 HTTP/3 连接的 SETTINGS,可反过来识别访问者所用客户端库(与 HTTP/2 客户端指纹互补)。
  • 边界:实现升级会改变默认值;CDN/反向代理终止 QUIC 后读到的是边缘节点指纹;SETTINGS 值可由实现方修改,指纹会漂移;公告值不等于执行值,识别结果需用版本信息交叉验证。

检测与防御

  • 检测(防守方):在端点侧记录 HTTP/3 连接日志(qlog/密钥日志),关注同一来源短时间内建立 QUIC 连接后仅读取 SETTINGS 即断开的探测行为;网络侧因 QUIC 加密只能看到“单条 UDP 流内握手后立即结束”的弱信号,置信度低。
  • 防御(资产方):不要依赖实现默认值隐藏指纹;对 MAX_FIELD_SECTION_SIZE 明确公告并在解码路径中真实执行,避免“公告非 0 但不生效”的弱配置;对外仅暴露必要的 h3 端点,并对 UDP/443 做连接速率限制。
  • 隐私/合规边界:该指纹只能识别实现类型与配置,不足以定位单个用户;主动探测需取得授权。