Настройка аутентификации через диплинк

Диплинки позволяют пользователю авторизоваться в Web Shop через игру в один клик, вместо того чтобы проходить процесс авторизации через ID пользователя или через Xsolla Login.

Если у пользователя на мобильном устройстве установлена игра, с помощью диплинка он будет перенаправлен в игру для получения авторизационного токена.

Сценарий пользователя

В мобильном приложении

1. Неавторизованный пользователь в Web Shop нажимает кнопку входа или кнопку покупки. Открывается модальное окно ввода ID пользователя или входа через мобильную игру.

2. Пользователь нажимает кнопку входа через игру.
3. Пользователь перенаправляется в игру, после чего автоматически перенаправляется в Web Shop как авторизованный пользователь.

В настольной версии

1. Неавторизованный пользователь в Web Shop нажимает кнопку входа или кнопку покупки. Открывается модальное окно ввода ID пользователя или входа в мобильную версию игры с помощью QR-кода.

2. Пользователь сканирует QR-код с помощью мобильного устройства, после чего на мобильном устройстве пользователя открывается Web Shop.
3. На мобильном устройстве пользователя открывается игра.
4. Пользователь автоматически перенаправляется в Web Shop на мобильном устройстве как авторизованный пользователь.

Сценарий взаимодействия сервисов

Как настроить

На стороне игры

1. В настройках вашей игры зарегистрируйте URL-схему для открытия игры через диплинк:
   • в приложениях под Android — в файле AndroidManifest.xml;
   • в приложениях под iOS — в файле Info.plist.

• gamename — название вашей игры, которая должна открываться на мобильном устройстве для авторизации пользователя;
• authorize — пример названия действия, которое должно быть выполнено после открытия игры gamename. Используйте название действия, которое соответствует действиям в операционной системе вашего приложения.

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

Пример регистрации URL-схемы в приложениях под 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. Реализуйте генерацию авторизационного токена в формате JWT, используя ID пользователя из игры.

Пример вызова метода API генерации токена пользователя с использованием библиотеки 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"
 }
}'

Вы получите ответ вида {token=“JWT_TOKEN”}.

3. Добавьте всплывающее окно с уведомлением об успешной авторизации (опционально).
4. Реализуйте открытие Web Shop в браузере, используя полученный токен пользователя.

Пример создания URL-адреса для открытия Web Shop в браузере для авторизованного пользователя:

• https:​//example.com/?token={token}, если вы используете кастомный домен.
• https:​//example.xsollasitebuilder.com/?token={token}, если вы используете домен Xsolla.

На стороне Конструктора сайтов

1. Откройте проект в Личном кабинете.
2. В боковом меню нажмите Конструктор сайтов.
3. Нажмите Настроить в карточке вашего сайта Web Shop с аутентификацией через ID пользователя.
4. Перейдите к блоку Настройки аутентификации и выберите раздел ID пользователя.
5. Установите переключатель Авторизация по диплинку в положение Вкл.

6. В поле URL диплинка укажите ссылку для авторизации пользователя.

7. Если вы используете блок Быстрый вход на сайте:
   1. Перейдите к блоку Быстрый вход.
   2. В секции Настройки блока установите переключатель QR-код в положение Вкл.

8. Для проверки авторизации нажмите Просмотр.
9. Для публикации сайта нажмите Опубликовать.