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

# Fiddler를 사용하여 웹 서비스 호출 검사

> Fiddler Classic을 웹 디버깅 프록시로 사용해 디바이스와 XBOX Live 서비스 또는 신뢰 당사자 API 간의 HTTP 및 HTTPS 트래픽을 기록하고 검사하는 방법을 안내합니다.

Fiddler는 디바이스와 인터넷 사이의 모든 HTTP 및 HTTPS 트래픽을 로그로 기록하는 웹 디버깅 프록시입니다. Fiddler를 사용하여 XBOX Live 서비스 및 신뢰 당사자 웹 서비스 간의 트래픽을 로그하고 검사하여 웹 서비스 호출을 이해하고 디버깅할 수 있습니다. Fiddler는 여러 버전으로 제공됩니다. 'Fiddler Classic'은 무료 소프트웨어입니다. 다음 섹션에서는 이 버전만 언급합니다.

## XBOX One 이상에서 실행되는 Microsoft Game Development Kit (GDK) 프로젝트용

자세한 내용은 [Fiddler](/build/console-features/networking/tools/fiddler-setup-networking)를 참조하세요.

## XBOX One(이상) XBOX One Software Development Kit 프로젝트용

일반적인 작업에서 프록시를 통해 통신하는 콘솔은 통신이 프록시에 의해 수정될 위험이 있습니다. 이러한 수정은 플레이어가 부정 행위를 할 수 있게 할 수 있습니다. 따라서 콘솔은 프록시를 통한 통신을 허용하지 않습니다. XBOX One(이상) 개발 키트와 함께 Fiddler를 사용하려면 Fiddler 프록시를 사용할 수 있도록 개발 키트에서 몇 가지 특수 구성 단계를 수행해야 합니다.

[Fiddler 웹사이트](https://www.telerik.com/download/fiddler)에서 Fiddler Classic을 다운로드할 수 있습니다.

Fiddler는 콘솔이 보고하는 네트워크 상태에 영향을 줄 수 있습니다. Fiddler를 실행 중인 머신에서 업스트림 연결을 비활성화하면 콘솔이 인증이 만료될 때까지 이 연결 해제를 감지하지 못할 수 있습니다. Fiddler를 사용하는 경우 Fiddler를 사용하여 연결 해제를 시뮬레이션하는 대신 콘솔과 Fiddler를 실행하는 컴퓨터 간의 연결을 끊으세요. 더 나은 방법으로 테스트 목적으로 연결 해제를 시뮬레이션하려면 네트워크 스트레스 도구를 사용하세요.

### 개발 PC에 Fiddler 설치 및 활성화

개발 키트의 트래픽을 모니터링하도록 Fiddler를 설치하고 활성화하려면 다음 단계를 따르세요.

1. [Fiddler 웹사이트](https://www.telerik.com/download/fiddler)의 지침에 따라 개발 PC에 Fiddler Classic을 설치합니다.
2. Fiddler를 실행하고 **도구** 메뉴에서 **Fiddler 옵션**을 선택합니다.
3. **연결** 탭을 선택하고 **원격 컴퓨터가 연결하도록 허용** 확인란이 선택되어 있는지 확인합니다.
4. 설정 변경 사항을 적용하려면 **확인**을 선택합니다. 변경 사항을 적용하려면 Fiddler를 다시 시작해야 하며, 방화벽을 수동으로 구성해야 할 수 있다는 대화 상자가 표시됩니다. 이 대화 상자에서 **확인**을 선택하지만 아직 Fiddler를 다시 시작하지 마세요.
5. 원격 컴퓨터가 연결할 수 있도록 필요한 방화벽 규칙을 구성합니다. Windows 방화벽 제어판 애플릿을 시작합니다. **고급 설정**을 선택한 다음 **인바운드 규칙**을 선택합니다. **FiddlerProxy**라는 규칙을 찾고 오른쪽으로 스크롤하여 해당 규칙에 대해 다음 설정이 각각 나타나는지 확인합니다.

| 설정               | 선호 값                 |
| ---------------- | -------------------- |
| Name             | FiddlerProxy         |
| Group            | (Group에 값을 설정하지 마세요) |
| Profile          | All                  |
| Enabled          | Yes                  |
| Action           | Allow                |
| Override         | No                   |
| Program          | fiddler.exe 경로       |
| LocalAddress     | Any                  |
| RemoteAddress    | Any                  |
| Protocol         | TCP                  |
| LocalPort        | Any                  |
| RemotePort       | Any                  |
| AllowedUsers     | Any                  |
| AllowedComputers | Any                  |

6. HTTPS 트래픽을 캡처하고 해독하도록 Fiddler를 구성합니다.
   1. 최상의 성능을 위해 버튼 표시줄에서 **Stream** 버튼을 선택하여 Fiddler가 스트리밍 모드를 사용하도록 설정합니다.
   2. Fiddler에서 **Tools**, **Fiddler Options**, **HTTPS**를 선택합니다.
   3. **Decrypt HTTPS traffic** 확인란을 선택합니다. Windows에서 CA 인증서를 신뢰하도록 구성할지 묻는 메시지 상자가 나타나면 **예**를 선택합니다.
   4. **Export Root Certificate to Desktop** 버튼을 선택합니다.
7. Fiddler를 종료한 후 다시 시작합니다.

### 인터넷 프록시로 Fiddler를 사용하도록 개발 키트 구성

개발 키트에서 Fiddler 구성은 이전 릴리스에서 사용된 방법보다 간단합니다.

1. 데스크톱으로 내보낸 Fiddler 루트 인증서를 개발 키트에 `xs:\Microsoft\Cert\FiddlerRoot.cer`로 복사합니다. 다음 명령을 사용하세요: `xbcp [local Fiddler Root directory]\FiddlerRoot.cer xs:\Microsoft\Cert\FiddlerRoot.cer`.
2. Fiddler를 실행하는 개발 PC의 IP 주소 또는 호스트 이름과 Fiddler가 수신하는 포트 번호만을 내용으로 하는 `ProxyAddress.txt`라는 텍스트 파일을 만듭니다. 이름/IP 주소와 포트의 형식은 다음과 같이 지정하세요: `HOST:PORT`. (기본적으로 Fiddler는 포트 8888을 사용합니다.) 예: `10.124.220.250:8888` 또는 `my_dev_pc.contoso.com:8888`.
3. 해당 파일을 개발 키트에 `xs:\Microsoft\Fiddler\ProxyAddress.txt`로 복사합니다. 다음 명령을 사용하세요: `xbcp [local Proxy Address file directory]\ProxyAddress.txt xs:\Microsoft\Fiddler\ProxyAddress.txt`.
4. 명령 프롬프트에 `xbreboot`를 입력하여 개발 키트를 재부팅합니다.

### Fiddler 사용 중지

Fiddler를 인터넷 프록시로 사용하는 것을 중지하고, 따라서 개발 키트의 모든 네트워크 트래픽을 Fiddler에서 추적하는 것을 중지하려면 개발 키트의 `FiddlerRoot.cer` 파일 이름을 바꾸거나 삭제한 다음 개발 키트를 재부팅하세요.

### 작동 방식

`xs:\Microsoft\Cert\FiddlerRoot.cer` 파일과 `xs:\Microsoft\Fiddler\ProxyAddress.txt` 파일이 모두 부팅 시점에 있으면 개발 키트는 `ProxyAddress.txt`에 지정된 프록시 서버를 사용하도록 자체를 구성합니다. 파일 중 하나라도 없으면 개발 키트는 Fiddler 프록시를 통해 작동하도록 자체를 구성하지 않습니다.

Fiddler가 설치된 각 PC는 다른 Fiddler 루트 인증서를 사용합니다. 개발 키트에 Fiddler 프록시를 제공할 수 있는 PC가 여러 대 있는 경우, 하나가 `FiddlerRoot.cer`이라는 이름을 가지고 있는 한 각 PC의 Fiddler 루트 인증서를 `xs:\Microsoft\Cert` 디렉터리에 복사할 수 있습니다.

개발 키트는 Fiddler 프록시를 인증할 때 Cert 디렉터리의 모든 인증서를 검사합니다. 개발 키트는 인증서가 Cert 디렉터리에 있는 한 `ProxyAddress.txt`에 있는 주소의 PC에 있는 Fiddler 인스턴스를 사용합니다.

## XBOX One(이상) UWP 프로젝트용

UWP 문서의 <a href="https://learn.microsoft.com/en-us/windows/uwp/xbox-apps/uwp-fiddler" target="_blank">UWP 개발 시 XBOX One과 함께 Fiddler를 사용하는 방법 ⬀</a> 문서의 단계를 따르세요.

## Windows UWP PC 앱용

1. PC에서 현재 사용자가 관리자 그룹에 있는지 확인합니다.
2. [https://www.telerik.com/fiddler](https://www.telerik.com/fiddler)에서 Fiddler를 다운로드합니다.
3. **.NET 4용으로 빌드됨** 버전을 선택했는지 확인합니다.
4. 설치되면 **Tools** > **Fiddler Options**로 이동하여 **Capture HTTPS CONNECTs**와 **Decrypt HTTPS traffic**을 활성화합니다. 런타임과 XBOX services 간의 모든 통신은 SSL을 사용하여 암호화됩니다. 이 옵션이 없으면 유용한 것을 볼 수 없습니다. Fiddler가 표시하는 모든 대화 상자를 수락합니다(UAC를 포함하여 5개의 대화 상자가 있음).
5. **WinConfig**로 이동하여 **Exempt All**을 선택한 후 **Save Changes**를 선택합니다. 그렇지 않으면 Fiddler는 Store 앱과 함께 작동하지 않습니다.
6. 이제 앱을 실행하면 앱, 런타임 및 XBOX services 간의 요청과 응답을 볼 수 있습니다.

일반적으로 필요하지 않지만 로그인 및 인게임 이벤트를 디버깅할 때 도움이 될 수 있는 UWP OS 수준 호출을 디버깅하려면 다음 명령을 사용하여 Fiddler가 WinHTTP 트래픽을 캡처하도록 구성하세요.

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

포트 번호는 Fiddler **Tools** | **Options** | **Connections** 탭에서 구성된 포트와 일치해야 합니다. 기본 포트 번호는 8888입니다.

이 구성을 실행 취소하려면 다음 명령을 사용하세요.

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


## Related topics

- [XBOX services Trace Analyzer (XblTraceAnalyzer.exe)](/ko/tools/tools-services/live-trace-analyzer.md)
- [XBOX 서비스용 개발 도구](/ko/tools/tools-services/live-tools.md)
- [XBOX 서비스용 도구](/ko/tools/tools-services/live-tools-nav.md)
- [Windows PC의 Fiddler](/ko/build/console-features/networking/tools/fiddler-pc.md)
- [파트너 센터에서 웹 서비스 설정하기](/ko/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/web-services/live-web-services.md)