Passer au contenu principal
Fiddler est un proxy de débogage web qui journalise tout le trafic HTTP et HTTPS entre votre appareil et Internet. Utilisez Fiddler pour journaliser et inspecter le trafic à destination et en provenance des services XBOX Live et des services web de parties de confiance, afin de comprendre et de déboguer les appels de services web. Fiddler est disponible en plusieurs versions. ‘Fiddler Classic’ est un logiciel gratuit. La section suivante concerne uniquement cette version.

Pour les projets Microsoft Game Development Kit (GDK) exécutés sur XBOX One ou version ultérieure

Pour plus de détails, voir Fiddler.

Pour les projets XBOX One Software Development Kit sur XBOX One (ou version ultérieure)

En fonctionnement normal, une console qui communique via un proxy risque de voir ses communications modifiées par ce proxy. Cette modification pourrait permettre aux joueurs de tricher. C’est pourquoi les consoles n’autorisent pas la communication via un proxy. Pour utiliser Fiddler avec votre kit de développement XBOX One (ou ultérieur), vous devez effectuer des étapes de configuration spéciales sur le kit de développement pour lui permettre d’utiliser le proxy Fiddler. Vous pouvez télécharger Fiddler Classic depuis le site web de Fiddler. Fiddler peut affecter l’état du réseau signalé par la console. Si vous désactivez une connexion en amont sur la machine qui exécute Fiddler, la console risque de ne pas détecter cette déconnexion avant l’expiration de son authentification. Si vous utilisez Fiddler, veillez à couper la connexion entre la console et l’ordinateur qui exécute Fiddler, plutôt que d’utiliser Fiddler pour simuler une déconnexion. Mieux encore, utilisez les outils de stress réseau pour simuler une déconnexion à des fins de test.

Installation et activation de Fiddler sur le PC de développement

Pour installer et activer Fiddler afin de surveiller le trafic de votre kit de développement, procédez comme suit.
  1. Installez Fiddler Classic sur votre PC de développement en suivant les instructions du site web de Fiddler.
  2. Lancez Fiddler et sélectionnez Fiddler Options dans le menu Tools.
  3. Sélectionnez l’onglet Connections et assurez-vous que la case Allow remote computers to connect est cochée.
  4. Sélectionnez OK pour accepter la modification des paramètres. Une boîte de dialogue indique que Fiddler doit être redémarré pour que la modification prenne effet et que vous devrez peut-être configurer votre pare-feu manuellement. Sélectionnez OK dans cette boîte de dialogue, mais ne redémarrez pas encore Fiddler.
  5. Configurez la règle de pare-feu nécessaire pour autoriser les ordinateurs distants à se connecter. Démarrez l’applet Pare-feu Windows du Panneau de configuration. Sélectionnez Paramètres avancés, puis Règle de trafic entrant. Recherchez la règle nommée FiddlerProxy et faites défiler vers la droite pour vérifier que chacun des paramètres suivants apparaît pour cette règle.
  1. Configurez Fiddler pour capturer et déchiffrer le trafic HTTPS.
    1. Pour obtenir les meilleures performances, configurez Fiddler en mode Streaming en sélectionnant le bouton Stream dans la barre de boutons.
    2. Dans Fiddler, sélectionnez Tools, puis Fiddler Options, puis HTTPS.
    3. Cochez la case Decrypt HTTPS traffic. Si un message vous demande si Windows doit faire confiance au certificat de l’autorité de certification, sélectionnez Yes.
    4. Sélectionnez le bouton Export Root Certificate to Desktop.
  2. Quittez Fiddler et redémarrez-le.

Configurer un kit de développement pour utiliser Fiddler comme proxy vers Internet

La configuration de Fiddler sur le kit de développement est plus simple que la méthode utilisée dans les versions précédentes.
  1. Copiez le certificat racine de Fiddler que vous avez exporté sur le Bureau vers le kit de développement sous le nom xs:\Microsoft\Cert\FiddlerRoot.cer. Utilisez la commande suivante : xbcp [local Fiddler Root directory]\FiddlerRoot.cer xs:\Microsoft\Cert\FiddlerRoot.cer.
  2. Créez un fichier texte nommé ProxyAddress.txt dont le seul contenu est l’adresse IP ou le nom d’hôte du PC de développement qui exécute Fiddler, ainsi que le numéro de port sur lequel Fiddler écoute. Mettez en forme le nom ou l’adresse IP et le port comme suit : HOST:PORT. (Par défaut, Fiddler utilise le port 8888.) Par exemple, 10.124.220.250:8888 ou my_dev_pc.contoso.com:8888.
  3. Copiez ce fichier sur le kit de développement sous le nom xs:\Microsoft\Fiddler\ProxyAddress.txt. Utilisez la commande suivante : xbcp [local Proxy Address file directory]\ProxyAddress.txt xs:\Microsoft\Fiddler\ProxyAddress.txt.
  4. Redémarrez le kit de développement en tapant xbreboot dans l’invite de commandes.

Arrêter d’utiliser Fiddler

Pour ne plus utiliser Fiddler comme proxy vers Internet, et donc ne plus tracer dans Fiddler l’ensemble du trafic réseau du kit de développement, renommez ou supprimez le fichier FiddlerRoot.cer sur le kit de développement, puis redémarrez celui-ci.

Fonctionnement

Si le fichier xs:\Microsoft\Cert\FiddlerRoot.cer et le fichier xs:\Microsoft\Fiddler\ProxyAddress.txt sont tous deux présents au démarrage, le kit de développement se configure pour utiliser le serveur proxy spécifié dans ProxyAddress.txt. Si l’un des fichiers est absent, le kit de développement ne se configure pas pour fonctionner via un proxy Fiddler. Chaque PC sur lequel Fiddler est installé utilise un certificat racine Fiddler différent. Si plusieurs PC peuvent fournir un proxy Fiddler à votre kit de développement, vous pouvez copier le certificat racine Fiddler de chaque PC dans le répertoire xs:\Microsoft\Cert, à condition que l’un d’entre eux soit nommé FiddlerRoot.cer. Le kit de développement vérifie tous les certificats du répertoire Cert lorsqu’il authentifie un proxy Fiddler. Il utilise l’instance de Fiddler du PC dont l’adresse figure dans ProxyAddress.txt, à condition que le certificat de celui-ci soit présent dans le répertoire Cert.

Pour les projets UWP sur XBOX One (ou version ultérieure)

Suivez les étapes de l’article How to use Fiddler with XBOX One when developing for UWP ⬀ dans la documentation UWP.

Pour les applications UWP pour PC Windows

  1. Assurez-vous que l’utilisateur actuel fait partie du groupe Administrateurs sur le PC.
  2. Téléchargez Fiddler depuis https://www.telerik.com/fiddler.
  3. Veillez à sélectionner la version Built for .NET 4.
  4. Une fois l’installation terminée, accédez à Tools > Fiddler Options et activez Capture HTTPS CONNECTs et Decrypt HTTPS traffic. Toutes les communications entre le runtime et les services XBOX sont chiffrées à l’aide de SSL. Sans cette option, vous ne verrez rien d’utile. Acceptez toutes les boîtes de dialogue affichées par Fiddler (il y en a cinq, y compris le Contrôle de compte d’utilisateur).
  5. Accédez à WinConfig, sélectionnez Exempt All, puis Save Changes. Sinon, Fiddler ne fonctionne pas avec les applications du Store.
  6. Si vous exécutez maintenant votre application, vous voyez les requêtes et les réponses échangées entre l’application, le runtime et les services XBOX.
Pour déboguer les appels UWP au niveau du système d’exploitation, ce qui n’est généralement pas nécessaire mais peut être utile pour déboguer la connexion et les événements en jeu, utilisez cette commande afin de configurer Fiddler pour capturer le trafic WinHTTP :
Le numéro de port doit correspondre au port configuré dans l’onglet Tools | Options | Connections de Fiddler. Le numéro de port par défaut est 8888. Utilisez cette commande pour annuler cette configuration :
Dernière modification le 8 octobre 2026