Solicitud de un User Store ID con tokens X u OAuth 2.0

• Experiencias en las que no hay un cliente del juego dentro del flujo
• Vincular la cuenta XBOX del usuario a la cuenta que su propio servicio tiene para el usuario
• Juegos y servicios que ya usan la autenticación con tokens de seguridad de XBOX (XSTS o tokens X) para las llamadas de cliente a servicio y de servicio a servicio

​

Requisito de token X

​

Requisitos de OAuth 2.0 para generar los User Store IDs

• El usuario debe tener una identidad de XBOX vinculada a su cuenta de Microsoft, ya que las credenciales de OAuth deben intercambiarse por un token X.
• El ámbito de OAuth que solicite debe incluir tanto xboxlive.signin como xboxlive.offline_access para garantizar el consentimiento adecuado del usuario para este flujo y la capacidad de recuperar el token X necesario.

​

Pasos al usar credenciales de OAuth 2.0

1. Obtenga el código de autorización de OAuth 2.0
2. Intercambie el código de autorización por un token RPS (también denominado token de acceso de cuenta de Microsoft)
3. Intercambie el token RPS por un XBOX User Token
4. Intercambie el XBOX User Token por un token X para su propio usuario de confianza (relying party)
5. Use el token X en Pasos al usar tokens X.

​

Pasos al usar tokens X

1. Extraiga la notificación DelegationToken (dlt) del token X del usuario.
2. Obtenga un Service Token del servicio XSAS usando su certificado de socio comercial.
3. Intercambie el DelegationToken, el Service Token y el usuario de confianza (relying party) de destino (consulte la tabla) por un token X de autenticación delegada.

​

Solicitud

​

Sintaxis de la solicitud

​

Encabezado de solicitud

​

Cuerpo de la solicitud

​

Ejemplo de solicitud

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"
}

​

Respuesta

​

Cuerpo de la respuesta

​

Ejemplo de respuesta

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..."}

​

Consulte también