はじめに

Trace Eagleはクロスプラットフォームのパケットキャプチャ・復号ツールです。パソコンやスマホのトラフィックをキャプチャし、暗号文を平文へ自動的に復号し、あらゆるリクエストとレスポンスを直接読めるようにします。

このガイドでは、初めての復号済みリクエストをキャプチャして理解するまでを、わずか数分でご案内します。

1. インストールと起動

すぐに結果を見たいですか? プロセス別キャプチャを使いましょう。ツールがあなたの代わりにブラウザを起動し、その1つのプログラムだけをキャプチャし、すべてを自動的に復号します。プロキシの設定も証明書のインストールも不要です。

ターゲットが違えば、必要なキャプチャ方式も異なります。下のリストから1つ選びましょう。

キャプチャしたいもの	どのキャプチャ方式
ローカルのブラウザ / プログラムで、さらにパケットを編集してリプレイもしたい	プロキシキャプチャ
プロキシを通らないトラフィック、UDP / QUIC、DNSを含む、マシン全体の全トラフィック	NICキャプチャ
1つのプログラムだけ、自動復号で証明書なし	プロセス別キャプチャ
証明書ピンニングや独自暗号化を使っていて復号できないアプリ	アプリ層平文
システム標準アプリや手強いアプリケーション	システムレベルキャプチャ
iPhone / iPadのトラフィック	iOSキャプチャ
Androidスマホのトラフィック	Androidキャプチャ

迷ったら、プロキシキャプチャから始めてください。最も汎用的で、平文を生成し、パケットの編集とリプレイができ、ついでにスマホやLANデバイスもキャプチャできます。

リクエストリスト:キャプチャした各フローがここに順番に現れます。クリックすると詳細が展開されます。
自動復号:あるフローのセッションキーが利用可能なとき、ツールは暗号文を平文へ自動的に復号します。キーがどこから来るか、対応がどこまで及ぶかは、TLS復号を参照してください。
生データと平文を並べて表示:復号済みのリクエスト / レスポンスと、その下にある生バイトの両方を見られます。
プロセス帰属:各フローには、それを送信したプログラムのラベルが付くので、すべてが入り混じっていても一目で見分けられます。

キャプチャしたものの読み方とデコードの仕方は検査とデコードを、2つのリクエストの差異を見つけるにはリクエスト比較を参照してください。

症状	最も可能性が高い原因	対処
リクエストが1つも出ない	ターゲットがシステムプロキシを使っていない	NICキャプチャに切り替える。NIC層ならすべてキャプチャ可能
キャプチャできたが、すべて暗号文	証明書がインストールされていない、またはアプリが証明書ピンニングを使っている	証明書をインストールする(証明書の管理とインストールを参照)、またはアプリ層平文に切り替える
スマホに証明書をインストールしたのに、まだキャプチャできない	新しいバージョンのAndroidはユーザー証明書を信頼しない	Androidキャプチャの証明書インストール不要の方法を参照
HTTP/3 / QUICが見えない	UDP上で動くため、一般的なプロキシでは見えない	NICキャプチャとH3復号を併用する。TLS復号を参照

さらに質問があれば、FAQを参照してください。

リクエストをキャプチャし、復号し、理解できたら、次は日常的に高頻度で使う機能です。