ShadowrocketでHTTPS通信を解析する方法｜証明書設定とURLリライト実践

1. HTTPS解析でできることと、事前に知っておくこと

HTTPSの通信内容は暗号化されているため、通常は接続先のホスト名が分かっても、リクエストのパスや応答本文まで確認できるとは限りません。MitM（中間者による通信の検査）を有効にすると、Shadowrocketが対象ホストの通信を中継し、端末にインストールして信頼させたCA証明書を使ってHTTPS通信を処理します。その結果、対応する通信ではURLやヘッダーなどを確認できる場合があります。

これはHTTPSの暗号化を一律に解除する機能ではありません。対象ホストがMitMの対象に含まれていない、証明書の信頼設定が完了していない、アプリ側が独自の証明書検証を行っているなどの理由で、通信内容を取得できないことがあります。また、Webサイトやアプリの動作を変える設定ではありません。まずは自分で管理するテスト用ホストと、機密情報を含まないテスト通信だけを使ってください。

MitMの対象ホストとURL Rewriteの条件は、別々に確認してください。前者はHTTPS通信を処理する対象を決め、後者は条件に一致したURLを書き換えるルールです。URL Rewriteだけを記述しても、そのホストのHTTPS通信を解析できるようになるわけではありません。変更前に現在のConfigを保存し、テストに使うホスト名と期待する動作を記録しておくと、元に戻すときや結果を比較するときに役立ちます。

2. CA証明書をインストールして信頼設定を行う

証明書の設定は、Shadowrocket側でCA証明書を生成・インストールする操作と、iOS/iPadOS側でその証明書を信頼する操作に分かれます。アプリ内でインストールを完了しただけでは、システムの完全な信頼設定が終わっていない場合があります。メニューの表示名や配置はアプリやOSのバージョンで異なることがあるため、画面に表示されるCertificate関連の項目を確認しながら進めてください。

1. Configを保存

   Configで現在有効な設定を確認し、編集前のコピーを保存します。共有する場合は、接続情報や個人情報が含まれていないかを先に確認してください。

2. CAをインストール

   ShadowrocketのSettingsを開き、Certificateに関する項目からCA Certificateのインストールを実行します。表示されるシステムの確認画面を読み、端末への追加を許可します。

3. 完全な信頼を有効化

   iOS/iPadOSのSettings → General → About → Certificate Trust Settingsを開き、ShadowrocketのCA証明書に対応する項目が表示されていることを確認して、完全な信頼を有効にします。

4. 対象ホストを限定

   ConfigのMitM設定では、テスト用ホストだけを対象にします。証明書を信頼させた後も対象を広げず、テスト後に不要となった設定を解除できるように記録します。

5. テスト通信を確認

   Shadowrocketで接続を開始し、対象ホストに新しいリクエストを送ります。Homeの通信ログで対象ホストの記録を開き、HTTPS通信の詳細が表示されるか確認します。

証明書の完全な信頼を有効にすると、その証明書を使った通信を端末が信頼することになります。信頼するCA証明書は必要なものだけに限定し、証明書やConfigを不用意に共有しないでください。検証後はSettingsのCertificate関連画面で証明書を確認し、不要になった証明書を削除するとともに、ConfigのMitM設定も無効化または削除します。

3. MitMの対象ホストをConfigで指定する

HTTPS通信を解析する設定は、利用中のConfigに記述します。別のConfigを編集したまま切り替えていないと、設定を保存しても動作に反映されません。以下は構文を説明するための例です。test.example.comは実在サービスの接続先として提示しているものではありません。実際には、自分が管理し、テストが許可されているホスト名に置き換えてください。

[MITM]
hostname = test.example.com
enable = true

hostnameにはテスト対象のホスト名を指定します。例のように単一ホストから始め、複数のホストや広範囲のワイルドカードを一度に追加しないでください。対象ホストを増やす必要がある場合も、各ホストを管理していること、検査が許可されていること、不要な通信を巻き込まないことを確認してから変更します。Configの既存の[MITM]セクションがある場合は、重複したセクションを新たに作らず、既存の項目を編集してください。

保存したら、Home → Global Routingでテスト時のルーティングを確認し、Configを使う場合はConfigが選択されていることを確かめます。続いて、Homeで編集したConfigが有効か、接続が開始されているかを確認します。Configを切り替えたときは、対象ホストへの新しいリクエストを発生させてからログを見てください。以前から開いているページの表示だけでは、設定が適用されたかを判断しにくい場合があります。

4. URL Rewriteを追加し、ログで動作を検証する

URL Rewriteは、条件に一致するURLを別のURLへ書き換える設定です。たとえば自分が管理するテスト用ページで、特定パスへのアクセスを別のテスト用パスへ転送する場合は、次のようなルールを使えます。置き換え先も管理対象のテスト用ホストとパスにしてください。この例は書式の説明用であり、一般のWebサイト向けの設定を示すものではありません。

[URL Rewrite]
^https://test\.example\.com/old$ https://test.example.com/new 302

この正規表現では、指定したホスト上の/oldに一致するURLを、/newへの302リダイレクトに書き換えます。末尾の302は一時的なリダイレクトを示す指定です。正規表現の記号、ドットのエスケープ、スキーム、パスの違いで一致結果が変わるため、最初は条件を狭くして確認してください。ルールは既存の[URL Rewrite]セクションに追加し、同じセクションを重ねて作らないようにします。

• 設定を保存する：使用中のConfigを編集し、保存後にそのConfigが選択されていることを確認します。
• 新しい通信を発生させる：テスト端末から指定したURLを開き、必要に応じてページを再読み込みします。
• 通信ログを確認する：Homeのログで対象ホストとURLを探し、リクエストが記録されているか、書き換え後の応答が期待どおりかを確認します。
• 条件を一つずつ変える：一致しない場合はホスト名、パス、正規表現、MitM対象の順に照合し、複数の項目を同時に変更しません。

5. よくある質問

HTTPS通信の解析は、対象ホスト、証明書、Config、URL Rewriteを分けて確認すると原因を絞り込みやすくなります。特にCA証明書の信頼設定は通信の安全性に関わるため、必要な期間と対象に限って使用し、テスト後の削除までを作業手順に含めてください。アプリやOSの表示が手元の画面と異なる場合は、現在の画面に表示される説明を確認してから操作します。