> ## 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.

# Autenticação dos serviços do XBOX

> Informações básicas sobre a autenticação de chamadas ao XBOX Live usando tokens XSTS e assinaturas, abrangendo o uso da XSAPI no lado do cliente e os fluxos RESTful de serviço para serviço.

Este tópico fornece informações básicas sobre a autenticação de chamadas aos serviços do XBOX.

Para expor os serviços do XBOX em um ritmo mais rápido e permitir que os títulos usem esses serviços sem depender de versões de recuperação específicas, os serviços do XBOX são lançados como pontos de extremidade HTTPS RESTful. A autenticação e a autorização desses serviços exigem um token e uma assinatura válidos do XBOX Secure Token Service (XSTS). Para obter mais informações sobre os tokens XSTS, consulte [Tokens de segurança dos serviços do XBOX (tokens XSTS)](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-security-tokens).

Os serviços do XBOX são chamados por dois caminhos possíveis.

1. *Cliente dos serviços do XBOX*
   A partir de um cliente autenticado nos serviços do XBOX. Essas chamadas são sempre feitas no contexto de um usuário.
2. *Serviço para serviço*
   A partir de um serviço web de título personalizado, por meio de chamadas de serviço para serviço aos serviços do XBOX. Essas chamadas são feitas em nome de um usuário ou diretamente como um serviço.
   Para obter mais informações sobre chamadas a partir de serviços de título, consulte [Chamadas de serviços de título aos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/s2s-calls/live-title-service-calls-xbox-live).

## Chamadas do cliente aos serviços do XBOX

Para todas as chamadas aos serviços do XBOX usando o Microsoft Game Development Kit (GDK), recomendamos fortemente que os títulos usem as XBOX Service APIs (XSAPI) incluídas nas versões do Microsoft Game Development Kit (GDK). Essas APIs tratam as requisições HTTP e retornam os dados de serviço disponíveis diretamente ao título, por meio de objetos. Elas também implementam o comportamento de conexão e cache que recomendamos para os serviços do XBOX e para a autenticação. Para obter mais informações sobre essas APIs, consulte a documentação da XBOX Service API na [referência da XSAPI](/pt-BR/reference/live/xsapi-c/atoc-xsapi-c).

As seções a seguir são fornecidas apenas para fins de completude e para uma compreensão mais profunda da autenticação dos serviços do XBOX.

### Configuração inicial

Os serviços do XBOX são pré-configurados de forma transparente para todos os títulos. Nenhuma configuração adicional de ponto de extremidade é necessária. Isso se aplica a todos os subdomínios `*.xboxlive.com`.

### Fluxo de recuperação do token e de conexão

Para usar qualquer ponto de extremidade dos serviços do XBOX, um token de autenticação XSTS e uma assinatura da mensagem precisam estar presentes. Sem essas informações, a comunicação com o serviço é rejeitada.

O token XSTS e a identificação do usuário (hash do usuário) precisam ser incluídos no cabeçalho `Authentication` da requisição. A assinatura da mensagem precisa ser especificada no cabeçalho `Signature` da requisição. Para obter informações detalhadas sobre a estrutura desses cabeçalhos, consulte [Tokens de segurança dos serviços do XBOX (tokens XSTS)](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-security-tokens).

### Obtendo um token XSTS

O token XSTS e os dados do cabeçalho de assinatura são obtidos por meio da API [XUserGetTokenAndSignatureUtf16Async](/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16async). Ela fornece os cabeçalhos necessários para as requisições de serviço.

Em seguida, o título solicita o token XSTS para um ponto de extremidade dos serviços do XBOX usando a API `XUserGetTokenAndSignatureUtf16Async` por meio do fluxo a seguir.

1. Chame `XUserGetTokenAndSignatureUtf16Async` para o usuário atual. Inclua na chamada à API a URL dos serviços do XBOX e os cabeçalhos ou o corpo da mensagem necessários.
   Essa chamada à API recupera o token XSTS para o ponto de extremidade dos serviços do XBOX. A chamada gera uma assinatura para a mensagem e os cabeçalhos predefinidos.
2. Recupere o token XSTS e a assinatura por meio de `XUserGetTokenAndSignatureUtf16Result` a partir do resultado assíncrono.
   `XUserGetTokenAndSignatureUtf16Result` retorna um token XSTS criptografado. Os títulos devem tratar o token retornado como dados opacos. Os dados do token não podem ser gravados em disco nem armazenados em cache no espaço do título além da chamada de serviço subsequente.
3. Use o Microsoft Windows HTTP Services (WinHTTP), o xCurl e o token XSTS conforme apropriado no cabeçalho Authorization da requisição HTTPS.

### Expiração e atualização do token

Um token XSTS é válido apenas por um período específico. O tempo de expiração padrão de um token XSTS é de quatro horas. Cada token contém um carimbo de data/hora que é verificado por todos os serviços do XBOX.

A API [XUserGetTokenAndSignatureUtf16Async](/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureasync) precisa ser usada a cada nova requisição de autenticação ou entrada. `XUserGetTokenAndSignatureUtf16Async` trata a expiração e o cache dos tokens. A API garante que o título sempre receba um token válido. Caso contrário, um título não pode armazenar tokens em cache.

Quando um token expirado ou inválido é apresentado a um ponto de extremidade dos serviços do XBOX, um erro HTTP/401 é retornado.


## Related topics

- [Autenticação de serviços](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/index.md)
- [Autenticação](/pt-BR/services/xbox-services/fundamentals/identity/auth/index.md)
- [Autenticação dos serviços do XBOX (conteúdo)](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-service-authentication-nav.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)
- [Autenticação e S2S](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/live-s2s-auth-calls-nav.md)