Solicitud de un identificador de la Tienda del usuario para la autenticación de servicio a servicio

1. Identificador de colecciones del usuario para autenticarse con el servicio de colecciones de Microsoft Store
2. Identificador de compra del usuario para autenticarse con el servicio de compra de Microsoft Store

1. Configure una aplicación de Microsoft Entra ID.
2. Asocie el identificador de aplicación de Microsoft Entra con la aplicación cliente en Partner Center.
3. En su servicio, cree tokens de acceso de Microsoft Entra ID que representen su identidad de publicador.
4. En su juego, cree una clave de identificador de la Tienda del usuario que represente la identidad del usuario y pase esta clave de vuelta a su servicio.
5. Autentique las solicitudes a las API de Microsoft Store.
6. Renueve una clave de identificador de la Tienda del usuario cuando expire.

• Su servicio: back-end seguro que crea tokens de acceso de Microsoft Entra y llama a las API de la Tienda.
• Su juego: cliente que crea claves de identificador de la Tienda del usuario para el usuario con sesión iniciada y las pasa a su servicio.

​

La biblioteca .NET Microsoft.StoreServices y el ejemplo

• Biblioteca Microsoft.StoreServices
• Ejemplo de Microsoft.StoreServices

​

Paso 1: Configurar una aplicación de Microsoft Entra ID

1. Si aún no lo ha hecho, siga las instrucciones de Inicio rápido: Registro de una aplicación con la plataforma de identidad de Microsoft para registrar una aplicación de tipo Web app / API con Microsoft Entra ID.

   [!NOTE] Al registrar la aplicación, elija Web app / API como tipo de aplicación. Este tipo le permite recuperar una clave (también denominada secreto de cliente) para la aplicación. Para llamar a las API de Microsoft Store, debe proporcionar un secreto de cliente al solicitar un token de acceso de Microsoft Entra ID en un paso posterior.

2. En el Portal de administración de Azure, vaya a Microsoft Entra ID. Seleccione su directorio, App registrations en el panel izquierdo y, a continuación, su aplicación.
3. Copie los valores de Application (client) ID y Directory (tenant) ID para usarlos más adelante.
4. Cree y copie un nuevo secreto de cliente en Certificates & Secrets en el panel izquierdo.

​

Paso 2: Asociar el identificador de aplicación de Microsoft Entra con la aplicación cliente en Partner Center

1. Inicie sesión en Partner Center y, a continuación, seleccione su juego.
2. Seleccione Services > Product collections and purchases. Escriba el identificador de aplicación de Microsoft Entra en uno de los campos de Client ID disponibles.
3. Seleccione Save.
4. Vuelva a publicar el juego y sus complementos en la tienda.

​

Paso 3: Creación de tokens de acceso de Microsoft Entra ID

​

Descripción de los distintos tokens de acceso y URI de audiencia

​

Creación de tokens de acceso

POST https://login.microsoftonline.com/<tenant_id>/oauth2/v2.0/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://onestore.microsoft.com/.default

• Establezca client_id y client_secret en los valores del registro de aplicación del Portal de administración de Azure.
• Establezca resource en el URI de audiencia del tipo de token que necesite. Consulte Descripción de los distintos tokens de acceso y URI de audiencia.

​

Paso 4: Crear una clave de identificador de la Tienda del usuario

​

Para crear una clave de identificador de colecciones del usuario para el servicio de colecciones de Microsoft Store

1. Pase al juego un token de acceso de colecciones que haya creado en el Paso 3.
2. En el juego, llame a XStoreGetUserCollectionsIdAsync para recuperar la clave de identificador de colecciones del usuario. Pase el token de acceso de colecciones como el parámetro serviceTicket. De forma opcional, pase su identificador de usuario interno en publisherUserId.
3. Después de que la aplicación cree correctamente una clave de identificador de colecciones del usuario, pase la clave de vuelta a su servicio.

​

Para crear una clave de identificador de compra del usuario para el servicio de compra de Microsoft Store

1. Pase al juego un token de acceso de compra que haya creado en el Paso 3.
2. En el juego, llame a XStoreGetUserPurchaseIdAsync para recuperar la clave de identificador de compra del usuario. Pase el token de acceso de compra como el parámetro serviceTicket. De forma opcional, pase su identificador de usuario interno en publisherUserId.
3. Después de que la aplicación cree correctamente una clave de identificador de compra del usuario, pase la clave de vuelta a su servicio.

​

Paso 5: Autenticar las llamadas a las API de Microsoft Store

​

Paso 6: Renovar una clave de identificador de la Tienda del usuario cuando expire

​

Información adicional

​

Diagrama de la creación de una clave de identificador de la Tienda del usuario

​

Notificaciones de una clave de identificador de la Tienda del usuario

{
    "typ":"JWT",
    "alg":"RS256",
    "kid": "36D101AF67A9F61B8017FB96F91EDD4B22F05804",
    "x5t":"agA_pgJ7Twx_Ex2_rEeQ2o5fZ5g"
}

{
    "http://schemas.microsoft.com/marketplace/2015/08/claims/key/clientId": "1d577369placeholder7393beef1e13d",
    "http://schemas.microsoft.com/marketplace/2015/08/claims/key/payload": "placeholderytCRzCHSqnfczv3f0343wfSydx7hghfu0snWzMqyoAGy5DSJ5rMSsKoQFAccs1iNlwlGrX+/eIwh/VlUhLrncyP8c18mNAzAGK+lTAd2oiMQWRRAZxPwGrJrwiq2fTq5NOVDnQS9Za6/GdRjeiQrv6c0x+WNKxSQ7LV/uH1x+IEhYVtDu53GiXIwekltwaV6EkQGphYy7tbNsW2GqxgcoLLMUVOsQjI+FYBA3MdQpalV/aFN4UrJDkMWJBnmz3vrxBNGEApLWTS4Bd3cMswXsV9m+VhOEfnv+6PrL2jq8OZFoF3FUUpY8Fet2DfFr6xjZs3CBS1095J2yyNFWKBZxAXXNjn+zkvqqiVRjjkjNajhuaNKJk4MGHfk2rZiMy/aosyaEpCyncdisHVSx/S4JwIuxTnfnlY24vS0OXy7mFiZjjB8qL03cLsBXM4utCyXSIggb90GAx0+EFlVoJD7+ZKlm1M90xO/QSMDlrzFyuqcXXDBOnt7rPynPTrOZLVF+ODI5HhWEqArkVnc5MYnrZD06YEwClmTDkHQcxCvU+XUEvTbEk69qR2sfnuXV4cJRRWseUTfYoGyuxkQ2eWAAI1BXGxYECIaAnWF0W6ThweL5ZZDdadW9Ug5U3fZd4WxiDlB/EZ3aTy8kYXTW4Uo0adTkCmdLibw=",
    "http://schemas.microsoft.com/marketplace/2015/08/claims/key/userId": "infusQplaceholder/SZWoPB4FqLEwHXgZFuMJ6TuTY=",
    "http://schemas.microsoft.com/marketplace/2015/08/claims/key/refreshUri": "https://collections.mp.microsoft.com/v6.0/b2b/keys/renew",
    "iat": 1442395542,
    "iss": "https://collections.mp.microsoft.com/v6.0/keys",
    "aud": "https://collections.mp.microsoft.com/v6.0/keys",
    "exp": 1450171541,
    "nbf": 1442391941
}

​

Documentación de referencia de la API

• XStore (contenido de la API)
  • Funciones
    • XStoreGetUserCollectionsIdAsync
    • XStoreGetUserPurchaseIdAsync

​

Consulte también