LinkedIn Social Login Configuration Guide

LinkedIn is a business- and career-oriented social networking site with over 500 million registered users.

Before You Begin

To use LinkedIn for social login you must:

  1. Obtain a LinkedIn developer account from https://www.linkedin.com/secure/developer.
  2. Do one of the following:
    • Open a previously-created LinkedIn application, and copy the client ID and client secret.
    • Create a new LinkedIn application and copy the client ID and client secret.
       
  3. Use the Janrain Engage Dashboard and the LinkedIn client ID and client secret to configure LinkedIn as a social login provider.

In This Configuration Guide

  • Creating a LinkedIn Application for Social Login
  • Using an Existing LinkedIn Application for Social Login
  • Configuring LinkedIn as a Social Login Provider
  • Testing LinkedIn Social Login
  • Assigning a Different LinkedIn Application for Social Login
  • Removing LinkedIn as a Social Login Provider

Creating a LinkedIn Application for Social Login

This section walks you through the process of creating a LinkedIn application for social login. If you have already have an application, see the Using an Existing LinkedIn Application for Social Login section of this documentation.

To create a LinkedIn application, complete the following procedure:

  1. Log on to the LinkedIn Developers site (https://www.linkedin.com/secure/developer).
  2. From the My Applications page, click Create Application:

  1. On the Create a New Application page, enter:
    • The name of your company in the Company Name field.
    • The name of your application in the Name field.
    • A brief description of your application in the Description field.
       
  2. Click Select File to Upload to upload a logo for your new application (a logo is required). Using your operating system’s File Open dialog box, select the image file you want to use as your logo and then click Open.
  3. Click Application Use and select the intended use for your application:

  1. Enter:
    • The URL for your website in the Website URL field.
    • Your contact email address in the Business Email field.
    • Your phone number in the Business Phone field.

  2. Scroll to the bottom of the page, select I have read and agree to the LinkedIn API Terms of Use and then click Save:

  1. On the home page for your new app, under Default Application Permissions, select r_basicprofile:

  1. Enter your LinkedIn callback URL in the Authorized Redirect URLs field, click Add, and then click Update. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/linkedin/callback.
  2. Copy the Client ID and Client Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.
  3. Log off from the LinkedIn Developers center.

Using an Existing LinkedIn Application for Social Login

If you already have a LinkedIn application that can be used for social login, complete the following steps to retrieve the application’s client ID and client secret:

  1. Log on to the LinkedIn Developers center (https://www.linkedin.com/secure/developer).
  2. From the My Applications page, click the name of the application you want to use to configure social login:

  1. From the home page for your app, copy the Client ID and Client Secret, and then log off from the LinkedIn Developers center. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:


Configuring LinkedIn as a Social Login Provider

To configure LinkedIn as a social login provider, make sure you have your LinkedIn client ID and client secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click LinkedIn.
  6. In the LinkedIn dialog field, click Next until you reach the screen requesting the LinkedIn API key and secret key:

  1. Paste your LinkedIn client ID in the API Key field, paste your LinkedIn client secret in the Secret Key field, and then click Save. LinkedIn appears in your social login widget.
  2. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before LinkedIn appears as a social login option on your web site.

Testing LinkedIn Social Login

To test LinkedIn social login, complete the following procedure:

  1. Do one of the following:
    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.
       
  2. From the Test page, click the LinkedIn icon:

  1. In the Authorize | LinkedIn window, logon using a valid LinkedIn account:

  1. If login succeeds, information returned from the LinkedIn profile is displayed in the API response preview field:

The returned profile information will vary depending on:

  • The LinkedIn account used in the test.
  • The profile information you requested for LinkedIn.

You can verify LinkedIn profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

  1. From the Configure Providers page, click LinkedIn.
  2. Profile information returned from LinkedIn is displayed onscreen. For example:

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a LinkedIn account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

On the Configure Providers page, click Ask to turn off the information request.

See Also


Assigning a Different LinkedIn App for Social Login

If you want to use a different LinkedIn app or if you need to change your existing app, you must update the LinkedIn provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

  1. From the Configure Providers page, click LinkedIn.
  2. Click the green Configured button to display the LinkedIn is currently enabled dialog box:

  1. To change the LinkedIn configuration, click Modify these settings.
  2. In the LinkedIn dialog box, change the API Key and/or Secret Key as needed, and then click Save:

Although you can modify your LinkedIn settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as LinkedIn shows them.

This means that you cannot “unconfigure” the provider: once configured, the LinkedIn icon will always be shown as green (i.e., configured) in the Janrain Dashboard.


Removing LinkedIn as a Social Login Provider

If you no longer want to use LinkedIn for social login, you can remove LinkedIn as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the LinkedIn icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. LinkedIn no longer appears in the sign-on widget.
Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.