Deze handleiding helpt u bij het instellen van een applicatie in Microsoft Azure/Entra AD waarmee RESPONSUM gebruikersinformatie uit de AD kan ophalen en gebruikersaccounts voor die gebruikers kan aanmaken binnen RESPONSUM. Deze synchronisatie kan worden geconfigureerd en kan automatisch worden uitgevoerd met een ingesteld interval of handmatig vanuit het sub-menu AD-synchronisatie.
OPMERKING: Deze synchronisatieflow werkt alleen met Azure/Entra AD-configuraties. On-premise Active Directory-installaties worden niet ondersteund door RESPONSUM.
OPMERKING: Als er geen filter/filtertype is ingesteld in RESPONSUM, zal deze integratie alle gebruikers importeren die bekend zijn in uw Active Directory, inclusief externe accounts die toegang hebben via uw diensten en dus bekend zijn bij uw AD. Wees voorzichtig met het gebruik van deze integratie, aangezien deze meer gebruikers kan importeren dan u had verwacht; raadpleeg vooraf uw IT-beheerder.
OPMERKING: RESPONSUM zal gebruikers die eerder via AD-synchronisatie zijn toegevoegd archiveren bij de eerstvolgende synchronisatie als ze niet langer worden gevonden in de Active Directory.
Bekijk het in actie
Vereisten om aan de slag te gaan
- Machtigingen voor de specifieke sub-module “Gebruikersbeheer” of “AD-synchronisatieconfiguratie” als verantwoordelijke
- Kennis van uw Azure/Entra ID-omgeving en een account met verhoogde rechten om een “App-registratie” te kunnen maken
- Een idee van welke gebruikers/groepen u naar RESPONSUM wilt importeren om de set gebruikers te beperken tot degenen die nodig zijn voor het inloggen bij RESPONSUM.
Snel aan de slag
- Selecteer het menu “Instellingen” in de hoofdmenubalk (tandwielicoon)
- Beweeg met de muis over de subsectie “Gebruikersbeheer”
- Selecteer “AD-synchronisatieconfiguratie”
- Geef uw configuratie een naam
- Stel een filtertype in, ofwel “Gebruikers” (Graph-filters toegepast op het gebruikers-endpoint) of “Groepen” (Graph-filters toegepast op het groepen-endpoint)
- Opmerking: U hoeft geen “$select”-statement in de query op te nemen
- Stel een filterstatement in met behulp van de Microsoft Graph-filterstructuur (meer info hier)
- Selecteer of u de AD-synchronisatieruns wilt inplannen of handmatig wilt activeren
- Maak een app-registratie aan bij Microsoft Entra om de benodigde gegevens te verkrijgen (meer details over het aanmaken van de app hieronder)
- Vul de Client ID, Client Secret en Directory (Tenant) ID in die u van de geregistreerde app hebt gekregen
- Begin met het mappen van eigenschappen van Azure/Entra AD-gebruikers naar “Gebruiker”-velden binnen RESPONSUM
- U kunt zoveel rijen voor mapping toevoegen als nodig is om alle details te mappen
- U kunt elke aangepaste eigenschap in AD selecteren door “Aangepast veld instellen” te kiezen in de linker AD-kolom
- U kunt aangepaste velden aanmaken binnen RESPONSUM om eigenschappen naar te mappen door de “+”-knop in de rechter RESPONSUM-veldenkolom te gebruiken
- Stel de initiële eigenschappen in
- Als u in de initiële eigenschappen instelt dat gebruikers niet als “Gastgebruikers” moeten worden toegevoegd, worden ze “Gepromoveerde gebruikers”. In de volgende sectie kunt u “Standaardmachtigingen” definiëren om toe te wijzen aan alle gebruikers die via deze AD-synchronisatieconfiguratie worden toegevoegd.
- Sla de configuratie op
- Als u een schema hebt geselecteerd, zal de AD-configuratie nu met het ingestelde interval worden uitgevoerd; in het geval van “Handmatig” drukt u op “Start een handmatige synchronisatie” om de gebruikers naar RESPONSUM te synchroniseren.




Stapsgewijze begeleiding
Instellen van de Azure/Entra AD “App-registratie”
- Maak een nieuwe Active Directory-applicatie aan via het gedeelte “App-registratie” van de Azure Portal of Entra Portal (de stappen zijn vergelijkbaar, de Azure Portal wordt weergegeven in de onderstaande screenshots)
- Deze applicatie kan elke gewenste naam krijgen (bijv. “RESPONSUM AD Sync”). Selecteer de optie “Alleen accounts in deze organisatie-directory” bij “Ondersteunde accounttypen” en “Registreer” de applicatie.


- On the overview page of the newly created application, you will see following two parameters:
- ID van de toepassing (client)
- Map-ID (tenant)
- Noteer deze of onthoud hun locatie, aangezien u deze later in RESPONSUM moet invoeren.
- Next thing to be created is a Client Secret that RESPONSUM can use to access the API and get user/group info. This can be done from the same overview page by clicking “Add a certificate or secret”. On the newly opened “Certificates & Secrets” page, select “New Client Secret” to create the new secret. Give the secret a description (e.g. “RESPONSUM App secret”) and keep the default expiration date or choose your own.
- OPMERKING: Houd er rekening mee dat u dit geheim moet vernieuwen op basis van de vervaldatum die u hebt ingesteld, zodat de synchronisatie operationeel blijft.
- Kopieer dit geheim en sla het tijdelijk ergens op, aangezien het na het aanmaken slechts één keer wordt getoond. Het moet later in RESPONSUM worden ingevoerd.




- De volgende stap is om RESPONSUM de juiste machtigingen te geven om de API te gebruiken voor het ophalen van gebruikers-/groepsinformatie uit uw AD. Dit kan worden gedaan in de subsectie API-machtigingen van uw aangemaakte applicatie. Standaard zal de Microsoft Graph API-machtiging “User.Read” aanwezig zijn.
- Deze machtiging moet worden uitgebreid met de machtigingen “User.Read.All” en “Group.Read.All”. Deze kunnen worden toegevoegd door op “Een machtiging toevoegen” te drukken, gevolgd door “Microsoft Graph”. >> “Applicatiemachtigingen”. Vervolgens kunt u zoeken naar “User” en daarna naar “Group” om de gebruikers- en groepsspecifieke machtigingen te vinden:





- Once the permissions are set, you need to Grant admin consent for your organization for us to be able to use the new permissions. This can be done by pressing “Grant Admin consent for <Organization name>”:
- OPMERKING: Zorg ervoor dat u een account gebruikt met voldoende machtigingen om deze toegang te kunnen verlenen.



De “AD-synchronisatieconfiguratie” configureren binnen de RESPONSUM UI
- Selecteer het menu “Instellingen” in de hoofdmenubalk (tandwielicoon)
- Beweeg met de muis over de subsectie “Gebruikersbeheer”
- Selecteer “AD-synchronisatieconfiguratie”
- Geef uw configuratie een naam (dit kan dezelfde naam zijn als uw applicatie in Azure/Entra AD)
- Stel een filtertype in, ofwel “Gebruikers” (Graph-filters toegepast op het gebruikers-endpoint) of “Groepen” (Graph-filters toegepast op het groepen-endpoint)
- Opmerking: U hoeft geen “$select”-statement in de query op te nemen
- Stel een filterstatement in met behulp van de Microsoft Graph-filterstructuur (meer info hier)
- Selecteer of u de AD-synchronisatieruns wilt inplannen of handmatig wilt activeren
- Vul de Client ID, Client Secret en Directory (Tenant) ID in die u hebt gekregen van de geregistreerde app bij Azure/Entra AD (zie vorige stap)
- Begin met het mappen van eigenschappen van Azure/Entra AD-gebruikers naar “Gebruiker”-velden binnen RESPONSUM
- U kunt zoveel rijen voor mapping toevoegen als nodig is om alle details te mappen
- U kunt elke aangepaste eigenschap in AD selecteren door “Aangepast veld instellen” te kiezen in de linker AD-kolom
- U kunt aangepaste velden aanmaken binnen RESPONSUM om eigenschappen naar te mappen door de “+”-knop in de rechter RESPONSUM-veldenkolom te gebruiken
- Stel de initiële eigenschappen in
- Als u in de initiële eigenschappen instelt dat gebruikers niet als “Gastgebruikers” moeten worden toegevoegd, worden ze “Gepromoveerde gebruikers”. In de volgende sectie kunt u “Standaardmachtigingen” definiëren om toe te wijzen aan alle gebruikers die via deze AD-synchronisatieconfiguratie worden toegevoegd.
- Sla de configuratie op
- Als u een schema hebt geselecteerd, zal de AD-configuratie nu met het ingestelde interval worden uitgevoerd; in het geval van “Handmatig” drukt u op “Start een handmatige synchronisatie” om de gebruikers naar RESPONSUM te synchroniseren.
Als u vragen heeft over deze handleiding of werkwijze, neem dan contact op met support@responsum.eu voor assistentie.