SDK для Unity / Аутентификация
 На главную

SDK для Unity

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

  • Демопроект

  • Использование

  • Руководства по сборке приложений

  • Решение проблем

  • Как перейти на использование SDK версии 1.0.0 и выше

  • Аутентификация

    Основная информация

    Решение для входа и регистрации пользователей создано на базе продукта Авторизация. Настройка способов аутентификации для вашего проекта доступна в Личном кабинете в разделе Логин.

    Аутентификация по стандарту JWT и протоколу OAuth 2.0

    Стандартный протокол аутентификации OAuth 2.0 ориентирован на простоту разработки клиентского приложения. OAuth 2.0 позволяет обновлять токен без участия пользователя. При аутентификации по стандарту JWT для обновления токена пользователю нужно ввести свои учетные данные и войти в приложение.

    ОAuth 2.0 является рекомендуемым способом аутентификации и выбран в настройках SDK по умолчанию. Подробные сведения приведены в инструкции Как настроить OAuth 2.0 аутентификацию.

    Если вы используете в своем приложении авторизацию по стандарту JWT, рекомендуется настроить инвалидацию токена.

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

    Аутентификация по имени пользователя/email-адресу и паролю

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

    При регистрации ввод email-адреса является обязательным, даже если для аутентификации используется имя пользователя. Email-адрес используется для подтверждения регистрации пользователя и для сброса пароля.

    При успешной регистрации пользователю приложения отправляется письмо для подтверждения регистрации на указанный email-адрес. Вы можете кастомизировать письма для пользователей в Личном кабинете.

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

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

    Социальные сети могут быть как основным способом аутентификации в вашем приложении, так и альтернативным.

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

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

    • Пользователь, зарегистрированный с помощью имени пользователя или email-адреса, входит в приложение через аккаунт социальной сети.
    • Социальная сеть возвращает email-адрес.
    • Email-адрес из социальной сети совпадает с email-адресом, указанным пользователем при регистрации в вашем приложении.

    Поддерживается авторизация через следующие социальные сети:

    • Amazon
    • Apple
    • Baidu
    • Battle.net
    • Discord
    • Facebook
    • GitHub
    • Google
    • Kakao
    • LinkedIn
    • MSN
    • Mail.ru
    • Microsoft
    • Naver
    • Odnoklassniki
    • PayPal
    • QQ
    • Reddit
    • Steam
    • Twitch.tv
    • Twitter
    • VK
    • Vimeo
    • WeChat
    • Weibo
    • Xbox Live
    • Yahoo
    • Yandex
    • YouTube

    Для мобильных приложений также поддерживается авторизация через клиент социальной сети на устройстве пользователя (нативная авторизация через социальные сети). В настоящее время для SDK реализована нативная авторизация через:

    • Google
    • Facebook
    • WeChat
    • QQ

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

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

    Если вы используете для доставки вашего приложения пользователям Лаунчер Иксоллы или Steam, вы можетеаутентифицировать пользователя автоматически, используя учетные данные из установщика.

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

    Аутентификация через ID устройства

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

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

    Авторизация без пароля

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

    Политика конфиденциальности

    При использовании SDK добавьте в ваше приложение ссылку на соглашение о Политике конфиденциальности Иксоллы. Пример такой ссылки приведен в демопроекте на экране регистрации пользователя.

    Note
    Обратите внимание, что соглашение о Политике конфиденциальности Иксоллы не подразумевает использование пользовательских данных. Если вы планируете собирать и обрабатывать пользовательские данные, убедитесь в соблюдении всех требуемых норм законодательства — необходимо запрашивать согласие пользователя или уведомлять его о политике использования пользовательских данных.

    Инструкции

    Узнайте о дополнительных настройках из наших инструкций.

    Как настроить OAuth 2.0 аутентификацию

    Протокол OAuth 2.0 использует короткоживущие токены с долговременной авторизацией (refresh-токены) вместо долгоживущих токенов. Refresh-токен позволяет длительное время использовать ваше приложение без необходимости повторного ввода имени пользователя и пароля. При этом исключается вероятность того, что данные авторизации пользователя будут скомпрометированы.

    Протокол OAuth 2.0 используется для авторизации:

    • через имя пользователя или email-адрес и пароль;
    • через социальные сети;
    • через Steam.

    При включении настройки регистрация и авторизация пользователя выполняются с помощью вызова методов API Register new user и JWT auth by username and password. В SDK для авторизации по протоколу OAuth 2.0 предусмотрены те же методы, что и для авторизации с использованием токена в формате JWT.

    Note
    При включении настройки процесс авторизации в вашем приложении для пользователя не меняется.

    Для настройки авторизации по протоколу OAuth 2.0:

    1. Настройте авторизацию по протоколу OAuth 2.0 для варианта Авторизации в Личном кабинете.
    2. Настройте ассет для вашего проекта Unity.

    Настройка авторизации по протоколу OAuth 2.0 для варианта Авторизации в Личном кабинете

    1. Перейдите к вашему проекту в Личном кабинете.
    2. Выберите пункт Авторизация в боковом меню.
    3. Нажмите Настроить в панели с вариантом авторизации.
    4. Перейдите к блоку Безопасность и выберите раздел OAuth 2.0 аутентификация.
    5. Нажмите Добавить OAuth 2.0.
    6. Укажите URI переадресации OAuth 2.0 и нажмите Подключить.
    7. Скопируйте и сохраните ID клиента.

    Настройка ассета в вашем проекте Unity

    1. Перейдите к вашему проекту Unity.
    2. В главном меню выберите пункт Window > Xsolla > Edit Settings.
    3. В панели Inspector:
      1. В поле Authorization Type выберите OAuth2.0.
      2. В поле OAuth2.0 client ID укажите ID клиента, полученный при настройке авторизации по протоколу OAuth 2.0 в Личном кабинете.

    Для работы с refresh-токенами в SDK реализованы следующие методы:

    • RefreshOAuthToken — обновляет существующий токен, используя ранее сохраненный refresh-токен OAuth2.0.
    • ExchangeCodeToToken — обменивает код аутентификации пользователя на действительный JWT.

    Для дополнительной проверки пользователя при авторизации по протоколу OAuth 2.0 в методе GetSocialNetworkAuthUrl предусмотрен аргумент oauthState. Этот аргумент используется для сдерживания возможных атак CSRF.

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

    Как использовать собственную систему авторизации

    Вы можете интегрировать SDK с собственной системой авторизации. В этом случае необходимо реализовать идентификацию пользователя по custom ID (ID пользователя, сформированный на вашем сервере) для открытия внутриигрового магазина, проведения платежа и управления инвентарем.

    Сценарий взаимодействия c серверами Иксоллы при использовании собственной системы авторизации:

    1. Ваш клиент отправляет на ваш сервер запрос на аутентификацию.
    2. Ваш сервер аутентифицирует пользователя и отправляет на сервер Иксоллы запрос на получение JSON Web Token (JWT) пользователя, передавая custom ID.
    3. Сервер Иксоллы возвращает JWT пользователя.
    4. Ваш сервер передает JWT пользователя клиенту.
    5. Полученный JWT пользователя используется методами SDK вместо авторизационного токена для открытия внутриигрового магазина, проведения платежа и управления инвентарем.

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

    1. В Личном кабинете настройте серверный OAuth 2.0-клиент.
    2. Реализуйте получение серверного JWT.
    3. Реализуйте получение JWT пользователя.
    4. Реализуйте логику работы с внутриигровым магазином, покупками и инвентарем с использованием JWT пользователя.

    Note
    Если вы используете систему авторизации PlayFab или Firebase, реализуйте получение JWT пользователя с помощью готовых расширений Иксоллы для BaaS.

    Настройка серверного OAuth 2.0-клиента

    1. Откройте ваш проект в Личном кабинете и перейдите в раздел Авторизация.
    2. Нажмите Настроить в панели нужного варианта авторизации.
    3. На странице навигации перейдите к блоку Безопасность и выберите раздел OAuth 2.0 аутентификация.
    4. Нажмите Добавить OAuth 2.0.
    5. Укажите URI переадресации OAuth 2.0.
    6. Установите флажок Серверная (соединение server-to-server).
    7. Нажмите Подключить.
    8. Скопируйте и сохраните ID клиента и секретный ключ.

    Получение серверного JWT

    В серверной части вашего приложения реализуйте метод для получения серверного JWT с использованием запроса Generate JWT. Запрос должен содержать следующие параметры:

    Note
    Срок жизни серверного JWT — 59 минут.

    Получение JWT пользователя

    В серверной части вашего приложения реализуйте метод для получения JWT пользователя с использованием запроса Auth by custom ID. Запрос должен содержать заголовок X-Server-Authorization: <server_JWT>, где <server_JWT> — серверный JWT, полученный на предыдущем шаге.

    Note
    Срок жизни JWT пользователя — 24 часа. Чтобы изменить это значение, обратитесь к аккаунт-менеджеру проекта или напишите на integration@xsolla.com.

    Использование JWT пользователя

    Используйте методы SDK для открытия внутриигрового магазина, проведения платежа и управления инвентарем, при этом передайте JWT пользователя в свойство Token.Instance.

    Примеры использования токена приведены в сценариях:

    Реализуйте получение нового JWT пользователя после истечения его срока жизни. Рекомендуется получать новый токен в фоновом режиме, без повторного входа пользователя в приложение.

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

    Как настроить нативную авторизацию через социальные сети

    Нативная авторизация позволяет пользователям войти в ваше приложение с помощью аккаунта социальной сети, настроенного на мобильном устройстве.

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

    В настоящее время для SDK реализована нативная авторизация через следующие социальные сети:

    • Google
    • Facebook
    • WeChat
    • QQ

    Чтобы настроить нативную авторизацию:

    1. Создайте сборку вашего проекта Unity под Android.
    2. Настройте приложение в личном кабинете разработчика социальной сети:
      1. Для авторизации через Facebook:
        1. Зарегистрируйтесь и создайте новое приложение.
        2. Настройте страницу приложения в личном кабинете разработчика Facebook.
      2. Для авторизации через Google настройте проект в Google API Console.
      3. Для авторизации через WeChat:
        1. Зарегистрируйтесь и создайте новое мобильное приложение.
        2. Отправьте приложение на проверку.
      4. Для авторизации через QQ:
        1. Зарегистрируйтесь и создайте новое мобильное приложение.
        2. Отправьте приложение на проверку.

    1. Настройте авторизацию через социальные сети на стороне Иксоллы:
      1. Для Facebook и Google настройте социальные сети в Личном кабинете.
      2. Для WeChat и QQ обратитесь к аккаунт-менеджеру проекта.
    2. Настройте ассет для вашего проекта Unity.

    Создание сборки проекта Unity под Android

    1. Перейдите к вашему проекту Unity.
    2. В главном меню выберите пункт File > Build settings.
    3. В панели Platform выберите пункт Android.
    4. Нажмите Build.

    Для дальнейшей настройки нативной авторизации вам понадобятся:

    • Название пакета, которое можно найти в поле Package Name в панели Inspector после выбора платформы Android в File > Build settings.
    • Имя класса Android — название главной Activity с указанием неймспейса приложения (например, com.domain.appname.activity). Имя класса можно найти в AndroidManifest.xml. Тег главной Activity должен содержать тег intent-filter с действием android.intent.action.MAIN и категорией android.intent.category.LAUNCHER.
    • Хеш-ключ Android. Вы можете получить его с помощью OpenSSL.

    Настройка страницы приложения в личном кабинете разработчика Facebook

    1. Перейдите к настройкам приложения в личном кабинете разработчика Facebook.
    2. Перейдите Настройки > Основное.
    3. Нажмите Добавить платформу и выберите Android.
    4. В поле Название пакета Google Play укажите название пакета из вашего проекта Unity.
    5. В поле Название класса укажите имя класса Android из вашего проекта Unity.
    6. В поле Ключевые хеш-адреса укажите хеш-ключ Android из вашего проекта Unity.
    7. Нажмите Сохранить изменения.

    Для дальнейшей настройки нативной авторизации вам понадобятся Идентификатор приложения и Секрет приложения, которые можно найти в настройках приложения в разделе Настройки > Основное.

    Настройка проекта в Google API Console

    1. Перейдите в Google API Console.
    2. Нажмите Создать проект.
    3. Укажите Название проекта и Местоположение, нажмите Создать.
    4. Перейдите в созданный проект и в боковом меню нажмите Окно запроса доступа OAuth.
    5. Установите флажок Внешнее и нажмите Создать.
    6. Укажите необходимые параметры и нажмите Сохранить.
    7. В боковом меню выберите Учетные данные.
    8. Создайте клиент OAuth 2.0 для вашего приложения на Unity:

      1. Нажмите Создать учетные данные и выберите Идентификатор проекта OAuth.
      2. В поле Тип приложения укажите Android.
      3. Укажите Имя.
      4. В поле Название пакета укажите имя пакета из вашего проекта Unity.
      5. В поле Контрольная сумма сертификата SHA-1 укажите хеш-ключ Android из вашего проекта Unity.
      6. Нажмите Создать.
      7. Нажмите OK.

    1. Создайте клиент OAuth 2.0 для веб-приложения:
      1. Нажмите Создать учетные данные и выберите пункт Идентификатор проекта OAuth.
      2. В поле Тип приложения укажите Веб-приложение.
      3. Укажите Имя.
      4. Нажмите Добавить URI в разделе Разрешенные URI перенаправления и укажите URI https://login.xsolla.com/api/social/oauth2/callback.
      5. Нажмите Создать.
      6. Нажмите OK.

    Для дальнейшей настройки нативной авторизации вам понадобятся Идентификатор клиента и Секретный код клиента, которые можно найти в настройках идентификатора клиента для веб-приложения.

    Настройка социальных сетей для варианта авторизации в Личном кабинете Иксоллы

    1. Перейдите к вашему проекту в Личном кабинете.
    2. Нажмите Авторизация в боковом меню и перейдите в раздел Варианты авторизации > ваш вариант авторизации > Социальные сети.
    3. Для настройки авторизации через Facebook:

      1. Нажмите Редактировать в панели Facebook и измените статус на Отключен.
      2. В поле Application ID укажите Идентификатор приложения из личного кабинета разработчика Facebook.
      3. В поле Application Secret укажите Секрет приложения из личного кабинета разработчика Facebook.
      4. Нажмите Подключить.

    1. Для настройки авторизации через Google:
      1. Нажмите Редактировать в панели Google и измените статус на Отключен.
      2. В поле Application ID укажите Идентификатор клиента из Google API Console для веб-приложения.
      3. В поле Application Secret укажите Секретный код клиента из Google API Console для веб-приложения.
      4. Нажмите Подключить.

    Настройка ассета для проекта Unity

    1. Перейдите к вашему проекту Unity.
    2. В главном меню выберите пункт Window > Xsolla > Edit Settings.
    3. Укажите идентификатор приложения:
      1. В поле Facebook App ID укажите Идентификатор приложения из личного кабинета разработчика Facebook.
      2. В поле Google server ID укажите Идентификатор клиента из Google API Console для веб-приложения.
      3. В поле WeChat App ID укажите AppID из настроек приложения WeChat.
      4. В поле QQ App ID укажите AppID из настроек приложения QQ.

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

    Как подключить нативную авторизацию через Steam

    Notice
    Используйте эту инструкцию, если вы включили демопроект в свой проект Unity.

    Нативная авторизация позволяет игрокам войти в ваше приложение через установленное приложение Steam.

    Чтобы настроить нативную авторизацию:

    1. Подключите автоматическую аутентификацию через Steam в Личном кабинете.
    2. Настройте ваш проект Unity.
    3. Настройте обработку событий.
    4. Проверьте авторизацию через Steam.

    Настройка проекта Unity

    1. Создайте файл steam_appid.txt, впишите в него ID вашего приложения в Steam и поместите его в каталог Assets/Plugins/Steamworks.NET/redist/ вашего проекта.

    Note
    Если вы загрузили SDK из GitHub, в каталоге Assets/Plugins/Steamworks.NET/redist/ уже создан файл steam_appid.txt Steam для демопроекта.

    1. Откройте ваш проект Unity.
    2. В главном меню выберите пункт Window > Xsolla > Demo Settings.
    3. В панели Inspector:
      1. Установите флажок Use Steam authorization.
      2. В поле Steam App ID укажите ID вашего приложения в Steam. Значение должно совпадать со значением, указанным в файле steam_appid.txt.

    Настройка обработки событий

    Для аутентификации пользователей через Steam необходимо передать session ticket в метод SilentAuth. В качестве примера см. класс SteamAuth.cs в демопроекте.

    Проверка авторизации через Steam

    1. Создайте сборку вашего проекта Unity для stand-alone платформы.
    2. Запустите приложение Steam и авторизуйтесь в нем.
    3. Запустите ваше приложение. Если настройка выполнена правильно, вы автоматически авторизуетесь в приложении.

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

    Как настроить инвалидацию токена

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

    Note
    Вы можете настроить инвалидацию токена для авторизации с использованием токена в формате JWT. При авторизации по протоколу OAuth 2.0 инвалидация токена предусмотрена самим протоколом и ее не нужно настраивать отдельно.

    При использовании SDK инвалидация существующего токена и генерация нового выполняется при вызове методов API Auth by username and password и Auth via social network, если для параметра with_logout указано значение 1.

    Для включения инвалидации токена в вашем проекте Unity:

    1. В главном меню выберите пункт Window > Xsolla > Edit Settings.
    2. Перейдите в панель Inspector. В поле Authorizaton Type выберите JWT и установите флажок Invalidate Existing Sessions.

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

    Как настроить авторизацию в приложении через Лаунчер

    Для доставки вашего приложения пользователям и его обновления вы можете использовать Лаунчер Иксоллы. Лаунчер содержит встроенный инструмент авторизации. Чтобы избежать необходимости повторного ввода имени пользователя и пароля, настройте авторизацию в вашем приложении через Лаунчер.

    Notice
    Для использования Лаунчера должен быть настроен продукт Авторизация. Использование другой системы авторизации не поддерживается.

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

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

    Note
    В файле config.json достаточно изменить значения для следующих объектов:
    • launcher_project_id — укажите ID лаунчера, который можно найти в разделе Лаунчер > Общие настройки > Общая информация Личного кабинета;
    • login_project_id — укажите ID варианта авторизации, который можно найти в разделе Лаунчер > Общие настройки > Настройки аутентификации Личного кабинета.

    1. Кастомизируйте интерфейс лаунчера.

    Notice
    При интеграции SDK с серверами Иксоллы используется Commerce API, поэтому магазин Лаунчера не поддерживается.

    1. Реализуйте в вашем приложении логику авторизации через Лаунчер.
    2. Сгенерируйте установочный файл лаунчера и архив с его сборкой.
    3. Создайте сборку приложения.
    4. Загрузите сборку приложения на сервер обновлений Иксоллы.

    Реализация логики авторизации через Лаунчер

    Сценарий авторизации в приложении через Лаунчер:

    1. Пользователь авторизуется в Лаунчере.
    2. Пользователь устанавливает и запускает приложение.
    3. Лаунчер запускает приложение с передачей параметров пользователя через командную строку. Токен для авторизации передается в параметре xsolla-login-token.
    4. Приложение обрабатывает параметры командной строки и получает токен. Пример скрипта обработки токена приведен в демопроекте.
    5. Приложение валидирует полученный токен. Пример скрипта валидации токена приведен в демопроекте.
    6. Приложение автоматически авторизует пользователя, не отображая страницу авторизации. Пример скрипта авторизации пользователя приведен в демопроекте.

    Note
    Полученный токен используется методами SDK для открытия внутриигрового магазина, проведения платежа и других операций. Передайте токен в свойство Token.Instance.

    Создание сборки приложения

    1. Откройте ваш проект Unity.
    2. В главном меню выберите пункт Window > Xsolla > Edit Settings. В панели Inspector:
      1. В поле Project ID укажите ID проекта, который можно найти в разделе Настройки проекта > ID проекта Личного кабинета.
      2. В поле Login ID укажите ID варианта авторизации, который можно найти в разделе Лаунчер > Общие настройки > Настройки аутентификации Личного кабинета.

    1. Запустите сцену авторизации пользователя, в которой выполняется обработка токена.
    2. В главном меню выберите пункт File > Build settings и нажмите Add Open Scenes. Убедитесь, что сцена авторизации добавлена первой в списке.
    3. Нажмите Build.
    4. Во всплывающем окне укажите путь к директории, в которую будет помещена готовая сборка.

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

    Как реализовать аутентификацию пользователя по ID устройства

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

    Notice
    Созданный по ID устройства аккаунт позволяет использовать приложение только на текущем мобильном устройстве. Доступ к нему будет утерян при смене Android- или iOS-устройства, а также при удалении приложения на iOS-устройстве. Чтобы сохранить прогресс в приложении и пользоваться аккаунтом на других устройствах, пользователь может обновить аккаунт, привязав социальную сеть или указав имя пользователя, email-адрес и пароль.

    С помощью ID устройства вы можете реализовать авторизацию пользователя на одном или нескольких мобильных устройствах в фоновом режиме. Для этого пользователю потребуется привязать к уже существующему аккаунту ID устройства.

    SDK поддерживает авторизацию по ID мобильных устройств на платформах Android и iOS.

    Получение ID устройства

    ID устройства генерируется платформой и доступно приложениям, установленным на мобильном устройстве. SDK получает значение ID с помощью API платформы и использует это значение для выполнения различных функций с помощью API Иксоллы.

    ID iOS-устройства передается в свойстве UIDevice.identifierForVendor. Для определения ID используется стандартный метод Unity SystemInfo.deviceUniqueIdentifier.

    ID Android-устройства передается в константе android.provider.Settings.Secure.ANDROID_ID. Для определения ID используется собственная логика SDK, потому что стандартный метод Unity возвращает ID Android-устройства в виде MD5 хеш-кода, который не подходит для методов API Иксоллы.

    Методы SDK

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

    Аутентификация

    Название метода SDKОписание
    AuthViaDeviceID
    Аутентифицирует пользователя в приложении с помощью ID текущего устройства.

    Обновление аккаунта

    Название метода SDKОписание
    AddUsernameEmailAuthToAccount
    Добавляет к текущему аккаунту имя пользователя, email-адрес и пароль, которые можно использовать для аутентификации.
    Привязывает к текущему аккаунту социальную сеть, которую можно использовать для аутентификации.
    Notice
    С помощью перечисленных методов можно обновлять аккаунт, созданный любым доступным способом (например, с помощью социальной сети или email-адреса и пароля).

    Управление устройствами

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

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

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