Skip to main content
xCurl 대신 타이틀이 사용자 지정 HTTP 스택을 직접 사용하고 Fiddler와 같은 프록시를 통해 트래픽을 디버깅해야 하는 경우 이 문서를 사용합니다.

이 지침을 사용하는 경우

이 지침은 다음 중 하나 이상이 적용되는 경우에 가장 유용합니다.
  • 타이틀이 프록시 설정을 직접 검사하거나 적용해야 합니다.
  • 디버깅 워크플로우가 Fiddler 또는 다른 개발 프록시에 의존합니다.
  • HTTP 스택이 Schannel을 보안 공급자로 사용하지 않으며 프록시 인증서를 명시적으로 로드해야 합니다.
일반적인 보안 지침은 Microsoft Game Development Kit 타이틀용 보안 웹 요청 및 WebSockets 모범 사례를 참조하세요.

XBOX 및 PC의 프록시 설정

XBOX에서 프록시 설정을 처리할 때 빌드 및 대상 환경에서 해당 경로를 사용할 수 있는 경우 WinHttpProxySettingsTypeXBox와 함께 WinHttpGetProxySettingsEx를 선호합니다. XBOX에서 이 API는 2026년 4월 Microsoft Game Development Kit (GDK)부터 프록시 설정을 읽기 위한 미래 지향적인 API입니다. XBOX에서 타이틀이 이전 GDK를 대상으로 하는 경우 XBOX 전용 프록시 설정 경로를 사용할 수 없습니다. 이 경우 HTTP 스택에서 프록시 주소와 포트를 수동으로 설정합니다. 이 문서 뒷부분에 설명된 인증서 로드 경로는 XBOX 전용 프록시 주소 API를 사용할 수 없더라도 이러한 이전 GDK에서도 여전히 적용됩니다. PC 타이틀도 WinHTTP를 통해 프록시 설정을 쿼리할 수 있지만 XBOX 흐름을 직접 복사하지 마세요. PC에서 WinHttpGetProxySettingsEx는 비동기이므로 WinHttpGetProxySettingsResultEx를 호출하고 반환된 프록시 값을 HTTP 스택에 복사하기 전에 작업이 완료될 때까지 기다립니다. libcurl을 사용하는 예제는 XBOX 프록시 설정 API로 프록시 주소를 확인한 다음 스택에 직접 전달하는 것입니다. 세션은 WINHTTP_FLAG_ASYNC로 열리고 상태 콜백이 등록되어 코드가 동기 완료와 ERROR_IO_PENDING 반환 모두를 처리합니다. 다음 예제는 호출 흐름을 보여줍니다.

TLS 공급자 동작

Schannel 기반 스택

스택이 Schannel 기반 TLS 동작에 의존하는 경우 콘솔은 구성한 프록시 인증서를 자동으로 적용합니다. 이 동작은 Schannel을 TLS 공급자로 사용하는 libcurl 빌드에도 적용됩니다.

비 Schannel 스택

스택이 OpenSSL 또는 다른 비 Schannel TLS 공급자에 의존하는 경우 타이틀은 활성 디버깅 도구에서 필요한 인증서를 명시적으로 로드할 책임이 있습니다. 릴리스 코드에 이 인증서 로드 경로를 유지하세요. 콘솔에서 타이틀은 필요할 때 프록시된 트래픽을 진단할 수 있도록 RETAIL 빌드에서도 관련 프록시 디버깅 경로를 사용할 수 있게 유지해야 합니다. 신뢰, 프록시 및 보안 기본값 지침은 Microsoft Game Development Kit 타이틀용 보안 웹 요청 및 WebSockets 모범 사례를 참조하세요.

프록시 루트 인증서 찾기

비 Schannel 스택의 경우 디버깅 도구에 해당하는 인증서를 명시적으로 로드하고 이 경로를 릴리스 코드에 유지합니다. 인증서 위치와 주제는 도구에 따라 다릅니다. 예를 들어 XBOX Multiplayer Analysis Tool (XMAT)CurrentUser\Root에서 Xbox Multiplayer Analysis Tool Root Cert Authority 인증서를 사용합니다. 이 예제는 해당 인증서를 조회하고 DER 인코딩된 인증서 바이트를 타이틀 소유 버퍼로 복사합니다.
이 단계 후에 TLS 공급자가 사용하는 인증서 로드 경로로 encodedCertificate를 전달합니다.

제안된 디버깅 워크플로우

  1. XBOX 개발 킷의 Fiddler에 설명된 대로 XBOX Device Portal에서 콘솔 프록시 설정을 구성합니다.
  2. 2026년 4월 GDK 이상으로 XBOX를 대상으로 하고 타이틀이 프록시 설정을 직접 검사해야 하는 경우 WinHttpProxySettingsTypeXBox와 함께 WinHttpGetProxySettingsEx를 사용합니다.
  3. PC 코드 경로가 WinHTTP를 통해 프록시 설정을 쿼리하는 경우, WinHttpGetProxySettingsResultEx를 호출하고 반환된 프록시 값을 적용하기 전에 비동기 결과를 기다립니다.
  4. XBOX에서 이전 GDK를 대상으로 하거나 XBOX 전용 프록시 설정 경로를 사용하지 않는 스택을 사용하는 경우 타이틀 내에서 프록시 주소와 포트를 수동으로 설정합니다.
  5. Schannel을 사용하는 경우 콘솔이 적용한 인증서에 의존합니다. OpenSSL 또는 다른 스택을 사용하는 경우 사용 중인 디버깅 도구에 대한 인증서를 인증서 저장소에서 검색하고 명시적으로 로드합니다.

관련 페이지

마지막 수정일 2026년 8월 24일