Integrating LinkedIn Accounts

This topic explains how to allow your users to sign up for and log in to your mobile app with their LinkedIn account. Just add a few parameters in the developer portal and a few lines of code in your mobile app and you will be social-ready!

Configuring LinkedIn integration

Creating a LinkedIn application

To get started, you first need to create a LinkedIn application and get your LinkedIn API key and secret key. For the detailed instructions, see the LinkedIn official documentation.

You will need to fill in the following information. In the "OAuth 2.0 Redirection URL", please specify the value that corresponds to the server location you've selected (please put your AppID in ${your-app-id}):

  • Company name
  • Application name
  • Application description
  • Website URL
  • Application Use
  • Live Status
  • Developer Contact Email
  • Developer Phone
  • OAuth User Aggreement
    • Default Scope (Make sure to select "r_basicprofile")
    • Agreement Language
    • OAuth 2.0 Redirection URL:
      • United States: https://${your-app-id}.us.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback
      • Japan: https://${your-app-id}.jp.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback
      • China: https://${your-app-id}.cn3.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback
      • Singapore: https://${your-app-id}.sg.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback
      • Europe: https://${your-app-id}.eu.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback

When your LinkedIn application is created, you will get a LinkedIn API key and secret key.

Configuring a Kii application

Take the following steps in the developer portal to configure your application by setting your LinkedIn API key and secret key.

  1. Click on the "Edit" button in your application console in the developer portal.

  2. Click "SOCIAL NETWORKS".

  3. Click "LinkedIn" to open the configuration screen for LinkedIn.

  4. Set your LinkedIn API key and secret key.

Then, add the following tag under the application tag in your AndroidManifest.xml so as to enable the Activity that the SDK uses for LinkedIn authentication.

<activity
    android:name="com.kii.cloud.storage.social.connector.KiiSocialNetworkConnectorLoginActivity"
    android:label="@string/app_name" />

Logging in with a LinkedIn account

Here is the sample code for letting a new user log in with their LinkedIn account:

Activity activity = this.getActivity();
KiiSocialConnect connect = Kii.socialConnect(SocialNetwork.SOCIALNETWORK_CONNECTOR);

Bundle options = new Bundle();
options.putParcelable(KiiSocialNetworkConnector.PROVIDER, KiiSocialNetworkConnector.Provider.LINKEDIN);

// Login.
connect.logIn(activity, options, new KiiSocialCallBack() {
  @Override
  public void onLoginCompleted(SocialNetwork network, KiiUser user, Exception exception) {
    if (exception != null) {
      // Handle the error.
      return;
    }
  }
});

The basic steps are as follows.

  1. Create an Activity for handling logging in with a LinkedIn account.
  2. Create a social network connector instance with the socialConnect() method. Here, we are specifying SocialNetwork.SOCIALNETWORK_CONNECTOR.
  3. Create a bundle and specify the target social network service. In this case, we are specifying Provider.LINKEDIN.
  4. Authenticate the user with the logIn() method. If the specified LinkedIn account is new to Kii Cloud, the user is registered before the login. The logIn() method is non-blocking and receives the processing result with the callback method.

Note: You also need to add a method to the onActivityResult() method to finish the LinkedIn authentication.

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  if (requestCode == KiiSocialNetworkConnector.REQUEST_CODE) {
    Kii.socialConnect(SocialNetwork.SOCIALNETWORK_CONNECTOR).respondAuthOnActivityResult(
      requestCode,
      resultCode,
      data);
  }
}

If the login successful, the user is cached inside the SDK as the current user and you can get the user information with the getCurrentUser() method. You can also retrieve the access token and related parameters with the getAccessTokenBundle() method as follows:

KiiSocialConnect connect = Kii.socialConnect(SocialNetwork.SOCIALNETWORK_CONNECTOR);
Bundle b = connect.getAccessTokenBundle();

// The access token.
String accessToken = b.getString("oauth_token");

// The access token secret.
String accessTokenSecret = b.getString("oauth_token_secret");

// User id provided by the social network provider.
String providerUserId = b.getString("provider_user_id");

// If a new Kii user is created with the logIn method.
boolean kiiNewUser = b.getBoolean("kii_new_user");