> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuration des services web dans Partner Center > Créez et configurez des services web d'éditeur dans Partner Center pour l'authentification unique XBOX Live, la configuration des parties de confiance et l'accès aux appels de service à service. > [!NOTE] > > 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](https://partner.microsoft.com/dashboard/windows/overview). 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. \[!NOTE] 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**. ## Related topics - [Services web](https://docs.xbox.com/fr/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/web-services/live-web-services-nav.md) - [Vue d'ensemble de la configuration du portail](https://docs.xbox.com/fr/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md) - [Configuration des parties de confiance](https://docs.xbox.com/fr/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/relying-parties/live-relying-parties-nav.md) - [Configuration de services personnalisés](https://docs.xbox.com/fr/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/index.md) - [Configuration des stratégies d'accès dans Partner Center](https://docs.xbox.com/fr/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/access-policies/config/live-access-policies-udc.md)