Introduction

This article shows you how to integrate the Docebo Learn platform with your Google Apps account so that you can import users from your Google Apps Database and allow them to access the platform with their Google Apps credentials.

Tip: If Google Apps and Slack are working on the same user or users, the two integrations cannot be used at the same time.

Configuring your Google Apps account

Log into your Google Workspace account as the admin, then access your Google Apps Admin page and click Admin Console. A new tab/page will open, listing all the areas where you can operate. Click the Security section.

On the Security page, select API Reference and flag the option to Enable API Access. Now open the Google Cloud Services Manage Resources page (link opens in a new window):

https://console.cloud.google.com/cloud-resource-manager

Next, click Create Project from the page upper bar. Define a project name, select the organization and location and press Create to start the creation procedure. Please note that the project ID is automatically assigned to your project by Google, but you can modify it by pressing Edit in the project ID line.

Once the project has been created, it will be listed in the Notifications dropdown menu. Click on the Select Project link below the project name to access the project's main page. From here, go to the APIs section and click Go to APIs Overview to access the APIs & Services Dashboard. Move to the Library tab and look for the Admin SDK API from the search bar. Click on the Admin SDK API card.

Press the Enable button in the section header to enable API calls. Now the API is enabled, but you have to create credentials in order to use it. To do so, press Create Credentials from the page upper bar.

On the Credentials page, set the following configurations: in the Which API are you using? field select Admin SDK and in the What data will you be accessing? field select User data and click Next. On the next screen enter the name of the application asking for consent, choose the support email address from the drop-down menu, optionally add an application logo image and enter the developer email address, then click Save and Continue.

On the next screen, you can optionally add scopes to your application then click Save and Continue.

In the next section choose Web Application from the Application Type drop-down menu:

You can give the web application a name at this point (this is optional as it’s already pre-populated).

Then, click on the Add URI button under Authorized Javascript Origins and enter the URL of your LMS. If you are using a custom domain, you must insert the custom domain URL.

Next, click on the Add URI button under Authorized Redirect URIs and enter the following URL, replacing mylms.docebosaas.com with the URL of your platform:

https://mylms.docebosaas.com/lms/index.php?r=GoogleappsApp/GoogleappsApp/googleappsRedirect

Next, click on Create to move to the next step.

You will now be presented with your OAuth credentials which you can download or copy to your clipboard.

The process on the Google side of the integration is now complete. The system will ask if you want to download your credentials information and you can do so, if desired. Your credential information is, however, available for retrieval in the system whenever you need it. Press Done to complete the process.

Activating Google Apps in Docebo

Activate the Google Apps 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 Google Apps in 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.

In order to configure the App, go to the Admin Menu from the gear icon in the top right corner of your homepage, then find the Google Apps section and press the Manage item.

On the settings page, fill in the text boxes as follows:

Google Apps Domain

Type the domain of your Google Apps here. Omit the https:// and www prefixes, and do not append any slashes. For example, for the domain https://www.mydomainname.com/ enter just mydomainname.com 

Consumer Key

The Client ID previously generated in the Google configuration area

Consumer Secret

The Client Secret Field from the Google configuration area

The Redirect URL will be automatically generated for you based on your domain name. Press Save Changes to complete the configuration.

Importing Google Apps users into Docebo

Tip: The only fields that can be imported into Docebo during user provisioning are name and email. Additional fields or attributes should be imported in a different way.

To import users from Google Apps into your Docebo platform, access the Admin Menu from the gear icon in the top right corner of your homepage, and select Users from the E-Learning section. On the Users main page, click on Import & Manage from on the top right corner and select Import Users from Google Apps from the list of available options.

Proceed with the process by allowing access to your Google contacts. The system displays the number of contacts that will be imported. Select Import Users from Google Apps to complete the process.

Please Note: When importing users, Google Apps users having the same username as existing Docebo users will not be imported. Users imported from Google Apps will be able to access the platform by selecting the Google Apps button on the Login Page.