Armazenamento PlayFab

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

• cadastro de usuários
• autenticação via endereço de e-mail e senha de usuário
• autenticação via Twitch
• redefinição de senha de usuário
• bloqueio de usuários

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

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.

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.

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.

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.

Continuar lendo