Autenticação silenciosa via plataforma de distribuição
A autenticação silenciosa permite que os usuários façam login em seu aplicativo sem precisar inserir suas credenciais novamente. Com esse tipo de autenticação, o servidor Xsolla Login usa as credenciais que o usuário forneceu na plataforma de distribuição do aplicativo.
Observação
Atualmente, a autenticação silenciosa é suportada para as plataformas Steam, Xbox Live e Epic Games. Se você precisar de suporte para as plataformas Stone ou Mail.ru, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
- Configure o aplicativo na conta de desenvolvedor da plataforma.
- Configure a autenticação silenciosa na Conta de Distribuidor.
- Conclua as etapas de integração no lado do aplicativo.
Configurar 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).
Observação
O projeto Login sombra é necessário para criar contas multiplataforma que permitem aos usuários jogar em diferentes plataformas sob a mesma conta, sincronizar o inventário deles entre as plataformas, entre outros. Um projeto de Login sombra é criado para cada plataforma de distribuição que hospeda o jogo e, em seguida, é vinculado à conta principal do usuário. Consulte Conta multiplataforma para mais detalhes.Na opção de login clássica, você pode habilitar a autenticação silenciosa para várias plataformas de publicação de uma só vez, mas não é possível criar uma conta multiplataforma. Se um usuário fizer login em um jogo em uma plataforma e depois fizer o mesmo em outra, o produto Login considerará esses acessos como dois usuários diferentes.
- Abra seu projeto na Conta de Distribuidor e vá para a seção Login.
- Clique em Configure no painel de uma opção de login clássica.
- Vá para o bloco Authentication e selecione a seção Plataformas de distribuição.
- Para conectar uma plataforma de distribuição, clique no ícone ⚙ ao lado do nome e selecione Settings.
- 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.
- Steam:
Observação
Para a plataforma Xbox Live, não é necessário fornecer valores de configuração. Você pode conectar o Xbox Live com chaves de acesso de propriedade da Xsolla. Para fazer isso, clique no ícone ⚙ à direita do nome da plataforma e selecione Connect.
- Clique em Connect.
- Repita as etapas 4 a 6 para outras plataformas de distribuição, se necessário.
Integre no lado do aplicativo
- Integre o SDK da plataforma de distribuição em seu aplicativo.
- Implemente a lógica de obtenção do tíquete de sessão:
- Para o Steam, obtenha o tíquete de sessão.
- Para o Xbox Live, forme um tíquete de sessão 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>
— hash do usuário<XSTSToken>
— Xbox Secure Token Service
- Para a Epic Games, obtenha o código de autorização (
exchange code ) da plataforma, que é gerado após a autenticação do usuário e é usado como um tíquete de sessão.
- Implemente a lógica de autenticação de usuários usando os métodos SDK:
SilentAuth
— troca o tíquete de sessão da plataforma de distribuição para JSON Web Token (JWT) e autentica o usuário.OAuthLogout
— encerra a sessão de usuário ativa.
Documentação de referência do SDK
Saiba mais sobre os métodos SDK e seus parâmetros.
Observação
A autenticação silenciosa via Steam é implementada no projeto de demonstração. Você pode usar a classe
SteamAuth.cs
como exemplo. Se você usar o projeto de demonstração como a versão inicial do sistema de autenticação, você poderá configurar a autenticação silenciosa pelo Steam seguindo o guia Como configurar a autenticação nativa via Steam.Este artigo foi útil?
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Links úteis
Última atualização: 22 de Janeiro de 2024Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.