Utiliser XBOX Multiplayer Analysis Tool pour inspecter et modifier le trafic réseau

• Servir de proxy pour le trafic HTTP et HTTPS.
• Déchiffrer et afficher les données des requêtes et des réponses.
• Filtrer le trafic capturé par hôte, code d’état et méthode.
• Exécuter des scripts C# qui modifient ou interrompent les requêtes et les réponses.
• Capturer et analyser le trafic réseau de bas niveau d’une console de développement XBOX.
• Analyser des captures en direct ou enregistrées afin de détecter des modèles d’appel problématiques aux services XBOX.

​

Configuration requise

• Un PC de développement exécutant Windows 10, version 1809 (build 17763) ou ultérieure, ou Windows 11.
• Des autorisations d’administrateur sur le PC de développement.
• Le .NET 10 Desktop Runtime et ASP.NET Core Runtime pour Windows x64, ou le SDK .NET 10 pour Windows x64.
• Pour la capture sur console, une console de développement XBOX exécutant la recovery 2106 ou ultérieure.
• Les extensions GDK pour XBOX, pour les fonctionnalités de XMAT qui se connectent à une console de développement XBOX.

​

Installer XMAT

1. Téléchargez le fichier ZIP actuel depuis les versions de XMAT.
2. Extrayez le fichier ZIP dans un dossier local.
3. Exécutez XMAT en tant qu’administrateur.
4. Lorsque vous y êtes invité, installez le certificat racine de XMAT et accordez-lui votre confiance. XMAT utilise ce certificat pour déchiffrer le trafic HTTPS.

​

Capturer le trafic Web

1. Dans XMAT, sélectionnez l’onglet +.
2. Sélectionnez l’appareil qui exécute le titre :
   • Pour la console de développement XBOX par défaut, sélectionnez Default XBOX Console.
   • Pour une autre console de développement XBOX, sélectionnez XBOX Console at IP or Hostname.
   • Pour un titre sur le PC de développement, sélectionnez Local PC.
3. Sélectionnez Web Proxy, puis Add Capture.
4. Démarrez le proxy :
   • Pour une console de développement XBOX, sélectionnez Enable XBOX Proxy. La console redémarre et commence à envoyer son trafic Web par XMAT.
   • Pour un PC Windows, sélectionnez Start Capture.
5. Lancez le titre et exécutez les scénarios que vous voulez inspecter.
6. Sélectionnez une connexion pour inspecter les en-têtes et le corps de sa requête et de sa réponse.

[!IMPORTANT] Si une console de développement XBOX reste configurée pour utiliser le proxy XMAT alors que XMAT n’effectue pas de capture, les vérifications des services XBOX et les autres requêtes réseau peuvent échouer. Sélectionnez Disable XBOX Proxy une fois les tests terminés. La console redémarre pour appliquer la modification.

​

Identifier les hôtes des services partenaires

1. Démarrez une capture de proxy Web XMAT.
2. Lancez le titre et utilisez chaque fonctionnalité qui fait appel à un service en ligne, notamment :
   • Les menus et les classements.
   • La création et la jonction de sessions multijoueur.
   • Les amis et les fonctionnalités sociales.
   • Les boutiques intégrées au titre.
   • Les événements à durée limitée.
3. Utilisez le filtre Host pour examiner chaque hôte contacté par le titre.
4. Comparez les hôtes capturés avec l’inventaire des services du titre et identifiez les services hébergés par des partenaires à tester.

​

Bloquer un service partenaire

1. Ouvrez le Script Editor dans la capture de proxy Web active.
2. Sélectionnez l’événement SSL Connection Request.
3. Remplacez l’hôte d’exemple par chaque hôte de service partenaire que vous voulez bloquer. Par exemple :
   string host = Params.Request.Host.ToLowerInvariant();
   
   if (host == "api.publisher.example" ||
       host.EndsWith(".api.publisher.example"))
   {
       Params.Continue = false;
   }
   
4. Sélectionnez Enable. Vérifiez que le script se compile correctement.
5. Utilisez la fonctionnalité concernée du titre et vérifiez que les requêtes vers les hôtes sélectionnés échouent, tandis que les services Microsoft, XBOX et PlayFab restent disponibles.

[!CAUTION] Les scripts XMAT affectent le trafic en direct de l’appareil sélectionné. Limitez un script de blocage aux hôtes partenaires spécifiques nécessaires au test, et désactivez le script une fois le test terminé.

​

Arrêter la capture

1. Désactivez tous les scripts actifs.
2. Sélectionnez Stop Capture.
3. Si une console de développement XBOX utilise le proxy, sélectionnez Disable XBOX Proxy et attendez que la console redémarre.