Charles Proxy Mobile Guide

Der Leitfaden für mobile Hacker zu Charles Proxy 👍

Einführung

Charles ist ein HTTP-Proxy / HTTP-Monitor / Reverse-Proxy, der es Entwicklern ermöglicht, den gesamten HTTP- und SSL-/HTTPS-Datenverkehr zwischen ihrem Rechner und dem Internet anzuzeigen. Dazu gehören Anfragen, Antworten und die HTTP-Header (die Cookies und Caching-Informationen enthalten).

SSL-Proxying

Computer (macOS)

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

  • Aktivieren Sie "Enable SSL Proxying"
  • Fügen Sie den Standort-Matcher "Host: *", "Port: *" hinzu
  

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

  • Dadurch wird das Zertifikat im Schlüsselbund installiert und automatisch geöffnet
  • Doppelklicken Sie auf das Zertifikat im Schlüsselbund
  • Erweitern Sie Trust, wählen Sie Always Trust für When using this certificate
  

• Ermitteln Sie die IP-Adresse, auf der Charles lauscht

  • Charles -> Help -> Local IP Address
  • Oder ermitteln Sie die WLAN-IP-Adresse über die Kommandozeile (direkt in Ihre Zwischenablage)

    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
    

  • Oder ermitteln Sie die LAN-IP-Adresse über die Kommandozeile (direkt in Ihre Zwischenablage)

    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

• Starten Sie Charles und lassen Sie es laufen

• Ermitteln Sie die IP-Adresse

• Stellen Sie sicher, dass das Android-Gerät dasselbe Netzwerk wie Charles verwendet

• Auf dem Android-Gerät

  • Gehen Sie zu Settings -> Wi-Fi -> klicken Sie lange auf das verwendete Netzwerk -> Modify network -> Advanced options -> Proxy -> Manual

    • Proxy hostname = IP-Adresse
    • Proxy port = 8888
    

  • Starten Sie den Browser, besuchen Sie https://chls.pro/ssl, speichern Sie das Zertifikat

  
  • Das System fordert Sie auf, eine PIN oder ein Passwort für den Sperrbildschirm festzulegen; legen Sie einfach eines fest und speichern Sie es
  • Nun ist das Zertifikat installiert
  • Öffnen Sie eine Anwendung und überwachen Sie den Datenverkehr in Charles

• Auf dem Computer erscheint ein Dialog mit der Meldung "A connection attempt to Charles has been made from the host ..."; klicken Sie einfach auf die Schaltfläche Allow

Android N (7.0, API-Level 24) und später

• Öffnen Sie Ihr Android-Projekt mit Android Studio
• 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
• Der obige Schritt erzeugt eine XML-Datei mit dem angegebenen Root-Element. Fügen Sie nun den folgenden Inhalt ein, um den vorhandenen Inhalt in der generierten XML-Datei zu ersetzen.

  <?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>
  

• Gehen Sie dann zum debug-Source-Set, erstellen Sie eine leere AndroidManifest.xml-Datei, falls Sie noch keine für die Debug-Build-Variante haben, und fügen Sie Inhalt wie unten hinzu (der Manifest-Merger wird ihn schließlich mit dem Hauptmanifest zusammenführen). Wenn Sie bereits eine haben, fügen Sie einfach das Attribut networkSecurityConfig unter application hinzu.

  <?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>
  

Nun sollte das SSL-Proxying für die Debug-Build-Variante Ihrer App funktionieren, jedoch nicht für die Release-Build-Variante.

iOS

• Starten Sie Charles und lassen Sie es laufen

• Ermitteln Sie die IP-Adresse

• Stellen Sie sicher, dass das iOS-Gerät dasselbe Netzwerk wie Charles verwendet

• Auf dem iOS-Gerät

  • Gehen Sie zu Settings -> Wi-Fi -> tippen Sie auf das verwendete Netzwerk -> setzen Sie HTTP PROXY auf Manual

    • Server = IP-Adresse
    • Port = 8888
    

  • Starten Sie Safari, besuchen Sie https://chls.pro/ssl (falls es nicht funktioniert, versuchen Sie http://www.charlesproxy.com/getssl), installieren Sie das Zertifikat

  
  • Öffnen Sie eine Anwendung und überwachen Sie den Datenverkehr in Charles

• Auf dem Computer erscheint ein Dialog mit der Meldung „A connection attempt to Charles has been made from the host ...“, klicken Sie einfach auf die Schaltfläche Allow

iOS 10.3 und später

• Nachdem das Zertifikat installiert wurde
• Gehen Sie zu Settings -> General -> About -> Certificate Trust Settings -> Enable Full Trust For Root Certificates -> aktivieren Sie das Zertifikat von Charles

Terminal

Falls Sie über curl in einem Terminal debuggen müssen:

• Um Charles als Proxy festzulegen

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

• Um den Proxy zu entfernen

  unset http_proxy https_proxy
  

SSL-CA-Zertifikat

• Charles Proxy, das auf demselben Computer läuft, stellt dasselbe SSL-Zertifikat bereit.