Fluxo do usuário

1. O usuário acessa a Web Shop com a autenticação de ID de usuário configurada.
2. O usuário é autorizado na Web Shop de uma das seguintes maneiras:
   • O usuário insere seu ID no bloco Login Rápido e clica no botão de login.
   • O usuário clica no botão de compra do item selecionado ou no botão de login na barra superior:
     1. Uma janela modal para inserir o ID de usuário ou fazer login por uma rede social é aberta.
     2. O usuário insere seu ID e clica em Continue ou clica no ícone de redes sociais para escolher uma rede social e concluir a autenticação na respectiva página da rede social.

3. O sistema confere se um usuário já existe no jogo. Se um usuário com esse ID ou conta social existir no jogo, o usuário é autorizado na Web Shop. Caso contrário, uma mensagem de erro é exibida.

Como obtê-lo

1. Do lado do seu aplicativo, implemente a manipulação do webhook de validação do usuário.

Ao receber um webhook, o aplicativo deve fazer o seguinte:

• Procurar um usuário por seu ID passado no webhook.
• Dependendo do resultado, enviar um dos seguintes códigos de status:
  • Código HTTP 200 com uma resposta do webhook se um usuário for encontrado
  • Código HTTP 404 se o ID do usuário não for encontrado
• Enviar atributos de usuário para personalização.

2. Abra seu projeto na Conta de Distribuidor.
3. Na barra lateral, clique em Site Builder.
4. Clique em Open Site Builder.
5. Vá para o bloco Login Settings:

6. Selecione a opção ID do usuário.

7. Na lista suspensa, selecione Novo login.

8. Insira o URL para receber webhooks.

9. Configurar autorização via redes sociais já conectadas ao seu aplicativo (opcional):
   1. Abra seu projeto na Conta de Distribuidor e vá para a seção Login.
   2. Clique em Configurar na barra do site.
   3. Vá para o bloco Autenticação e selecione Login social.

1. 4. Para configurar uma rede social, vá para o cartão de rede social, clique no ícone ⚙ à direita do título e selecione Connect.

Fluxo do usuário

1. O usuário vai à Web Shop com a autenticação por Xsolla Login configurada.
2. O usuário clica no botão de compra do item selecionado, o botão de login na barra superior, ou o botão de login no bloco Login Rápido.
3. Uma janela modal é aberta com os métodos de autorização configurados no Xsolla Login.

4. O usuário prossegue à autorização e insere dados adicionais se necessário.
5. O sistema confere se um usuário já existe no jogo. Se um usuário existir no jogo, o usuário é autorizado na Web Shop. Caso contrário, uma mensagem de erro é exibida.

Como obtê-lo

1. No Builder do seu site, vá para o bloco Login settings.

2. Selecione a opção de autorização Xsolla Login.
3. Na lista suspensa, selecione New Login.

4. Vá para as configurações do projeto Login na janela modal ou clique em Set up authentication method no bloco Xsolla Login.

5. Conecte o armazenamento de dados do usuário.

Dependendo do método de armazenamento de dados do usuário, diferentes funcionalidades do produto estão disponíveis para você (consulte a Comparação de opções de armazenamento de dados do usuário).

Armazenamento Xsolla

Se você quiser que o produto Login processe toda a lógica de autenticação, conecte-se ao armazenamento Xsolla. Você terá configurações mais flexíveis disponíveis a você.

Quando você cria um projeto Login, o armazenamento Xsolla é conectado por padrão, sem nenhuma etapa adicional sendo necessária para configurá-lo. Se você alterou o tipo de armazenamento padrão e precisa se reconectar ao armazenamento Xsolla, siga essas etapas:

1. Vá para o bloco User database e selecione a seção Storage.
2. Selecione o Xsolla storage e clique em Save changes.

Armazenamento PlayFab

Se você quiser usar a funcionalidade do PlayFab para trabalhar com usuários, conecte-se ao armazenamento PlayFab. Esse armazenamento salva os seguintes dados do usuário:

• nome de usuário
• endereço de e-mail do usuário
• senha do usuário
• campos de um formulário de registro estendido se o formulário estiver configurado

O armazenamento do PlayFab dá acesso aos seguintes recursos:

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

Para conectar o armazenamento:

1. Vá para o bloco User database e selecione a seção Storage.
2. Selecione PlayFab.
3. No campo Title ID, insira o valor do mesmo campo da sua conta.
4. Clique em Save changes.

Armazenamento Firebase

Se você quiser usar a funcionalidade do Firebase para trabalhar com usuários, conecte-se ao armazenamento Firebase. Esse armazenamento salva os seguintes dados do usuário:

• nome de usuário
• endereço de e-mail do usuário
• senha do usuário
• campos de um formulário de registro estendido se o formulário estiver configurado

1. Vá para o bloco User database e selecione a seção Storage.
2. Selecione Firebase.
3. No campo API key, insira o valor do mesmo campo da sua conta Firebase.
4. Clique em Save changes.

Armazenamento personalizado

Se você usar seu próprio sistema de autorização e armazenar dados do usuário no lado do aplicativo, conecte-se ao armazenamento personalizado.

O armazenamento personalizado dá acesso aos seguintes recursos:

• cadastro de usuário
• autenticação por endereço de e-mail ou nome de usuário e senha autenticação
• autenticação sem senha por número telefônico
• autenticação via redes sociais
• redefinição de senha de usuário

1. Conecte o armazenamento personalizado.
2. Configure o processamento de solicitações do servidor Xsolla Login.

Conectar armazenamento personalizado

1. Vá para o bloco User database e selecione a seção Storage.
2. Selecione Custom storage.
3. Insira URLs para onde enviar as solicitações de API:
   • User verification URL
   • New user URL
   • Password reset URL
   • Passwordless login with phone URL
   • Social login URL
4. Clique em Save changes.
5. Para os URLs definidos, implemente uma API que responderá da seguinte maneira:
   • HTTP 200 / HTTP 204 para solicitações bem-sucedidas. Se necessário, um JSON contendo dados adicionais do usuário pode ser colocado no corpo da resposta. Os dados passados são gravados em um JWT (o parâmetro partner_data).
   • Outros códigos de status HTTP para solicitações malsucedidas.

Configure o processamento de solicitações do servidor Xsolla Login

As solicitações do servidor Xsolla Login são enviadas para os URLs que você especificou na Publisher Account, com o cabeçalho Authorization: Bearer <JWT>. O JWT é assinado com a chave secreta do seu projeto.

Para processar uma solicitação:

1. Valide um JWT recebido.
2. Se a validação for bem-sucedida, decodifice o JWT e verifique se ele inclui as declarações da tabela abaixo. Localize e use uma biblioteca para a decodificação.

{
  "exp": 1573635020,
  "iat": 1573634600,
  "iss": "https://login.xsolla.com",
  "request_type": "gateway_request",
  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000"
}