Login / Автоматическая аутентификация
  На главную

Login

Автоматическая аутентификация

Как это работает

Автоматическая аутентификация позволяет авторизовать пользователя в игре через платформу публикации. В настоящий момент поддерживается интеграция с платформами Steam, Xbox Live и Epic Games. Если вам нужна поддержка платформы Stone или Mail.ru, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

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

  1. Пользователь запускает игру.
  2. Ваша игра посредством SDK платформы получает данные авторизации платформы.
  3. Ваша игра формирует и отправляет запрос на сервер Xsolla Login для получения JWT.
  4. Сервер Xsolla Login авторизует пользователя и выдает JWT.

Примечание
Если у вас подключен Xsolla Launcher, воспользуйтесь инструкцией для авторизации пользователя через платформы.
При автоматической аутентификации вы также можете собирать email-адреса пользователей как при аутентификации через социальные сети. Для настройки воспользуйтесь инструкцией Сбор email-адресов и номеров телефонов.

Для кого подходит

Для партнеров, у которых уже подключен продукт Login и есть аккаунт платформы публикации.

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

  1. Подключите автоматическую аутентификацию в Личном кабинете.
  2. Выполните шаги по интеграции на стороне вашего приложения.

Подключение автоматической аутентификации

В продукте Login реализованы два подхода к подключению автоматической аутентификации:

Примечание
Теневой вариант авторизации необходим для создания кросс-платформенных аккаунтов, которые дают пользователям возможность играть на разных платформах под одним аккаунтом, синхронизировать свой инвентарь на разных платформах и т. д. Теневой вариант авторизации создается для каждой платформы публикации, на которой размещена игра, а затем привязывается к единому аккаунту пользователя. Подробнее см. в разделе Кросс-платформенный аккаунт.

В классическом варианте авторизации можно подключить автоматическую аутентификацию сразу для нескольких платформ публикации, но создать кросс-платформенный аккаунт невозможно. Если пользователь войдет в игру сначала на одной платформе, а затем на другой, для продукта Login это будут два разных пользователя.
Чтобы подключить автоматическую аутентификацию в классическом варианте авторизации:
  1. Откройте проект в Личном кабинете и перейдите в раздел Login.
  2. Нажмите Настроить в панели классического варианта авторизации.
  3. Перейдите к блоку Аутентификация и выберите раздел Платформы публикации.
  1. Чтобы подключить платформу публикации, на которой размещена игра, нажмите значок ⚙ справа от имени платформы и выберите пункт Настройки.
  1. В модальном окне укажите параметры настройки для выбранной платформы:
    • Steam:
      • ID приложения — AppID вашего аккаунта на платформе;
      • Секретный ключ приложенияключ веб-API.
    • Epic Games:
      • ID приложения — Client ID клиента вашей игры на платформе;
      • Секретный ключ приложения — Secret key клиента вашей игры на платформе.
    • Xbox Live:
      • ID приложения — Application ID/Client ID вашей игры на платформе;
      • Секретный ключ приложения — Application Secret, сгенерированный при регистрации вашей игры на платформе.
Примечание
Для платформы Xbox Live необязательно указывать значения параметров настройки. Вы можете подключить Xbox Live с ключами доступа, принадлежащими Xsolla. Для этого нажмите значок ⚙ справа от имени платформы и выберите пункт Подключить.
  1. Нажмите Подключить.
  2. Если требуется, повторите шаги 4 – 6 для других платформ публикации.

Интеграция на стороне приложения

Воспользуйтесь инструкцией для платформы публикации, на которой размещено ваше приложение:

Steam

Сформируйте сессионный ключ (параметр session_ticket) на основе данных платформы после аутентификации пользователя:
  1. Получите билет сессии аутентификации.
  2. Передайте его в запрос на автоматическую аутентификацию (JWT или OAuth 2.0) как параметр session_ticket.

Xbox Live

  1. Сформируйте сессионный ключ (параметр session_ticket) на основе данных платформы после аутентификации пользователя. Параметр формируется по шаблону <xid>-<uhs>;<XSTSToken>, где:
    • <xid> — Xbox User ID;
    • <uhs> — user hash;
    • <XSTSToken> — Xbox Secure Token Service.
  2. Передайте параметр session_ticket в запрос на автоматическую аутентификацию (JWT или OAuth 2.0).

Epic Games

  1. Получите от платформы код авторизации exchangecode, который генерируется после аутентификации пользователя.
  2. Передайте полученный exchangecode в запрос на автоматическую аутентификацию (JWT или OAuth 2.0) как параметр session_ticket.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 22 января 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!