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

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

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 aux API du Microsoft Store.
6. Renouveler une clé User Store ID lorsqu’elle expire.

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

​

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

• 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éer des jetons d’accès Microsoft Entra ID

​

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

​

Créer des 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 du 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 Collections du Microsoft Store

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 comme paramètre serviceTicket. Vous pouvez également 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 Purchase du Microsoft Store

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 comme paramètre serviceTicket. Vous pouvez également 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 aux API du Microsoft Store

​

Étape 6 : Renouveler une clé User Store ID à son expiration

​

Informations supplémentaires

​

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

​

Revendications dans 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 des API

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

​

Voir aussi