【入門編】Postman Proxy機能でスマホアプリの通信を傍受！iOS/AndroidのHTTPSトラフィックをデバッグする裏技 – データベース・API管理活用バイブル

スマホアプリの通信を丸裸にせよ！Postmanプロキシで実現する「神速」デバッグ術

こんにちは。現場で叩き上げられてきたエンジニアとして、皆さんに一つだけ断言できることがあります。「API開発において、見えない通信を推測でデバッグするのは、目隠しをして迷路を走るようなものだ」ということです。

特にスマートフォンアプリの開発では、アプリが実際にどんなJSONを投げ、どんなヘッダーを付与しているのか。これを確認できないと、無駄な試行錯誤で一日が過ぎてしまいます。

今回は、Postmanを「プロキシサーバー」として使い、スマホのHTTPS通信をリアルタイムに傍受・解析する、現場のプロが使う「裏技」を伝授します。これをマスターすれば、あなたのデバッグ速度は間違いなく3倍速になります。

—

通常、API開発ではサーバー側を叩くことが多いですが、アプリ固有の挙動（認証ヘッダーの付与タイミングや、端末固有のパラメータなど）は、実機を通さないと分かりません。

Postmanのプロキシ機能を使えば、スマホとサーバーの間にPostmanを割り込ませることができます。これにより、アプリが送受信するすべてのリクエストをPostmanの「History」パネルで直接確認・編集・再送できるようになるのです。

—

まずはPC上でPostmanをプロキシサーバー化します。

1. Postmanを開き、右上の「Proxy」アイコン（衛星のようなマーク）をクリック。
2. 「Proxy Settings」を開きます。
3. Port: `5555`（デフォルトでOK）に設定。
4. 「Capture requests」をONにします。

これで、あなたのPCは「ポート5555で待ち構える通信の門番」になりました。

PCとスマホは必ず同一のWi-Fiネットワークに接続してください。

ここが一番の難所です。スマホ側で「このPCを通れ」と設定します。

iOSの場合: 「設定」 > 「Wi-Fi」 > 接続中のWi-Fi名の「i」ボタン > 「プロキシを構成」 > 「手動」を選択。
サーバー: PCのローカルIPアドレス（`192.168.x.x` など）
ポート: `5555`
Androidの場合: 「設定」 > 「ネットワークとインターネット」 > 「Wi-Fi」 > 歯車アイコン > 鉛筆アイコン（編集） > 「詳細設定」 > 「プロキシ」を「手動」へ。

—

ここを怠ると「通信がエラーになる」と泣きを見ることになります。HTTPSは暗号化されているため、間に入るPostmanが中身を見るには「信頼された証明書」が必要です。

1. スマホのブラウザから `http://proxy.pstmn.io` にアクセスします。
2. 「CA Certificate」をダウンロードします。
3. インストール（重要）:

iOS: 設定プロファイルをインストール後、「一般」 > 「情報」 > 「証明書信頼設定」から、Postmanのルート証明書を必ずフル信頼してください。
Android: 「設定」 > 「セキュリティ」 > 「暗号化と認証情報」 > 「証明書のインストール」からCA証明書をインストールします。

—

準備ができたら、いよいよ魔法の瞬間です。

1. Postmanの左サイドバーにある「History」タブを開きます。
2. スマホで適当なアプリ（ブラウザでも可）を開き、Webサイトにアクセスします。
3. 見てください！ Postmanの画面に、スマホが投げたHTTP/HTTPSリクエストが次々と流れてくるはずです。

これが確認できれば成功です。もし何も表示されない場合は、PCのファイアウォール設定でポート5555がブロックされていないか確認してください。

—

「通信が遮断される」場合: 多くのアプリは「SSL Pinning」というセキュリティ技術を採用しており、途中で証明書を差し替える（プロキシを通す）と通信を拒絶します。この場合は、アプリ側の設定でPinningを無効にするか、開発用のビルドを使用してください。
キャッシュに惑わされない: 通信が反映されないときは、スマホ側のブラウザキャッシュをクリアするか、アプリを一度終了させて再起動するのが鉄則です。
フィルタリングを活用せよ: 膨大なトラフィックが流れてくると混乱します。Postmanの「Filter」機能で、特定のドメイン（`api.example.com` など）だけを表示するように絞り込みましょう。

—

API開発において「何が起きているか」を可視化できるエンジニアは、圧倒的に強いです。このプロキシ設定は、一度作ってしまえばあなたの強力な武器となります。

「通信が見えない」というストレスから解放され、ぜひもっと自由でエキサイティングな開発ライフを楽しんでください。何か詰まったら、いつでもまたここへ戻ってきてくださいね。応援しています！