SDK para Unreal Engine / Autenticação silenciosa via plataforma de distribuição
  Voltar aos Documentos

SDK para Unreal Engine

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.

Para implementar a autenticação silenciosa por meio da plataforma de distribuição:

  1. Configure o aplicativo na conta de desenvolvedor da plataforma.
  2. Configure a autenticação silenciosa na Conta de Distribuidor.
  3. 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:

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.
Para habilitar a autenticação silenciosa na opção de login clássica:
  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.
  1. Para conectar uma plataforma de distribuição, clique no ícone ⚙ ao lado do nome e selecione Settings.
  1. Na janela modal, especifique os parâmetros para a plataforma selecionada:
    • Steam:
      • Application ID — AppID da sua conta na plataforma;
      • Application secret keyChave 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.
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.
  1. Clique em Connect.
  2. Repita as etapas 4 a 6 para outras plataformas de distribuição, se necessário.

Integre no lado do aplicativo

  1. Integre o SDK da plataforma de distribuição em seu aplicativo.
  2. 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.

  1. Implemente a lógica de autenticação de usuários usando os métodos SDK:
    • AuthenticateWithSessionTicket — troca o tíquete de sessão da plataforma de distribuição para JSON Web Token (JWT) e autentica o usuário.
    • LogoutUser — 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 os blueprints do projeto de demonstração 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!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.

Links úteis

Última atualização: 22 de Janeiro de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!