> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utilisation de Fiddler pour inspecter les appels de services web

> Comment utiliser Fiddler Classic comme proxy de débogage web pour journaliser et inspecter le trafic HTTP et HTTPS entre votre appareil et les services XBOX Live ou les API de parties de confiance.

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](/fr/build/console-features/networking/tools/fiddler-setup-networking).

## 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](https://www.telerik.com/download/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](https://www.telerik.com/download/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.

| Paramètre | Valeur recommandée |
| - | - |
| Name | FiddlerProxy |
| Group | (ne définissez pas de valeur pour Group) |
| Profile | All |
| Enabled | Yes |
| Action | Allow |
| Override | No |
| Program | chemin d'accès à fiddler.exe |
| LocalAddress | Any |
| RemoteAddress | Any |
| Protocol | TCP |
| LocalPort | Any |
| RemotePort | Any |
| AllowedUsers | Any |
| AllowedComputers | Any |

6. 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**.
7. 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 <a href="https://learn.microsoft.com/en-us/windows/uwp/xbox-apps/uwp-fiddler" target="_blank">How to use Fiddler with XBOX One when developing for UWP ⬀</a> 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](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 :

```cpp theme={null}
    netsh winhttp set proxy 127.0.0.1:8888 "<-loopback>"
```

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 :

```cpp theme={null}
    netsh winhttp reset proxy
```


## Related topics

- [XBOX services Trace Analyzer (XblTraceAnalyzer.exe)](/fr/tools/tools-services/live-trace-analyzer.md)
- [Outils de développement pour les services XBOX](/fr/tools/tools-services/live-tools.md)
- [Outils pour les services XBOX](/fr/tools/tools-services/live-tools-nav.md)
- [Configuration des services web dans Partner Center](/fr/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/web-services/live-web-services.md)
- [Connexion aux services XBOX pour les sites web de titres](/fr/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-website-authentication.md)
