Passer au contenu principal
Utilisez cette rubrique pour récupérer les privilèges des services XBOX d’un utilisateur et découvrir comment les privilèges peuvent influer sur ses interactions avec votre titre. Les privilèges contrôlent les fonctionnalités des services XBOX auxquelles un utilisateur peut accéder à un moment donné. Un titre doit vérifier certains privilèges avant de permettre à un utilisateur d’effectuer une action. Les applications et les services d’authentification unique (SSO) utilisent des privilèges. Un service et une application peuvent utiliser les privilèges des services XBOX pour contrôler l’accès aux fonctionnalités du service et personnaliser l’expérience utilisateur sur l’appareil client.

Les privilèges reposent sur plusieurs facteurs

Les privilèges effectifs d’un utilisateur des services XBOX reposent sur les facteurs suivants.
  • Les droits d’abonnement de cet utilisateur
  • Le type d’appareil utilisé pour accéder aux services XBOX
  • L’application en cours d’exécution
  • Le contrôle parental appliqué au compte de cet utilisateur
  • Les informations (comme les suspensions des services XBOX) fournies par les modérateurs de la sécurité en ligne et de l’application des règles des services XBOX
Le contrôle d’accès basé sur les privilèges est appliqué au moment de l’accès à n’importe quel service en ligne. Les privilèges amènent les applications clientes à afficher l’interface utilisateur à l’utilisateur. Cette interface explique l’état de l’utilisateur et propose les actions qu’il peut effectuer pour obtenir les privilèges requis. Pour les titres des services XBOX, le compte de chaque utilisateur authentifié est associé à des privilèges. Certains de ces privilèges concernent des fonctionnalités contrôlées par le système, tandis que d’autres sont associés à des jeux spécifiques ou à des abonnements d’extension. Ces privilèges couvrent plusieurs scénarios courants, du multijoueur au streaming vidéo. Les applications clientes et les services utilisent ces informations pour prendre des décisions de contrôle d’accès et de personnalisation.

Les privilèges sont calculés lors de l’authentification

Les services XBOX calculent et émettent les privilèges effectifs d’un utilisateur lorsque celui-ci se connecte et est autorisé à accéder aux services XBOX. Les privilèges d’un utilisateur sont transportés dans le jeton reçu au moment de l’authentification. Les privilèges sont émis dans une revendication du jeton.

Informations sur les privilèges dans les services XBOX

Un utilisateur doit accéder aux services XBOX pour que votre application cliente puisse obtenir ses informations de privilèges, comme illustré dans la capture d’écran suivante. Capture d'écran de l'obtention des informations de privilèges d'un utilisateur

Flux des informations de privilèges d’un utilisateur

  1. Le client des services XBOX (pour le compte d’un titre ou d’une application) demande un jeton au XBOX Security Token Service (XSTS).
  2. XSTS renvoie un jeton pour la partie de confiance demandée. XSTS calcule ensuite les privilèges de tous les utilisateurs de la requête et les leur émet dans une revendication du jeton. Les requêtes de l’application cliente comprennent les actions automatisées suivantes.
    • L’application appelle directement les services XBOX et inclut le jeton dans l’en-tête d’autorisation de la requête.
      • Les services XBOX accordent l’accès à la fonctionnalité demandée (comme XPRIVILEGE_MULTIPLAYER_SESSIONS) en fonction des privilèges contenus dans le jeton.
    • L’application peut aussi appeler un service de partie de confiance configuré pour l’authentification unique.
      • Le service inclut le jeton dans l’en-tête d’autorisation de la requête. Si le service SSO partenaire fournit une implémentation d’une fonctionnalité des services XBOX (par exemple, du contenu téléchargeable créé par les utilisateurs, comme XPRIVILEGE_USER_CREATED_CONTENT), le service partenaire utilise les privilèges contenus dans le jeton pour accorder l’accès à la fonctionnalité demandée.
      • Pour déchiffrer et désérialiser les jetons des services XBOX, le service partenaire doit être configuré pour l’authentification unique.
      • Pour plus d’informations sur cette configuration, consultez Authentification des services XBOX pour les services de titre.
    [!NOTE] Le client peut utiliser les API de la plateforme XBOX pour personnaliser l’expérience utilisateur et piloter la résolution (comme la vente incitative ou la dérogation parentale) avant d’émettre des requêtes vers les services XBOX.
  3. Les services partenaires peuvent effectuer des requêtes auprès des services XBOX pour le compte des utilisateurs à l’aide d’un jeton d’autorisation délégué.
    • Si la requête concerne une fonctionnalité qui nécessite un privilège spécifique (comme XPRIVILEGE_COMMUNICATIONS), le service partenaire doit obtenir un jeton d’autorisation délégué pour les services XBOX pour le compte de l’utilisateur et l’inclure dans l’en-tête d’autorisation de la requête.
    • Les services XBOX accordent l’accès à la fonctionnalité demandée en fonction des privilèges de l’utilisateur.

Privilèges dans l’identité utilisateur

Les privilèges sont une revendication de l’identité utilisateur ; cette revendication contient l’ensemble des privilèges effectifs actuels de l’utilisateur, comme indiqué dans la revendication d’en-tête suivante. Si un privilège figure dans l’ensemble, l’utilisateur est actuellement autorisé à accéder à la fonctionnalité correspondante. Si le privilège ne figure pas dans l’ensemble, l’utilisateur n’est actuellement pas autorisé. Les privilèges effectifs d’un utilisateur sont dynamiques et dépendent des scénarios suivants.
  • Les droits d’abonnement expirés
  • Les applications en cours d’exécution
  • Tous les comptes connectés sur le même appareil client
  • L’état de l’appareil client
  • Le contrôle parental appliqué au compte de cet utilisateur
  • Les informations (comme les suspensions des services XBOX) fournies par les modérateurs de la sécurité en ligne et de l’application des règles
[!NOTE] Le fait qu’un utilisateur soit autorisé à accéder à une fonctionnalité à un moment donné ne garantit pas qu’il le sera ultérieurement. Les privilèges émis pour l’utilisateur sont valides pendant toute la durée de vie du jeton émis lors de son authentification.

Privilèges et paramètres de confidentialité

Les privilèges déterminent si un utilisateur est autorisé à accéder à une fonctionnalité des services XBOX ou d’un service tiers. Il s’agit d’une vérification grossière. Par exemple, les privilèges déterminent si un utilisateur peut utiliser une quelconque communication par chat vocal, et non simplement si deux utilisateurs peuvent discuter entre eux. Pour les fonctionnalités sociales des services XBOX, les applications et les services utilisent le service de confidentialité pour déterminer avec qui une action peut être effectuée, en fonction des paramètres de confidentialité de tous les utilisateurs concernés par l’action. Par exemple, il détermine si l’utilisateur peut utiliser le chat vocal avec une cible, en fonction des paramètres de cette cible (comme une liste Mute ou une liste Avoid). Pour plus d’informations sur l’intégration au service de confidentialité, consultez Confidentialité et autorisations.

Privilèges et restrictions de contenu

Les privilèges ne fournissent pas d’informations sur la classification du contenu. Pour plus d’informations sur les exigences XBOX (XR), consultez Stratégies et exigences XBOX.

Voir aussi

Stratégies et exigences XBOX
Authentification des services XBOX pour les services de titre Exemple Game Services
Dernière modification le 8 octobre 2026