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

# Usar o Fiddler para inspecionar chamadas de serviços web

> Como usar o Fiddler Classic como proxy de depuração web para registrar em log e inspecionar o tráfego HTTP e HTTPS entre seu dispositivo e os serviços do XBOX Live ou APIs de terceira parte confiável.

O Fiddler é um proxy de depuração web que registra em log todo o tráfego HTTP e HTTPS entre seu dispositivo e a internet. Use o Fiddler para registrar e inspecionar o tráfego de e para os serviços do XBOX Live e os serviços web de terceira parte confiável, para que você possa entender e depurar chamadas de serviços web. O Fiddler está disponível em várias versões. O 'Fiddler Classic' é gratuito. A seção a seguir se refere apenas a essa versão.

## Para projetos do Microsoft Game Development Kit (GDK) executados no XBOX One ou posterior

Para obter detalhes, veja [Fiddler](/pt-BR/build/console-features/networking/tools/fiddler-setup-networking).

## Para projetos do XBOX One Software Development Kit no XBOX One (ou posterior)

Em operação normal, um console que se comunica por meio de um proxy corre o risco de ter suas comunicações modificadas pelo proxy. Essa modificação pode permitir que jogadores trapaceiem. Por isso, os consoles não permitem comunicação por meio de um proxy. Para usar o Fiddler com seu kit de desenvolvimento XBOX One (ou posterior), você precisa executar algumas etapas especiais de configuração no kit de desenvolvimento para permitir que ele use o proxy do Fiddler.

Você pode baixar o Fiddler Classic no [site do Fiddler](https://www.telerik.com/download/fiddler).

O Fiddler pode afetar o status de rede que o console informa. Se você desabilitar uma conexão upstream da máquina que executa o Fiddler, o console poderá não detectar essa desconexão até que a autenticação do console expire. Se você estiver usando o Fiddler, desconecte a conexão entre o console e o computador que executa o Fiddler, em vez de usar o Fiddler para simular uma desconexão. Melhor ainda, use as ferramentas de estresse de rede para simular a desconexão para fins de teste.

### Instalar e habilitar o Fiddler no PC de desenvolvimento

Para instalar e habilitar o Fiddler para monitorar o tráfego do seu kit de desenvolvimento, siga estas etapas.

1. Instale o Fiddler Classic no seu PC de desenvolvimento, seguindo as instruções no [site do Fiddler](https://www.telerik.com/download/fiddler).
2. Inicie o Fiddler e selecione **Fiddler Options** no menu **Tools**.
3. Selecione a guia **Connections** e verifique se a caixa de seleção **Allow remote computers to connect** está marcada.
4. Selecione **OK** para aceitar a alteração nas configurações. Você verá uma caixa de diálogo informando que o Fiddler precisa ser reiniciado para que a alteração entre em vigor e que talvez seja necessário configurar o firewall manualmente. Selecione **OK** nessa caixa de diálogo, mas não reinicie o Fiddler ainda.
5. Configure a regra de firewall necessária para permitir que computadores remotos se conectem. Inicie o miniaplicativo do Painel de Controle do Firewall do Windows. Selecione **Configurações avançadas** e, em seguida, **Regra de entrada**. Encontre a regra chamada **FiddlerProxy** e role para a direita, verificando se cada uma das configurações a seguir aparece para essa regra.

| Configuração | Valor preferencial |
| - | - |
| Name | FiddlerProxy |
| Group | (não defina um valor para Group) |
| Profile | All |
| Enabled | Yes |
| Action | Allow |
| Override | No |
| Program | caminho para fiddler.exe |
| LocalAddress | Any |
| RemoteAddress | Any |
| Protocol | TCP |
| LocalPort | Any |
| RemotePort | Any |
| AllowedUsers | Any |
| AllowedComputers | Any |

6. Configure o Fiddler para capturar e descriptografar o tráfego HTTPS.
   1. Para obter o melhor desempenho, configure o Fiddler para usar o Modo de streaming selecionando o botão **Stream** na barra de botões.
   2. No Fiddler, selecione **Tools**, depois **Fiddler Options** e depois **HTTPS**.
   3. Marque a caixa de seleção **Decrypt HTTPS traffic**. Se uma caixa de mensagem perguntar se deseja configurar o Windows para confiar no certificado da AC, selecione **Yes**.
   4. Selecione o botão **Export Root Certificate to Desktop**.
7. Saia do Fiddler e inicie-o novamente.

### Configurar um kit de desenvolvimento para usar o Fiddler como proxy para a internet

A configuração do Fiddler no kit de desenvolvimento é mais simples do que o método usado em versões anteriores.

1. Copie o certificado raiz do Fiddler que você exportou para a área de trabalho para o kit de desenvolvimento como `xs:\Microsoft\Cert\FiddlerRoot.cer`. Use o seguinte comando: `xbcp [local Fiddler Root directory]\FiddlerRoot.cer xs:\Microsoft\Cert\FiddlerRoot.cer`.
2. Crie um arquivo de texto chamado `ProxyAddress.txt` cujo único conteúdo seja o endereço IP ou o nome do host do PC de desenvolvimento que executa o Fiddler e o número da porta em que o Fiddler está escutando. Formate o nome/endereço IP e a porta da seguinte forma: `HOST:PORT`. (Por padrão, o Fiddler usa a porta 8888.) Por exemplo, `10.124.220.250:8888` ou `my_dev_pc.contoso.com:8888`.
3. Copie esse arquivo para o kit de desenvolvimento como `xs:\Microsoft\Fiddler\ProxyAddress.txt`. Use o seguinte comando: `xbcp [local Proxy Address file directory]\ProxyAddress.txt xs:\Microsoft\Fiddler\ProxyAddress.txt`.
4. Reinicie o kit de desenvolvimento digitando `xbreboot` no prompt de comando.

### Parar de usar o Fiddler

Para parar de usar o Fiddler como proxy para a internet e, assim, deixar de rastrear todo o tráfego de rede do kit de desenvolvimento no Fiddler, renomeie ou exclua o arquivo `FiddlerRoot.cer` no kit de desenvolvimento e reinicie-o.

### Como funciona

Se os arquivos `xs:\Microsoft\Cert\FiddlerRoot.cer` e `xs:\Microsoft\Fiddler\ProxyAddress.txt` estiverem presentes no momento da inicialização, o kit de desenvolvimento se configura para usar o servidor proxy especificado em `ProxyAddress.txt`. Se algum dos arquivos estiver ausente, o kit de desenvolvimento não se configura para operar por meio de um proxy do Fiddler.

Cada PC com o Fiddler instalado usa um certificado raiz do Fiddler diferente. Se você tiver mais de um PC que possa fornecer um proxy do Fiddler para seu kit de desenvolvimento, poderá copiar o certificado raiz do Fiddler de cada PC para o diretório `xs:\Microsoft\Cert`, desde que um deles se chame `FiddlerRoot.cer`.

O kit de desenvolvimento verifica todos os certificados do diretório Cert ao autenticar um proxy do Fiddler. O kit de desenvolvimento usa a instância do Fiddler no PC cujo endereço está em `ProxyAddress.txt`, desde que o certificado dele esteja presente no diretório Cert.

## Para projetos UWP no XBOX One (ou posterior)

Siga as etapas do artigo <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> na documentação da UWP.

## Para apps UWP para PC com Windows

1. Verifique se o usuário atual está no grupo de administradores do PC.
2. Baixe o Fiddler em [https://www.telerik.com/fiddler](https://www.telerik.com/fiddler).
3. Selecione a versão **Built for .NET 4**.
4. Após a instalação, vá para **Tools** > **Fiddler Options** e habilite **Capture HTTPS CONNECTs** e **Decrypt HTTPS traffic**. Todas as comunicações entre o runtime e os serviços XBOX são criptografadas usando SSL. Sem essa opção, você não verá nada útil. Aceite todas as caixas de diálogo exibidas pelo Fiddler (são cinco caixas de diálogo, incluindo o UAC).
5. Vá para **WinConfig**, selecione **Exempt All** e **Save Changes**. Caso contrário, o Fiddler não funciona com apps da Store.
6. Agora, se você executar seu app, verá as solicitações e respostas entre o app, o runtime e os serviços XBOX.

Para depurar chamadas da UWP no nível do sistema operacional, o que geralmente não é necessário, mas pode ser útil ao depurar a entrada e eventos no jogo, use este comando para configurar o Fiddler para capturar o tráfego do WinHTTP:

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

O número da porta deve corresponder à porta configurada na guia **Tools** | **Options** | **Connections** do Fiddler. O número de porta padrão é 8888.

Use este comando para desfazer essa configuração:

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


## Related topics

- [Analisador de rastreamento dos serviços XBOX (XblTraceAnalyzer.exe)](/pt-BR/tools/tools-services/live-trace-analyzer.md)
- [Ferramentas para serviços XBOX](/pt-BR/tools/tools-services/live-tools-nav.md)
- [Ferramentas de desenvolvimento para serviços XBOX](/pt-BR/tools/tools-services/live-tools.md)
- [Fiddler no PC com Windows](/pt-BR/build/console-features/networking/tools/fiddler-pc.md)
- [Inspecionar e modificar o tráfego de rede com o XMAT](/pt-BR/tools/tools-services/live-xbox-multiplayer-analysis-tool.md)
