Authentifier votre service auprès des API du Microsoft Store

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

​

Authentification avec Microsoft Entra ID et des User Store ID

Authorization: Bearer <Entra ID access token>  

  "sbx": "XDKS.1"

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

• Microsoft.StoreServices (GitHub) : bibliothèque et code source pour vous authentifier et appeler les services du Microsoft Store à partir de votre back-end.
• Exemple Microsoft.StoreServices (GitHub) : exemple de service qui illustre les 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 d’utilisation des produits à partir d’un service

​

Diagramme de l’appel d’une API du 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 au moyen de Microsoft Entra ID et de User Store ID

1. Dans la page Partner Center de votre jeu, sélectionnez Product collections and purchases dans le panneau de gauche.
2. Entrez 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 de ce produit dans le Microsoft Store de votre bac à sable ou de votre environnement de développement.

​

Authentification avec des jetons X d’authentification déléguée

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

• Game Service Sample : un exemple complet de service Web qui illustre la validation et la gestion des jetons X provenant du client, l’authentification de serveur à serveur, les services de commerce, et plus encore. Téléchargez la version la plus récente à partir du site de téléchargement du GDK. Téléchargez la plus récente 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 jetons X et de la façon dont Game Service Sample peut vous aider à amorcer votre propre démarche d’authentification de service à service. Pour télécharger les informations de la présentation, sélectionnez GDK Track Downloads sur le site d’archives.
• Authentification des services XBOX et appels de service à service : documentation plus détaillée sur l’authentification, les jetons X, ainsi que les étapes et les 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 jetons X 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 plutôt un nouveau Dev Studio au lieu de l’écraser, afin d’éviter de briser 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 assurez-vous que le Business Partner lié est le même que celui utilisé à l’étape 2.
9. Republiez tous les éléments du groupe de produits dans le Microsoft Store de votre bac à sable ou de votre environnement de développement.

​

Voir aussi