Pular para o conteúdo principal
Use este tópico para recuperar os privilégios dos serviços do XBOX de um usuário e saber como os privilégios podem afetar a forma como um usuário interage com seu título. Os privilégios controlam quais recursos dos serviços do XBOX um usuário pode acessar em um determinado momento. Um título precisa verificar alguns privilégios antes de permitir que um usuário conclua uma ação. Os aplicativos e os serviços de logon único (SSO) usam privilégios. Um serviço e um aplicativo podem usar os privilégios dos serviços do XBOX para controlar o acesso aos recursos do serviço e personalizar as experiências do usuário no dispositivo cliente.

Os privilégios se baseiam em vários fatores

Os privilégios efetivos de um usuário dos serviços do XBOX se baseiam nos fatores a seguir.
  • Os direitos de assinatura desse usuário
  • O tipo de dispositivo usado para acessar os serviços do XBOX
  • O aplicativo em execução no momento
  • Os controles parentais aplicados à conta desse usuário
  • As informações (como suspensões dos serviços do XBOX) dos moderadores de segurança online e aplicação de medidas dos serviços do XBOX
O controle de acesso baseado em privilégios é aplicado no momento do acesso a qualquer serviço online. Os privilégios fazem com que os aplicativos cliente mostrem a interface ao usuário. Essa interface explica o estado do usuário e fornece ações que ele pode executar para obter os privilégios necessários. Para títulos dos serviços do XBOX, a conta de cada usuário autenticado tem privilégios associados. Alguns desses privilégios são para recursos controlados pelo sistema, enquanto outros estão associados a jogos específicos ou a assinaturas de extensão. Esses privilégios abrangem vários cenários comuns, de multiplayer a streaming de vídeo. Os aplicativos cliente e os serviços usam essas informações para tomar decisões de controle de acesso e personalização.

Os privilégios são calculados durante a autenticação

Os serviços do XBOX calculam e emitem os privilégios efetivos de um usuário quando ele entra e é autorizado nos serviços do XBOX. Os privilégios de um usuário são transportados no token recebido no momento da autenticação. Os privilégios são emitidos em uma declaração do token.

Informações de privilégios nos serviços do XBOX

Um usuário precisa acessar os serviços do XBOX para que seu aplicativo cliente obtenha as informações de privilégio desse usuário, conforme mostrado no diagrama a seguir. Diagrama do fluxo de privilégios: o aplicativo cliente se autentica com o XSTS, que emite os privilégios, e depois chama os serviços do XBOX ou um serviço de parceiro, que os aplicam

Fluxo das informações de privilégio de um usuário

  1. O cliente dos serviços do XBOX (em nome de um título ou aplicativo) solicita um token ao XBOX Security Token Service (XSTS).
  2. O XSTS retorna um token para a terceira parte confiável solicitada. Em seguida, o XSTS calcula os privilégios de todos os usuários da requisição e emite para eles uma declaração do token. As requisições do aplicativo cliente incluem as ações automatizadas a seguir.
    • O aplicativo chama os serviços do XBOX diretamente e inclui o token no cabeçalho de autorização da requisição.
      • Os serviços do XBOX concedem acesso ao recurso solicitado (como XPRIVILEGE_MULTIPLAYER_SESSIONS) com base nos privilégios do token.
    • Como alternativa, o aplicativo chama um serviço de terceira parte confiável configurado para SSO.
      • O serviço inclui o token no cabeçalho de autorização da requisição. Se o serviço de SSO do parceiro fornecer uma implementação de um recurso dos serviços do XBOX (por exemplo, conteúdo baixável criado por usuários, como XPRIVILEGE_USER_CREATED_CONTENT), o serviço do parceiro usará os privilégios do token para conceder acesso ao recurso solicitado.
      • Para descriptografar e desserializar os tokens dos serviços do XBOX, o serviço do parceiro precisa estar configurado para SSO.
      • Para obter mais informações sobre essa configuração, consulte Autenticação dos serviços do XBOX para serviços de título.
    O cliente pode usar as APIs da plataforma XBOX para personalizar a experiência do usuário e conduzir a resolução (como upsell ou substituição parental) antes de enviar requisições aos serviços do XBOX.
  3. Os serviços de parceiros podem fazer requisições aos serviços do XBOX em nome dos usuários usando um token de autorização delegada.
    • Se a requisição for para um recurso que exige um privilégio específico (como XPRIVILEGE_COMMUNICATIONS), o serviço do parceiro precisará obter um token de autorização delegada para os serviços do XBOX em nome do usuário e incluí-lo no cabeçalho de autorização da requisição.
    • Os serviços do XBOX concedem acesso ao recurso solicitado com base nos privilégios do usuário.

Privilégios na identidade do usuário

Os privilégios são uma declaração na identidade do usuário, e essa declaração contém o conjunto dos privilégios efetivos atuais do usuário, conforme mostrado na declaração de cabeçalho a seguir. Se um privilégio estiver no conjunto, o usuário está autorizado no momento a acessar o recurso correspondente. Se o privilégio não estiver no conjunto, o usuário não está autorizado no momento. Os privilégios efetivos de um usuário são dinâmicos e dependem dos cenários a seguir.
  • Quaisquer direitos de assinatura expirados
  • Aplicativos em execução no momento
  • Todas as contas conectadas no mesmo dispositivo cliente
  • Status do dispositivo cliente
  • Controles parentais aplicados à conta desse usuário
  • As informações (como suspensões dos serviços do XBOX) dos moderadores de segurança online e aplicação de medidas
Quando um usuário está autorizado a usar um recurso em um determinado momento, isso não garante que ele estará autorizado a acessar o recurso mais tarde. Os privilégios emitidos para o usuário são válidos durante o tempo de vida do token emitido quando o usuário é autenticado.

Privilégios e configurações de privacidade

Os privilégios determinam se um usuário está autorizado a acessar um recurso dos serviços do XBOX ou de um serviço de terceiros. Essa é uma verificação geral. Por exemplo, os privilégios determinam se um usuário pode usar qualquer comunicação por chat de voz, e não apenas se dois usuários podem conversar entre si. Para os recursos sociais dos serviços do XBOX, os aplicativos e serviços usam o serviço de privacidade para determinar com quem uma ação pode ser executada, com base nas configurações de privacidade de todos os usuários envolvidos na ação. Por exemplo, ele determina se o usuário pode usar o chat de voz com um destino, com base nas configurações do destino (como uma lista de silenciados ou uma lista de evitados). Para obter mais informações sobre a integração com o serviço de privacidade, consulte Privacidade e permissões.

Privilégios e restrições de conteúdo

Os privilégios não fornecem informações sobre a classificação de conteúdo. Para obter mais informações sobre os XBOX Requirements (XRs), consulte XBOX Requirements.

Confira também

XBOX Requirements
XR-045: XBOX network and Account Privileges
XR-018: User Generated Content
Autenticação dos serviços do XBOX para serviços de título Exemplo de Game Services
Última modificação em 30 de outubro de 2026