SDKs para Android / Autenticação via ID personalizado
  Voltar aos Documentos

SDKs para Android

Autenticação via ID personalizado

Você pode autenticar usuários no lado Xsolla por meio de um ID personalizado (um ID de usuário gerado no seu servidor).

Esta opção de autenticação permite:

Para autenticar um usuário por meio de um ID personalizado, você precisará implementar a chamada de API Auth by custom ID no back-end do seu aplicativo. A chamada retorna um JSON Web Token (JWT) do usuário, que você pode usar como um token de autorização nos métodos SDK para fazer pagamentos e gerenciar o inventário.

Observação
Uma nova conta é criada automaticamente no lado Xsolla quando um usuário conclui a autenticação com seu ID pela primeira vez.
Para encerrar uma sessão de usuário ativa, use o método de SDK oauthLogout.
Documentação de referência do SDK
Saiba mais sobre os métodos SDK e seus parâmetros.

Guias

Saiba mais sobre configurações avançadas em nossos guias.

Como usar seu próprio sistema de autorização

Aviso
Use esse tutorial ao trabalhar com as seguintes bibliotecas:
  • Store
  • Payments
  • Inventário

Você pode integrar o SDK com seu próprio sistema de autorização. Para fazer isso, implemente a identificação do usuário por ID personalizado (ID do usuário gerado no seu servidor) para abrir uma loja no jogo, fazer pagamentos e gerenciar o inventário.

O fluxo de interação com os servidores Xsolla ao usar seu próprio sistema de autorização:

  1. Seu cliente envia uma solicitação de autenticação para seu servidor.
  2. Seu servidor autoriza o usuário e envia uma solicitação ao servidor Xsolla para receber o JSON Web Token (JWT) do usuário, passando o ID personalizado.
  3. O servidor Xsolla retorna o JWT do usuário.
  4. Seu servidor passa o JWT do usuário para o cliente.
  5. Os métodos SDK usam o JWT do usuário recebido em vez do token de autorização para abrir uma loja no jogo, fazer pagamentos e gerenciar o inventário.

Para usar seu próprio sistema de autorização com produtos Xsolla:

  1. Configure o cliente OAuth 2.0 do servidor na sua Conta de Distribuidor.
  2. Implemente a obtenção do JWT do servidor.
  3. Implemente a obtenção do JWT do usuário.
  4. Implemente a lógica de trabalho com a loja do jogo, compras e inventário usando o JWT do usuário.

Observação
Se você usar o sistema de autorização PlayFab ou Firebase, obtenha o JWT do usuário usando as extensões Xsolla prontas para uso BaaS.

Configure o cliente OAuth 2.0 do servidor

  1. Abra seu projeto na Conta de Distribuidor e vá para a seção Login.
  2. Clique em Configure no painel de um projeto Login.
  3. Vá para o bloco Security e selecione a seção OAuth 2.0.
  4. Clique em Add OAuth 2.0.
  5. Especifique os URLs de redirecionamento OAuth 2.0.
  6. Marque a caixa Server (server-to-server connection).
  7. Clique em Connect.
  8. Copie e salve o ID do cliente e chave secreta.

Obter JWT do servidor

No back-end do seu aplicativo, implemente um método para obter o JWT do servidor usando a chamada de API Generate JWT. A solicitação deve conter os seguintes parâmetros:

Observação
A vida útil do JWT do servidor é de 59 minutos.

Obter JWT do usuário

No back-end do seu aplicativo, implemente um método para obter o JWT do usuário usando a chamada de API Auth by custom ID. A solicitação deve conter o cabeçalho X-Server-Authorization: <server_JWT>, onde <server_JWT> é o JWT do servidor obtido na etapa anterior.

Observação
A vida útil do JWT do usuário é de 24 horas. Para alterá-lo, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para integration@xsolla.com.

Utilizar o JWT do usuário

Passe o JWT do usuário para o método XStore.init e use os métodos SDK para abrir a loja do jogo, fazer um pagamento e gerenciar o inventário.

Implemente a lógica de receber um novo JWT de usuário após sua validade. É recomendável que você obtenha um novo token no modo em segundo plano, para que o usuário não precise fazer login no aplicativo novamente.

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

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!