
2026/11/17 4:29
HTTP/3トラフィックのインターセプト方法:QUICとQPACK
RSS: https://news.ycombinator.com/rss
要約▶
日本語訳:
HTTP/3 のトラフィックの傍受は、標準の TCP ベースのプロキシを回避して UDP を介した QUIC プロトコル上で動作するため、古いプロトコルを処理するよりも著しく困難です。従来の手法とは異なり、このデータをキャプチャするには InterceptSuite などの特殊なツールを用いて生の UDP パケットを直接管理する必要があります。重要な技術的な障壁の一つはヘッダーのデコードであり、コアツールでは生のバイトをキャプチャすることはできても、HTTP/3 API と QPACK ヘッダー用の特定の実装がない限りコンテンツを読み取ることはできません。これらの振る舞いを理解することは重要であり、HTTP/3 は TLS 1.3 を使用して接続を開始し、ALPN アイデンティファイヤーとして 'h3'を使用します。また、クライアントリクエストとサーバーレスポンスはそれぞれ偶数および奇数のストリーム ID を用いて区別されます。将来これを効果的にテストするには、クライアントに
--http3-only フラグを設定してフェールバックメカニズムを防ぎ、プロトコルの本質を隠すことを防止する必要があります。さらに、ブラウザは検査のために機能設定と証明書信頼ポリシーの特定のアジャストメントを必要とし、具体的には Chromium はローカルでインストールされた CA に対して QUIC をデフォルトで拒否し、ECH によってサイト名を隠します。Edge については、--disable-features=EncryptedClientHello と起源上で QUIC を強制するなどの特定の実装が必要です。その結果、開発者は SOCKS5 UDP リダイレクトや ProxyBridge などの外部ツールを使用しなければならず、そうでない場合、セキュリティツールは編集可能なリクエストヘッダーではなく読み込めない生の hex データしか表示しないため、効果的な分析が妨げられます。また、QPACK ダイナミックテーブルは以前送信された値への参照を用いてヘッダーを圧縮するため、インターセプションツールではフルテーブル状態を再構築するまでプレースホルダーを示す可能性があります。進行中のリクエストの編集を試みると、フレーム長が壊れているか静的なみの QPACK テーブルに依存しているため、タイムアウトや H3_FRAME_ERROR (0x106) が発生します。本文
HTTP/3 の傍受と編集ガイド:InterceptSuite を使った実践的解説
結論から言うと、HTTP/3 は HTTP プロキシを介しません。 それは QUIC プロトコル上で動作し、UDP を使用するためです。Burp Suite などの多くのプロキシは「TCP 上での HTTP」に基づいて構築されているため、HTTP/3 のトラフィックを見ることはできません。
HTTP/3 を傍受するには、UDP を中継でき、かつ QUIC に対して中間者攻撃(MitM)の役割を果たせるプロキシが必要です。その技術的詳細について解説します。
目次
- HTTP/3 で何が変化するか
- なぜ通常のプロキシ設定では機能しないか
- 実際のトラフィック:curl とブラウザの実験
- 実験室:すべてのバイトを見る
- 難しい部分:QPACK ダイナミックテーブル
- Replay: 独自の HTTP/3 リクエストを送信
- 制限事項とショートチェックリスト
HTTP/3 で何が変化するか
HTTP/1.1 または HTTP/2 と比較して、以下の 3 つの違いに注意してください。
1. プロトコルの基盤
- TCP ではなく QUIC 上で動作します。
- HTTP/3 (RFC 9114) は、QUIC (RFC 9000) を介して運ばれます。
- QUIC パケットは UDP データグラムの中に伝播します。
- TLS 1.3 は QUIC のハンドシェイクの一部 (RFC 9001) に含まれているため、「TCP 続いて TLS」という分離したステップは存在しません。
2. プロトコルの切り替え条件
- クライアントがサーバーが HTTP/3 を話すことを学ぶ必要があります。
- HTTP/3 の ALPN 名は
です。h3 - サーバーは
レスポンスヘッダーや DNS HTTPS レコード (RFC 9460) でこれを宣伝します。Alt-Svc - ブラウザは通常、最初の要求を TCP で送信してから QUIC に移行します。
- HTTP/3 の ALPN 名は
3. データの流れ(ストリーム)
- すべてはストリームです。
- QUIC コネクションには多くのストリームが持ち運ばれます。
- ストリーム ID の下位の 2 ビットがその種類を表します:
| ストリーム ID の末尾 (Binary) | 意味 |
|---|---|
| クライアント開始。両側から送信可能 |
| サーバー開始。両側から送信可能 |
| クライアント開始。クライアントのみが送信 |
| サーバー開始。サーバーのみが送信 |
- HTTP/3 の構造:
- すべてのクライアント開始の双方向ストリームは、1 つのリクエストとそのレスポンス (ストリーム 0, 4, 8 など) を表します。
- 一方通行のストリームは管理用です:コントロールストリームと 2 つの QPACK ストリーム。
- 最初のバイトでタイプが示されます:
(コントロール)、0x00
(QPACK エンコーダー)、0x02
(QPACK デコード)。0x03
傍受に関する重要な注意点
- 初期パケットの秘匿性:
- QUIC コネクションの最初のパケット (Initial パケット) は、コネクション ID から計算可能な鍵で保護されているため、実質的な秘匿性はありません。
- 受動的な観察者でもハンドシェイク内のサーバー名などを確認できます。
- 暗号化:
- ハンドシェイク以降は、TLS 1.3 エクスチェンジからの鍵を使って暗号化されています。両エンドのいずれでもない限り、これを読み取ることはできません。
なぜ通常のプロキシ設定では機能しないか
HTTP プロキシは
CONNECT メソッドを使ってトンネルを開きますが、これは TCP コネクションへのトンネルです (RFC 9114 セクション 4.4)。UDP を HTTP でトンネルするには別の方法 (CONNECT-UDP, RFC 9298) が存在しますが、多くのツールはこれを採用していません。
SOCKS5 の限界
- SOCKS5 は UDP を中継できます。 (コマンド:
, RFC 1928)UDP ASSOCIATE - しかし、多くのクライアント(例:Chromium)はこれを使用しません。Chrome のドキュメントによると、SOCKSv5 は TCP ベースのリクエストのプロキシ化にのみ使用され、UDP を中継できないとされています。
HTTP/3 をプロキシに入れるための方法
以下の 2 つのいずれかが必要です。
- アプリケーション側の実装: アプリケーション(またはライブラリ)が自身で SOCKS5 UDP を話します。
- 外部からのリダイレクト: アプリの外側からアプリのトラフィックをプロキシにリダイレクトします。(
やcurl
に使用する方法です。ProxyBridge もこれを独自に行います。)Edge
InterceptSuite の設定(Redirect タブ)
- プロキシを開き、Redirect タブをクリックして「Add」を選択し、プログラム名を入力します(例:
)。curl.exe - **「アクション」**は Proxy に保ったまま保存し、「Start Redirect」をクリックします。
- ステータス行には「127.0.0.1:4444 のプロキシを介してリダイレクト中」と表示され、TCP および UDP のトラフィックが InterceptSuite を通り抜けられます。プログラム側の設定は変更しません。
注意: インストール時やセットアップ時に必ず
に信頼を置くことを忘れないでください。宛先ホストとポートの制限もルールで設定可能です。InterceptSuite CA
実際のトラフィック:curl とブラウザの実験
curl を使用する場合
curl はシンプルで指示通り動作するため、最初のテスト対象として最適です。HTTP/3 サポートのあるビルドが必要です。
-
環境確認とインストール: Windows にバンドルされている
(8.x) の一部は HTTP/3 をサポートしていない場合があります。以下のコマンドで最新のビルドをインストールします。curlwinget install cURL.cURL新しいビルド(例:8.23.0)を確認します (
):curl -V... HTTP3, ngtcp2, nghttp3 -
テスト実行:
フラグは、TCP へのフォールバックを不可能にします。--http3-onlycurl --http3-only -sS -D - https://cloudflare-quic.com/cdn-cgi/trace- 出力には
が表示されます。HTTP/3 200
(CA 証明書検証跳过) は不要です。-k
は Windows の信頼ストアを使用しており、そこに InterceptSuite CA がインストールされているためです。curl
- 出力には
-
プロキシ履歴の確認:
- Proxy History ではコネクションが QUIC で、ホスト名
、ALPNcloudflare-quic.com
と表示されます。h3 - クライアントパケット (46 バイト): HTTP/3 タブでは以下のように読み取れます。
- Proxy History ではコネクションが QUIC で、ホスト名
-
リクエストの編集:
- Intercept を ON にし、
をuser-agent: curl/8.23.0
に置き換えて「Forward」を押します。user-agent: edited-by-proxy - テストサイトは
を返却表示します。uag=edited-by-proxy - サーバーは編集されたヘッダーを受け取りますが、クライアント(curl)はその変更を知らされていません。
- Intercept を ON にし、
-
SETTINGS フレーム: curl の SETTINGS フレームを見ると、
と表示されます。これは curl が QPACK ダイナミックテーブルを一切使用しないことを示しており、すべての curl リクエストは読みやすく編集しやすいです。QPACK_MAX_TABLE_CAPACITY: 0
ブラウザ(Microsoft Edge)のトラフィック
ブラウザは以下の理由で扱いが難しいです。
- ECH (Encrypted Client Hello): 実際のサイト名はハンドシェイク内部に隠されており、プロキシは CDN の公開名しか見えないため、間違った証明書の作成をブラウザが拒否します。
- ローカル CA の問題: Chromium はユーザーがインストールした CA で QUIC を実行しません(Windows の信頼ストアでも同様です)。
ブラウザの設定方法
以下の 3 つのフラグで起動してください:
msedge.exe --disable-features=EncryptedClientHello,UseDnsHttpsSvcb \ --ignore-certificate-errors-spki-list=<hash> \ --origin-to-force-quic-on=*
: ECH を無効にし、ブラウザが HTTPS DNS レコードを読むのを止めます。--disable-features=...
: Alt-Svc ヘッダーを待たずに Edge が即座に QUIC を試行します(すべてのホスト)。--origin-to-force-quic-on=*
: InterceptSuite CA で署名された QUIC コネクションに信頼します。--ignore-certificate-errors-spki-list=<hash>
SHA-256 ハッシュの取得方法
自身の CA ファイルから計算します:
openssl x509 -in intercept-ca.pem -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | openssl enc -base64
Edge がフラグを認識しない場合、テスト用プロファイルを使用するか、再起動する必要があります。Redirect ルールを有効にし、「あなたのブラウザは HTTP/3 を使用しました」と表示されたら正常です。
- InterceptSuite では ALPN
の QUIC コネクションとして表示されます。h3 - Edge の SETTINGS は curl と異なり、64 KB のダイナミックテーブルと最大 100 ブロックされたストリームを提供します。そのため、最初のヘッダーリクエスト以降はテーブル参照として送信できます。
実験室:すべてのバイトを見る
実際のサーバーでは仕組みが見えにくいので、小さな実験室(Python + aioquic)を用意しました。
- サーバー:
にあり、JSON で受信した内容を返却します。127.0.0.1:4433 - クライアント: SOCKS5 UDP リレーを通じてデータグラムを送信する HTTP/3 クライアントです。
SOCKS5 が UDP を運ぶ方法:
UDP ASSOCIATE は 2 つのパートで動作します。
- クライアントは TCP コネクションを開き、コマンド
(UDP ASSOCIATE) を送信します。03 - プロキシはアドレスとポートで応答(リレー設定)。
- クライアントは UDP データグラムをそのリレーアドレスへ送信します。
InterceptSuite のポート:
- TCP 上の SOCKS5:
127.0.0.1:4444 - UDP リレー:
(UDP ASSOCIATE への応答)127.0.0.1:4445
エンコーダーストリームラッパーの実装例
クライアント自身がデータグラムを SOCKS5 ヘッダーでラップします:
class Shim(asyncio.DatagramProtocol): """QUIC データグラムのそれぞれを SOCKS5 UDP ヘッダーでラップする""" def sendto(self, data, addr=None): hdr = b'\x00\x00\x00\x01' + socket.inet_aton(SERVER[0]) + struct.pack('!H', SERVER[1]) self.t.sendto(hdr + data, self.relay) def datagram_received(self, d, addr): if d[0:3] != b'\x00\x00\x00' or d[3] != 1: return self.proto.datagram_received(d[10:], SERVER) # 10 バイトのヘッダーを削除
難しい部分:QPACK ダイナミックテーブル
ここが注意が必要な部分です。コネクション上でより多くのリクエストを送信すると、ダイナミックテーブル(Dynamic Table)の使用が始まります。
例:リサイズの観察
- リクエスト 1 と 2 はそれぞれ 122 バイトでした。
- リクエスト 3 は 13 バイトになり、クライアントの QPACK エンコーダーストリームに 114 バイトのエントリが表示されました。
ヘッダーの圧縮構造
HTTP/3 では HPACK の弟である QPACK が以下の役割を果たします:
- 静的テーブル: 予定義された 99 つのヘッダーフィールド(
,content-type
など)を小さな番号で表現。:method - ハフマン符号化: テーブルにない文字列に対する圧縮。
- ダイナミックテーブル: コネクション中に成長するテーブル。QPACK ストリーム (02, 03) で満たされます。
QPACK エンコードの詳細
リクエスト 3 の 13 バイトは以下のように解析されます:
01 0B HEADERS フレーム、長さ 11 バイト 08 86 QPACK ブロックのプレフィックス(必須挿入カウントなど) D1 D7 静的テーブルからの 2 つのエントリ (GET, https) 10-16 「ポストベース索引を持つ索引化フィールド行」の指示が 7 つ(ダイナミックテーブル参照)
- プレースホルダー:
- HTTP/3 タブで
と表示されます。[dynamic table entry (post-base) N] - これらのエントリ値は以前、別のストリームで送信されたものが保持されており、現在の履歴行には含まれていません。拡張機能は一度に 1 つのエントリをデコードするため、プレースホルダーしか表示できないのです。
- HTTP/3 タブで
- 通信順序:
- キャプチャーでは、13 バイトのリクエストが、114 バイトのエンコーダーストリームエントリよりも先に到着しています。QPACK は必要な挿入が到着するまでリクエストを待機(ブロック)させることができます(サーバーは最大 16 ブロックされたストリームを保持)。
エンコーディングと編集の限界
拡張機能では、ヘッダーブロックがダイナミックテーブルを使用する場合、再構築せず、編集は適用されません。また、キャプチャーデータには
content-encoding: gzip などの圧縮も含まれており、テキストとして表示する際の問題もあります。
どう対処するか?
- コネクションの開始時を使用: 最初の 2 つのリクエストはテーブルを一切使用しない場合があります。
- 編集を伴う新しいコネクションで Replay を行う: 新しい QUIC コネクションは空のテーブルから始まるため、静的テーブルのみを用いて書き込むことができます。
- ダイナミックテーブルを使うリクエストを変えずに Replay しない: レイヤー間での同期が重要であり、古いエントリを参照した新しいコネクションではサーバー応答を得られません。
Replay: 独自の HTTP/3 リクエストを送信
Proxy History の行を右クリックし、「Send to Replay」を選択します。
- セッションが開き、ホスト、ポート、プロトコル (QUIC)、ALPN (
) が埋め込まれます。h3
タブでパスをHTTP/3
、ヘッダーを/admin
に変更して「Send」を押します。x-demo= replayed
会話のフロー:
- SENT: ストリーム 0 で FIN を含んだリクエスト (158 バイト) を送信。
- RECV: ストリーム 0 で FIN を含んだレスポンス (152 バイト) を受信。
サーバーは
GET /admin x-demo= replayed を正しく処理し、JSON レスポンスを返却します。
壊れたリクエストの見え方
編集されたテキストが壊れたヘッダーブロックを残した場合(例:フレーム長とデータ数が不一致)、Replay はわずかなバイト数しか送信せず、サーバーはコネクションを閉じます (
0x106 - H3_FRAME_ERROR)。
警告: Raw タブや Hex タブで手作りの HTTP/3 バイトを記述する場合、最初に遭遇するエラーがフレーム長不一致になる可能性が高いです。
制限事項とショートチェックリスト
知っておくべき制限事項
- QUIC バージョン 1 のみ: QUICバージョン2はまだサポートされていません。
- ECH (Encrypted Client Hello): コネクションに ECH が使用されている場合、傍受できません。
- CA 証明書への信頼: クライアントはプロキシの CA 証明書を常に信頼する必要があります(ピン留めや信頼なしの場合は拒否されます)。
- UDP パスのルート化: アプリが SOCKS5 UDP を話さない場合、ProxyBridge や外部リダイレクトが必要です。
- 拡張機能の限界: 拡張機能は一度に 1 つのエントリを読み取ります。QPACK テーブルを追跡しないため、ダイナミックテーブルヘッダーはプレースホルダーとして表示されます。
- 大きなボディ: 後続のエントリで続くボディはテキストとして編集できません。
ショートチェックリスト
- UDP トラフィックをプロキシにルーティングする(SOCKS5 UDP またはリダイレクト)。
- クライアントを動かすマシンでプロキシ CA に信頼を置く。
- まず履歴を見ること(1 つのリクエストに対して多くの小さな行が表示されることを予想してください)。
- 静的テーブルのみを使うリクエストを読み書きするには HTTP/3 タブを使用します。
-
を見つけたら、Hex ビューでエンコーダーストリームエントリを確認するか、新しいコネクションでテストしてください。[dynamic table entry ...] - クライアントなしでリクエストを送信して変更するには Replay を使用します。
関連読書:
これらはすべて、7 日間のトライアルで自分のサーバーで試すことができます。テストするサーバーは所有権があるか、またはテストを許可されたもののみで行ってください。