Motivation
Dans certains tests, tu pourrais avoir besoin d'utiliser un outil de proxy de débogage Web pour enregistrer le trafic de données entre le périphérique utilisé pour les tests et Internet. Un des outils utilisés à cette fin est appelé Charles Proxy, et tu pourrais avoir besoin de l'utiliser lors des tests avec certains de nos clients. Le processus pour installer et configurer correctement Charles Proxy est décrit ci-dessous.
Première étape : Configuration de Charles Proxy sur ton ordinateur
Pour les tests Web et d'application, tu auras besoin d'un ordinateur et d'installer le programme Charles Proxy dessus.
Télécharge la version d'essai de Charles Proxy qui correspond à ton système informatique ici.
Installe l'application Charles Proxy.
Dans l'application Charles, va dans l'élément de menu Proxy > Paramètres proxy externes....
Coche la case Utiliser des serveurs proxy externes.
Coche la case pour le Proxy Web (HTTP) et coche Proxy nécessite un mot de passe. Entre les détails du proxy comme suit:
Serveur proxy Web: forward.test.io:3128
Domaine: forward.test.io
Nom d'utilisateur: tu peux trouver cette information dans la description du test.
Mot de passe: tu peux trouver cette information dans la description du test.
Coche la case Proxy sécurisé pour le proxy Web (HTTPS) et coche Proxy nécessite un mot de passe. Répète les champs de détails de la dernière étape.
Clique sur le bouton OK pour enregistrer les paramètres.
Le proxy Test IO est maintenant correctement enregistré comme proxy externe dans ton application Charles Proxy.
Installation du certificat SSL sur ton ordinateur Windows
Avant de tenter de naviguer sur le site Web du client que tu veux tester, tu dois installer un certificat SSL sur ton appareil, afin que le trafic Internet puisse être correctement capturé.
Prérequis: Tu as installé et configuré Charles Proxy sur ton ordinateur.
Lance l'application Charles Proxy sur ton ordinateur.
Dans le menu, va à Aide > Proxy SSL > Installer le certificat racine Charles.
Clique sur Installer le certificat... et sélectionne Utilisateur en cours.
Clique sur Suivant. On te demandera où les certificats seront conservés dans ton système.
Sélectionne Placer tous les certificats dans le magasin suivant et clique sur Parcourir...
Sélectionne Autorités de certification racines de confiance et clique sur OK.
Clique sur Suivant, puis sur Terminer.
Redémarre ton ordinateur pour terminer l'installation.
Maintenant, le certificat SSL de Charles Proxy est entièrement installé sur ton appareil.
Configuration d'un appareil iOS
Prérequis: Tu as installé et configuré Charles Proxy sur ton ordinateur.
Assure-toi que ton appareil mobile et ton ordinateur sont connectés au même réseau WiFi.
Lance l'application Charles Proxy sur ton ordinateur.
Dans le menu, va à Aide > Proxy SSL > Installer le certificat racine Charles sur un appareil mobile ou un navigateur distant. Une fenêtre s'ouvrira et te donnera ton adresse IP locale et un port à utiliser.
Sur ton appareil iOS, va dans le paramètres Wi-Fi et clique sur l'icône bleue "i" à côté de ton Wi-Fi.
En bas de l'écran, appuie sur Configurer le proxy et choisis l'option Manuel.
Saisis l'adresse IP locale dans le champ du serveur et le port donné par l'application Charles Proxy à l'étape 3.
Enregistre les paramètres > Une boîte de dialogue devrait apparaître sur ton ordinateur pour demander l'autorisation d'autoriser cet nouvel accès.
Donne l'autorisation.
Le trafic Internet de ton appareil est maintenant routé via Charles Proxy. Désormais, Internet sur ton appareil ne fonctionnera que lorsque l'application Charles Proxy est ouverte sur ton ordinateur.
Installation du certificat SSL sur iOS
Avant de tenter de lancer l'application client que tu souhaites tester, tu dois installer un certificat SSL sur ton appareil pour que le trafic Internet puisse être correctement capturé.
Prérequis:
Tu as installé et configuré Charles Proxy sur ton ordinateur.
Tu as installé et configuré Charles Proxy sur ton appareil iOS.
Accéde à chls.pro/ssl en utilisant le navigateur Safari sur ton appareil mobile. Une boîte de dialogue devrait apparaître sur ton appareil pour installer le certificat SSL.
Autorise l'installation du certificat. Une boîte de dialogue devrait apparaître pour expliquer que tu dois examiner le profil dans l'application Paramètres sur ton appareil.
Fermez le modal et le navigateur Safari.
Accède à l'application Paramètres sur ton appareil et suis le chemin Général > VPN et gestion des appareils > Profil téléchargé, puis sélectionne le certificat CA de Charles Proxy.
Appuie sur Installer pour installer le certificat sur ton appareil. On te demandera de saisir le mot de passe de ton appareil. Après une authentification réussie, un écran d'avertissement s'affichera. Appuie sur Installer pour terminer l'installation du certificat.
Une fenêtre de confirmation Profil installé s'affichera. Appuie simplement sur Terminé.
Retourne dans le menu Paramètres > Général et accéde à À propos > Paramètres de confiance des certificats.
Active le certificat CA de Charles Proxy.
Un écran d'avertissement apparaîtra. Appuie sur Continuer.
Maintenant, le certificat SSL de Charles Proxy est entièrement installé sur ton appareil.
Configuration d'un appareil Android
Prérequis: Tu as installé et configuré Charles Proxy sur ton ordinateur.
Assure-toi que ton appareil mobile et ton ordinateur sont connectés au même réseau WiFi.
Lance l'application Charles Proxy sur ton ordinateur.
Dans le menu, accéde à Aide > Proxy SSL > Installer le certificat racine Charles sur un appareil mobile ou un navigateur distant.
Une fenêtre s'ouvrira et te donnera ton adresse IP locale et un port à utiliser.
Sur ton appareil Android, va dans les paramètres WiFi et sélectionne pour modifier le réseau actuel.
Recherche l'option Proxy et sélectionne Manuel.
Saisis l'adresse IP locale dans le champ Nom du serveur proxy et le port donné par l'application Charles Proxy à l'étape 3.
Enregistre les paramètres > Une boîte de dialogue devrait apparaître sur ton ordinateur pour demander l'autorisation d'autoriser ce nouvel accès.
Donne l'autorisation.
Le trafic Internet de ton appareil est maintenant routé via Charles Proxy. Désormais, Internet sur ton appareil ne fonctionnera que lorsque l'application Charles Proxy est ouverte sur ton ordinateur.
Installation du certificat SSL sur Android 10 ou inférieur
Prérequis :
Tu as installé et configuré Charles Proxy sur ton ordinateur.
Tu as installé et configuré Charles Proxy sur ton appareil Android.
Avant de tenter de lancer l'application client que tu veux tester, tu dois installer un certificat SSL sur ton appareil pour que le trafic Internet puisse être correctement capturé en suivant les étapes suivantes:
Accéde à chls.pro/ssl en utilisant le navigateur Chrome sur ton appareil mobile. Le fichier de certificat "*.crt" commencera à se télécharger sur ton appareil.
Ouvre le fichier téléchargé et authentifie-toi.
Fournis un nom pour le certificat et assure-toi que l'option VPN et applications est sélectionnée sous Utilisation des informations d'identification.
Appuie sur OK.
Maintenant, le certificat SSL de Charles Proxy est entièrement installé sur ton appareil.
Installation du certificat SSL sur Android 11 et supérieur
Avant de tenter de lancer l'application client que tu veux tester, tu dois installer un certificat SSL sur ton appareil pour que le trafic Internet puisse être correctement capturé en suivant les étapes suivantes:
Prérequis :
Tu as installé et configuré Charles Proxy sur ton ordinateur.
Tu as installé et configuré Charles Proxy sur ton appareil Android.
Accéde à chls.pro/ssl en utilisant le navigateur Chrome sur ton appareil mobile. Le fichier de certificat "*.crt" commencera à se télécharger sur ton appareil.
Après le téléchargement du fichier, accéde à l'application Paramètres de ton appareil et recherche une option similaire pour Installer depuis le stockage de l'appareil (elle se trouve généralement dans les paramètres de sécurité avancés de ton appareil).
Sélectionne Certificat CA, puis Installez quand même en cas d'affichage d'un écran d'avertissement.
Authentifie-toi et cherche le fichier "*.crt" téléchargé.
Sélectionne le fichier téléchargé et appuie sur Terminé.
Maintenant, le certificat SSL de Charles Proxy est entièrement installé sur ton appareil.
Capture d'un journal
Prérequis: Assure-toi d'avoir installé et configuré Charles Proxy sur ton ordinateur comme expliqué ci-dessus. Assure-toi également que le certificat SSL est correctement installé sur le périphérique que tu utilises pour les tests.
Prérequis :
Capture d'un journal de ton trafic sur ordinateur: assure-toi que l'option Proxy Windows sous l'élément de menu Proxy est activée
Capture d'un journal de ton trafic mobile: assure-toi que l'option Proxy Windows sous l'élément de menu Proxy est désactivée.
Remarque: Assure-toi toujours qu'un seul appareil est connecté à Charles Proxy à chaque fois que tu captures un journal, sinon les données de trafic de tous les appareils seront enregistrées dans ton journal.
Lance l'application Charles Proxy sur ton ordinateur.
Dans le menu, accéde à Proxy > Paramètres de proxy SSL...
Assure-toi de cocher la case Activer le proxy SSL et, sous la section Inclure, clique sur Ajouter.
Saisis le ou les serveurs du client que tu veux surveiller et le port (ces informations seront fournies à chaque cycle de test).
Clique sur OK pour revenir à la fenêtre des paramètres de proxy SSL.
Clique à nouveau sur OK pour enregistrer les paramètres.
Maintenant, Charles Proxy appliquera le proxy SSL uniquement aux serveurs sélectionnés. Pour démarrer une nouvelle session, tu dois:
Vérifie que le bouton d'enregistrement (le cercle rouge situé juste en dessous du menu principal sur l'application Charles Proxy) est activé.
Clique sur l'icône de pinceau pour effacer les journaux précédents.
Accéde à l'environnement de test (ouvre l'application client ou accéde à la page d'accueil du site Web).
Reproduis le comportement souhaité (mentionné dans les instructions du cycle, un rapport de bogue, une histoire utilisateur ou un cas de test).
Une fois que tu as terminé, désactive le bouton d'enregistrement pour arrêter la capture du journall.
Dans le menu, accéde à Fichier > Enregistrer la session sous..., sélectionne l'emplacement pour enregistrer le fichier, donne-lui un nom approprié et assure-toi que l'extension de fichier de session Charles (.chls) est sélectionnée.
Maintenant, tu peux enregistrer ton fichier journal Charles Proxy et le soumettre.
FAQ
Comment puis-je savoir si Charles Proxy fonctionne correctement?
Tu peux vérifier si Charles Proxy fonctionne pour un serveur spécifique en ouvrant l'application Charles Proxy, en cliquant sur le serveur que tu veux vérifier, en accédant à l'onglet Aperçu > Notes et en vérifiant que la valeur Proxy SSL est activée pour cet hôte.
Si la valeur de Proxy SSL n'est pas activée pour cet hôte, tu dois l'activer dans le menu Proxy, Paramètres de proxy SSL. Cela signifie que tu n'as pas ajouté le serveur actuel à la liste de proxy SSL. Tu peux ajouter le serveur manuellement en visitant les options de Paramètres de proxy SSL ou en faisant un clic droit sur le serveur et en sélectionnant l'option Activer le proxy SSL.
Remarque: Tu devras peut-être démarrer une nouvelle session de journal pour appliquer les nouveaux paramètres.
Les enregistrements d'écran capturés dans un rapport de bogue doivent-ils correspondre aux journaux de Charles Proxy?
Tout comme lors de la capture d'un journal de plantage, si tu dois fournir un enregistrement d'écran avec ton journal (par exemple, lors de la soumission d'un rapport de bogue), les horodatages du journal de Charles Proxy et de l'enregistrement d'écran doivent correspondre, sinon ton journal sera invalide.
Puis-je utiliser les journaux de Charles Proxy dans les rapports de plantage?
Les journaux de Charles Proxy ne remplacent pas les journaux de plantage, donc si tu signales un plantage et que l'utilisation de Charles Proxy est également l'une des exigences du cycle, tu dois joindre les deux à ton rapport.
Je ne trouve pas d'option pour installer le certificat SSL sur mon appareil Android.
L'emplacement de l'option pour installer le certificat SSL sur ton Android sera différent en fonction de l'appareil. Tu peux utiliser la fonction de discussion disponible à l'intérieur de chaque cycle pour demander de l'aide pour localiser cette option sur ton appareil.
Pourquoi mon internet ne fonctionne-t-il pas sans Charles Proxy après avoir suivi le tutoriel avec succès?
Si tu as suivi toutes les étapes mentionnées, les données de trafic de ton appareil seront acheminées vers l'application Charles Proxy sur ton ordinateur. Après avoir terminé la session de test, tu peux fermer l'application Charles Proxy sur ton ordinateur et revenir aux paramètres de proxy de ton appareil mobile à Aucun (Android) ou Désactivé (iOS). De cette manière, tu fermeras la connexion à ton ordinateur et ton internet fonctionnera à nouveau normalement.
L'application Charles Proxy s'est fermée au milieu d'une session. Que s'est-il passé?
L'application Charles Proxy sur ordinateur ne peut être utilisée que pendant 30 minutes au maximum, à partir du moment où tu as ouvert l'application. Ainsi, si ton application est déjà ouverte depuis un certain temps et que tu as trouvé un nouveau bogue, il est recommandé de fermer le programme Charles Proxy et de le rouvrir, afin que la limite de 30 minutes soit réinitialisée et que tu aies le temps d'enregistrer ton journal.
Je n'ai pas d'ordinateur de bureau ni de connexion WiFi. Puis-je quand même tester avec Charles Proxy?
Malheureusement, un PC Windows, MacOS ou Linux utilisant le même WiFi que ton appareil mobile est obligatoire pour capturer les journaux de Charles Proxy. Si tu ne remplis pas cette exigence, tu dois sauter le cycle pour le moment.
Pourquoi l'application Charles Proxy ne capture-t-elle pas le journal de mon navigateur même après l'avoir configurée avec succès?
Généralement, un VPN et d'autres applications ou paramètres système (par exemple, pare-feu ou logiciels antivirus) peuvent interférer avec l'application Charles Proxy. Nous te recommandons de fermer toutes les connexions VPN et de désinstaller toutes les extensions de navigateur pour t'assurer que l'application Charles Proxy est le seul proxy lié à l'environnement de test depuis ton appareil. Tu peux également utiliser un navigateur différent pour surveiller le trafic.