Login / Armazenamento PlayFab
  Voltar aos Documentos

Login

Armazenamento PlayFab

Se você usa o armazenamento do PlayFab, você tem acesso a:

Observação
Você pode usar os métodos PlayFab para enviar boletins informativos aos usuários, por exemplo, sobre promoções ou atualizações.

Fluxo de interação

Você pode usar o widget de Login ou seu aplicativo como um cliente. O fluxo de interação entre o cliente e o servidor Xsolla Login é o seguinte:

  1. O cliente envia solicitações para o servidor Xsolla Login. O formato de solicitações é descrito em pontos de extremidade JWT, OAuth 2.0 e Password.
  2. O servidor Xsolla Login envia solicitações para o PlayFab.
  3. O servidor Xsolla Login processa uma resposta do PlayFab e retorna resultados para o cliente.
  4. O cliente processa a resposta.

Cadastro de usuário no PlayFab

O cadastro de usuários segue esse fluxo. Você pode configurar o e-mail de confirmação de conta que os usuários recebem para concluir o cadastro.

Fluxo de cadastro de usuários

  1. O cliente envia a solicitação Register new user para o servidor Xsolla Login.
  2. O servidor Xsolla Login envia uma solicitação de cadastro.
  3. Os dados do usuário são gravados no banco de dados Xsolla.
  4. O servidor Xsolla Login envia uma solicitação ao PlayFab para alterar os dados do usuário.
  5. Se você configurou a confirmação da conta:
    • Quando você usa as chamadas da API Login para integrar a solução, o cadastro é considerado concluído.
    • Quando você usa o widget de Login para integrar a solução, o usuário é redirecionado a uma página com a seguinte mensagem: O e-mail de confirmação da conta foi enviado para {endereço de e-mail}.
    Se você não configurou a confirmação da conta, o usuário será conectado automaticamente após o cadastro.

Confirmação de conta de usuário no PlayFab

Para configurar o envio do e-mail de confirmação da conta, conclua as seguintes etapas:
  1. Siga as instruções para configurar seu projeto no PlayFab.
  2. Verifique se você concluiu as etapas Crie um modelo de e-mail e Crie uma regra para enviar um e-mail quando um e-mail de contato é atualizado no módulo Requirements.
  3. Entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
Observação
O usuário que se inscreveu no projeto que usa o PlayFab pode fazer login sem confirmar seu endereço de e-mail.

Autenticação via endereço de e-mail e senha do usuário

Há dois tipos de autenticação via endereço de e-mail e senha do usuário: autenticação baseada no padrão JWT e autenticação baseada no protocolo OAuth 2.0.

Observação
Se não houver dados do usuário no armazenamento Xsolla:
  • Os dados do usuário serão gravados lá.
  • O servidor Xsolla Login envia a solicitação para alterar dados no PlayFab.

Fluxo de autenticação baseado no padrão JWT

  1. O cliente envia a solicitação Auth by username and password para o servidor Xsolla Login.
  2. O servidor Xsolla Login envia a solicitação de autenticação para o PlayFab.
  3. O servidor Xsolla Login gera um JWT de usuário, enquanto:
    • O valor PlayFabId da resposta à solicitação do PlayFab é gravado na declaração external_account_id.
    • O valor do SessionTicket da resposta à solicitação do PlayFab é gravado na declaração session_ticket.
    • Os valores EntityToken da resposta à solicitação do PlayFab são gravados nas declarações entity_token, entity_id, entity_type.
  4. O usuário é redirecionado para login_url com um parâmetro de consulta token. O JWT do usuário é gravado no parâmetro token.

Fluxo de autenticação baseado no protocolo OAuth 2.0

  1. O cliente envia a solicitação Auth by username and password com o parâmetro redirect_uri para o servidor Xsolla Login.
  2. O servidor Xsolla Login envia a solicitação de autenticação para o PlayFab.
  3. O servidor Xsolla Login retorna login_url junto com code no parâmetro de consulta e o parâmetro redirect_uri passado.
  4. O usuário é redirecionado para redirect_uri com o parâmetro de consulta code.
  5. O cliente envia a solicitação Generate JWT para o servidor Xsolla Login para trocar o code recebido por um JWT do usuário.
  6. O servidor Xsolla Login gera um JWT de usuário, enquanto:
    • O valor PlayFabId da resposta à solicitação do PlayFab é gravado na declaraçãoexternal_account_id.
    • O valor de SessionTicket da resposta à solicitação do PlayFab é gravado na declaração session_ticket se você passou scope=playfab para a solicitação Auth by username and password.
    • Os valores EntityToken da resposta à solicitação do PlayFab são gravados nas declarações entity_token, entity_id, entity_type.

Autenticação via Twitch

Você deve configurar uma rede social no PlayFab para autenticar usuários via Twitch. Há dois tipos de autenticação via Twitch — autenticação baseada no padrão JWT e autenticação baseada no protocolo OAuth 2.0.

Observação
Se o registro do usuário no PlayFab estiver vinculado à conta do Twitch, ele será considerado uma única conta.

Fluxo de autenticação baseado no padrão JWT

  1. O cliente envia a solicitação Auth via social network para o servidor Xsolla Login.
  2. O servidor Xsolla Login envia a solicitação de autenticação para o PlayFab.
  3. Os dados do usuário são registrados no banco de dados Xsolla.
  4. O servidor Xsolla Login gera um JWT de usuário, enquanto:
    • O valor PlayFabId da resposta à solicitação do PlayFab é gravado na declaração external_account_id.
    • O valor do SessionTicket da resposta à solicitação do PlayFab é gravado na declaração session_ticket.
    • Os valores EntityToken da resposta à solicitação do PlayFab são gravados nas declarações entity_token, entity_id, entity_type.
  5. O usuário é redirecionado para login_url com um parâmetro de consulta token. O JWT do usuário é gravado no parâmetro token.

Fluxo de autenticação baseado no protocolo OAuth 2.0

  1. O cliente envia a solicitação Auth via social network com o parâmetro redirect_uri para o servidor Xsolla Login.
  2. O servidor Xsolla Login envia a solicitação de autenticação para o PlayFab.
  3. Os dados do usuário são registrados no banco de dados da Xsolla.
  4. O servidor Xsolla Login envia a solicitação para solicitar os dados no PlayFab.
  5. O usuário é redirecionado para redirect_uri com o parâmetro de consulta code.
  6. O cliente envia a solicitação Generate JWT para o servidor Xsolla Login para trocar o code recebido por um JWT do usuário.
  7. O servidor Xsolla Login gera um JWT de usuário, enquanto:
    • O valor PlayFabId da resposta à solicitação do PlayFab é gravado na declaraçãoexternal_account_id.
    • O valor de SessionTicket da resposta à solicitação do PlayFab é gravado na declaração session_ticket se você passou scope=playfab para a solicitação de autenticação do Twitch.
    • Os valores EntityToken da resposta à solicitação do PlayFab são gravados nas declarações entity_token, entity_id, entity_type.

Configure a autenticação Twitch

  1. Crie sua conta do Twitch e obtenha um Twitch Client ID.
  2. Vá para Conta de Distribuidor e abra your project > Login.
  3. Clique em Configure no painel do projeto Login necessário.
  4. Vá para o bloco Authentication e selecione a seção Social Login.
  5. Acesse o painel da rede social Twitch, clique no ícone ⚙ e selecione Settings.
  6. Insira seu Twitch Client ID no campo Application ID.
  7. Se necessário, altere outras configurações.
  8. Clique em Connect.
  9. Configure o Twitch na sua conta PlayFab.
  10. Se você integrou o produto Login através das chamadas de Login API:
    1. Obtenha um link para autenticação via Twitch. Para fazer isso, use a chamada de autenticação de rede social (JWT ou OAuth 2.0).
    2. Coloque o link recebido na interface do seu aplicativo.

Redefinição de senha do usuário

O fluxo de redefinição de senha do usuário é o seguinte:

  1. O cliente envia a solicitação Reset password para o servidor Xsolla Login.
  2. O servidor Xsolla Login envia a solicitação de redefinição de senha para o PlayFab.
  3. A senha atualizada é gravada no PlayFab.

Bloqueio de usuários

Você pode bloquear usuários por meio da Conta de Distribuidor. Os usuários bloqueados não podem fazer autenticações. O bloqueio será gravado e salvo apenas no lado Xsolla.

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.
Avalie esta página
Avalie esta página
Podemos melhorar alguma coisa?

Não quero responder

Obrigado pelo seu feedback!

Continuar lendo

Última atualização: 10 de Outubro de 2023

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!