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

• 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. В боковом меню выберите пункт Авторизация.
3. Нажмите Настроить в панели нужного варианта авторизации.
4. На странице навигации перейдите к блоку Аутентификация и выберите раздел Авторизация через социальные сети.

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

1. • Чтобы подключить нужную социальную сеть, нажмите значок ⚙ и выберите пункт Подключить.

1. • Чтобы подключить сразу несколько социальных сетей, выберите нужные панели (рамки панелей станут зелеными). Затем в раскрывающемся меню Управление выберите пункт Подключить.

1. • Чтобы подключить сразу все доступные социальные сети, нажмите Выбрать все. Затем в раскрывающемся меню Управление выберите пункт Подключить.

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

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

1. Для настольных приложений:
   1. Получите URL-адрес страницы регистрации/авторизации с помощью метода SDK GetSocialNetworkAuthUrl.
   2. Откройте страницу регистрации/авторизации в браузере с помощью метода BrowserHelper.Instance.InAppBrowser.
   3. Подпишитесь на событие изменения URL-адреса, для этого добавьте функцию обратного вызова BrowserHelper.Instance.InAppBrowser.AddUrlChangeHandler(OnUrlChanged).
   4. Отследите изменение URL-адреса страницы после успешной аутентификации пользователя.
   5. Получите код аутентификации из URL-адреса активной страницы. Для этого вы можете использовать вспомогательный метод SDK ​​ParseUtils.TryGetValueFromUrl().
   6. Обменяйте код аутентификации на токен с помощью метода SDK ExchangeCodeToToken и используйте его в запросах к серверам Иксоллы. ​

2. Для Android-приложений:
   1. Создайте объект класса AndroidSDKSocialAuthHelper.
   2. Вызовите метод PerformSocialAuth, передав в него параметры:
      • SocialProvider — название социальной сети;
      • onSuccess — функция, которая вызывается в случае успешной аутентификации пользователя;
      • onCancelled — функция, которая вызывается в случае отмены аутентификации пользователем;
      • onError — функция, которая вызывается в случае ошибки.
   3. Получите токен, который функция onSuccess вернет в параметре token, и используйте его в запросах к серверам Иксоллы.

3. Для iOS-приложений:
   1. Создайте объект класса IosSDKSocialAuthHelper.
   2. Вызовите метод PerformSocialAuth, передав в него параметры:
      • SocialProvider — название социальной сети;
      • onSuccess — функция, которая вызывается в случае успешной аутентификации пользователя;
      • onCancelled — функция, которая вызывается в случае отмены аутентификации пользователем;
      • onError — функция, которая вызывается в случае ошибки.
   3. Получите токен, который функция onSuccess вернет в поле access_token объекта LoginOAuthJsonResponse, и используйте его в запросах к серверам Иксоллы.

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

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

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

• Google
• Facebook
• WeChat
• QQ

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

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

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

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

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

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

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

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

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

Настройка ассета для проекта 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.

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

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

• Для Android-приложения создайте экземпляр класса AndroidSDKSocialAuthHelper и вызовите метод PerformSocialAuth. Пример реализации приведен в демопроекте в скрипте Assets/Xsolla.Demo/Login/Scripts/Login/Auth/AndroidSocialAuth.cs.

• Для iOS-приложения создайте экземпляр класса IosSDKSocialAuthHelper и вызовите метод PerformSocialAuth. Пример реализации приведен в демопроекте в скрипте Assets/Xsolla.Demo/Login/Scripts/Login/Auth/IosSocialAuth.cs.