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

Авторизация

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

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

  • Инструкции

  • Расширения

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

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

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

    Автоматическая аутентификация позволяет авторизовать пользователя в продукте Авторизация через платформу публикации (Xbox, Steam, Stone, Mail.ru).

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

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

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

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

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

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

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

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

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

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

    1. Перейдите в Личный кабинет, в раздел ваш вариант авторизации > Социальные сети > Аутентификация через платформы публикации.
    2. Выберите платформу публикации и нажмите Подключить/Редактировать.
    3. В модальном окне укажите параметры для соответствующей платформы:
      • Steam:
        1. Application ID — ID приложения (AppID)
        2. Application Secret — ключ веб-API
      • Stone:
        1. Application ID — ID приложения (Stoneport ID)
        2. Application Secret — секретный ключ (Stoneport Keys)
      • Mail.ru:
        1. Application ID — ID приложения (GMRID)
        2. Application Secret — секретный ключ, указанный в Кабинете разработчика Mail.ru на вкладке System characteristics > Secret for api.games.mail/gc.mail.ru
    4. Нажмите Подключить.

    Note
    Значения параметров для Xbox указывать не требуется.

    Xbox

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

    Steam

    Сформируйте сессионный ключ (параметр session_ticket) на основе данных платформы после аутентификации пользователя:

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

    Stone

    Передайте в запрос Silent authentication параметры session_ticket и area_id, полученные от платформы после аутентификации пользователя:

    Copy
    Full screen
    Small screen
    http
    • http
    • curl
    GET https://login.xsolla.com/api/social/stone/cross_auth?projectId=<project_id>&session_ticket=<session_ticket>&area_id=<area_id>&app_id=<app_id>&login_url=<login_url> HTTP/1.1
    curl --request GET \
      --url 'https://login.xsolla.com/api/social/stone/cross_auth?projectId=project_id&session_ticket=session_ticket&area_id=area_id&app_id=app_id&login_url=login_url'

    Mail.ru

    Передайте в запрос Silent authentication параметры uid и hash (ID пользователя и аналог сессионного ключа соответственно), полученные от платформы после аутентификации пользователя:

    Copy
    Full screen
    Small screen
    http
    • http
    • curl
    GET https://login.xsolla.com/api/social/mailru/cross_auth?projectId=<project_id>&uid=<user_id>&hash=<ticket>&fields=email&login_url=<login_url> HTTP/1.1
    curl --request GET \
      --url 'https://login.xsolla.com/api/social/mailru/cross_auth?projectId=project_id&uid=user_id&hash=ticket&fields=email&login_url=login_url'

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

    В другой раз

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

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

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