Как настроить теневой вариант авторизации

1. Создайте теневой вариант авторизации, если он не был создан ранее (см. раздел Руководство по интеграции, шаги 1–5).
2. Настройте ваш теневой вариант авторизации в Личном кабинете.
3. Интегрируйте решение на стороне вашего приложения.

Настройка в Личном кабинете

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. Перейдите на вкладку Настройки callback URL и задайте значения следующих параметров:
   • Callback URL — URL-адрес или путь в приложении, на который перенаправляются пользователи после их успешной аутентификации, подтверждения электронной почты или сброса пароля. Можно указать несколько допустимых URL-адресов.
   • Callback URL ошибки — URL-адрес или путь в приложении, на который перенаправляется пользователь в случае ошибки аутентификации. Если значение не указано, будет использоваться значение Callback URL.

8. Нажмите Сохранить изменения.

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

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

• 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.