Автоматическая аутентификация через платформу публикации

Автоматическая аутентификация позволяет пользователям не вводить учетные данные в вашем приложении. При таком типе аутентификации сервер Xsolla Login использует учетные данные, которые пользователь указал на платформе публикации приложения.

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

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

В продукте 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 для других платформ публикации.

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

1. Интегрируйте в ваше приложение SDK платформы публикации.
2. Реализуйте логику получения сессионного ключа (session ticket):

1. • Для Steam получите билет сессии аутентификации.
   • Для Xbox Live сформируйте session ticket на основе данных платформы после аутентификации пользователя. Параметр формируется по шаблону <xid>-<uhs>;<XSTSToken>, где:
     • <xid> — Xbox User ID;
     • <uhs> — user hash;
     • <XSTSToken> — Xbox Secure Token Service.
   • Для Epic Games получите от платформы код авторизации (exchange code), который генерируется после аутентификации пользователя и используется в качестве session ticket.

3. Реализуйте логику аутентификации пользователя с помощью методов SDK:

1. • SilentAuth — обменивает session ticket от платформы публикации на JSON Web Token (JWT) и аутентифицирует пользователя.
   • OAuthLogout — завершает активную сессию пользователя.

Справочная документация SDK

Узнайте больше о методах SDK и их параметрах.

Полезные ссылки