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 连接,需在授权范围内进行。
利用步骤
- 确认 HTTP/3 可达:对目标域名发起 HTTPS 请求,检查
Alt-Svc是否通告 h3;也可直接向 UDP 443 发送 QUIC Initial 判断是否响应。 - 用支持 HTTP/3 的客户端完成握手,读取服务端控制流(单向流类型 0x00)的第一个
SETTINGS帧;若客户端不直接暴露,开启 qlog/keylog 记录握手。 - 记录三项参数值:
0x01、0x06、0x07。缺失的参数按 HTTP/3 语义记为该参数未公告(如MAX_FIELD_SECTION_SIZE缺省为不限)。 - 与已知指纹表比对,判断实现类型:
-
4096 / 16384 / 100对应 Bun 1.4.x 系列; -4096 / 0 / 16对应 aioquic 1.7.x; -0 / 0 / 0对应 quic-go 0.56.x 等旧版 Go 实现。 - 对
MAX_FIELD_SECTION_SIZE为 0 的端点标记为“无解码预算公告”,再结合实现版本与官方修复公告核对是否仍存在预算缺失;公告非 0 的端点也需核对实现是否真的执行该预算。 - 资产测绘时可用 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 做连接速率限制。 - 隐私/合规边界:该指纹只能识别实现类型与配置,不足以定位单个用户;主动探测需取得授权。