Pular para o conteúdo principal
Use este tópico para configurar seus serviços de logon único (SSO) (também conhecidos como terceiras partes confiáveis) para se integrarem aos privilégios dos serviços do XBOX.

Pré-requisitos

Para aplicar o controle de acesso baseado em privilégios ao seu serviço, você precisa ter um serviço configurado para SSO com os serviços do XBOX. Isso permite que o XBOX Secure Token Service (XSTS) emita tokens criptografados com uma chave pública que você fornece durante a configuração. Isso é chamado de configurar sua terceira parte confiável. Para obter mais informações, consulte Autenticação dos serviços do XBOX para serviços de título.

Implementando o controle de acesso baseado em privilégios em serviços de parceiros

O aplicativo cliente precisa enviar o token XSTS ao serviço do parceiro usando o cabeçalho “authorization” da requisição HTTP. Depois que o token for descriptografado pelo serviço do parceiro e a assinatura do token for verificada, a declaração de privilégio precisará ser extraída e verificada em relação ao privilégio esperado para o serviço. O exemplo Game Server é um bom recurso com exemplos de como tratar tokens XSTS e recuperar as declarações incluídas.
Os tokens dos serviços do XBOX podem conter várias identidades de usuário. Cada identidade de usuário no token tem uma declaração de privilégio.
Por exemplo, você pode usar o código de um serviço de matchmaking de parceiro para determinar se cada usuário em uma requisição está autorizado a ingressar em sessões multiplayer.

Formato do token para privilégios

Os privilégios são transportados na declaração de usuário e privilégios de cada identidade de usuário de um token. A declaração de privilégio contém um conjunto de inteiros delimitados por espaços. Cada inteiro representa um privilégio específico. Se um valor estiver no conjunto, isso significa que o usuário tem o privilégio no momento e está autorizado a acessar o recurso correspondente. O código a seguir é um exemplo de um token web JSON totalmente descriptografado que contém a declaração de privilégio.

Confira também

Visão geral dos privilégios de usuário dos serviços do XBOX Uso dos privilégios de usuário dos serviços do XBOX no lado do cliente
Última modificação em 8 de outubro de 2026