This article shows you how to integrate Docebo 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.
Configuring your Google Apps Account
Log into your Google Work 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 this URL (https://console.cloud.google.com/cloud-resource-manager), and 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 (optional as it’s already pre-populated).
Then click on the Add URI button under Authorized Redirect URIs and enter the following URL, replacing “mylms.docebosaas.com” with URL of your LMS:
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.
Configuring Google Apps in Docebo
Log into your platform as the Superadmin, then select the Admin Menu from the gear icon in the top right corner of your homepage. Then, press the Add New Apps button.
Once you’re on the Apps & Features page, select the Single Sign On tab from the tab menu on the left side of the page. Then, find the Google Apps app in the list of apps in the tab, and press the Try It For Free button in the app’s row. In the pop up box, read more information about the integration. When ready, press Try It For Free. The app is now activated in your 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 here the domain of your Google Apps
- 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
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.
Tips & Tricks
- 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.
- If Google Apps and Slack are working on the same user or users, the two integrations cannot be used at the same time.