Autenticação silenciosa

Como funciona

A autenticação silenciosa permite que você autentique automaticamente os usuários em seu jogo por meio de uma plataforma de publicação. As plataformas Steam, Xbox Live e Epic Games são atualmente suportadas. Se você precisar de suporte para a Stone ou plataformas, entre em contato com seu Gerente de Sucesso do Cliente ou Mail.ru envie um e-mail para csm@xsolla.com.

Fluxo de interação:

1. o usuário inicia seu jogo.
2. O jogo recebe dados de autorização da plataforma por meio do SDK da plataforma.
3. Seu jogo gera e envia uma solicitação para o servidor Xsolla Login para obter um JWT.
4. O servidor Xsolla Login autentica o usuário e envia o JWT.

Quem pode usar

Parceiros que já integraram o Login e têm uma conta na plataforma de publicação.

Como obtê-lo

1. Configure a autenticação silenciosa na Conta de Distribuidor.
2. Conclua as etapas de integração na lateral do seu aplicativo.

Configuração da autenticação silenciosa

No produto Login, são implementadas duas abordagens para habilitar a autenticação silenciosa:

• configurando a opção de login clássica (veja as instruções abaixo);
• criando um projeto Login sombra (consulte Como configurar um projeto Login sombra).

1. Abra seu projeto na Conta de Distribuidor e vá para a seção Login.
2. Clique em Configure no painel de uma opção de login clássica.
3. Vá para o bloco Authentication e selecione a seção Plataformas de distribuição.

4. Para conectar uma plataforma de distribuição, clique no ícone ⚙ ao lado do nome e selecione Settings.

5. Na janela modal, especifique os parâmetros para a plataforma selecionada:
   • Steam:
     • Application ID — AppID da sua conta na plataforma;
     • Application secret key — Chave Web API.
   • Epic Games:
     • Application ID — ID do cliente do seu jogo na plataforma;
     • Application secret key — Chave secreta do cliente do seu jogo na plataforma.
   • Xbox Live:
     • Application ID — ID do aplicativo/ID do cliente do seu jogo na plataforma;
     • Application secret key — Chave secreta do aplicativo gerada ao cadastrar seu jogo na plataforma.

6. Clique em Connect.
7. Repita as etapas 4 a 6 para outras plataformas de distribuição, se necessário.

Integração do lado do aplicativo

Use as instruções para a plataforma de publicação que hospeda seu aplicativo:

• Steam
• Xbox Live
• Epic Games

Steam

1. Obtenha o tíquete de sessão.
2. Passe-o para a solicitação de autenticação silenciosa (JWT ou OAuth 2.0) como um parâmetro session_ticket.

Xbox Live

1. Forme um tíquete de sessão (parâmetro session_ticket) com base nos dados da plataforma após a autenticação do usuário. O parâmetro é formado com base no modelo <xid>-<uhs>;<XSTSToken> onde:
   • <xid> — Xbox User ID;
   • <uhs> — user hash;
   • <XSTSToken> — Xbox Secure Token Service.
2. Passe o parâmetro session_ticket para a solicitação de autenticação silenciosa (JWT ou OAuth 2.0).

Epic Games

1. Obtenha o código de autorização exchangecode da plataforma, que é gerado após a autenticação do usuário.
2. Passe o exchangecode recebido para a solicitação de autenticação silenciosa (JWT ou OAuth 2.0) como o parâmetro session_ticket.