> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tratamento dos privilégios de usuário dos serviços do XBOX no lado do servidor

> Aplique os privilégios dos serviços do XBOX no seu servidor decodificando os tokens XSTS das terceiras partes confiáveis e lendo as declarações de privilégio de cada identidade de usuário.

Use este tópico para configurar seus [serviços de logon único (SSO)](https://learn.microsoft.com/azure/active-directory/manage-apps/what-is-single-sign-on) (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](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-title-service-authentication).

## 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](https://aka.ms/gdkdl) é um bom recurso com exemplos de como tratar tokens XSTS e recuperar as declarações incluídas.

<Note>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.</Note>

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.

```json theme={null}
...
{ "enc":"A128CBC+HS256", ... }.
{ "typ":"JWT", ... }.
{
"aud":"rp://your_relying_party.com/",
"iss":"xsts.auth.xboxLive.com", ...
"cnf":"
{...}",
"xdi":"
{...}",
"xti":"
{...}",
"xui":"
[
{
"xid":"2533274991020393",
"gtg":"SampleGamertag1",
"agg":"Adult",
...,
"prv":"211 212 220 226 227 228 229 230 231 234 237 240 243 244 245 246 247 248 249 251 252 255"
},
{
"xid":"1234574991020397",
"gtg":"SampleGamertag2",
"agg":"Adult",
...,
"prv":"211 212 220 226 227 228 229 230 231 234 237 240 243 244 246 251 252 255"
}
]"
}
...
```

## Confira também

[Visão geral dos privilégios de usuário dos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview)
[Uso dos privilégios de usuário dos serviços do XBOX no lado do cliente](/pt-BR/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client)


## Related topics

- [Privilégios de usuário dos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/identity/privileges/concepts/live-privileges-concepts-nav.md)
- [Uso dos privilégios de usuário dos serviços do XBOX no lado do cliente](/pt-BR/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)
- [Visão geral dos privilégios de usuário dos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview.md)
- [Autenticação dos serviços do XBOX para serviços de título](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-title-service-authentication.md)
- [Declarações de tokens de segurança dos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims.md)