Authentification de votre service auprès des API Microsoft Store

• User Store IDs et Microsoft Entra ID : lie l’authentification et les résultats au compte d’utilisateur connecté à l’application Microsoft Store.
• X-tokens d’authentification déléguée : lie l’authentification et les résultats au compte de services XBOX de l’utilisateur qui joue actuellement au jeu.

​

Authentification avec Microsoft Entra ID et les User Store IDs

Authorization: Bearer <Entra ID access token>  

  "sbx": "XDKS.1"

  "beneficiaries": [
    {
        "identitytype" : "b2b",
        "identityValue" : "eyJ0eXAiOiJ...",
        "localTicketReference" : "testReference"
    }
  ],

• Microsoft.StoreServices (GitHub) : bibliothèque et code source permettant de s’authentifier et d’appeler les services Microsoft Store depuis votre back-end.
• Exemple Microsoft.StoreServices (GitHub) : exemple de service qui illustre des modèles d’authentification, d’intégration du commerce et de rapprochement des remboursements.
• Demande d’un User Store ID pour l’authentification de service à service
• Renouvellement d’une clé User Store ID
• Gérer les droits de produit à partir d’un service

​

Diagramme d’appel d’une API Microsoft Store

​

Configuration supplémentaire requise pour afficher et gérer des produits avec un User Store ID et l’authentification Microsoft Entra ID

​

Configurer vos produits pour qu’ils soient visibles par votre service via Microsoft Entra ID et les User Store IDs

1. Dans la page Partner Center de votre jeu, sélectionnez Product collections and purchases dans le volet de gauche.
2. Saisissez l’ID client de l’application Microsoft Entra que vous utilisez pour authentifier votre service.
3. Sélectionnez le bouton Save.
4. Republiez le produit de jeu et toutes les extensions du produit sur le Microsoft Store dans votre bac à sable ou votre environnement de développement.

​

Authentification avec des X-tokens d’authentification déléguée

Authorization: XBL3.0 x=<user hash>;<X-token>

• Game Service Sample : exemple complet de service web qui illustre la validation et la gestion des X-tokens provenant du client, l’authentification de serveur à serveur, les services de commerce, et bien plus encore. Téléchargez la dernière version depuis le site de téléchargement du GDK. Téléchargez la dernière version de All Samples. Game Service Samples se trouve sous samples\\Live\\GameService dans le fichier .zip téléchargé.
• Xfest 2019 - XSTS Auth and Server to Server made Easy : vue d’ensemble et explication des X-tokens et de la manière dont le Game Service Sample peut vous aider à démarrer votre propre implémentation de l’authentification de service à service. Pour télécharger les informations de la présentation, sélectionnez GDK Track Downloads sur le site d’archive.
• Authentification des services XBOX et appels de service à service : documentation plus détaillée sur l’authentification, les X-tokens, ainsi que les étapes et appels requis pour effectuer des appels de service à service vers les services XBOX.

​

Configuration supplémentaire requise pour afficher et gérer des produits avec des X-tokens d’authentification déléguée

​

Pour configurer vos produits et services web dans Partner Center

1. Créez un certificat Business Partner à l’aide du lien Generate Certificate du service web. (Sélectionnez Developer Settings > XBOX Live > Web Services.) Choisissez le lien dans la ligne du service web auquel votre partie de confiance est liée.
2. Accédez à l’interface de gestion Business Partner (sélectionnez Developer Settings > XBOX Live > Business Partner) et copiez le Business Partner ID qui correspond à celui du service web utilisé à l’étape 1. (Exemple de Business Partner ID : 12345678-9012-3456-7890-123456789012)
3. Dans la page Partner Center Overview de vos produits, sélectionnez Create a new, puis Product group.
4. Attribuez ce groupe de produits à un Dev Studio, ou sélectionnez Create a new developer studio si vous n’en avez pas encore.
5. Assurez-vous que l’ID du Dev Studio sélectionné correspond au Business Partner ID de l’étape 2. Copiez le Business Partner ID dans Dev Studio ID (optional) si ce champ est vide. Si ce champ contient déjà une valeur utilisée, créez un nouveau Dev Studio au lieu de l’écraser afin de ne pas rompre les mappages de produits de service à service existants.
6. Une fois le Dev Studio configuré avec l’ID correspondant du Business Partner, revenez au Product Group que vous avez créé. Ajoutez votre jeu et tous les produits à la liste Included in this product group.
7. Sélectionnez Save pour terminer la création du groupe de produits.
8. Accédez à l’interface XBOX Settings de votre jeu et vérifiez que le Business Partner lié est bien celui utilisé à l’étape 2.
9. Republiez tous les éléments du groupe de produits sur le Microsoft Store dans votre bac à sable ou votre environnement de développement.

​

Voir aussi