Configuração de autenticação via link profundo

Links profundos permitem que o usuário autentique-se na Web Shop pelo jogo em um clique, em vez de passar pelo processo de autenticação via ID de usuário ou Xsolla Login.

Se o jogo for instalado no dispositivo móvel do usuário, ele será redirecionado ao jogo via link profundo para obter um token de autorização.

Fluxo do usuário

No aplicativo móvel

1. Um usuário não autorizado na Web Shop clica no botão de login ou no botão de compra. Uma janela modal para inserir o ID do usuário ou fazer login pelo jogo móvel é aberta.

2. O usuário clica no botão de login pelo jogo.
3. O usuário é redirecionado para o jogo, onde ele é redirecionado automaticamente para a Web Shop como um usuário autorizado.

Na versão desktop

1. Um usuário não autorizado na Web Shop clica no botão de login ou no botão de compra. Uma janela modal para inserir o ID do usuário ou fazer login na versão móvel do jogo usando um código QR é aberta.

2. O usuário digitaliza o código QR usando o dispositivo móvel dele e então a Web Shop é aberta no dispositivo móvel.
3. A versão móvel do jogo abre no dispositivo móvel do usuário.
4. O usuário é automaticamente redirecionado para a Web Shop no dispositivo móvel como um usuário autorizado.

Fluxo de interação de serviços

Como configurar

No lado do jogo

1. Nas configurações do aplicativo móvel do seu jogo, cadastre um esquema URL para abrir o jogo via link profundo:
   • em aplicativos Android — no arquivo AndroidManifest.xml
   • em aplicativos iOS — no arquivo Info.plist

• gamename — o nome do seu jogo que deve ser aberto em um dispositivo móvel para a autenticação do usuário.
• authorize — um exemplo de um nome de ação que deve ser executada após a abertura do jogo. Use o nome da ação que corresponde às ações no sistema operacional do seu aplicativo.

<key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>gamename</string>
      </array>
    </dict>
  </array>

Exemplo de cadastro de um esquema de URL em aplicativos Android:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="gamename" android:host="authorize" />
</intent-filter>

2. Implemente a geração de um token de autorização no formato JWT usando o ID de usuário do jogo.

Exemplo de chamada do método API de geração de token do usuário usando curl:

curl --location 'https://sb-user-id-service.xsolla.com/api/v1/user-id' \
--header 'Content-Type: application/json' \
--data '{
 "loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
 "webhookUrl": "https://nowebhook.com",
 "settings": {
   "projectId": 123456,
   "merchantId": 123456
 },
 "user": {
   "id": "123",
   "name": "a-user-name"
 }
}'

Você obterá a resposta do tipo {token=“JWT_TOKEN”}.

3. Adicione uma janela pop-up com uma notificação de autorização bem-sucedida (opcional).
4. Implemente a abertura do Web Shop no navegador usando o token de usuário obtido.

Exemplo de criar um URL para abrir a Web Shop no navegador para um usuário autorizado:

• https:​//example.com/?token={token}, se você estiver usando um domínio personalizado.
• https:​//example.xsollasitebuilder.com/?token={token}, se você estiver usando um domínio Xsolla.

Dentro do Site Builder

1. Abra o projeto na Conta de Distribuidor.
2. No menu lateral, clique em Site Builder.
3. Clique em Configure no cartão do seu site Web Shop com autenticação via ID de Usuário.
4. Vá para Login Settings e selecione a seção User ID.
5. Defina a opção Deeplink authorization como On.

6. No campo Deeplink URL, insira o link para a autenticação do usuário.

7. Se você estiver usando o bloco Fast Login no site:
   1. Vá para o bloco Fast Login.
   2. Na seção Layout, defina a opção QR code como On.

8. Para conferir a autorização, clique em Preview.
9. Para publicar o site, clique em Publish.