SDK supports the following providers for social login:

• 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

To set up authentication through web services:

1. In the application interface, add buttons for authentication via social networks.
2. Set up social connections for a Login project in Publisher Account.
3. Implement authentication logic on the application side.

Set up social connections for Login project in Xsolla Publisher Account

1. Open your project in Publisher Account.
2. In the side menu, click Login.
3. Click Configure in the pane of a Login project.
4. Go to the Authentication block and select the Social login section.

5. Connect social networks that users can use to sign up and log into the application:

1. • To connect a social network, click the ⚙ icon and select Connect.

1. • To connect several social networks at once, select the required panes (their borders will turn green). Then, from the Manage drop-down menu, select Connect.

1. • To connect all available social networks, click Select all. Then, from the Manage drop-down menu, select Connect.

Integrate on application side

Implement the following logic when clicking the social login button:

1. Call the startSocialAuth method from the Login library.
2. Inside the onActivityResult method, call the finishSocialAuth method from the Login library.

SDK reference documentation

Learn more about SDK methods and its parameters.

Native authentication lets users log in to your application via a social network account configured on a mobile device.

The first time a user logs in, the social networking application is launched and asks for permission to authenticate the user. After that, authentication is performed automatically without requiring the user to do anything.

Currently, SDK has implemented native authentication via the following social networks:

• Google
• Facebook
• WeChat
• QQ

To configure native authentication:

1. In the application interface, add buttons for authentication via social networks.
2. Configure the application in the developer account for the social network:
   1. For authentication via Facebook:
      1. Register and create a new application.
      2. Set up the application page in your Facebook developer account.
   2. For authentication via Google, set up the project in Google API Console.
   3. For authentication via WeChat:
      1. Register and create a new application.
      2. Submit the application for review.
   4. For authentication via QQ:
      1. Register and create a new application.
      2. Submit the application for review.

3. Set up authentication via social networks on the Xsolla side:
   1. For Facebook and Google, set up social connections in Publisher Account.
   2. For WeChat and QQ, contact your Customer Success Manager or email to csm@xsolla.com.

4. Install libraries for authenticating via social network. To do this, open the build.gradle file of your application and in the dependencies section add the following lines, where <version_number> is the required version of the library:
   • For authentication via Facebook:

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

1. • For authentication via Google:

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

1. • For authentication via WeChat:

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

1. • For authentication via QQ:

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

5. Initialize the Login library with the following parameters:
   • facebook_id — App ID from the Facebook developer account
   • google_id — Client ID for web application from the Google API Console
   • wechat_id — AppID from the WeChat developer account
   • qq_id — AppID from the QQ developer account

An example of initializing the library when authenticating via 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. For authentication via WeChat, modify the application code:
   • Add the WXEntryActivity class to the <your_package_name>.wxapi package, where <your_package_name> is the name of your application package:

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. • Add the following element to your AndroidManifest.xml file:

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

Set up application page in your Facebook developer account

1. Go to project settings in the Facebook developer account.
2. Go to Settings > Basic.
3. Click Add Platform and select Android.
4. Specify the package name of your Android application in the Google Play Package Name field.
5. Specify a fully qualified class name of the default Activity in the Class Name field.
6. Generate a hash key and specify it in the Key Hashes field.
7. Click Save Changes.

For further native authentication configuration, you will need App ID and App Secret found in project settings in Settings > Basic section.

Set up project in Google API Console

1. Go to Google API Console.
2. Click New Project.
3. Specify Project name and Location and click Save.
4. Go to the created project and click OAuth consent screen in the side menu.
5. Select External option and click Create.
6. Specify the necessary parameters and click Save.
7. Click Credentials in the side menu.
8. Create an OAuth 2.0 client for your Android app:

1. 1. Click Create credentials and select OAuth client ID.
   2. Specify Android in the Application type field.
   3. Specify Name.
   4. Specify package name of your Android application in the Package name field.
   5. Get the SHA-key.
   6. Specify SHA-key generated in the previous step SHA-key in the SHA-1 certificate fingerprint field.
   7. Click Create.
   8. Click OK.

9. Create an OAuth 2.0 client for the web application:
   1. Click Create credentials and select OAuth client ID.
   2. Specify Web application in the Application type field.
   3. Specify Name.
   4. Click Add URI in the Authorized redirect URIs section and specify https://login.xsolla.com/api/social/oauth2/callback URI.
   5. Click Create.
   6. Click OK.

For further native authentication configuration, you will need Client ID and Client Secret found in settings of the Client ID for the web application.

Set up social connections for Login project in Xsolla Publisher Account

1. Open your project in Publisher Account.
2. In the side menu, click Login.
3. Click Configure in the pane of a Login project.
4. Go to the Authentication block and select Social login section.

5. To set up a social network, go to the social network card, click the ⚙ icon to the right of the title, and select Connect.

Integrate on application side

Implement the following logic when clicking the social login button:

1. Call the startSocialAuth method from the Login library.
2. Inside the onActivityResult method, call the finishSocialAuth method from the Login library.

SDK reference documentation

Learn more about SDK methods and its parameters.