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

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

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

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

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

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

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

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

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

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

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

• путем настройки классического варианта авторизации (см. инструкцию ниже);
• путем создания теневого варианта авторизации (см. раздел Как настроить теневой вариант авторизации).

1. Откройте проект в Личном кабинете и перейдите в раздел Login.
2. Нажмите Настроить в панели классического варианта авторизации.
3. Перейдите к блоку Аутентификация и выберите раздел Платформы публикации.

4. Чтобы подключить платформу публикации, на которой размещена игра, нажмите значок ⚙ справа от имени платформы и выберите пункт Настройки.

5. В модальном окне укажите параметры настройки для выбранной платформы:
   • Steam:
     • ID приложения — AppID вашего аккаунта на платформе;
     • Секретный ключ приложения — ключ веб-API.
   • Epic Games:
     • ID приложения — Client ID клиента вашей игры на платформе;
     • Секретный ключ приложения — Secret key клиента вашей игры на платформе.
   • Xbox Live:
     • ID приложения — Application ID/Client ID вашей игры на платформе;
     • Секретный ключ приложения — Application Secret, сгенерированный при регистрации вашей игры на платформе.

6. Нажмите Подключить.
7. Если требуется, повторите шаги 4 – 6 для других платформ публикации.

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

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

• Steam
• Xbox Live
• Epic Games

Steam

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.