SDK enterprise-уровня для Unreal Engine / Аутентификация пользователя через социальные сети 
  На главную

SDK enterprise-уровня для Unreal Engine

Последняя версия v0

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

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

Coциальные сети:

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

Примечание
Чтобы аутентифицировать пользователей вашего iOS-приложения с помощью Apple ID, Face ID или Touch ID реализуйте аутентификацию с помощью веб-сервисов. В этом случае методы SDK используют нативные библиотеки для iOS.

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

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

  • Пользователь, зарегистрированный с помощью имени пользователя или 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

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

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

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

Внимание
В Личном кабинете для варианта авторизации, который вы используете в своем приложении, должен быть выбран способ — Классическая авторизация или Авторизация через социальные сети. Вы можете изменить способ авторизации по ссылке Изменить метод авторизации. Ранее сохраненные настройки останутся без изменений.
  1. Откройте проект в Личном кабинете.
  2. В боковом меню выберите пункт Login.
  3. Нажмите Настроить в панели нужного варианта авторизации.
  4. Перейдите к блоку Аутентификация и выберите раздел Авторизация через социальные сети.

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

    • Чтобы подключить нужную социальную сеть, нажмите значок ⚙ и выберите пункт Подключить.
    • Чтобы подключить сразу несколько социальных сетей, выберите нужные панели (рамки панелей станут зелеными). Затем в раскрывающемся меню Управление выберите пункт Подключить.
    • Чтобы подключить сразу все доступные социальные сети, нажмите Выбрать все. Затем в раскрывающемся меню Управление выберите пункт Подключить.
Примечание
По умолчанию при аутентификации используются ID и секретный ключ приложения Xsolla. Если ваше приложение настроено в личном кабинете разработчика социального провайдера, вы можете указать собственные ID и секретный ключ приложения. Подробную инструкцию по получению ID и секретного ключа можно найти в настройках карточки социальной сети в Личном кабинете.

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

Реализуйте следующую логику при нажатии кнопки аутентификации через социальную сеть:

  1. Откройте страницу регистрации/авторизации с помощью метода SDK AuthenticateViaSocialNetwork.
  2. Подпишитесь на события SuccessCallback, ErrorCallback, CancelCallback.
  3. Получите токен из параметра LoginData или с помощью метода GetLoginData и используйте его в запросах к серверам Xsolla.
Примечание
При успешной аутентификации функция SuccessCallback вернет токен авторизации в параметре LoginData. Токен локально кешируется в методе GetLoginData.

Пример реализации описанной логики приведен в блупринте BP_LoginController демопроекта.

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

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

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

  • Google
  • Facebook
  • WeChat
  • QQ

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

  1. В интерфейсе приложения добавьте кнопки для аутентификации через социальные сети.
  2. Создайте сборку проекта Unreal Engine под Android.

Примечание
Для дальнейшей настройки нативной авторизации вам понадобится имя пакета вашего Android-приложения, которое можно найти в разделе Edit > Project Settings > Platforms > Android в поле Android Package Name (‘com.YourCompany.Project’ [PROJECT] is replaced with project name).
  1. Настройте приложение в личном кабинете разработчика социальной сети:
    1. Для авторизации через Facebook:
      1. Зарегистрируйтесь и создайте новое приложение.
      2. Настройте страницу приложения в личном кабинете разработчика Facebook.
    2. Для авторизации через Google настройте проект в Google API Console.
    3. Для авторизации через WeChat:
      1. Зарегистрируйтесь и создайте новое мобильное приложение.
      2. Отправьте приложение на проверку.
    4. Для авторизации через QQ:
      1. Зарегистрируйтесь и создайте новое мобильное приложение.
      2. Отправьте приложение на проверку.
  1. Настройте авторизацию через социальные сети на стороне Xsolla:
    1. Для Facebook и Google настройте социальные сети в Личном кабинете.
    2. Для WeChat и QQ обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.
  2. Настройте SDK для проекта Unreal Engine.
  3. Реализуйте логику аутентификации на стороне приложения.

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

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

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

  • ID приложения и Секрет приложения, которые можно найти в настройках приложения в разделе Настройки > Основное.
  • Маркер клиента, который можно найти в настройках приложения в разделе Настройки > Дополнительно > Безопасность.

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

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

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

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

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

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

Внимание
В Личном кабинете для варианта авторизации, который вы используете в своем приложении, должен быть выбран способ — Классическая авторизация или Авторизация через социальные сети. Вы можете изменить способ авторизации по ссылке Изменить метод авторизации. Ранее сохраненные настройки останутся без изменений.
  1. Откройте проект в Личном кабинете.
  2. В боковом меню выберите пункт Login.
  3. Нажмите Настроить в панели нужного варианта авторизации.
  4. Перейдите к блоку Аутентификация и выберите раздел Авторизация через социальные сети.
  1. Чтобы подключить социальную сеть, в карточке социальной сети нажмите значок ⚙ справа от названия и выберите пункт Подключить.
Примечание
Для использования авторизации через социальные сети в проекте укажите ID и секретный ключ вашего приложения в настройках карточки социальной сети. ID и секретный ключ приложения находятся в аккаунте разработчика социального провайдера. Подробную инструкцию по получению ID и секретного ключа можно найти в настройках карточки социальной сети в Личном кабинете.

Настройка SDK для проекта Unreal Engine

  1. Откройте проект Unreal Engine.
  2. Перейдите в раздел Settings > Project Settings > Plugins > Xsolla Settings > Android.
  3. Укажите ID приложения:
    1. В поле Facebook App Id укажите ID приложения из личного кабинета разработчика Facebook.
    2. В поле Facebook Client Token укажите Маркер клиента из личного кабинета разработчика Facebook.
    3. В поле Google App Id укажите ID клиента из Google API Console для веб-приложения.
    4. В поле We Chat App Id укажите AppID из настроек приложения WeChat.
    5. В поле QQ App Id укажите AppID из настроек приложения QQ.

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

При нажатии кнопки аутентификации через социальную сеть реализуйте вызов метода LaunchNativeSocialAuthentication. Пример реализации приведен в демопроекте, метод AuthenticateViaSocialNetwork в контроллере BP_LoginController.

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

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

Авторизация через социальные сети: базовая настройка Аутентификация пользователя через социальные сети (обучающая инструкция)
Последнее обновление: 22 января 2024

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

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