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

# 인증 테스트에서 게임 저장 파일 검색

> XblConnectedStorage, xbstorage 및 xgamesaveutil을 사용하여 XBOX Live CERT 샌드박스에서 게임 저장 파일을 가져와 개발 테스트 계정에 적용합니다.

## 인증 보고서에 충돌이 나열되어 있나요?

이는 특히 모든 버그가 해결되기 전 선택적 인증 테스트 패스 중에 드물지 않습니다. 어려움은 종종 스튜디오로 돌아가 개발 빌드에서 이러한 문제를 재현하는 것에 있습니다.

크래시 덤프를 사용할 수 없거나 도움이 되지 않는 경우, 인증에서 사용한 계정의 저장 파일이 도움이 될 수 있습니다. 인증 테스트 계정의 저장 파일을 개발 샌드박스 테스트 계정에 적용하면 문제를 더 쉽게 특정할 수 있습니다.

이 문서에서는 방법을 보여줍니다.

## CERT에서 저장 파일을 가져와 테스트 계정에 적용하는 방법

[XblConnectedStorage](/tools/tools-services/live-connected-storage-tool)는 XBOX Live CERT 샌드박스에서 저장 blob을 가져옵니다.

[Xbstorage](/tools/tools-console/commandlinetools/xbstorage)는 콘솔용 개발 샌드박스의 테스트 계정에 저장 파일을 적용하는 데 사용됩니다.

[Xgamesaveutil](/tools/tools-pc/commandlinetools/gr-xgamesaveutil)은 PC용 개발 샌드박스의 테스트 계정에 저장 파일을 적용하는 데 사용됩니다.

### 사전 요구 사항

1. 사용 중인 PC에 [GDK 또는 GDK Tools](https://aka.ms/gdkdl) 설치
2. 게임이 게시된 Partner Center 계정에 대한 로그인 자격 증명
   * 게임 제품에 대한 XBOX Live "Tools Access" 권한 포함([권한 문서](https://learn.microsoft.com/windows/apps/publish/partner-center/assign-product-level-custom-permissions-to-account-users#xbox-live-))
   * 로그인이 게스트 계정인 경우 계정이 게스트로 있는 Microsoft Entra 테넌트 이름이 필요합니다(아마도 ?.onmicrosoft.com 형식).
3. Partner Center의 Game Setup/Identity 세부 정보 섹션에서 게임의 XBOX Service Configuration ID(SCID).
4. 동일한 위치에서 게임의 Package Family Name(PFN).
5. 인증 팀에서 제공한, 저장 파일을 검색하려는 계정의 gamertag.
6. 인증에서 사용한 샌드박스 이름: CERT 또는 CERT.DEBUG.
7. 저장 파일을 적용하려는 테스트 계정의 이메일 주소.

### XBOX Live에서 저장 blob 검색

1. GDK 명령 프롬프트 창 열기
2. [xbldevaccount](/tools/tools-services/live-dev-account-tool)를 사용하여 사전 요구 사항 #2의 Partner Center 계정에 로그인합니다. 예:
   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com)</pre>

   다른 테넌트에서 게스트로 로그인하는 경우 --tenant 옵션을 사용합니다. 예:

   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) --tenant sombodyelseslovelygamecompany.onmicrosoft.com</pre>
3. XblConnectedStorage 명령줄을 사용하여 XBOX Live에서 저장 파일을 가져옵니다. 예:
   <pre>C:\temp>xblconnectedstorage --scid 00000000-0000-0000-0000-000012345678 -s CERT --gamertag "2 SomeCertAccount" --output .\GameSaveFrom2SomeCertAccount.xml
   Using Dev account [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) from WindowsDevCenter
   Operation complete. Downloaded 4 save containers to .\GameSaveFrom2SomeCertAccount.xml.</pre>

모두 성공하면 지정한 xml 파일에 저장 blob이 있어야 합니다. 내부에서 base64로 인코딩된 바이너리 blob을 볼 수 있어야 합니다. 파일 형식에 대한 자세한 정보는 [여기(NDA 항목)](/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat)에서 확인할 수 있습니다.

### 테스트 계정에 저장 파일 적용(콘솔)

xbstorage 문서의 지침에 따라 xml 파일을 저장소 공간에 적용합니다. 예:

<pre>C:\temp>xbstorage import .\GameSaveFrom2SomeCertAccount.xml /msa:[MLGC-MyTestAccount0000@xboxtest.com](mailto:MLGC-MyTestAccount0000@xboxtest.com) /replace /verbose</pre>

### 테스트 계정에 저장 파일 적용(PC)

XGameSaveUtil 문서의 지침에 따라 xml 파일을 저장소 공간에 적용합니다. 예:

<pre>C:\temp>xgamesaveutil import .\GameSaveFrom2SomeCertAccount.xml /pfn:mygame\_xxxxxx /replace</pre>

## 주의 사항

### 타이밍

인증에서 테스트해야 하는 방식으로 인해 문제가 발생한 후에도 계정이 계속 사용될 수 있습니다. 인증 보고서는 일반적으로 테스트가 완료된 후에 발급됩니다.

이로 인해 XBOX Live의 저장 파일이 문제가 발생했을 때 사용된 저장 파일보다 최신일 수 있습니다.

### Xblconnectedstorage 출력 디렉토리

xblconnectedstorage.exe에 --output을 제공하지 않으면 현재 작업 디렉토리에 출력을 시도합니다. GDK 명령 프롬프트를 방금 시작한 경우 이는 Windows 시스템 디렉토리일 가능성이 높으므로 xblconnectedstorage가 실패합니다. 명시적으로 --output 매개 변수를 제공하여 쓰기 가능한 위치를 가리키는 것이 좋습니다.

### Modern gamertag

이 절차는 현재 modern gamertag에서 테스트되지 않았습니다.


## Related topics

- [게임 인증](/ko/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game.md)
- [샌드박스](/ko/services/xbox-services/fundamentals/sandboxes/live-sandboxes-nav.md)
- [게임 저장 개요](/ko/build/core-features/common/game-save/game-saves-overview.md)
- [사전 릴리스 테스트 옵션](/ko/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-prerelease.md)
- [선택적 인증에 게임 패키지 제출](/ko/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-optional-certification.md)
