XMAT를 사용하여 네트워크 트래픽 검사 및 수정

• HTTP 및 HTTPS 트래픽을 프록시합니다.
• 요청 및 응답 데이터를 해독하고 표시합니다.
• 호스트, 상태 코드 및 메서드별로 캡처된 트래픽을 필터링합니다.
• 요청 및 응답을 수정하거나 종료하는 C# 스크립트를 실행합니다.
• XBOX 개발 콘솔에서 하위 수준 네트워크 트래픽을 캡처하고 분석합니다.
• 라이브 또는 저장된 캡처를 분석하여 문제가 있는 XBOX 서비스 호출 패턴을 찾습니다.

​

요구 사항

• Windows 10 버전 1809(빌드 17763) 이상 또는 Windows 11을 실행하는 개발 PC.
• 개발 PC에 대한 관리자 권한.
• Windows x64용 .NET 10 Desktop Runtime 및 ASP.NET Core Runtime 또는 Windows x64용 .NET 10 SDK.
• 콘솔 캡처의 경우 복구 2106 이상을 실행하는 XBOX 개발 콘솔.
• XBOX 개발 콘솔에 연결하는 XMAT 기능을 위한 GDK Extensions for XBOX.

​

XMAT 설치

1. XMAT 릴리스에서 현재 ZIP 파일을 다운로드합니다.
2. ZIP 파일을 로컬 폴더에 압축을 풉니다.
3. 관리자 권한으로 XMAT를 실행합니다.
4. 메시지가 표시되면 XMAT 루트 인증서를 설치하고 신뢰합니다. XMAT는 이 인증서를 사용하여 HTTPS 트래픽을 해독합니다.

​

웹 트래픽 캡처

1. XMAT에서 + 탭을 선택합니다.
2. 타이틀을 실행하는 디바이스를 선택합니다.
   • 기본 XBOX 개발 콘솔의 경우 Default XBOX Console을 선택합니다.
   • 다른 XBOX 개발 콘솔의 경우 XBOX Console at IP or Hostname을 선택합니다.
   • 개발 PC의 타이틀인 경우 Local PC를 선택합니다.
3. Web Proxy를 선택한 다음 Add Capture를 선택합니다.
4. 프록시를 시작합니다.
   • XBOX 개발 콘솔의 경우 Enable XBOX Proxy를 선택합니다. 콘솔이 다시 시작되고 XMAT를 통해 웹 트래픽을 보내기 시작합니다.
   • Windows PC의 경우 Start Capture를 선택합니다.
5. 타이틀을 실행하고 검사하려는 시나리오를 수행합니다.
6. 연결을 선택하여 요청 및 응답 헤더와 본문을 검사합니다.

[!IMPORTANT] XMAT가 캡처하지 않을 때 XBOX 개발 콘솔이 XMAT 프록시를 사용하도록 구성된 상태로 남아 있으면 XBOX 서비스 확인 및 기타 네트워크 요청이 실패할 수 있습니다. 테스트가 완료되면 Disable XBOX Proxy를 선택하세요. 변경 사항을 적용하기 위해 콘솔이 다시 시작됩니다.

​

파트너 서비스 호스트 식별

1. XMAT 웹 프록시 캡처를 시작합니다.
2. 타이틀을 실행하고 온라인 서비스를 사용하는 모든 기능을 수행합니다. 예:
   • 메뉴 및 순위표.
   • 멀티플레이어 세션 만들기 및 참가.
   • 친구 및 소셜 기능.
   • 타이틀 내 스토어.
   • 기간 한정 이벤트.
3. Host 필터를 사용하여 타이틀이 접속하는 모든 호스트를 검토합니다.
4. 캡처된 호스트를 타이틀의 서비스 인벤토리와 비교하고 테스트할 파트너 호스팅 서비스를 식별합니다.

​

파트너 서비스 차단

1. 활성 웹 프록시 캡처에서 Script Editor를 엽니다.
2. SSL Connection Request 이벤트를 선택합니다.
3. 샘플 호스트를 차단하려는 각 파트너 서비스 호스트로 바꿉니다. 예:
   string host = Params.Request.Host.ToLowerInvariant();
   
   if (host == "api.publisher.example" ||
       host.EndsWith(".api.publisher.example"))
   {
       Params.Continue = false;
   }
   
4. Enable을 선택합니다. 스크립트가 성공적으로 컴파일되는지 확인합니다.
5. 영향을 받는 타이틀 기능을 수행하고, Microsoft, XBOX 및 PlayFab 서비스는 계속 사용할 수 있는 상태에서 선택한 호스트에 대한 요청이 실패하는지 확인합니다.

[!CAUTION] XMAT 스크립트는 선택한 디바이스의 라이브 트래픽에 영향을 줍니다. 차단 스크립트는 테스트에 필요한 특정 파트너 호스트로 제한하고, 테스트가 완료되면 스크립트를 사용하지 않도록 설정하세요.

​

캡처 중지

1. 활성 스크립트를 모두 사용하지 않도록 설정합니다.
2. Stop Capture를 선택합니다.
3. XBOX 개발 콘솔이 프록시를 사용하는 경우 Disable XBOX Proxy를 선택하고 콘솔이 다시 시작될 때까지 기다립니다.