---
title: Configuring Auto Provisioning in Microsoft Azure EntraID with SCIM
description: SCIM allows you to synchronise user information between EntraAD and EdApp.
---

[Skip to content](https://support.edapp.com/configuring-auto-provisioning-in-azure-ad-with-scim#main-content)

English

Show submenu for translations

![EdApp - logo dark mode-1.png\]](https://support.edapp.com/hs-fs/hubfs/EdApp%20-%20logo%20dark%20mode-1.png?height=40&name=EdApp%20-%20logo%20dark%20mode-1.png)

- [Default HubSpot Blog](https://edapp-5741180.hs-sites.com/blog)

Open main navigation

Close main navigation

- [Default HubSpot Blog](https://edapp-5741180.hs-sites.com/blog)
- English
  
  Show submenu for translations
- [edapp.com](https://www.edapp.com/)

[edapp.com](https://www.edapp.com/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.edapp.com/?hsLang=en)
2. [Technical / API documentation](https://support.edapp.com/technical-api-documentation?hsLang=en)
3. [Single Sign On for the Learner's Portal](https://support.edapp.com/technical-api-documentation?hsLang=en#single-sign-on-for-the-learners-portal)

# Configuring Auto Provisioning in Microsoft Azure EntraID with SCIM

## SCIM allows you to synchronise user information between EntraAD and EdApp.

We only support importing users from EntraID into EdApp, we never send back information to EntraID.

### Step 1 - Enable SCIM in EdApp

1. Access the [integrations page](https://admin.edapp.com/integrations) from the admin portal then select SCIM
2. Select the setup tab to reveal configuration options.
3. Choose if you want to **send welcome emails** to users created through SCIM.   
   *We recommend leaving this option off unless you use SCIM independent of SSO.*
4. Choose whether to **delete inactive users**.  
   *Deleting users is irreversible.*
5. Click **Connect** to enable the integration

![](https://support.edapp.com/hs-fs/hubfs/image-png-Feb-21-2023-05-11-23-4237-PM.png?width=576&height=343&name=image-png-Feb-21-2023-05-11-23-4237-PM.png)

### Step 2 - Enable SCIM provisioning in Microsoft Azure EntraID

To enable automatic provisioning of users

- Go to the Azure EntraID portal and select [Enterprise applications](https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null)
- Select the application that you have created when setting up SSO with EdApp ([Configuring SSO with Azure](https://support.edapp.com/configuring-sso-with-azure-active-directory-ad?hsLang=en))
- Enable "provisioning"
- Set the "Provisioning mode" to automatic and populate the Tenant URL field with "https://edappintegrations.com/scim/v2"
- In the secret token field paste the API key that can be found at: [https://admin.edapp.com/app-settings/api](https://admin.edapp.com/app-settings/api)

![](https://support.edapp.com/hs-fs/hubfs/image-png-Jan-30-2023-02-59-56-8591-AM.png?width=688&height=528&name=image-png-Jan-30-2023-02-59-56-8591-AM.png)

- Click the "Test Connection" button to see if the setup is successful.
- Save the settings.

### Step 3 - Configure the mappings between EdApp and Azure EntraID

To setup custom fields, expand the mappings section and click "Provision Active Directory Users".

![](https://support.edapp.com/hs-fs/hubfs/image-png-Dec-14-2023-09-46-30-5632-PM.png?width=688&height=273&name=image-png-Dec-14-2023-09-46-30-5632-PM.png)

The next thing to setup is the mappings between the fields in EntraID and EdApp. Click the "Provision Azure Active Directory Users" link.

By default there are a lot of mappings of which most we will not be using. Delete all the mappings that are not needed and only leave the ones as shown below.

![](https://support.edapp.com/hs-fs/hubfs/image-png-Dec-14-2023-09-18-36-6278-PM.png?width=680&height=321&name=image-png-Dec-14-2023-09-18-36-6278-PM.png)

- Save the mappings with the "Save" button at the top.
- Scroll to the bottom of the page and tick the "Show advanced options" box.
- Next, click the "Edit attribute list for customappsso" link.
- In this screen also delete all the fields that are not needed and leave the ones as shown below.  
  ![](https://support.edapp.com/hs-fs/hubfs/image-png-Dec-18-2023-04-54-06-0638-AM.png?width=652&height=381&name=image-png-Dec-18-2023-04-54-06-0638-AM.png)
- Save the fields with the "Save" button at the top.
- Now, add a new mapping by clicking the "Add New Mapping" link.
- For the "Source attribute" select "objectId" from the list and for the "Target attribute" select "externalId".
- Click "Ok" at the bottom of the page.
- Click "Save" at the top of the page.
- Custom fields

If you have another identifier in your EntraID system that uniquely identifies a users, you can also use that as the "externalId"

### Step 4 - Adding custom fields

With mappings you can also populate [custom fields](https://support.edapp.com/custom-fields?hsLang=en) in EdApp.

Assuming that the custom fields have been setup in EdApp, we now need to add them to the "customappsso" by clicking the "Edit attribute list for customappsso" link. In this example we are adding the "department" field.

The name of the attribute needs to have a specific format. "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:{custom field name}", see example below. Make sure to use the "Field Name" from EdApp, not the "Field Label".

![](https://support.edapp.com/hs-fs/hubfs/image-png-Dec-14-2023-09-31-36-9353-PM.png?width=688&height=482&name=image-png-Dec-14-2023-09-31-36-9353-PM.png)

Click Save.

Please note that we only support fields of type "string"

Now we can add the mapping between the EdApp field and the newly added attribute by clicking "Add New Mapping".

In this example we choose the "department" as the "Source attribute" and the newly added attribute as the "Target" attribute.

![](https://support.edapp.com/hs-fs/hubfs/image-png-Dec-14-2023-09-36-58-0080-PM.png?width=688&height=364&name=image-png-Dec-14-2023-09-36-58-0080-PM.png)

Click Ok and Save.

When the newly added attribute does not show up in the drop down list, refresh the page as that will refresh the values.

Please note that we only support "direct" mappings

 

- [Getting started](https://support.edapp.com/getting-started?hsLang=en#main-content)

    - [Get Started in 5 Minutes](https://support.edapp.com/getting-started?hsLang=en#get-started-in-5-minutes)
    - [Lessons & Courses](https://support.edapp.com/getting-started?hsLang=en#lessons-courses)
    - [Basic User Management](https://support.edapp.com/getting-started?hsLang=en#basic-user-management)
    - [Course Library](https://support.edapp.com/getting-started?hsLang=en#course-library)
    - [Definitions](https://support.edapp.com/getting-started?hsLang=en#definitions)
- [Admin portal](https://support.edapp.com/admin-portal?hsLang=en#main-content)

    - [Advanced User Management](https://support.edapp.com/admin-portal?hsLang=en#advanced-user-management)
    - [Lesson Management](https://support.edapp.com/admin-portal?hsLang=en#lesson-management)
    - [Course Management](https://support.edapp.com/admin-portal?hsLang=en#course-management)
    - [App Customisation](https://support.edapp.com/admin-portal?hsLang=en#app-customisation)
    - [Peer Learning](https://support.edapp.com/admin-portal?hsLang=en#peer-learning)
    - [Engagement](https://support.edapp.com/admin-portal?hsLang=en#engagement)
    - [Analytics](https://support.edapp.com/admin-portal?hsLang=en#analytics)
    - [Features](https://support.edapp.com/admin-portal?hsLang=en#features)
    - [EducateAll](https://support.edapp.com/admin-portal?hsLang=en#educateall)
    - [Sharing Content](https://support.edapp.com/admin-portal?hsLang=en#sharing-content)
    - [Integrations](https://support.edapp.com/admin-portal?hsLang=en#integrations)
- [Learner's app](https://support.edapp.com/learners-app?hsLang=en#main-content)

    - [Logging In](https://support.edapp.com/learners-app?hsLang=en#logging-in)
    - [Taking Courses](https://support.edapp.com/learners-app?hsLang=en#taking-courses)
    - [Features For Learners](https://support.edapp.com/learners-app?hsLang=en#features-for-learners)
    - [Extras](https://support.edapp.com/learners-app?hsLang=en#extras)
    - [Star Bar](https://support.edapp.com/learners-app?hsLang=en#star-bar)
- [Creator Tool](https://support.edapp.com/creator-tool?hsLang=en#main-content)

    - [Branding](https://support.edapp.com/creator-tool?hsLang=en#branding)
    - [Templates](https://support.edapp.com/creator-tool?hsLang=en#templates)
    - [Course & Lesson Configurations](https://support.edapp.com/creator-tool?hsLang=en#course-lesson-configurations)
    - [Copying Slides/Lessons/Courses](https://support.edapp.com/creator-tool?hsLang=en#copying-slides-lessons-courses)
    - [Translations](https://support.edapp.com/creator-tool?hsLang=en#translations)
    - [Content](https://support.edapp.com/creator-tool?hsLang=en#content)
- [Tips and tricks](https://support.edapp.com/tips-and-tricks?hsLang=en#main-content)

    - [Learning Programme Management](https://support.edapp.com/tips-and-tricks?hsLang=en#learning-programme-management)
    - [Authoring](https://support.edapp.com/tips-and-tricks?hsLang=en#authoring)
    - [Best Practices](https://support.edapp.com/tips-and-tricks?hsLang=en#best-practices)
    - [Programme Success](https://support.edapp.com/tips-and-tricks?hsLang=en#programme-success)
    - [Engagement](https://support.edapp.com/tips-and-tricks?hsLang=en#engagement)
    - [Launch Kit](https://support.edapp.com/tips-and-tricks?hsLang=en#launch-kit)
- [FAQ](https://support.edapp.com/faq?hsLang=en#main-content)

    - [Lessons & Courseware](https://support.edapp.com/faq?hsLang=en#lessons-courseware)
    - [Authoring](https://support.edapp.com/faq?hsLang=en#authoring)
    - [User Registration & Management](https://support.edapp.com/faq?hsLang=en#user-registration-management)
    - [Display](https://support.edapp.com/faq?hsLang=en#display)
    - [Engagement](https://support.edapp.com/faq?hsLang=en#engagement)
    - [Peer Learning](https://support.edapp.com/faq?hsLang=en#peer-learning)
    - [Knowledge Performance](https://support.edapp.com/faq?hsLang=en#knowledge-performance)
    - [Analytics](https://support.edapp.com/faq?hsLang=en#analytics)
    - [System & Technical Support](https://support.edapp.com/faq?hsLang=en#system-technical-support)
    - [Subscriptions & Pricing](https://support.edapp.com/faq?hsLang=en#subscriptions-pricing)
    - [Educate All](https://support.edapp.com/faq?hsLang=en#educate-all)
    - [Contact & Support](https://support.edapp.com/faq?hsLang=en#contact-support)
- [Webinars](https://support.edapp.com/webinars?hsLang=en)
- [Technical / API documentation](https://support.edapp.com/technical-api-documentation?hsLang=en#main-content)

    - [Single Sign On for the Learner's Portal](https://support.edapp.com/technical-api-documentation?hsLang=en#single-sign-on-for-the-learners-portal)
    - [Single Sign-on for Admin Portal](https://support.edapp.com/technical-api-documentation?hsLang=en#single-sign-on-for-admin-portal)
    - [Integrations](https://support.edapp.com/technical-api-documentation?hsLang=en#integrations)
    - [API](https://support.edapp.com/technical-api-documentation?hsLang=en#api)
- [Legal documentation](https://support.edapp.com/legal-documentation?hsLang=en#main-content)

    - [Third Party Gateway](https://support.edapp.com/legal-documentation?hsLang=en#third-party-gateway)
    - [Privacy & Terms](https://support.edapp.com/legal-documentation?hsLang=en#privacy-terms)
- [Troubleshooting](https://support.edapp.com/troubleshooting?hsLang=en)
- [EdApp to SC Migration](https://support.edapp.com/edapp-to-sc-migration?hsLang=en)

- [Default HubSpot Blog](https://edapp-5741180.hs-sites.com/blog)

[![Chill listening crop-3](https://support.edapp.com/hs-fs/hubfs/EdApp-AIP%20icon-216x216.jpg?width=32&height=32&name=EdApp-AIP%20icon-216x216.jpg "Chill listening crop-3")](http://edapp.com)

EdApp Help Center

<https://www.linkedin.com/company/edapp-micro-learning/> <https://www.instagram.com/thisisedapp/?hl=en> <https://www.facebook.com/thisisedapp> <https://www.youtube.com/channel/UCgDNMep0ASddBGi7HV5-dJg>

Copyright © 2026, EdApp Pty Ltd