--- title: How to synchronise participants via Microsoft Entra (previously Active Directory)? description: In this article, we show you how to sync the master data of your users from Active Directory / Entra with reteach. --- [Skip to content](https://support.reteach.com/en/how-to-synchronise-participants-via-microsoft-entra-previously-active-directory#main-content) - [English](https://support.reteach.com/en/how-to-synchronise-participants-via-microsoft-entra-previously-active-directory) - [Deutsch](https://support.reteach.com/wie-synchronisiere-ich-meine-teilnehmenden-über-active-directory-entra-scim) English Show submenu for translations [Customer portal](https://support.reteach.com/anfragen?hsLang=en) [![1-logo-reteach-farbe@4x](https://support.reteach.com/hs-fs/hubfs/1-logo-reteach-farbe@4x.webp?width=188&height=50&name=1-logo-reteach-farbe@4x.webp)](https://www.reteach.com) Open main navigation Close main navigation - - [English](https://support.reteach.com/en/how-to-synchronise-participants-via-microsoft-entra-previously-active-directory) - [Deutsch](https://support.reteach.com/wie-synchronisiere-ich-meine-teilnehmenden-über-active-directory-entra-scim) English Show submenu for translations - [Customer portal](https://support.reteach.com/anfragen) - Contact us Contact us Welcome to the help-center. Insert a keyword to find a solution: - There are no suggestions because the search field is empty. 1. [reteach help-center](https://support.reteach.com/en?hsLang=en) 2. [Settings](https://support.reteach.com/en/settings?hsLang=en) 3. [Automatisations](https://support.reteach.com/en/settings?hsLang=en#automatisations) # How to synchronise participants via Microsoft Entra (previously Active Directory)? ## How participant data from Microsoft Entra can be synchronised with reteach In this chapter we show how to connect reteach with Microsoft Entra (previously Microsoft Active Directory) to synchronise participants and groups with reteach. The interface implements the SCIM 2.0 Standard and is therefore usable for many user directories.   The interface can synchronise the following participant data: - User name - Email - First name - Surname - Gender - Date of Birth - Language - Company - Department - Manager - Notification email - Authentification method - Activity status   Furthermore, the interface transfers the following group data: - Group name - Group affiliation of participants   Hint: It is recommended to combine the synchronisation with [Single-Sign-On (SSO)](https://support.reteach.com/single-sign-on-einstellungen-f%C3%BCr-teilnehmerinnen?hsLang=en) to achieve a smooth user experience. The following steps are necessary to enable the synchronisation: ### 1) Creating an application in Active Directory Create an application in Active Directory and assign it an unique name. ![Active Directory](https://support.reteach.com/hs-fs/hubfs/image-png-Aug-08-2023-01-33-02-3514-PM.png?width=387&height=624&name=image-png-Aug-08-2023-01-33-02-3514-PM.png) Click on Provisioning to configure the synchronisation: ![Provisioning](https://support.reteach.com/hubfs/image-png-Aug-08-2023-01-36-31-8440-PM.png) ### 2) Enter access data Activate the SCIM integration [HERE](https://app.reteach.io/settings/integrations/scim) and copy the values of URL and Token into the asisgned fields in the application by clicking on them. Copying values from reteach:![Synchronizing Participants & groups](https://support.reteach.com/hs-fs/hubfs/Screenshot%202024-08-13%20at%2015.11.10.png?width=670&height=236&name=Screenshot%202024-08-13%20at%2015.11.10.png) Click on Provisioning in the previously created application: ![Provisioning](https://support.reteach.com/hubfs/image-png-Aug-08-2023-01-38-55-8944-PM.png) Enter the values URL and Token from reteach here: ![URL & Token](https://support.reteach.com/hubfs/image-png-Aug-08-2023-01-44-37-0946-PM.png) ### 3) Configure attribute assignment Next, the attributes need to be adjusted in the application. For this, enter the start page of the application and click on "Edit attribute mapping". ![Academy provisioning overview](https://support.reteach.com/hs-fs/hubfs/image-png-Aug-08-2023-02-12-26-1736-PM.png?width=670&height=251&name=image-png-Aug-08-2023-02-12-26-1736-PM.png) The following attributes are transferred via our interface. When assigning the attributes, ensure the desired attributes have been configured. | **customappsso-Attribut** | **Beschreibung** | | | --- | --- | --- | | userName | User name | | | emails\[type eq "work"\].value | Email | | | active | Is the user active or blocked? | | | preferredLanguage | Language | | | name.givenName | First name | | | name.familyName | Surname | | | name.formatted | Profile name | | | externalId | ID | | | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization | Company | | | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department | Department | | | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager | Manager | | | urn:ietf:params:scim:schemas:extension:reteach:2.0:User:notificationMail | Notification email (managers) | | | urn:ietf:params:scim:schemas:extension:reteach:2.0:User:gender | Gender  Possible values: MALE, FEMALE, DIVERSE | | | urn:ietf:params:scim:schemas:extension:reteach:2.0:User:birthDate | Date of birth | | | urn:ietf:params:scim:schemas:extension:reteach:2.0:User:authenticationMethod | Authentificaion method  Possible values: SSO, DEFAULT Standard: SSO | | To transfer the attributes notification email, gender, date of birth or authentification method, the attributes have to be added to the attribute list. This can be configured via the following link: ![Attribute Mapping 2](https://support.reteach.com/hs-fs/hubfs/image-png-Aug-08-2023-02-16-33-1454-PM.png?width=670&height=447&name=image-png-Aug-08-2023-02-16-33-1454-PM.png)   The attributes can be added here: ![Attribute Mapping 3](https://support.reteach.com/hs-fs/hubfs/image-png-Aug-08-2023-02-18-53-4620-PM.png?width=670&height=353&name=image-png-Aug-08-2023-02-18-53-4620-PM.png) To match already existing participants in reteach with participants in Microsoft Active Directory / Entra, the email address should be used, too. To achieve this, click on the "mail" attribute in the attribute list and adjust the values like we have here: ![Edit Attribute 1](https://support.reteach.com/hs-fs/hubfs/image-png-Sep-13-2023-01-04-07-8236-PM.png?width=670&height=521&name=image-png-Sep-13-2023-01-04-07-8236-PM.png) The end result should look like this: ![Attribute Mapping X](https://support.reteach.com/hs-fs/hubfs/image-png-Sep-13-2023-01-08-12-4372-PM.png?width=670&height=528&name=image-png-Sep-13-2023-01-08-12-4372-PM.png) ### 4) Adding groups and participants Under "Users and groups" you can delegate groups or participants to the application. Only if participants are entered here, they will be synchronised. ![Users and groups](https://support.reteach.com/hs-fs/hubfs/image-png-Aug-08-2023-02-22-29-9062-PM.png?width=670&height=269&name=image-png-Aug-08-2023-02-22-29-9062-PM.png) ### 5) Testing of the Provision (Synchronisation) It is best to test the synchronisation via the tab "Provision on demand" to eliminate potential errors. Select single participants or groups and start the synchronisation. Check, whether participants have been added or updated correctly in [reteach -\> Participants](https://app.reteach.io/customer). ![Provision on demand](https://support.reteach.com/hs-fs/hubfs/image-png-Aug-08-2023-02-24-06-2777-PM.png?width=670&height=270&name=image-png-Aug-08-2023-02-24-06-2777-PM.png) ### 6) Activating the Provision (Synchronisation) By clicking on "Start provisioning" on the start page of the application you can start the synchronisation. The update interval is set to 40 minutes by default. The status and logs can be followed on this page. ![Start provisioning](https://support.reteach.com/hubfs/image-png-Aug-08-2023-02-27-24-4565-PM.png) - [Courses](https://support.reteach.com/en/courses?hsLang=en#main-content) - [Categories](https://support.reteach.com/en/courses?hsLang=en#categories) - [Create and manage courses](https://support.reteach.com/en/courses?hsLang=en#create-and-manage-courses) - [Lessons](https://support.reteach.com/en/courses?hsLang=en#lessons) - [Course Catalog](https://support.reteach.com/en/courses?hsLang=en#course-catalog) - [Certificates](https://support.reteach.com/en/courses?hsLang=en#certificates) - [Live trainings and sessions](https://support.reteach.com/en/courses?hsLang=en#live-trainings-and-sessions) - [Participants](https://support.reteach.com/en/participants?hsLang=en#main-content) - [Filters and Tags](https://support.reteach.com/en/participants?hsLang=en#filters-and-tags) - [Mailings](https://support.reteach.com/en/participants?hsLang=en#mailings) - [Help for your participants](https://support.reteach.com/en/participants?hsLang=en#help-for-your-participants) - [Export participant data](https://support.reteach.com/en/participants?hsLang=en#export-participant-data) - [Managing participants](https://support.reteach.com/en/participants?hsLang=en#managing-participants) - [Learning Progress & Analytics](https://support.reteach.com/en/learning-progress-analytics?hsLang=en) - [E-Commerce](https://support.reteach.com/en/e-commerce?hsLang=en#main-content) - [Sell courses](https://support.reteach.com/en/e-commerce?hsLang=en#sell-courses) - [Stripe](https://support.reteach.com/en/e-commerce?hsLang=en#stripe) - [Orders](https://support.reteach.com/en/e-commerce?hsLang=en#orders) - [Account & Admin](https://support.reteach.com/en/account-admin?hsLang=en#main-content) - [Tariff](https://support.reteach.com/en/account-admin?hsLang=en#tariff) - [Administrators](https://support.reteach.com/en/account-admin?hsLang=en#administrators) - [Legal & Data Protection](https://support.reteach.com/en/account-admin?hsLang=en#legal-data-protection) - [Settings](https://support.reteach.com/en/settings?hsLang=en#main-content) - [Personalisation of your academy](https://support.reteach.com/en/settings?hsLang=en#personalisation-of-your-academy) - [Zoom & MS Teams Integrations](https://support.reteach.com/en/settings?hsLang=en#zoom-ms-teams-integrations) - [Useful information](https://support.reteach.com/en/settings?hsLang=en#useful-information) - [Automatisations](https://support.reteach.com/en/settings?hsLang=en#automatisations) - [Translation Tips](https://support.reteach.com/en/translation-tips?hsLang=en) [![reteach Die Lernplattform für den Mittelstand](https://support.reteach.com/hubfs/logo.svg "reteach Die Lernplattform für den Mittelstand")](https://www.reteach.com/) Haben Sie noch Fragen? Kontaktieren Sie unseren Support unter: support@reteach.com [mailto:support@reteach.com](mailto:support@reteach.com) Copyright © 2025, reteach by Susell GmbH