Motivation
In einigen Tests kann es notwendig sein, ein Web-Debugging-Proxy-Tool zu verwenden, um den Datenverkehr zwischen dem für Tests verwendeten Gerät und dem Internet zu protokollieren. Ein derartiges Tool, das für diesen Zweck verwendet wird, heißt Charles Proxy und du musst es möglicherweise bei Testläufen für einige unserer Kunden verwenden. Der Prozess zur Installation und Konfiguration von Charles Proxy wird unten beschrieben.
Schritt 1: Charles Proxy auf deinem Computer einrichten
Für Web- und App-Tests benötigst du einen Computer und musst das Programm Charles Proxy darauf installieren.
Lade die Testversion von Charles Proxy von hier herunter, die zu deinem Computersystem passt.
Installiere die Charles Proxy-App.
Gehe in der Charles-App zu Proxy > Externe Proxy-Einstellungen...
Aktiviere das Kontrollkästchen Externe Proxy-Server verwenden.
Aktiviere das Kontrollkästchen für Web Proxy (HTTP) und Proxy-Server erfordert ein Passwort. Gib die Proxy-Daten wie folgt ein:
Web Proxy Server: forward.test.io:3128
Domäne: forward.test.io
Benutzername: Diese Informationen findest du in der Testlaufbeschreibung.
Passwort: Diese Informationen findest du in der Testlaufbeschreibung.
Aktiviere das Kontrollkästchen Sicherer Web-Proxy (HTTPS) und Proxy-Server erfordert ein Passwort. Wiederhole die Angaben aus dem vorherigen Schritt.
Klicke auf OK, um die Einstellungen zu speichern.
Der Test IO-Proxy ist nun korrekt als externer Proxy in deiner Charles Proxy-App gespeichert.
SSL-Zertifikat auf deinem Windows-Computer installieren
Bevor du die Website des Kunden aufrufst, die du testen möchtest, musst du ein SSL-Zertifikat auf deinem Gerät installieren, damit der Internetverkehr korrekt erfasst werden kann.
Voraussetzung: Du hast Charles Proxy auf deinem Computer installiert und konfiguriert.
Starte die Charles Proxy-App auf deinem Computer.
Navigiere im Menü zu Hilfe > SSL-Proxying > Charles Root Certificate installieren.
Klicke auf Zertifikat installieren... und wähle Aktueller Benutzer.
Klicke auf Weiter. Du wirst aufgefordert, auszuwählen, wo die Zertifikate in deinem System gespeichert werden.
Wähle Alle Zertifikate in folgendem Speicher platzieren und klicke auf Durchsuchen...
Wähle Vertrauenswürdige Stammzertifizierungsstellen (Trusted Root Certification Authorities) aus und klicke auf OK.
Klicke auf Weiter und dann auf Fertigstellen.
Starte deinen Computer neu, um die Installation abzuschließen.
Jetzt ist das Charles Proxy SSL-Zertifikat vollständig auf deinem Gerät installiert.
Die Konfiguration eines iOS-Geräts
Voraussetzung: Du hast Charles Proxy auf deinem Computer installiert und konfiguriert.
Stelle sicher, dass dein mobiles Gerät und dein Computer mit demselben WLAN-Netzwerk verbunden sind.
Starte die Charles Proxy-App auf deinem Computer.
Im Menü gehe zum Menüpunkt Hilfe > SSL-Proxying > Charles Root Certificate auf einem Mobilgerät oder Remote-Browser installieren. Ein Fenster wird geöffnet und zeigt dir deine lokale IP-Adresse und einen Port, den du verwenden sollst.
Gehe auf deinem iOS-Gerät zu deinen WLAN-Einstellungen und klicke auf das blaue "i"-Symbol neben deinem WLAN.
Tippe am unteren Bildschirmrand auf Proxy konfigurieren und wähle die Option Manuell.
Gib die lokale IP-Adresse in das Serverfeld ein und den Port, den die Charles Proxy-App im Schritt 3 angegeben hat.
Speichere die Einstellungen. Auf deinem Computer sollte ein Dialogfeld erscheinen, das um Erlaubnis für diesen neuen Zugriff bittet.
Genehmige die Erlaubnis.
Der Internetverkehr deines Geräts wird jetzt durch Charles Proxy geleitet. Ab sofort funktioniert das Internet auf deinem Gerät nur, wenn die Charles Proxy-App auf deinem Computer geöffnet ist.
SSL-Zertifikat auf iOS installieren
Bevor du die Kunden-App startest, die du testen möchtest, musst du ein SSL-Zertifikat auf deinem Gerät installieren, damit der Internetverkehr korrekt erfasst wird.
Voraussetzungen:
Du hast Charles Proxy auf deinem Computer installiert und konfiguriert.
Du hast Charles Proxy auf deinem iOS-Gerät installiert und konfiguriert.
Gehe auf deinem mobilen Gerät mit dem Safari-Browser zu chls.pro/ssl. Ein Dialogfeld sollte auf deinem Gerät erscheinen, um das SSL-Zertifikat zu installieren.
Erlaube die Installation des Zertifikats. Ein Dialogfeld sollte erscheinen und erklären, dass du das Profil in der Einstellungs-App auf deinem Gerät überprüfen musst.
Schließe das Dialogfeld und den Safari-Browser.
Gehe zur Einstellungs-App auf deinem Gerät und folge dem Pfad Allgemein > VPN & Geräteverwaltung > Heruntergeladene Profile und wähle das Charles Proxy CA.
Tippe auf Installieren, um das Zertifikat auf deinem Gerät zu installieren. Du wirst aufgefordert, das Passwort deines Geräts einzugeben. Nach erfolgreicher Authentifizierung wird ein Warnbildschirm angezeigt. Tippe auf Installieren, um die Installation des Zertifikats abzuschließen.
Es wird ein Bestätigungsfenster für das installierte Profil angezeigt. Klicke einfach auf Fertig.
Gehe zurück zum Untermenü Einstellungen > Allgemein und navigiere zu Über > Zertifikat-Vertrauenseinstellung (Certificate Trust Settings).
Aktiviere das Charles Proxy CA-Zertifikat.
Ein Warnbildschirm wird angezeigt. Tippe auf Fortsetzen.
Jetzt ist das Charles Proxy SSL-Zertifikat vollständig auf deinem Gerät installiert.
Die Konfiguration eines Android-Geräts
Voraussetzung: Du hast Charles Proxy auf deinem Computer installiert und konfiguriert.
Stelle sicher, dass dein mobiles Gerät und dein Computer mit demselben WLAN-Netzwerk verbunden sind.
Starte die Charles Proxy-App auf deinem Computer.
Gehe über das Menü zu Hilfe > SSL-Proxying > Charles Root Certificate auf einem Mobilgerät oder Remote-Browser installieren.
Ein Fenster wird geöffnet und zeigt dir deine lokale IP-Adresse und einen Port, den du verwenden sollst.
Gehe auf deinem Android-Gerät zu deinen WLAN-Einstellungen und wähle die Option zum Bearbeiten des aktuellen Netzwerks.
Suche nach der Proxy-Option und wähle Manuell.
Gib die lokale IP-Adresse in das Feld "Proxy-Host-Name" ein und den Port, den die Charles Proxy-App im Schritt 3 angegeben hat.
Speichere die Einstellungen. Auf deinem Computer sollte ein Dialogfeld erscheinen, das um Erlaubnis für diesen neuen Zugriff bittet.
Genehmige die Erlaubnis.
Der Internetverkehr deines Geräts wird jetzt durch Charles Proxy geleitet. Ab sofort funktioniert das Internet auf deinem Gerät nur, wenn die Charles Proxy-App auf deinem Computer geöffnet ist.
SSL-Zertifikat auf Android 10 oder darunter installieren
Voraussetzungen:
Du hast Charles Proxy auf deinem Computer installiert und konfiguriert.
Du hast Charles Proxy auf deinem Android-Gerät installiert und konfiguriert.
Bevor du versuchst, die Kunden-App zu starten, die du testen möchtest, musst du ein SSL-Zertifikat auf deinem Gerät installieren, damit der Internetverkehr korrekt erfasst wird. Folge diesen Schritten:
Gehe auf deinem mobilen Gerät mit dem Chrome-Browser zu chls.pro/ssl. Die Datei "*.crt" wird auf dein Gerät heruntergeladen.
Öffne die heruntergeladene Datei und authentifiziere dich.
Gib einen Namen für das Zertifikat an und stelle sicher, dass unter "Verwendung der Berechtigung" die Option "VPN und Apps" ausgewählt ist.
Klicke auf OK.
Jetzt ist das Charles Proxy SSL-Zertifikat vollständig auf deinem Gerät installiert.
SSL-Zertifikat auf Android 11+ installieren
Bevor du versuchst, die Kunden-App zu starten, die du testen möchtest, musst du ein SSL-Zertifikat auf deinem Gerät installieren, damit der Internetverkehr korrekt erfasst wird. Folge diesen Schritten:
Voraussetzungen:
Du hast Charles Proxy auf deinem Computer installiert und konfiguriert.
Du hast Charles Proxy auf deinem Android-Gerät installiert und konfiguriert.
Gehe auf deinem mobilen Gerät mit dem Chrome-Browser zu chls.pro/ssl. Die Datei "*.crt" wird auf dein Gerät heruntergeladen.
Nachdem die Datei heruntergeladen wurde, gehe zur Einstellungs-App auf deinem Gerät und suche nach einer ähnlichen Option zur Installation aus dem Gerätespeicher (normalerweise in den erweiterten Sicherheitseinstellungen auf deinem Gerät).
Wähle CA-Zertifikat und dann Installieren, falls ein Warnbildschirm angezeigt wird.
Authentifiziere dich und suche nach der heruntergeladenen "*.crt"-Datei.
Wähle die heruntergeladene Datei aus und tippe auf Fertig.
Jetzt ist das Charles Proxy SSL-Zertifikat vollständig auf deinem Gerät installiert.
Einen Log erfassen
Voraussetzung: Stelle sicher, dass du Charles Proxy wie oben erläutert auf deinem Computer installiert und konfiguriert hast. Stelle außerdem sicher, dass das SSL-Zertifikat korrekt auf dem Gerät installiert ist, das du für die Tests verwendest.
Voraussetzungen:
Einen Log deines Computer-Traffics erfassen: Stelle sicher, dass die Windows-Proxy-Option unter dem Menüpunkt Proxy aktiviert ist.
Einen Log deines Mobil-Traffics erfassen: Stelle sicher, dass die Windows-Proxy-Option unter dem Menüpunkt Proxy deaktiviert ist.
Hinweis: Stelle immer sicher, dass immer nur ein Gerät mit Charles Proxy verbunden ist, wenn du einen Log erfassen möchtest, da sonst Traffic-Daten von allen Geräten in deinem Log erfasst werden.
Starte die Charles Proxy-App auf deinem Computer.
Gehe im Menü zu Proxy > SSL-Proxy-Einstellungen...
Stelle sicher, dass das Kästchen SSL-Proxy aktivieren aktiviert ist und klicke unter dem Abschnitt Einschließen (Include) auf Hinzufügen.
Gib die Kunden-Server an, die du überwachen möchtest sowie den Port (diese Informationen werden in jedem Testlauf bereitgestellt).
Klicke auf "OK", um zum Fenster "SSL-Proxy-Einstellungen" zurückzukehren.
Klicke erneut auf "OK", um die Einstellungen zu speichern.
Jetzt wendet Charles Proxy die SSL-Proxy-Einstellungen nur auf die ausgewählten Server an. Gehe wie folgt vor, um eine neue Sitzung zu starten:
Stelle sicher, dass die Aufnahmetaste (der rote Kreis unter dem Hauptmenü der Charles Proxy App) aktiviert ist.
Klicke auf das Pinsel-Symbol, um die vorherigen Protokolle zu löschen.
Gehe zur Testumgebung (öffne entweder die Kunden-App oder gehe zur Startseite der Website).
Reproduziere das gewünschte Verhalten (wie in den Anweisungen des Testlaufs, eines Bug-Reports, einer User Story oder eines Testfalls beschrieben).
Sobald du fertig bist, beende die Protokollaufzeichnung durch Deaktivieren der Aufnahmetaste.
Gehe im Menü zu Datei > Sitzung speichern unter..., wähle den Speicherort aus, gib einen geeigneten Namen ein und stelle sicher, dass die Dateierweiterung ".chls" für die Charles-Sitzungsdatei ausgewählt ist.
Jetzt kannst du deine Charles Proxy-Protokolldatei speichern und einreichen.
FAQ
Wie kann ich überprüfen, ob Charles Proxy korrekt funktioniert?
Du kannst überprüfen, ob Charles Proxy für einen bestimmten Server funktioniert, indem du die Charles Proxy-App öffnest, auf den Server klickst, zu Übersicht > Notizen-Informationen gehst. Hier sollte der Wert SSL-Proxy aktiviert für diesen Host (SSL Proxying enabled for this host) aktiviert sein.
Ein Wert von SSL Proxying is not enabled for this host. Enable in the Proxy Menu, SSL Proxying Settings bedeutet, dass du den aktuellen Server nicht zur SSL-Proxy-Liste hinzugefügt hast. Du kannst den Server entweder manuell in den SSL-Proxy-Einstellungen hinzufügen oder mit der rechten Maustaste auf den Server klicken und die Option SSL-Proxy aktivieren auswählen.
Hinweis: Du musst möglicherweise eine neue Log-Session starten, um die neuen Einstellungen zu übernehmen.
Sollten Screencasts, die für einen Bug-Report angefertigt werden, mit den Charles Proxy-Logs übereinstimmen?
Wie bei der Erfassung eines Crash-Logs müssen die Zeitstempel des Charles Proxy-Protokolls und des Screencasts übereinstimmen, ansonsten ist dein Log ungültig.
Kann ich Charles Proxy-Logs in Crash-Reports verwenden?
Charles Proxy-Logs ersetzen keine Crash-Logs. Wenn du also einen Crash meldest und die Verwendung von Charles Proxy eine Anforderung des Testlaufs ist, musst du beide Dateien zu deinem Bug-Report hinzufügen.
Ich finde keine Option zum Installieren des SSL-Zertifikats auf meinem Android-Gerät.
Der Ort der Option zum Installieren des SSL-Zertifikats auf deinem Android-Gerät kann je nach Gerät unterschiedlich sein. Du kannst die Chat-Funktion innerhalb jedes Testlaufs verwenden, um um Hilfe bei der Suche nach dieser Option auf deinem Gerät zu bitten.
Warum funktioniert mein Internet nicht mehr ohne Charles Proxy, nachdem ich das Tutorial erfolgreich abgeschlossen habe?
Wenn du alle genannten Schritte abgeschlossen hast, wird der Datenverkehr deines Geräts zur Charles Proxy Computer-App umgeleitet. Nach Abschluss der Test-Session kannst du die Charles Proxy Computer-App schließen und die Proxy-Einstellungen deines mobilen Geräts auf "Keine" (Android) oder "Aus" (iOS) zurücksetzen. Auf diese Weise wird die Verbindung zu deinem Computer geschlossen und dein Internet funktioniert wieder normal.
Die Charles Proxy-App hat sich mitten in einer Sitzung geschlossen. Was ist passiert?
Die Charles Proxy Computer-App kann höchstens 30 Minuten lang verwendet werden, beginnend ab dem Zeitpunkt, an dem du die App geöffnet hast. Wenn deine App bereits eine Weile geöffnet ist und du einen neuen Bug gefunden hast, wird empfohlen, das Charles Proxy-Programm zu schließen und erneut zu öffnen, damit das 30-Minuten-Limit zurückgesetzt wird und du Zeit hast, deinen Log aufzuzeichnen.
Ich habe keinen Desktop-Computer oder eine WLAN-Verbindung. Kann ich trotzdem mit Charles Proxy testen?
Leider ist ein Windows-, MacOS- oder Linux-PC, der mit demselben WLAN wie dein mobiles Gerät verbunden ist, erforderlich, um Charles Proxy-Logs zu erfassen. Wenn du diese Anforderung nicht erfüllst, musst du den Testlauf vorerst überspringen.
Warum erfasst die Charles Proxy-App nach erfolgreichem Setup die Logs meines Browsers nicht?
In der Regel können ein VPN und andere System-Apps oder Einstellungen (z. B. Firewall oder Antivirensoftware) die Charles Proxy-App stören. Wir empfehlen, alle VPN-Verbindungen zu schließen und alle Browsererweiterungen zu deinstallieren, um sicherzustellen, dass die Charles Proxy-App die einzige Proxy-Verbindung zur Testumgebung von deinem Gerät ist. Du kannst auch einen anderen Browser verwenden, um den Datenverkehr zu überwachen.