Passer au contenu principal
Cette rubrique s’adresse uniquement aux partenaires gérés, et non au programme Creators, en raison des restrictions imposées à la configuration des services web. Elle n’est accessible qu’aux développeurs disposant de l’autorisation Relying Parties au niveau du compte. Si vous ne contrôlez pas vos autorisations au niveau du compte, contactez votre gestionnaire de compte développeur (DAM) pour obtenir de l’aide.
Les éditeurs peuvent créer des services web s’ils souhaitent personnaliser la façon dont leurs applications ou titres interagissent avec les services XBOX. Les services web sont des configurations au niveau de l’éditeur et peuvent être appelés par n’importe quel titre d’un sandbox appartenant à l’éditeur, en configurant l’authentification unique (SSO). Raisons de définir des services web :
  1. Fournir l’authentification unique aux utilisateurs XBOX : pour que votre service web puisse fournir l’authentification unique aux utilisateurs XBOX, il doit être configuré en tant que partie de confiance des services XBOX. Avec cette configuration, les utilisateurs authentifiés auprès des services XBOX sont automatiquement authentifiés auprès de vos services, sans avoir à saisir d’autres informations d’identification.
  2. Effectuer des appels de service à service depuis votre service vers les services XBOX : si votre titre utilise l’un de vos services web pour effectuer des appels aux services XBOX, directement ou pour le compte d’utilisateurs individuels, vous avez besoin d’un certificat de partenaire commercial (Business Partner Certificate).

​
Création d’un service web

  1. Accédez au tableau de bord Partner Center.
  2. Sélectionnez la section Apps and Games
  3. Dans le volet de navigation de gauche, sélectionnez XBOX services > Web services.
  4. Dans la page Web Services, sélectionnez New Web Service.
  5. Saisissez le nom du service web, puis choisissez le type d’accès requis.
    • Telemetry access permet à votre service de récupérer les données de télémétrie de n’importe lequel de vos jeux.
    • App Channel access donne au fournisseur de contenu multimédia propriétaire du service le droit de publier par programmation des canaux d’application destinés à être consommés sur console.
  6. Sélectionnez Save.
À ce stade, vous avez défini le service et les services XBOX ont connaissance de son existence. Selon les raisons de la création du service web, vous devrez configurer des parties de confiance (SSO) ou des certificats de partenaire commercial (appels de service à service).

​
Configuration de la NSAL, des définitions de jetons XSTS et des parties de confiance dans Partner Center

Pour que votre titre puisse communiquer avec votre service web à l’aide de jetons XSTS, vous devez définir votre service web dans Partner Center, créer une partie de confiance et publier la Network Security Access List (NSAL) de votre titre via la configuration des services XBOX de votre sandbox.

​
Définition de votre service web, de la partie de confiance et des revendications du jeton XSTS

  1. Dans Partner Center, sélectionnez la section Apps and games
  2. Dans le menu de navigation de gauche, sélectionnez XBOX services > Relying parties.
  3. Dans la page Relying Parties, sélectionnez New Relying Party.
  4. Fournissez un Audience URI*.
  5. Sélectionnez le type de chiffrement que vos jetons doivent utiliser**.
  6. Créez un certificat de partie de confiance asymétrique en suivant les instructions de la section suivante. Exportez ensuite le fichier .cer public et chargez-le. Veillez à donner au fichier .cer un nom lié à la partie de confiance afin de pouvoir l’identifier facilement.
  7. Indiquez la durée de vie souhaitée de votre jeton, en heures (nous recommandons quatre heures).
  8. Ajoutez les revendications de jeton requises à la définition du jeton.
  9. Sélectionnez Save.
*L’Audience URI doit se présenter sous la forme d’un URI d’hôte. Toutefois, ce nom peut être différent de l’URI du service réel. Par exemple, Example.com peut être l’Audience URI de la partie de confiance, alors que le point de terminaison du service est en réalité https://game.example.com/action/.
**Nous recommandons d’utiliser l’option JWE RFC 7516 pour le chiffrement asymétrique. L’option héritée JWE Draft 7 est destinée à la rétrocompatibilité des anciens titres.

​
Création d’un nouveau certificat de partie de confiance

  1. Sur votre ordinateur, ouvrez l’Invite de commandes développeur pour Visual Studio.
  2. Exécutez la commande suivante, en remplaçant l’exemple de nom « Contoso » par le vôtre : makecert -sv RP_Private_Key.pvk -n "CN=Contoso Relying Party" RP_Cert.cer -b 01/01/2015 -e 12/31/2199 -sky exchange -ss My -a sha256 -len 2048 -r -pe
  3. Lorsque vous y êtes invité, saisissez un mot de passe pour la clé privée.
  4. Exécutez la commande suivante, en remplaçant le mot de passe figurant à la fin par le vôtre : PVK2PFX -pvk RP_Private_Key.pvk -spc RP_Cert.cer -pfx RP_Full_Cert.pfx -po PasswordForPFX!
  5. Lorsque vous y êtes invité, saisissez le mot de passe que vous avez défini pour la clé privée à l’étape 3.
  6. Utilisez le fichier RP_Cert.cer pour configurer la définition de votre jeton dans Partner Center.
  7. Copiez le fichier RP_Full_Cert.pfx sur votre serveur, puis importez-le dans le magasin de certificats de l’ordinateur.
  8. Lors de l’importation du certificat complet, veillez à sélectionner l’option Marquer cette clé comme exportable afin de pouvoir l’exporter vers d’autres serveurs si nécessaire.
  9. Si vous devez réexporter le fichier .cer de clé publique de ce certificat, sélectionnez l’option X.509 encodé en base 64 (.CER) dans l’Assistant Exportation de certificat.

​
Définition du point de terminaison de votre service dans la NSAL de votre titre

Maintenant que vous avez défini votre partie de confiance et les revendications du jeton XSTS, vous devez définir l’URL que votre titre appellera dans la NSAL de votre configuration des services XBOX. Cela indique à l’API GetTokenAndSignature du client quelle définition de jeton XSTS fournir lors de l’appel de cet hôte d’URL.
  1. Accédez à la page de vue d’ensemble de votre titre dans Partner Center.
  2. Sélectionnez XBOX services > Gameplay settings dans le menu de navigation de gauche. La page Gameplay Setting s’affiche.
  3. Consultez l’onglet, vers le haut de la page, correspondant au sandbox dans lequel vous effectuerez vos tests.
  4. Sélectionnez XBOX services > Single sign-on. La page XBOX Live single sign-on configuration s’affiche.
  5. Sélectionnez New endpoint.
  6. Saisissez l’adresse de l’hôte d’URL du service que votre titre appellera.
  7. Sélectionnez dans la liste déroulante la Relying Party que vous avez configurée précédemment.
  8. Sélectionnez Save.
  9. Revenez à la page Gameplay Setting.
  10. Sélectionnez l’onglet du sandbox dans lequel vous souhaitez publier votre NSAL mise à jour.
  11. Sélectionnez Publish dans le coin supérieur droit.

​
Création d’un certificat de partenaire commercial pour les appels de serveur à serveur (B2B) vers les services XBOX

  1. Dans Partner Center, sélectionnez la section Apps and games
  2. Dans le menu de navigation de gauche, sélectionnez XBOX services > Web services.
  3. Sélectionnez New web service.
  4. Saisissez un nom pour identifier votre service web. Ce nom peut être l’URL de l’hôte ou n’importe quelle chaîne qui vous aide à identifier l’endroit où les certificats seront utilisés et à les gérer.
  5. Sélectionnez Save.
  6. Dans la page Web services, votre nouveau service web devrait maintenant apparaître dans la liste.
  7. Sélectionnez Generate Certificate pour votre nouveau service web.
  8. Sélectionnez le lien Show Options pour afficher un script PowerShell permettant de créer la clé nécessaire. Vous pouvez exécuter ce script sur n’importe quel ordinateur, puis exporter le certificat vers d’autres ordinateurs.
  9. Dans la fenêtre de console, supprimez les éventuels sauts de ligne dus au retour automatique, puis copiez la chaîne de clé obtenue dans la zone de texte située sous Download the CSP Certificate.
  10. Sélectionnez Download.
  11. Suivez les instructions de la section Binding the Certificate.
  12. Assurez-vous qu’une fois le certificat importé, la clé privée lui est bien associée (comme l’indique la petite icône de clé dans le coin supérieur gauche).
La spécification d’une chaîne de certificats SSL pour la connexion au point de terminaison n’est requise que lors de l’utilisation d’un certificat auto-signé. Les certificats SSL publics émis par des autorités de certification connues sont valides sans configuration.
Les certificats auto-signés ne peuvent être utilisés que dans des scénarios de développement et sont interdits pour les services de production.

​
Configuration d’un certificat de partenaire commercial

Si votre titre utilise l’un de vos services web pour effectuer des appels aux services XBOX, directement ou pour le compte d’utilisateurs individuels, vous avez besoin d’un certificat de partenaire commercial.

​
Génération d’un certificat de partenaire commercial

Suivez les étapes ci-dessous après avoir créé un service web.
  1. Dans la page Web Services, recherchez le service web auquel vous souhaitez associer un certificat de partenaire commercial.
  2. Sélectionnez le lien Generate Certificate correspondant au service web choisi.
  3. Sélectionnez Show Options à côté de Generating a New Certificate. Les commandes à exécuter depuis PowerShell avec des privilèges d’administrateur s’affichent.
  4. L’exécution de toutes les commandes, l’une après l’autre, devrait produire un blob encodé en Base64. Il s’agit de la clé publique. Copiez la clé publique depuis PowerShell, puis collez-la dans l’espace réservé au blob du fournisseur de services de configuration (CSP).
  5. Sélectionnez Download, puis suivez les instructions de la page pour Binding the certificates.
    1. Utilisez le même ordinateur que celui qui a servi à générer la clé publique.
    2. Exécutez cette commande dans PowerShell : mmc.exe
    3. Sélectionnez Fichier, puis Ajouter/Supprimer un composant logiciel enfichable.
    4. Sélectionnez Certificats, puis Ajouter. Veillez à sélectionner Compte d’ordinateur pour le composant logiciel enfichable Certificats. Sélectionnez Terminer, puis OK.
    5. Ouvrez le magasin Personnel\Certificats.
    6. Cliquez avec le bouton droit sur Certificats, puis sélectionnez Toutes les tâches. Sélectionnez Importer.
    7. Sélectionnez le certificat que vous avez téléchargé depuis Partner Center.
    8. Une fois le certificat importé, cliquez dessus avec le bouton droit dans l’interface. Sélectionnez Toutes les tâches, puis Exporter.
    9. Suivez l’Assistant Exportation. Veillez à choisir d’exporter la clé privée avec le certificat.
    10. Terminez l’Assistant Exportation.
Dernière modification le 8 octobre 2026