Set up your user integration in the Integration Hub with Microsoft Entra ID.
Create a New App in Microsoft Entra Admin Center
Let's start by creating a dedicated app in Entra that Learningbank can connect to 🚀
Open the Microsoft Entra admin center
Expand the Entra ID category in the left side panel
Click on Enterprise apps in the Entra ID category
Click on All applications in the Manage category of the secondary left side panel
Click on New application in the top bar
Click on Create your own application at the top of the page
We recommend giving the application the following name: Learningbank
Select Integrate any other application you don't find in the gallery (Non-gallery)
Click the Create button
Good to know💭 We recommend giving the application the name Learningbank, to make sure you in the future remember the functionality of the application.
Add Permissions to the App
Now we need to make sure the app has the right permissions to read your users and groups 🔐
In the left side panel, click on App registrations in the Entra ID category
In the secondary top bar, switch to All applications
Search for the name given to the application (recommended: Learningbank) and click on the name
Click on API Permissions in the Manage category of the secondary left side panel
Click on Add a permission
Click on Microsoft Graph in the right side panel
Select Application permissions
Add the following permissions:
User.Read.All
Allows Learningbank to read the users and their data.
User-LifecycleInfo.Read.All
Allows Learningbank to read if a user is active or inactive.
Group.Read.All
Allows Learningbank to read the security groups of a user, to allow you to more easily filter which users are imported to Learningbank
Click the Add permissions button
Click Grant admin consent next to the Add a permission button
Confirm the dialog by clicking Yes
Copy Your Tenant ID and Client ID
Almost there! Now let's grab the IDs that Learningbank needs to identify your organization. 🎯
Switch back to Overview in the secondary left side panel
Expand the Essentials section in the main panel
Copy both IDs and paste them into the integration setup in Learningbank:
Application (client) ID
Directory (tenant) ID
Set Up a Client Secret
To authenticate securely, you need to create a client secret. Keep this value safe - you'll only see it once! ⚠️
Click on Add a certificate or secret next to Client credentials
Navigate to the Client secrets tab in the secondary top panel
Click +New client secret
Select an appropriate Expires duration
Click the Add button
Copy the Value of the secret and paste it into the integration setup in Learningbank
📣IMPORTANT: Make sure to copy the secret Value immediately after creation. Once you navigate away from the page, it will no longer be visible.
Do not share this secret with anyone other than Learningbank.
Enabling the Integration
An integration always defaults to being disabled. Before enabling a new integration, we always recommend making sure all communication settings are disabled.
If you are unsure of anything, please reach out to us before enabling.
Include a Specific Security Group (Optional, but recommended)
Only want to sync a specific group of users to Learningbank? No problem - you can use a security group to control exactly who gets imported. 👥
When setting up the integration in Learningbank, navigate to the Department tab on the integration, and type in the name of the security group. Remember to hit include when adding it. Only users within that group will be imported.
