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

Авторизация

  • Руководство по интеграции

  • Варианты аутентификации

  • Хранилище данных пользователей

  • Безопасность

  • Кастомизация

  • Провайдеры коммуникационных услуг

  • Возможности

  • Инструкции

  • Расширения

  • Юридические настройки

  • Справочники

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

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

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

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

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

    Примечание
    Если у вас подключен Лаунчер Иксолла, воспользуйтесь инструкцией для авторизации пользователя через платформы.

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

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

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

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

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

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

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

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

    В классическом варианте авторизации можно подключить автоматическую аутентификацию сразу для нескольких платформ публикации, но создать кросс-платформенный аккаунт невозможно. Если пользователь войдет в игру сначала на одной платформе, а затем на другой, для продукта Авторизация это будут два разных пользователя.

    Чтобы подключить автоматическую аутентификацию в классическом варианте авторизации:

    1. Откройте ваш проект в Личном кабинете и перейдите в раздел Авторизация.
    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 с ключами доступа, принадлежащими Иксолле. Для этого нажмите значок ⚙ справа от имени платформы и выберите пункт Подключить.

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

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

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

    Примечание
    Для работы с API Иксоллы вы можете использовать готовые методы SDK для игровых движков и платформ:

    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.

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Оценить страницу
    Оценить страницу
    Что может сделать страницу еще лучше?

    В другой раз

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

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

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