Introduction
By integrating your Docebo learning platform with Gmail, you can bind your Docebo user profiles with their corresponding Gmail accounts. This way, every user inside your platform can sign into their Docebo platforms without needing to manually enter the credentials. This manual will show you the integration in both your Docebo learning platform as well as from Gmail's side.
The Gmail integration with Docebo only works with Gmail accounts. You cannot use your Google Apps Developer account for this integration.
Activating the Gmail App in Docebo
Activate the Gmail 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 Gmail App in Docebo
Once the Gmail app is activated in your platform, you can access it by pressing the gear icon in the top right corner of your platform to reach the Admin Menu. In the Admin Menu, find the Gmail section and press the Settings subitem.
Now you need to insert your Consumer Key and Consumer Secret into the corresponding text boxes. This information is present in your Gmail account developers panel. Once you're finished, press Save Changes to complete the integration. If you need help retrieving this information from Gmail, please refer to the section below.
Configuring the Integration in Gmail
Begin by logging into your Gmail account. Once you're on the Google API's console, click the Create Project link in the Dashboard screen. Complete the information on the following page, then press the Create button.
Now, from the left sidebar, choose the Credentials tab. From this page, access the OAuth Consent Screen tab from the top. On the following screen select Internal and click Create.
On the next screen add your email address, product name, authorized domain, and support email addresses into the corresponding text boxes. Then, press Save. Now you can create your Client ID by clicking on the Credentials tab again. At the top of the screen, click Create Credentials and select OAuth Client ID. In the Application Type dropdown menu, select Web Application. Then, type in the name of your web application, as desired.
Below, in the Authorized redirect URIs section, copy and paste the Redirect URL that you found on the Gmail Settings page in your Docebo platform (http://mylms.docebo.info/hybridauth/?hauth.done=Google). Then, for the Authorized Javascripts Origins URL, type in the URL of your Docebo platform. If you use a custom domain please remember to insert the custom domain URL.
The form should look as follows:
Press Create when finished. A pop-up box should appear with your Client ID and Client Secret.
In order for your users to be able to login to their learning platforms with their Gmail credentials, their Gmail addresses must correspond with an email address registered in Docebo. Then, your users can log into the platform by pressing the Gmail icon on the platform's sign in page.
Next, return to the Gmail Settings page in Docebo to fill in the Client ID key and Client Secret. The consumer key is the Client ID. The consumer secret is the client secret. When you're finished, press Save Changes to complete the integration. You can find your Google credentials on your Google Admin Console in the Credentials tab whenever you need them.
Best Practices
When an SSO integration and a custom domain 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.