Introduction

By integrating your Docebo Learning Management System with Facebook, your users can log into their Docebo platforms using their Facebook login credentials. This article provides a step-by-step guide for your integration.

Please note: Be sure to double-check that an email address used to log into Facebook corresponds with a user that already exists in your Docebo platform (the username and the password don’t need to match, but the email address should belong to a pre-existing user).

This way, a user can proceed with access to the platform without errors. If the email address used for Facebook does not correspond with a user in Docebo, then a user will not be able to access the platform using Facebook credentials.

Creating a Facebook app for Docebo

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.

Begin by opening the link: https://developers.facebook.com/apps (link opens in a new tab). You may be prompted to log into your Facebook account. Once you're on the Apps page, press the Add a New App button.

In the pop-up box, fill in the App's Display Name and the Contact Email. Then, press Create App ID (you may be asked to fill out some security questions).

Once the app is created, you will be redirected to the app's main page on Facebook. Hover your mouse over the Facebook Login item, then press Set Up. On the next page, select the Web option. Move to the Site URL textbox and insert your platform Custom Domain URL if you are using a custom domain, configured in Domain Management, or the docebosaas URL if you do not have a custom domain. Press Save Changes, then move to the Settings option of the Facebook Login menu.

In the Valid Oauth redirect URIs text field, type the installation URL followed by a second endpoint, composed in the following way:

https://{{lms base url}}/lms/index.php?r=socialLogin/fbLogin

where {{lms base url}} is the target installation address. See the above screenshot as an example.

Please note: Use Strict Mode for Redirect URIs and Enforce HTTPS are enabled by default for all the Facebook Login Apps created after March 2018, it is not possible to disable them.

Select now the Settings menu option on the left panel, and click on Basic to define the Privacy Policy URL. This field is mandatory for a proper configuration.

When the configuration is over, activate your app by changing its status from In Development to Live by means of the dedicated toggle.

Select a category for your app, them press Confirm to finalize the status change.

Activating the Facebook app in Docebo

Activate the Facebook 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.

Configuring the Facebook app in Docebo

To reach the app, access the Admin Menu again, then press the Settings item in the Facebook section. On the Settings page, insert your Facebook API Code and your Facebook Secret Code into the corresponding text boxes. This information came from the Settings page of the app you created on Facebook (please see above if you need to know how to retrieve the information again).

When you're finished, press Save Changes. Your users can now log into their Docebo platforms using their Facebook login credentials. To see if everything is working properly, log out of your platform. On the login page, you should see the Facebook icon in the Sign In section.