Charles Proxy モバイルガイド

モバイルハッカーのための Charles Proxy ガイド 👍

はじめに

Charles は HTTP プロキシ / HTTP モニター / リバースプロキシであり、開発者が自身のマシンとインターネット間のすべての HTTP および SSL / HTTPS トラフィックを閲覧できるようにします。これにはリクエスト、レスポンス、および HTTP ヘッダー（Cookie やキャッシュ情報を含む）が含まれます。

SSL プロキシ

コンピューター (macOS)

• Charles -> Proxy -> SSL Proxying Settings... -> SSL Proxying

  • 「Enable SSL Proxying」にチェックを入れる
  • ロケーションマッチャー「Host: *」、「Port: *」を追加する
  

• Charles -> Help -> SSL Proxying -> Install Charles Root Certificate

  • 証明書が Keychain にインストールされ、自動的に開きます
  • Keychain 内の証明書をダブルクリックします
  • Trust を展開し、When using this certificate に対して Always Trust を選択します
  

• Charles がリッスンしている IP アドレス を取得する

  • Charles -> Help -> Local IP Address
  • またはコマンドラインで WLAN IP アドレスを取得する（そのままクリップボードにコピーされます）

    ifconfig | tr "\n" "→" | tr "\r" "→" | grep -Eo "→en0.*?→en[[:digit:]]" | grep -Eo "inet[[:blank:]+]([0-9]{1,3}\.){3}[0-9]{1,3}" | cut -d' ' -f2 | tr -d "\n" | pbcopy && pbpaste
    

  • またはコマンドラインで LAN IP アドレスを取得する（そのままクリップボードにコピーされます）

    ifconfig | tr "\n" "→" | tr "\r" "→" | grep -Eo "→en[[:digit:]].*?active→" | grep -v "en0" | grep -Eo "inet[[:blank:]+]([0-9]{1,3}\.){3}[0-9]{1,3}" | cut -d' ' -f2 | tr -d "\n" | pbcopy && pbpaste
    

Android

• Charles を起動し、実行したままにする

• IP アドレス を取得する

• Android デバイスが Charles と同じネットワークを使用していることを確認する

• Android デバイス上で

  • Settings -> Wi-Fi -> 使用中のネットワークを長押し -> Modify network -> Advanced options -> Proxy -> Manual に移動する

    • Proxy hostname = IP アドレス
    • Proxy port = 8888
    

  • ブラウザを起動し、https://chls.pro/ssl にアクセスして証明書を保存する

  
  • システムからロック画面の PIN または パスワード の設定を求められるので、設定して保存する
  • これで証明書がインストールされました
  • アプリケーションを開き、Charles でトラフィックを監視する

• コンピューター上に「A connection attempt to Charles has been made from the host ...」というダイアログが表示されるので、Allow ボタンをクリックする

Android N (7.0、API レベル 24) 以降

• Android Studio で Android プロジェクトを開きます
• Android Studio -> File -> New -> Android resource directory
  • Directory name = xml
  • Directory type = xml
  • Source set = debug
• Android Studio -> File -> New -> XML resource file
  • File name = network_security_config
  • Root element = network-security-config
• 上記の手順で、指定したルート要素を持つ XML ファイルが生成されます。次に、生成された XML ファイル内の既存の内容を置き換えるために、以下の内容を貼り付けます。

  <?xml version="1.0" encoding="utf-8"?>
  <network-security-config xmlns:android="http://schemas.android.com/apk/res/android">
      <debug-overrides>
          <trust-anchors>
              <!-- Trust user added CAs while debuggable only -->
              <certificates src="user" />
          </trust-anchors>
      </debug-overrides>
  </network-security-config>
  

• 次に debug ソースセットに移動し、debug ビルドバリアント用の空の AndroidManifest.xml ファイルがない場合は作成し、以下のような内容を追加します（最終的にはマニフェストマージャーがメインマニフェストとマージします）。すでにファイルがある場合は、application の下に networkSecurityConfig 属性を追加するだけです。

  <?xml version="1.0" encoding="utf-8"?>
  
  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:tools="http://schemas.android.com/tools">
  
      <application
          android:networkSecurityConfig="@xml/network_security_config">
      </application>
  
  </manifest>
  

これで、アプリの debug ビルドバリアントでは SSL プロキシが機能するようになりますが、release ビルドバリアントでは機能しません。

iOS

• Charles を起動し、実行したままにします

• IP アドレスを取得します

• iOS デバイスが Charles と同じネットワークを使用していることを確認します

• iOS デバイスで

  • Settings -> Wi-Fi に移動し、使用中のネットワークをクリックして、HTTP PROXY を Manual に設定します

    • Server = IP アドレス
    • Port = 8888
    

  • Safari を起動し、https://chls.pro/ssl にアクセスして（うまくいかない場合は http://www.charlesproxy.com/getssl を試してください）、証明書をインストールします

  
  • アプリケーションを開き、Charles でトラフィックを監視します

• コンピューター上に「A connection attempt to Charles has been made from the host ...」というダイアログが表示されるので、Allow ボタンをクリックするだけです

iOS 10.3 以降

• 証明書をインストールした後
• Settings -> General -> About -> Certificate Trust Settings -> Enable Full Trust For Root Certificates に移動し、Charles の証明書を有効にします

ターミナル

ターミナルで curl を使ってデバッグする必要がある場合：

• Charles をプロキシとして設定する

  export http_proxy=http://127.0.0.1:8888 && export https_proxy=$http_proxy
  

• プロキシを解除する

  unset http_proxy https_proxy
  

SSL CA 証明書

• 同じコンピューター上で実行されている Charles Proxy は、同じ SSL 証明書を提供します。