iOSアプリのCharles Proxyがリリースされました
これまでもCharlesはWindows, macOS, Linux用のアプリとして存在していましたが、この度iOSアプリの Charles Proxy がリリースされました。
App Storeから購入できます。これにより、iOSだけでパケットをトレースすることができるようになりました。
公式のアナウンスはこちらをご覧ください。
記事執筆時点の機能は以下です。
- iOSデバイス上のHTTP（S）通信のトラフィックをキャプチャする
- SSLプロキシとして機能し、SSL/TLS通信がプレーンテキストで見れる
- アプリでリクエストとレスポンスの内容が確認でき、個別のリクエストやセッション全体をデスクトップのCharlesに共有できる
使ってみた
早速App Storeで購入してインストールしてみました。
検証環境
本エントリは以下の環境で検証を行っています。
- iPhone X実機 iOS 11.2.6（15D100）
- Charles v1.0（61）
初期設定
まずは必要な初期設定を行います。アプリの初回起動時は「Use Proxy」がOFFになっているのでONにします。
VPN構成追加の許可が求められるので「Allow」をタップします。
パスコードを入力します。
「Use Proxy」がONになりました。
HTTP通信のキャプチャ
上述の初期設定を行うとHTTP通信は既にキャプチャできる状態になっています。
今回は確認のためお天気WebサービスAPIで札幌の天気予報を取得してみました。
以下のURLにiOSのSafariでアクセスしてみました。
http://weather.livedoor.com/forecast/webservice/json/v1?city=016010
その後、アプリの「CURRENT SESSIONS」を開くと該当のホストが表示されるのでタップします。
パスが表示されるのでタップします。
通信の内容が表示されます。OVERVIEWではHTTPのメソッドやステータスコードが確認できます。
SIZESではリクエスト・レスポンスそれぞれヘッダーとボディのサイズが表示されます。
TIMESは最初は非表示になっていますが、タップすると表示されます。通信にかかった時間が表示されます。
REQUEST HEADERも表示されます。
もちろんRESPONSE HEADERも表示されます。
RESPONSE BODYは「View body」をタップすると表示されます。
右上のボタンをタップすると内容を別のアプリやMacに共有できます。
HTTPS通信のキャプチャ
続いてHTTPS通信をキャプチャしてみます。今回は動作確認として郵便番号-住所検索APIを使用して岩本町の郵便番号で住所を検索してみました。
以下のURLにiOSのSafariでアクセスしてみました。
https://api.zipaddress.net/?zipcode=101-0032
初期状態ではSSL Proxyingが無効になっているため、このままでは通信の内容を見ることはできません。そこでまずは「Enable SSL Proxying」をタップします。
Charles CA Certificateをインストールして信頼する必要がある旨のメッセージが表示されるので「Settings」をタップします。
「Settings」が開くので「SSL Proxying」をタップします。
「Install SSL Certificate」をタップします。
「許可」をタップします。
プロファイルをインストールします。
パスコードを入力します。
「インストール」をタップします。
もう一度「インストール」をタップします。
完了をタップします。
続いてインストールした証明書を信頼する必要があります。設定アプリの一般 > 情報 > 証明書信頼設定をタップします。
「ルート証明書を全面的に信頼する」でCharles ProxyをONにして「続ける」をタップします。
再度セッション画面を開くと、SSL Proxyingは有効になっていましたが該当のリクエストは表示されませんでした。
画面下部に「SSL Proxyingの設定を変更した後はアプリを強制終了して再起動して」と書いてあるので素直にアプリをkillして再起動し、再度Safariで通信してみました。
すると、ちゃんと該当のリクエストが表示されました。
通信内容もちゃんと見れました。
まとめ「Charles Proxy、これはデバッグに便利だ...」
今回はCharles Proxyを実際に試してみました。
デバッグ時にHTTPリクエストでちゃんと想定したリクエストが送れているか、レスポンスで想定した内容が返ってきているかなどを確認する手段としてとても便利だと思います。
有料ですがその価値はあるんじゃないでしょうか。皆さんもぜひ試してみてください。