How To
ForgeRock Identity Cloud
Integrations

LinkedIn SSO integration with Identity Cloud for social authentication/registration

Last updated Nov 29, 2021

The purpose of this article is to provide information on configuring Identity Cloud to integrate with LinkedIn® as a social provider using OpenID Connect (OIDC) for Single Sign-On (SSO).


Overview

This article describes how to configure Identity Cloud to use LinkedIn as a social provider for authentication and/or registration. Identity Cloud provides a standards-based solution for LinkedIn social sign-on based on OIDC standards. Once configured, users can log in to applications protected by Identity Cloud using their LinkedIn credentials.

Steps involved:

  1. Configure LinkedIn
  2. Configure the Social Identity Provider in Identity Cloud
  3. Create the end-user journey
  4. Test the end-user experience

Prerequisites

Configuring LinkedIn

Disclaimer

ForgeRock assumes no responsibility for errors or omissions in the third-party software or documentation.

Create a LinkedIn app

  1. Go to the LinkedIn Developer portal.
  2. Create an app, completing (at least) the following details:
    • App name: Enter any unique name for the app.
    • LinkedIn page: Enter the LinkedIn company page URL that will be associated with this app.
    • App logo: Upload the logo that is displayed to users when they authenticate with this app.
  3. Accept LinkedIn's legal terms and click Create app.
  4. Follow the verification approval process to associate the app with the LinkedIn page.

Configure OAuth 2.0 authentication for your LinkedIn app

  1. Navigate to the app's Auth page and make a note of the Client ID and Client Secret. You'll need this information when you configure the LinkedIn social identity provider in Identity Cloud.
  2. Under OAuth 2.0 settings, add the redirect URL for your app. This is the path that users are redirected to after they have authenticated with LinkedIn, for example, https://<tenant-name>.forgeblocks.com/login.
  3. Click Update.
  4. On the Products page, select Sign In with LinkedIn.
Note

When you configure the Social Identity Provider in Identity Cloud, the r_liteprofile and r_emailaddress OAuth 2.0 scopes are added by default. Refer to the LinkedIn documentation for further information on athenticating with OAuth 2.0.

Configuring the Social Identity Provider in Identity Cloud

  1. In the Identity Cloud Admin UI, navigate to Native Consoles > Access Management > Services > Social Identity Provider Service.
  2. Choose Secondary Configurations, click Add a Secondary Configuration, and select Client configuration for LinkedIn.
  3. Complete the following configuration:
    • Name: Enter a name for the social identity provider, for example, LinkedIn.
    • Client ID: Enter the Client ID of your LinkedIn app.
    • Redirect URL: Enter the URL to go to once access has been granted. This must match the Valid OAuth Redirect URIs you configured in your LinkedIn app, for example, https://<tenant-name>.forgeblocks.com/login.
    • Scope Delimiter: Enter the scope delimiter, which is usually an empty space.
  1. Click Create.

The full configuration for the new LinkedIn social identity provider is displayed.

  1. Enter the Client Secret for your LinkedIn app in the Client Secret field.
  2. Check the rest of the default settings are correct. In particular, check the following fields:
    • Enabled: Ensure the configuration is enabled.
    • Transform Script: Ensure that LinkedIn Profile Normalization is entered. This script transforms LinkedIn credential data into a normalized form.
  3. Click Save Changes.

Creating the end-user journey

You can create custom end user journeys for social registration and sign in. These journeys will include all your enabled social identity providers, so you won't need to create different journeys for different providers.

See How do I create end user journeys for social registration and login in Identity Cloud? for information on how to create end user journeys for SSO with social providers.

Testing the end-user experience

  1. In the Identity Cloud Admin UI, navigate to Journeys.
  2. Click the journey that you want to test.
  3. Copy the Preview URL.
  4. Paste the preview URL into a browser using Incognito or Browsing mode.
  5. Follow the sign in and/or registration steps to test your journey.

For example, if LinkedIn is configured as a social identity provider for social login, end users are asked if they want to authenticate with Linkedin, similar to the screenshot below. 

See Also

Google SSO integration with Identity Cloud for social authentication/registration

Facebook SSO integration with Identity Cloud for social authentication/registration

Salesforce SSO integration with Identity Cloud for social authentication/registration

How do I create end user journeys for social registration and login in Identity Cloud?

Journeys

LinkedIn Social Identity Provider

Social Authentication


Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.