로그인 및 샌드박스 오류 문제 해결

이 문서는 PC의 개발 샌드박스에서 게임의 일반적인 로그인 및 샌드박스 관련 오류를 진단하고 수정하는 데 도움이 됩니다.

이 문서에서

사전 점검 체크리스트
진단 흐름도
계정 및 샌드박스 오류
구성 오류
게임 관련 문제 해결
추가 문제 해결
오류 코드 빠른 참조

사전 점검 체크리스트

특정 오류를 조사하기 전에 이 체크리스트를 통해 진행하세요. 대부분의 로그인 문제는 이러한 항목 중 하나가 잘못 구성되어 발생합니다. 아래의 진단 흐름도 및 오류 섹션으로 진행하기 전에 다음 모두를 확인하세요.

XblPCSandbox.exe 도구가 이미 설치되어 있는 것이 중요합니다. 얻는 방법에 대한 자세한 내용은 샌드박스 개요를 참조하세요.

환경 확인

이러한 항목은 XBOX 앱을 포함한 XBOX services에 로그인하는 능력에 영향을 미칩니다. 이것을 먼저 확인하세요.

✅ 1. 샌드박스 ID에 오타가 없는지 검토

샌드박스 ID가 올바르게 입력되었는지 확인하세요. 확인 방법:

XblPCSandbox /get

출력을 Partner Center의 Gameplay settings 페이지에 표시된 샌드박스와 비교하세요. https://partner.microsoft.com/en-us/xboxconfig?appid=[productId]를 사용하여 이를 수행할 수 있습니다. [productId] 매개 변수를 해당 Product Id로 바꿉니다. 해결 방법:

XblPCSandbox <your sandbox ID>

샌드박스 전환에 대한 자세한 지침은 샌드박스 개요를 참조하세요.

✅ 2. 샌드박스가 올바른지

PC는 게임의 XBOX services 구성이 게시된 것과 동일한 개발 샌드박스에 있어야 합니다. 확인 방법:

XblPCSandbox /get

XblPCSandbox <your sandbox ID>

샌드박스 전환에 대한 자세한 지침은 샌드박스 개요를 참조하세요.

✅ 3. 테스트 계정이 유효한지

테스트 계정은 여러 가지 이유로 유효하지 않게 될 수 있습니다. 다음을 모두 확인하세요.

계정의 샌드박스 액세스가 만료되지 않았는지

샌드박스에 대한 테스트 계정 액세스에는 만료 날짜가 있습니다. 샌드박스에 대한 만료된 액세스를 가진 계정은 샌드박스에 로그인할 수 없습니다. 확인 방법:

Partner Center로 이동합니다.
Apps and Games를 선택합니다.
XBOX Test accounts를 선택합니다(또는 테스트 계정 관리로 이동합니다).
테스트 계정을 찾아 Access Expires 및 Status 열을 확인합니다.

해결 방법: 계정이 만료된 경우 새 테스트 계정을 만들거나 기존 계정의 만료 날짜를 연장합니다.

계정에 샌드박스 액세스 권한이 있는지

테스트 계정을 만들 때 특정 샌드박스에 대한 액세스 권한을 부여해야 합니다. 확인 방법:

Partner Center에서 XBOX services > Test accounts로 이동합니다.
테스트 계정을 선택합니다.
개발 샌드박스가 계정의 샌드박스 액세스 아래에 나열되어 있는지 확인합니다.

해결 방법: 테스트 계정을 편집하고 개발 샌드박스를 액세스 목록에 추가합니다.

자격 증명이 올바른지

테스트 계정에 올바른 이메일 주소와 암호를 사용하고 있는지 확인하세요. 테스트 계정 이메일 주소는 일반적으로 @xboxtest.com으로 끝납니다.

✅ 4. XBOX 게임 구성 요소가 최신 상태

XBOX services는 PC의 XBOX 앱과 Gaming Services 구성 요소에 의존합니다. 둘 중 하나의 이전 버전은 예기치 않은 로그인 실패를 일으킬 수 있습니다. 확인 방법:

Game Repair Tool에 제공된 정보를 따르세요.

✅ 5. PC 다시 시작

때로는 로그인에 필요한 백그라운드 서비스(예: XBOX Live Auth Manager 또는 Gaming Services)가 잘못된 상태에 빠질 수 있습니다. PC 다시 시작은 위의 단계로 해결되지 않는 일시적인 문제를 해결할 수 있습니다. 이렇게 하기 전에 Feedback Hub를 통해 버그를 제출하여 추적하고 향후 릴리스에서 해결할 수 있도록 하는 것이 중요합니다. 다음 명령을 사용하여 이를 수행할 수 있습니다.

XblPCSandbox /feedback

또는 Feedback Hub에서 직접 하는 경우, Category: Gaming and XBOX 및 Area: Developer Tools를 선택하세요. 이 작업을 수행할 때: 위의 모든 환경 확인을 검증했지만 여전히 로그인이 실패하는 경우, PC를 다시 시작하고 프로젝트 확인으로 이동하기 전에 다시 시도하세요.

프로젝트 확인

이러한 항목은 특히 게임에서의 로그인에 영향을 미칩니다. XBOX 앱에 로그인할 수 있지만 게임에서는 로그인할 수 없는 경우 여기서 시작하세요.

✅ 6. ID가 Partner Center와 일치

MicrosoftGame.config의 ID는 Partner Center의 값과 정확히 일치해야 합니다. 하나의 불일치 값도 로그인을 방지합니다. 확인 방법: MicrosoftGame.config를 열고 이 값들을 Partner Center와 비교하세요:

MicrosoftGame.config 필드	Partner Center에서 찾을 수 있는 위치
`StoreId`	Game Setup > Identity details > Show details > Store ID
`Identity/Name`	Game Setup > Identity details > Show details > Package/Identity/Name
`Identity/Publisher`	Game Setup > Identity details > Show details > Package/Identity/Publisher
`TitleId`	XBOX services > XBOX Settings > Title ID (16진수 값, 10진수가 아님)
`MSAAppId`	XBOX services > XBOX Settings > MSA App ID (GUID 또는 16진수일 수 있음)

또한 SCID(Service Configuration ID)를 확인하세요. SCID는 MicrosoftGame.config에 없습니다. XblInitialize 메서드의 매개 변수로 전달됩니다. Partner Center의 XBOX services > XBOX Settings 아래에서 찾을 수 있습니다.

MicrosoftGame.config Editor의 Store Association Wizard를 사용하여 게임을 자동으로 연결하고 오타 가능성을 줄이세요.

✅ 7. XBOX services 구성이 샌드박스에 게시됨

Partner Center에서 변경 사항을 저장한 후에도 개발 샌드박스에 게시할 때까지 활성 상태가 아닙니다. 확인 방법:

Partner Center로 이동합니다.
제품을 선택합니다.
XBOX services > Gameplay settings로 이동합니다.
개발 샌드박스의 탭을 선택합니다.
게시 상태를 확인합니다.

해결 방법: 변경 사항이 게시되지 않은 경우 Publish를 선택하여 개발 샌드박스로 푸시합니다. 다시 테스트하기 전에 변경 사항이 전파될 때까지 약 30분 기다립니다.

XBOX Settings 페이지에서 Save를 클릭해도 변경 사항이 게시되지 않습니다. Gameplay settings 페이지에서 명시적으로 게시해야 합니다.

✅ 8. PC 플랫폼이 활성화됨

PC에서 개발하는 경우 Windows 10 PC(및 이후) 플랫폼이 타이틀에 활성화되어 있어야 합니다. 이 없이 로그인은 오류 0x87dd0005 (AM_E_XAST_UNEXPECTED)로 실패합니다. 확인 방법:

Partner Center로 이동합니다.
제품을 선택합니다.
XBOX services > XBOX Settings로 이동합니다.
Windows 10 PC 체크박스가 체크되어 있는지 확인합니다. 최신 Windows 버전에 대해서도 이를 수행합니다.

해결 방법:

Windows 10 PC 체크박스를 체크합니다.
Save를 선택합니다.
Gameplay settings로 이동하여 개발 샌드박스에 설정을 게시합니다.
테스트하기 전에 약 30분 기다립니다.

진단 흐름도

사전 점검 체크리스트로 문제가 해결되지 않은 경우, 이 단계별 프로세스를 사용하여 근본 원인을 좁혀보세요. 1단계에서 시작하여 분기를 따르세요.

┌─────────────────────────────────────────────────────────┐
│                  Still can't sign in?                   │
│         Start here after completing the                 │
│              Preflight Checklist                        │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
        ┌───────────────────────────────┐
        │  STEP 1: Can you sign in to   │
        │  the Xbox App with your       │
        │  test account?                │
        └───────┬───────────────┬───────┘
                │               │
            YES ▼           NO  ▼
    ┌───────────────┐   ┌──────────────────────────────────────────────┐
    │  Sandbox and  │   │  Sandbox or account                          │
    │  account are  │   │  issue. Check:                               │
    │  working.     │   │                                              │
    │  Go to Step 2 │   │  • Is the sandbox ID correct?                │
    │               │   │  • Is the account access to sandbox expired? │
    └───────┬───────┘   │  • Does the account have sandbox access?     │
            │           │  • Are the credentials right?                │
            │           │  • Is the Xbox App up to date?               │
            │           │  • Is the Xbox App licensed?                 │
            │           │                                              │
            │           │  See: Account & Sandbox Errors below         │
            │           └──────────────────────────────────────────────┘
            ▼
┌───────────────────────────────┐
│  STEP 2: Can you sign in to   │
│  a sample project with your   │
│  game's IDs?                  │
└───────┬───────────────┬───────┘
        │               │
    YES ▼           NO  ▼
┌───────────────┐   ┌──────────────────────────────┐
│  Config is    │   │  Configuration issue.        │
│  working.     │   │  Check:                      │
│  Go to Step 3 │   │                              │
│               │   │  • Are the IDs correct in    │
└───────┬───────┘   │    MicrosoftGame.config?     │
        │           │  • Are the gameplay settings │
        │           │    published to the sandbox? │
        │           │  • Is the PC Platform        │
        │           │    enabled?                  │
        │           │  • Is the SCID correct in    │
        │           │    XblInitialize?            │
        │           │                              │
        │           │  See: Configuration          │
        │           │  Errors below                │
        │           └──────────────────────────────┘
        ▼
┌───────────────────────────────┐
│  STEP 3: Game-specific issue  │
│  The sample works but your    │
│  game doesn't.                │
│                               │
│  • Compare the MicrosoftGame  │
│    .config files              │
│  • Compare the sign-in code   │
│  • Check the error code in    │
│     reference table below     │
└───────────────────────────────┘

계정 및 샌드박스 오류

XBOX 앱에 로그인할 수 없었던 경우(진단 흐름도의 1단계), 문제는 샌드박스 전환, 테스트 계정 또는 XBOX 앱 자체에 있습니다.

사용자가 이 샌드박스에 없음 (0x8015DC12)

테스트 계정이 샌드박스에 액세스할 수 없거나 게임의 구성이 샌드박스와 일치하지 않습니다. 일반적인 원인 및 해결 방법:

원인	해결 방법
`MicrosoftGame.config`의 ID가 Partner Center와 일치하지 않음	체크리스트 항목 1 및 체크리스트 항목 2를 참조하세요
테스트 계정에 샌드박스 액세스 권한이 없음	Partner Center에서 테스트 계정을 편집하고 샌드박스를 추가합니다
테스트 계정의 샌드박스 액세스가 만료됨	Partner Center에서 만료 날짜를 확인합니다. 새 계정을 만들거나 연장합니다
공유가 아닌 격리된 샌드박스 사용	Partner Center에서 샌드박스 유형을 확인합니다. 격리를 사용할 특정 이유가 없다면 공유 샌드박스로 전환합니다. 격리된 vs. 공유 샌드박스를 참조하세요.

잘못된 샌드박스 ID

일반적인 실수는 다음을 포함합니다.

문자 누락 또는 추가: XDKS.1 대신 XDKS1
잘못된 샌드박스: 게임의 구성이 게시된 것과 다른 샌드박스로 전환

해결 방법:

XblPCSandbox /get을 실행하고 출력을 Partner Center와 비교합니다.
Partner Center의 정확한 값으로 XblPCSandbox <correct sandbox ID>를 다시 실행합니다.

테스트 계정에 대한 잘못된 샌드박스 (Garrison 오류)

계정이 다른 샌드박스에서 작동해야 한다고 제안하는 오류 메시지를 보거나 로그인 중에 XBOX identity service가 예기치 않은 오류를 반환하는 경우, 해당 테스트 계정에 대한 잘못된 샌드박스에 로그인되어 있을 가능성이 큽니다. 해결 방법:

XblPCSandbox /get을 실행하여 PC가 어느 샌드박스로 설정되어 있는지 확인합니다.
Partner Center에서 XBOX services > Test accounts로 이동하여 테스트 계정이 해당 샌드박스에 액세스할 수 있는지 확인합니다.
샌드박스가 일치하지 않으면 올바른 샌드박스로 전환합니다: XblPCSandbox <correct sandbox ID>

XBOX 앱 라이선싱 오류 (0x803F8001)

이전에 RETAIL에서 열지 않은 경우 XBOX 앱이 시작되지 않을 수 있습니다. 해결 방법:

RETAIL로 전환: XblPCSandbox /retail (또는 XblPCSandbox RETAIL)
XBOX 앱을 열고 완전히 시작되도록 합니다.
개발 샌드박스로 다시 전환: XblPCSandbox <your sandbox ID>

XBOX 앱을 찾을 수 없음

XBOX 앱은 Microsoft Store에서 사용할 수 있지만, RETAIL 샌드박스에 있을 때만 사용할 수 있습니다. 찾을 수 없는 경우:

RETAIL로 전환: XblPCSandbox /retail (또는 XblPCSandbox RETAIL)
Microsoft Store에서 “XBOX”를 검색하고 설치합니다.
샌드박스로 다시 전환합니다.

구성 오류

XBOX 앱에는 로그인할 수 있지만 게임이나 샘플 프로젝트 내에서는 로그인할 수 없는 경우(진단 흐름도의 2단계), 문제는 게임의 XBOX services 구성에 있습니다.

PC 플랫폼이 활성화되지 않음 (0x87dd0005, AM_E_XAST_UNEXPECTED)

이 오류는 Windows 10 PC 플랫폼이 Partner Center에 추가되지 않았음을 의미합니다. 이후 버전에 대해서도 확인하세요. 해결 방법:

Partner Center에서 제품 > XBOX services > XBOX Settings로 이동합니다.
Windows 10 PC 체크박스를 체크합니다.
Save를 선택합니다.
Gameplay settings로 이동하여 개발 샌드박스에 설정을 게시합니다.
30분 기다린 후 다시 로그인을 시도합니다.

XBOX Settings 페이지에서 Save를 클릭해도 변경 사항이 게시되지 않습니다. 로그인이 작동하려면 Gameplay settings 페이지에서 명시적으로 게시해야 합니다.

XBOX services 구성이 게시되지 않음

Partner Center에서 저장된 변경 사항은 개발 샌드박스에 게시될 때까지 활성 상태가 아닙니다. 해결 방법:

Partner Center에서 XBOX services > Gameplay settings로 이동합니다.
개발 샌드박스 탭을 선택합니다.
Publish를 선택합니다.
변경 사항이 전파될 때까지 약 30분 기다립니다.

MicrosoftGame.config의 잘못된 ID

로그인 오류의 일반적인 원인 중 하나는 MicrosoftGame.config에서 하나 이상의 불일치 값입니다. 해결 방법: MicrosoftGame.config Editor의 Store Association Wizard를 사용하여 게임을 연결하고 올바른 값을 자동 입력하세요. 또는 체크리스트 항목 1을 사용하여 Partner Center에 대해 각 값을 수동으로 확인합니다.

XblInitialize의 잘못된 SCID

SCID는 MicrosoftGame.config에 없습니다 – XblInitialize의 매개 변수로 전달됩니다. Partner Center(XBOX services > XBOX Settings)의 올바른 SCID를 전달하고 있는지 확인하세요.

격리된 vs. 공유 샌드박스

격리된 샌드박스를 사용할 특정 이유가 없다면 공유 샌드박스를 사용하세요. Partner Center에서 샌드박스 유형을 확인할 수 있습니다. 격리된 샌드박스에는 로그인 실패를 일으킬 수 있는 추가 제한이 있습니다.

게임 관련 문제 해결

XBOX 앱 로그인이 작동하고 그리고 샘플 프로젝트가 게임의 ID로 작동하지만 게임에서 여전히 로그인할 수 없는 경우(진단 흐름도의 3단계), 문제는 게임의 코드나 구성에만 관련이 있습니다.

MicrosoftGame.config 파일 비교

게임의 MicrosoftGame.config를 작동하는 샘플과 비교하세요. 추가 또는 누락된 필드, 형식 차이 또는 잘못된 값을 찾으세요.

로그인 코드 비교

게임의 로그인 구현을 샘플의 코드와 비교하세요. XUserAddAsync가 호출되는 방식(옵션, 콜백, 오류 처리)의 차이를 찾으세요.

기본 사용자 없음 (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

이 오류는 현재 로그인된 기본 사용자가 없음을 의미합니다. 원인: AddDefaultUserSilently 옵션으로 XUserAddAsync를 호출했지만 현재 로그인된 사용자가 없습니다. 해결 방법: 자세한 내용은 XUserAddAsync 및 AdvancedUserModel을 참조하세요.

추가 문제 해결

XBOX services에 중단이 발생하고 있음

다른 모든 옵션을 소진한 경우, XBOX services에 중단이 있는지 확인하세요:

XBOX Status 페이지

[!IMPORTANT] 알려진 제한 사항 (GDK 26.04): XblPCSandbox는 SSH 세션을 통해 실행할 때 샌드박스 전환에 실패합니다. 대신 로컬 세션에서 XblPCSandbox를 실행하세요.

오류 코드 빠른 참조

오류 코드	이름	가능한 원인	해결 방법
`0x8015DC12`	User not in sandbox	불일치 ID, 샌드박스 액세스 없음, 테스트 계정의 샌드박스 액세스 만료 또는 격리된 샌드박스	체크리스트를 참조하세요. ID, 계정 액세스 및 샌드박스 유형을 확인합니다
`0x87dd0005`	`AM_E_XAST_UNEXPECTED`	Partner Center에서 PC 플랫폼이 활성화되지 않음	XBOX Settings에서 Windows 10 (및 이후) PC를 활성화하고, 샌드박스에 게시한 후 30분 기다립니다
`0x89245106`	`E_GAMEUSER_NO_DEFAULT_USER`	기본 사용자가 로그인하지 않았음; `XUserAddAsync(AddDefaultUserSilently)`를 호출함	이 문제를 해결하는 방법에 대한 자세한 내용은 `XUserAddAsync` 및 AdvancedUserModel을 참조하세요.
`0x803F8001`	라이선싱 오류	XBOX 앱이 이전에 RETAIL에서 시작되지 않음	RETAIL로 전환, XBOX 앱 시작, 개발 샌드박스로 다시 전환
`0x80004005`	일반 로그인 실패	샌드박스 또는 계정 잘못된 구성; 서비스 측 문제를 나타낼 수도 있음	사전 점검 체크리스트를 통해 작업합니다. 샌드박스 ID, 테스트 계정 액세스 및 계정 만료를 확인합니다. 문제가 지속되면 PC를 다시 시작하고 샌드박스를 다시 전환해 보세요.

여기에 나열되지 않은 오류 코드가 표시되면 Feedback Hub를 통해 문제를 제출하세요.xblPcSandbox /feedback을 사용하여 버그를 제출하세요.또는 Feedback Hub에서 직접 하는 경우, Category: Gaming and XBOX 및 Area: Developer Tools를 선택하세요.

참고 항목

마지막 수정일 2026년 9월 1일

XBOX Services

PlayFab

이 문서에서

사전 점검 체크리스트

환경 확인

✅ 1. 샌드박스 ID에 오타가 없는지 검토

✅ 2. 샌드박스가 올바른지

✅ 3. 테스트 계정이 유효한지

계정의 샌드박스 액세스가 만료되지 않았는지

계정에 샌드박스 액세스 권한이 있는지

자격 증명이 올바른지

✅ 4. XBOX 게임 구성 요소가 최신 상태

✅ 5. PC 다시 시작

프로젝트 확인

✅ 6. ID가 Partner Center와 일치

✅ 7. XBOX services 구성이 샌드박스에 게시됨

✅ 8. PC 플랫폼이 활성화됨

진단 흐름도

계정 및 샌드박스 오류

사용자가 이 샌드박스에 없음 (0x8015DC12)

잘못된 샌드박스 ID

테스트 계정에 대한 잘못된 샌드박스 (Garrison 오류)

XBOX 앱 라이선싱 오류 (0x803F8001)

XBOX 앱을 찾을 수 없음

구성 오류

PC 플랫폼이 활성화되지 않음 (0x87dd0005, AM_E_XAST_UNEXPECTED)

XBOX services 구성이 게시되지 않음

MicrosoftGame.config의 잘못된 ID

XblInitialize의 잘못된 SCID

격리된 vs. 공유 샌드박스

게임 관련 문제 해결

MicrosoftGame.config 파일 비교

로그인 코드 비교

기본 사용자 없음 (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

추가 문제 해결

XBOX services에 중단이 발생하고 있음

오류 코드 빠른 참조

참고 항목

​이 문서에서

​사전 점검 체크리스트

​환경 확인

​✅ 1. 샌드박스 ID에 오타가 없는지 검토

​✅ 2. 샌드박스가 올바른지

​✅ 3. 테스트 계정이 유효한지

​계정의 샌드박스 액세스가 만료되지 않았는지

​계정에 샌드박스 액세스 권한이 있는지

​자격 증명이 올바른지

​✅ 4. XBOX 게임 구성 요소가 최신 상태

​✅ 5. PC 다시 시작

​프로젝트 확인

​✅ 6. ID가 Partner Center와 일치

​✅ 7. XBOX services 구성이 샌드박스에 게시됨

​✅ 8. PC 플랫폼이 활성화됨

​진단 흐름도

​계정 및 샌드박스 오류

​사용자가 이 샌드박스에 없음 (0x8015DC12)

​잘못된 샌드박스 ID

​테스트 계정에 대한 잘못된 샌드박스 (Garrison 오류)

​XBOX 앱 라이선싱 오류 (0x803F8001)

​XBOX 앱을 찾을 수 없음

​구성 오류

​PC 플랫폼이 활성화되지 않음 (0x87dd0005, AM_E_XAST_UNEXPECTED)

​XBOX services 구성이 게시되지 않음

​MicrosoftGame.config의 잘못된 ID

​XblInitialize의 잘못된 SCID

​격리된 vs. 공유 샌드박스

​게임 관련 문제 해결

​MicrosoftGame.config 파일 비교

​로그인 코드 비교

​기본 사용자 없음 (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

​추가 문제 해결

​XBOX services에 중단이 발생하고 있음

​오류 코드 빠른 참조

​참고 항목

이 문서에서

사전 점검 체크리스트

환경 확인

✅ 1. 샌드박스 ID에 오타가 없는지 검토

✅ 2. 샌드박스가 올바른지

✅ 3. 테스트 계정이 유효한지

계정의 샌드박스 액세스가 만료되지 않았는지

계정에 샌드박스 액세스 권한이 있는지

자격 증명이 올바른지

✅ 4. XBOX 게임 구성 요소가 최신 상태

✅ 5. PC 다시 시작

프로젝트 확인

✅ 6. ID가 Partner Center와 일치

✅ 7. XBOX services 구성이 샌드박스에 게시됨

✅ 8. PC 플랫폼이 활성화됨

진단 흐름도

계정 및 샌드박스 오류

사용자가 이 샌드박스에 없음 (0x8015DC12)

잘못된 샌드박스 ID

테스트 계정에 대한 잘못된 샌드박스 (Garrison 오류)

XBOX 앱 라이선싱 오류 (0x803F8001)

XBOX 앱을 찾을 수 없음

구성 오류

PC 플랫폼이 활성화되지 않음 (0x87dd0005, AM_E_XAST_UNEXPECTED)

XBOX services 구성이 게시되지 않음

MicrosoftGame.config의 잘못된 ID

XblInitialize의 잘못된 SCID

격리된 vs. 공유 샌드박스

게임 관련 문제 해결

MicrosoftGame.config 파일 비교

로그인 코드 비교

기본 사용자 없음 (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

추가 문제 해결

XBOX services에 중단이 발생하고 있음

오류 코드 빠른 참조

참고 항목