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

• 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. Перейдите к блоку Аутентификация и выберите раздел Авторизация через социальные сети.

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

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

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

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

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

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

1. Вызовите метод библиотеки Login startSocialAuth.
2. Внутри метода onActivityResult вызовите метод библиотеки Login finishSocialAuth.

Справочная документация SDK

Узнайте больше о методах SDK и их параметрах.

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

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

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

• Google
• Facebook
• WeChat
• QQ

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

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

3. Настройте авторизацию через социальные сети на стороне Xsolla:
   1. Для Facebook и Google настройте социальные сети в Личном кабинете.
   2. Для WeChat и QQ обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

4. Установите библиотеки для авторизации через социальную сеть. Для этого откройте файл build.gradle вашего приложения и в разделе зависимостей добавьте следующие строки, где <version_number> — необходимая версия библиотеки:
   • Для авторизации через Facebook:

implementation 'com.xsolla.android:login-facebook:<version_number>'

1. • Для авторизации через Google:

implementation 'com.xsolla.android:login-google:<version_number>'

1. • Для авторизации через WeChat:

implementation 'com.xsolla.android:login-wechat:<version_number>'

1. • Для авторизации через QQ:

implementation 'com.xsolla.android:login-qq:<version_number>'

5. Инициализируйте библиотеку Login с указанием следующих параметров:
   • facebook_id — ID приложения из личного кабинета разработчика Facebook;
   • google_id — ID клиента из Google API Console для веб-приложения;
   • wechat_id — AppID из личного кабинета разработчика WeChat;
   • qq_id — AppID из личного кабинета разработчика QQ.

Пример инициализации библиотеки при аутентификации через OAuth 2.0:

val loginConfig = LoginConfig.OauthBuilder()
                .setProjectId("login-project-id")
                .setOauthClientId("oauth2-client-id")
                .setSocialConfig(XLogin.SocialConfig(
                     facebookAppId = "facebook_id",
                     googleServerId = "google_id",
                     wechatAppId = "wechat_id",
                     qqAppId = "qq_id"
                ))

                .build()

XLogin.init(applicationContext, loginConfig)

6. Для авторизации через WeChat доработайте код приложения:
   • Добавьте в пакет <your_package_name>.wxapi класс WXEntryActivity, где <your_package_name> — название пакета вашего приложения:

package <your_package_name>.wxapi

import android.app.Activity
import android.os.Bundle
import com.tencent.mm.opensdk.modelbase.BaseReq
import com.tencent.mm.opensdk.modelbase.BaseResp
import com.tencent.mm.opensdk.openapi.IWXAPI
import com.tencent.mm.opensdk.openapi.IWXAPIEventHandler
import com.tencent.mm.opensdk.openapi.WXAPIFactory
import com.xsolla.android.login.util.WechatUtils

class WXEntryActivity : Activity(), IWXAPIEventHandler {

    private lateinit var iwxapi: IWXAPI

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        iwxapi = WXAPIFactory.createWXAPI(this, WechatUtils.wechatAppId, false)
        iwxapi.handleIntent(intent, this)
        finish()
    }

    override fun onReq(req: BaseReq?) {
    }

    override fun onResp(resp: BaseResp) {
        WechatUtils.wechatResult = resp
    }
}

1. • Добавьте в файл AndroidManifest.xml следующий элемент:

<activity
        android:name="<your_package_name>.wxapi.WXEntryActivity"
        android:exported="true"
        android:launchMode="singleTask" />

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

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

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

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

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

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

9. Создайте клиент 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. Перейдите к блоку Аутентификация и выберите раздел Авторизация через социальные сети.

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

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

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

1. Вызовите метод библиотеки Login startSocialAuth.
2. Внутри метода onActivityResult вызовите метод библиотеки Login finishSocialAuth.

Справочная документация SDK

Узнайте больше о методах SDK и их параметрах.