X-token 또는 OAuth 2.0으로 User Store ID 요청

• 흐름 내에 게임 클라이언트가 없는 경험
• 사용자의 XBOX 계정을 자체 서비스의 사용자 계정에 연결
• 클라이언트-서비스 및 서비스 간 호출에 이미 XBOX Security Tokens(XSTS 또는 X-token) 인증을 사용하는 게임 및 서비스

​

X-token 요구 사항

​

User Store ID를 생성하기 위한 OAuth 2.0 요구 사항

• OAuth 자격 증명을 X-token으로 교환해야 하므로 사용자는 Microsoft 계정에 연결된 XBOX identity가 있어야 합니다.
• 이 흐름에 대한 적절한 사용자 동의와 필요한 X-token을 검색하는 능력을 보장하려면 요청하는 OAuth 범위에 xboxlive.signin과 xboxlive.offline_access가 모두 포함되어야 합니다.

​

OAuth 2.0 자격 증명을 사용할 때의 단계

1. OAuth 2.0 인증 코드를 얻습니다.
2. 인증 코드를 RPS 토큰(Microsoft 계정 액세스 토큰이라고도 함)으로 교환합니다.
3. RPS 토큰을 XBOX User Token으로 교환합니다.
4. XBOX User Token을 자체 신뢰 당사자에 대한 X-Token으로 교환합니다.
5. X-Token을 사용할 때의 단계에서 X-token을 사용합니다.

​

X-Token을 사용할 때의 단계

1. 사용자의 X-token에서 DelegationToken 클레임(dlt)을 추출합니다.
2. Business Partner 인증서를 사용해 XSAS 서비스에서 Service Token을 얻습니다.
3. DelegationToken, Service Token, 대상 신뢰 당사자(표 참조)를 교환해 위임된 인증 X-token을 얻습니다.

​

요청

​

요청 구문

​

요청 헤더

​

요청 본문

​

요청 예

POST https://collections.mp.microsoft.com/v7.0/beneficiaries/me/keys HTTP/1.1
Authorization: XBL3.0 x=13178812777611882182;eyJ...
Content-Length: 1352
Content-Type: application/json;
Host: collections.mp.microsoft.com
 
{
    "serviceTicket": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIn...",
    "publisherUserId": "CustomPublisherUserId"
}

​

응답

​

응답 본문

​

응답 예

HTTP/1.1 200 OK
Date: Wed, 23 Mar 2022 23:06:25 GMT
Content-Type: application/json; 
Content-Length: 1716
MS-CorrelationId: dd5be303-f9a0-408a-bd01-e8c63afa721a
MS-RequestId: 0b9c8e5e-dfdd-4cf8-bfbe-93a5be3a7f48
MS-CV: rqFUH3gA+UOmTyXe.0

{"key":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjY..."}

​

참고