> ## 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.

# Inspeccionar y modificar el tráfico de red con XMAT

> Use XMAT para capturar, inspeccionar, analizar y modificar el tráfico de red de las consolas de desarrollo XBOX y los PC con Windows.

[XBOX Multiplayer Analysis Tool (XMAT)](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/README.md) captura, inspecciona y modifica el tráfico de red de las consolas de desarrollo XBOX y los PC con Windows. Descargue la [versión más reciente de XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/releases).

XMAT puede:

* Actuar como proxy del tráfico HTTP y HTTPS.
* Descifrar y mostrar los datos de solicitudes y respuestas.
* Filtrar el tráfico capturado por host, código de estado y método.
* Ejecutar scripts de C# que modifiquen o finalicen solicitudes y respuestas.
* Capturar y analizar el tráfico de red de bajo nivel de una consola de desarrollo XBOX.
* Analizar capturas en vivo o guardadas en busca de patrones problemáticos de llamadas a XBOX services.

## Requisitos

XMAT requiere:

* Un PC de desarrollo con Windows 10, versión 1809 (compilación 17763) o posterior, o Windows 11.
* Permisos de administrador en el PC de desarrollo.
* [.NET 10 Desktop Runtime y ASP.NET Core Runtime para Windows x64](https://dotnet.microsoft.com/download/dotnet/10.0), o el SDK de .NET 10 para Windows x64.
* Para la captura de la consola, una consola de desarrollo XBOX con la recuperación 2106 o posterior.
* GDK Extensions for XBOX para las características de XMAT que se conectan a una consola de desarrollo XBOX.

## Instalar XMAT

1. Descargue el archivo ZIP actual desde [las versiones de XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/releases).
2. Extraiga el archivo ZIP en una carpeta local.
3. Ejecute XMAT como administrador.
4. Cuando se le solicite, instale el certificado raíz de XMAT y confíe en él. XMAT usa este certificado para descifrar el tráfico HTTPS.

## Capturar el tráfico web

1. En XMAT, seleccione la pestaña **+**.
2. Seleccione el dispositivo que ejecuta el título:
   * Para la consola de desarrollo XBOX predeterminada, seleccione **Default XBOX Console**.
   * Para otra consola de desarrollo XBOX, seleccione **XBOX Console at IP or Hostname**.
   * Para un título en el PC de desarrollo, seleccione **Local PC**.
3. Seleccione **Web Proxy** y, a continuación, seleccione **Add Capture**.
4. Inicie el proxy:
   * Para una consola de desarrollo XBOX, seleccione **Enable XBOX Proxy**. La consola se reinicia y comienza a enviar el tráfico web a través de XMAT.
     


   \* Para un PC con Windows, seleccione **Start Capture**.
5. Inicie el título y ejecute los escenarios que desee inspeccionar.
6. Seleccione una conexión para inspeccionar los encabezados y el cuerpo de su solicitud y su respuesta.

Use los filtros **Host**, **Status** y **Method** para aislar el tráfico pertinente. Seleccione **Save Captures** en el menú **File** para guardar la captura como un archivo XMATCAP.

> \[!IMPORTANT]
> Si una consola de desarrollo XBOX sigue configurada para usar el proxy de XMAT cuando XMAT no está capturando, las comprobaciones de XBOX services y otras solicitudes de red pueden producir errores. Seleccione **Disable XBOX Proxy** cuando termine las pruebas. La consola se reinicia para aplicar el cambio.

## Identificar los hosts de servicios de asociados

Antes de simular una interrupción del servicio, capture el tráfico normal del título:

1. Inicie una captura de proxy web de XMAT.
2. Inicie el título y ejecute todas las características que usan un servicio en línea, incluidas:
   * Menús y marcadores.
   * Creación y unión a sesiones multijugador.
   * Amigos y características sociales.
   * Tiendas dentro del título.
   * Eventos por tiempo limitado.
3. Use el filtro **Host** para revisar todos los hosts con los que se comunica el título.
4. Compare los hosts capturados con el inventario de servicios del título e identifique los servicios hospedados por asociados que se deben probar.

No bloquee los hosts de servicios de Microsoft, XBOX ni PlayFab al probar la conectividad de los servicios de asociados. Confirme a quién pertenece cada host en lugar de basarse únicamente en una subcadena de su nombre.

## Bloquear un servicio de asociado

Los scripts de XMAT pueden finalizar las solicitudes a los hosts seleccionados sin afectar al resto del tráfico.

1. Abra el **Script Editor** en la captura de proxy web activa.

2. Seleccione el evento **SSL Connection Request**.

3. Reemplace el host de ejemplo por cada host de servicio de asociado que desee bloquear. Por ejemplo:

   ```csharp theme={null}
   string host = Params.Request.Host.ToLowerInvariant();

   if (host == "api.publisher.example" ||
       host.EndsWith(".api.publisher.example"))
   {
       Params.Continue = false;
   }
   ```

4. Seleccione **Enable**. Compruebe que el script se compila correctamente.

5. Ejecute la característica afectada del título y compruebe que las solicitudes a los hosts seleccionados producen errores mientras los servicios de Microsoft, XBOX y PlayFab siguen disponibles.

El evento **SSL Connection Request** bloquea las conexiones HTTPS. Si el servicio de asociado usa HTTP sin cifrar, aplique la misma condición de host al evento **Web Request** y establezca `Params.Continue` en `false`.

Para simular un servicio que no está disponible antes de que se inicie el título, habilite el script de bloqueo antes de iniciar el título.

> \[!CAUTION]
> Los scripts de XMAT afectan al tráfico en vivo del dispositivo seleccionado. Limite el script de bloqueo a los hosts de asociados específicos necesarios para la prueba y deshabilite el script cuando la prueba haya finalizado.

## Detener la captura

1. Deshabilite los scripts activos.
2. Seleccione **Stop Capture**.
3. Si una consola de desarrollo XBOX está usando el proxy, seleccione **Disable XBOX Proxy** y espere a que la consola se reinicie.

Para conocer los problemas conocidos y las opciones de soporte técnico, consulte la [documentación del proyecto XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/README.md#known-issues) y la [directiva de soporte técnico de XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/SUPPORT.md).


## Related topics

- [Captura de tráfico de red en kits de desarrollo de XBOX One](/es/build/console-features/networking/tools/netcap-networking.md)
- [XR-074 Pérdida de conectividad con XBOX y los servicios de asociados](/es/publishing/certification/xr/xr-074.md)
- [Requisitos de XBOX probados en la certificación para juegos de consola XBOX](/es/publishing/certification/console-cert-tested-requirements.md)
- [Solución de problemas del tráfico de los servicios XBOX en PC](/es/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [Uso de Fiddler para inspeccionar llamadas a servicios web](/es/tools/tools-services/live-fiddler-inspect-web-calls.md)