Demander un User Store ID pour l'authentification de service à service

1. User Collections ID pour s’authentifier auprès du service Microsoft Store Collections
2. User Purchase ID pour s’authentifier auprès du service Microsoft Store Purchase

1. Configurer une application Microsoft Entra ID.
2. Associer votre ID d’application Microsoft Entra à votre application cliente dans Partner Center.
3. Dans votre service, créer des jetons d’accès Microsoft Entra ID qui représentent votre identité d’éditeur.
4. Dans votre jeu, créer une clé User Store ID qui représente l’identité de l’utilisateur et renvoyer cette clé à votre service.
5. Authentifier les requêtes vers les API du Microsoft Store.
6. Renouveler une clé User Store ID lorsqu’elle expire.

• Votre service : back-end sécurisé qui crée les jetons d’accès Microsoft Entra et appelle les API du Store.
• Votre jeu : client qui crée les clés User Store ID pour l’utilisateur connecté et les transmet à votre service.

​

La bibliothèque .NET Microsoft.StoreServices et l’exemple associé

• Bibliothèque Microsoft.StoreServices
• Exemple Microsoft.StoreServices

​

Étape 1 : Configurer une application Microsoft Entra ID

1. Si ce n’est pas déjà fait, suivez les instructions de Démarrage rapide : Inscrire une application auprès de la plateforme d’identités Microsoft pour inscrire une application Web app / API auprès de Microsoft Entra ID.

   [!NOTE] Lorsque vous inscrivez votre application, choisissez Web app / API comme type d’application. Ce type vous permet de récupérer une clé (également appelée secret client) pour votre application. Pour appeler les API du Microsoft Store, vous devez fournir un secret client lorsque vous demandez un jeton d’accès à Microsoft Entra ID lors d’une étape ultérieure.

2. Dans le portail de gestion Azure, accédez à Microsoft Entra ID. Sélectionnez votre annuaire, App registrations dans le volet de gauche, puis votre application.
3. Copiez les valeurs Application (client) ID et Directory (tenant) ID pour une utilisation ultérieure.
4. Créez et copiez un nouveau secret client sous Certificates & Secrets dans le volet de gauche.

​

Étape 2 : Associer votre ID d’application Microsoft Entra à votre application cliente dans Partner Center

1. Connectez-vous à Partner Center, puis sélectionnez votre jeu.
2. Sélectionnez Services > Product collections and purchases. Entrez votre ID d’application Microsoft Entra dans l’un des champs Client ID disponibles.
3. Sélectionnez Save.
4. Republiez le jeu et ses extensions dans le Store.

​

Étape 3 : Création de jetons d’accès Microsoft Entra ID

​

Comprendre les différents jetons d’accès et URI d’audience

​

Création de jetons d’accès

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

• Définissez client_id et client_secret sur les valeurs de l’inscription de votre application dans le portail de gestion Azure.
• Définissez resource sur l’URI d’audience correspondant au type de jeton dont vous avez besoin. Consultez Comprendre les différents jetons d’accès et URI d’audience.

​

Étape 4 : Créer une clé User Store ID

​

Pour créer une clé User Collections ID pour le service Microsoft Store Collections

1. Transmettez au jeu un jeton d’accès Collections que vous avez créé à l’étape 3.
2. Dans le jeu, appelez XStoreGetUserCollectionsIdAsync pour récupérer la clé User Collections ID. Transmettez le jeton d’accès Collections en tant que paramètre serviceTicket. Vous pouvez éventuellement transmettre votre identificateur d’utilisateur interne dans publisherUserId.
3. Une fois que votre application a créé une clé User Collections ID, renvoyez la clé à votre service.

​

Pour créer une clé User Purchase ID pour le service Microsoft Store Purchase

1. Transmettez au jeu un jeton d’accès Purchase que vous avez créé à l’étape 3.
2. Dans le jeu, appelez XStoreGetUserPurchaseIdAsync pour récupérer la clé User Purchase ID. Transmettez le jeton d’accès Purchase en tant que paramètre serviceTicket. Vous pouvez éventuellement transmettre votre identificateur d’utilisateur interne dans publisherUserId.
3. Une fois que votre application a créé une clé User Purchase ID, renvoyez la clé à votre service.

​

Étape 5 : Authentifier les appels vers les API du Microsoft Store

​

Étape 6 : Renouveler une clé User Store ID lorsqu’elle expire

​

Informations supplémentaires

​

Diagramme de création d’une clé User Store ID

​

Revendications d’une clé User Store ID

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

​

Documentation de référence de l’API

• XStore (contenu de l’API)
  • Fonctions
    • XStoreGetUserCollectionsIdAsync
    • XStoreGetUserPurchaseIdAsync

​

Voir aussi