Introduction
By integrating your Docebo Learning Management System with LinkedIn, your users can log into their Docebo platforms using their LinkedIn login credentials. This article will provide a step-by-step guide for your integration.
Please note: The email address used to log in to LinkedIn must correspond to a user that already exists in your Docebo platform. The username and password do not need to match, but the email address must belong to a pre-existing user. If the email address does not match an existing Docebo user, the user will not be able to log in to the platform using their LinkedIn credentials.
You do not need a LinkedIn Premium account for this integration.
Best practice: When an SSO integration and a custom domain, configured in Domain Management, are set up at the same time, it is strongly suggested to configure the custom domain first. The endpoint URLs needed for the SSO integration are dependent on the URL of the platform.
Creating an app in LinkedIn for Docebo
Begin by logging into your LinkedIn account, then proceed to the LinkedIn Developer site (opens in a new window) at:
https://developer.linkedin.comAt the top of the page, select the My Apps tab in the action bar, then press the Create Application button once you're in the My Apps tab. Then, fill in all of the information.
Required fields are App Name, LinkedIn Page (This can be the URL to your company page or you can enter your company name and select the appropriate entry in the drop-down results.), Company Logo and acceptance of the terms and conditions. Please note that if you do not have a company page you can click on the Create a new LinkedIn page link immediately below the LinkedIn Page text box to create one.
Now, you will be redirected to the app's Settings page in LinkedIn. Move to the Auth tab to see the authentication keys (Client ID and Client Secret) that you will need to insert into Docebo to complete the integration.
Still in the Auth tab, move to the OAuth 2.0 settings section. First, confirm that the OAuth 2.0 scopes listed include openid, profile and email. These scopes are added automatically when you enable the Sign In with LinkedIn using OpenID Connect product. Next, add the redirect URL in the Authorized Redirect URLs field, using the following format:
https://{your_platform_url}/lms/index.php?r=socialLogin/linkedinLoginNext, click on the Products tab and locate Sign In with LinkedIn using OpenID Connect. Click the Select button to request access to it, then refresh the page. The Select button changes to grey with the text Review in Progress.
Once LinkedIn approves the request, the product status updates to Added. The app is ready to configure when the status shows any of:
- Added
- not Pending
- Review in Progress
Please note: If the LinkedIn app is in Development mode, only administrators of that LinkedIn app can use it to log in. Make sure the account used for testing is listed as an app administrator in the LinkedIn Developer Console.
Once the Product Add Request has been reviewed and approved by LinkedIn, the selected products will automatically be added to your application.
Activating the LinkedIn app in Docebo
Activate the LinkedIn app as described in the Managing Apps & Features article of the Knowledge Base. The app is listed in the Single Sign On tab.
Once it’s activated, you can begin the configuration. Please refer to the section below to learn more.
Managing the LinkedIn app in Docebo
To reach the app, access the Navigation menu > Add-ons and integrations (jigsaw icon) > Linkedin. On the Settings page, insert the LinkedIn Client ID in the LinkedIn API Access Code field, and the Client Secret of the LinkedIn App in the LinkedIn Secret Code field.
When you’re finished, press Save Changes. You’ve now completed the integration! Your users can now log into their learning platforms using their LinkedIn login credentials. To see if everything is working properly, log out of your platform. On the login page, you should see the LinkedIn icon on the sign in form.