Diese Anleitung hilft Ihnen bei der Einrichtung einer Anwendung in Microsoft Azure/Entra ID, die es RESPONSUM ermöglicht, Benutzerinformationen aus dem AD abzurufen und Benutzerkonten für diese Benutzer innerhalb von RESPONSUM zu erstellen. Diese Synchronisierung kann konfiguriert werden und erfolgt entweder automatisch in einem festgelegten Intervall oder manuell über das Untermenü „AD-Synchronisierung“.
HINWEIS: Dieser Synchronisierungsfluss funktioniert nur mit Azure/Entra ID-Setups. On-Premise Active Directory-Installationen werden von RESPONSUM nicht unterstützt.
HINWEIS: Wenn in RESPONSUM kein Filter oder Filtertyp festgelegt ist, importiert diese Integration alle in Ihrem Active Directory bekannten Benutzer, einschließlich externer Konten, die über Ihre Dienste Zugriff haben und somit Ihrem AD bekannt sind. Seien Sie vorsichtig bei der Verwendung dieser Integration, da sie mehr Benutzer als erwartet importieren kann; halten Sie vorher Rücksprache mit Ihrem IT-Administrator.
HINWEIS: RESPONSUM wird zuvor durch die AD-Synchronisierung hinzugefügte Benutzer bei der nächsten AD-Synchronisierung archivieren, wenn diese nicht mehr im Active Directory gefunden werden.
In der Praxis
Voraussetzungen für den Einstieg
- Berechtigungen für das spezifische Untermodul „Benutzerverwaltung“ oder „AD-Synchronisierungskonfiguration“ als Verantwortlicher
- Kenntnisse Ihrer Azure/Entra ID-Umgebung und ein Konto mit erweiterten Rechten, um eine „App-Registrierung“ vornehmen zu können
- Eine Vorstellung davon, welche Benutzer/Gruppen Sie in RESPONSUM importieren möchten, um den Satz der Benutzer auf diejenigen zu beschränken, die für die Anmeldung bei RESPONSUM erforderlich sind.
Schnell zum Erfolg
- Wählen Sie das Menü „Einstellungen“ in der Hauptmenüleiste (Zahnrad-Symbol)
- Bewegen Sie den Mauszeiger über den Unterabschnitt „Benutzerverwaltung“
- Wählen Sie „AD-Synchronisierungskonfiguration“
- Geben Sie Ihrer Konfiguration einen Namen
- Legen Sie einen Filtertyp fest, entweder „Benutzer“ (Graph-Filter, die auf den Benutzer-Endpunkt angewendet werden) oder „Gruppen“ (Graph-Filter, die auf den Gruppen-Endpunkt angewendet werden)
- Hinweis: Sie müssen keine „$select“-Anweisung in die Abfrage aufnehmen
- Legen Sie eine Filteranweisung unter Verwendung der Microsoft Graph-Filterstruktur fest (weitere Informationen hier)
- Wählen Sie aus, ob Sie die AD-Synchronisierungsläufe planen oder manuell auslösen möchten
- Erstellen Sie eine App-Registrierung bei Microsoft Entra, um die erforderlichen Details zu erhalten (weitere Details zur App-Erstellung unten)
- Geben Sie die Client-ID, das Client-Geheimnis (Client Secret) und die Verzeichnis-ID (Tenant-ID) ein, die Sie von der registrierten App erhalten haben
- Beginnen Sie mit dem Mapping der Eigenschaften von Azure/Entra AD-Benutzern auf die „Benutzer“-Felder innerhalb von RESPONSUM
- Sie können so viele Zeilen für das Mapping hinzufügen, wie benötigt werden, um alle Details zuzuordnen
- Sie können jede benutzerdefinierte Eigenschaft im AD auswählen, indem Sie in der linken AD-Spalte „Benutzerdefiniertes Feld festlegen“ wählen
- Sie können benutzerdefinierte Felder innerhalb von RESPONSUM erstellen, denen Eigenschaften zugeordnet werden können, indem Sie die Schaltfläche „+“ in der rechten Spalte der RESPONSUM-Felder verwenden
- Legen Sie die Anfangseigenschaften fest
- Wenn Sie in den Anfangseigenschaften festgelegt haben, dass die Benutzer nicht als „Gastbenutzer“ hinzugefügt werden sollen, werden sie zu „Promoted Users“. Im nächsten Abschnitt können Sie „Standardberechtigungen“ definieren, die allen über diese AD-Synchronisierungskonfiguration hinzugefügten Benutzern zugewiesen werden.
- Speichern Sie die Konfiguration
- Wenn Sie einen Zeitplan ausgewählt haben, wird die AD-Konfiguration nun im festgelegten Intervall ausgeführt; im Falle von „Manuell“ klicken Sie auf „Manuelle Synchronisierung starten“, um die Benutzer mit RESPONSUM zu synchronisieren.




Schritt-für-Schritt-Anleitung
Einrichtung der Azure/Entra ID „App-Registrierung“
- Erstellen Sie eine neue Active Directory-Anwendung über den Bereich „App-Registrierung“ des Azure-Portals oder Entra-Portals (die Schritte sind ähnlich, das Azure-Portal ist in den folgenden Screenshots dargestellt)
- Diese Anwendung kann beliebig benannt werden (z. B. „RESPONSUM AD Sync“). Wählen Sie die Option „Nur Konten in diesem Organisationsverzeichnis“ für die „Unterstützten Kontotypen“ und „Registrieren“ Sie die Anwendung.


- On the overview page of the newly created application, you will see following two parameters:
- Anwendungs-ID (Client-ID)
- Verzeichnis-ID (Tenant-ID)
- Notieren Sie sich diese oder merken Sie sich deren Speicherort, da Sie diese später in RESPONSUM eingeben müssen.
- 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.
- HINWEIS: Denken Sie daran, dieses Geheimnis basierend auf dem von Ihnen festgelegten Ablaufdatum zu erneuern, damit die Synchronisierung betriebsbereit bleibt.
- Kopieren Sie dieses Geheimnis und speichern Sie es vorübergehend an einem sicheren Ort, da es nach der Erstellung nur einmal angezeigt wird. Es muss später in RESPONSUM eingegeben werden.




- Der nächste Schritt besteht darin, RESPONSUM die korrekten Berechtigungen zu erteilen, um die API zum Abrufen von Benutzer-/Gruppeninformationen aus Ihrem AD zu verwenden. Dies kann im Unterabschnitt „API-Berechtigungen“ Ihrer erstellten Anwendung erfolgen. Standardmäßig ist die Microsoft Graph API-Berechtigung „User.Read“ bereits vorhanden.
- Diese Berechtigung sollte um die Berechtigungen „User.Read.All“ und „Group.Read.All“ erweitert werden. Diese können durch Klicken auf „Berechtigung hinzufügen“ gefolgt von „Microsoft Graph“ hinzugefügt werden. >> „Anwendungsberechtigungen“. Dann können Sie nach „User“ suchen und anschließend nach „Group“, um die benutzer- und gruppenspezifischen Berechtigungen zu finden:





- 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>”:
- HINWEIS: Stellen Sie sicher, dass Sie ein Konto mit ausreichenden Berechtigungen verwenden, um diesen Zugriff gewähren zu können.



Konfigurieren der „AD-Synchronisierungskonfiguration“ innerhalb der RESPONSUM-Benutzeroberfläche
- Wählen Sie das Menü „Einstellungen“ in der Hauptmenüleiste (Zahnrad-Symbol)
- Bewegen Sie den Mauszeiger über den Unterabschnitt „Benutzerverwaltung“
- Wählen Sie „AD-Synchronisierungskonfiguration“
- Geben Sie Ihrer Konfiguration einen Namen (dies kann derselbe Name wie der Ihrer Anwendung in Azure/Entra AD sein)
- Legen Sie einen Filtertyp fest, entweder „Benutzer“ (Graph-Filter, die auf den Benutzer-Endpunkt angewendet werden) oder „Gruppen“ (Graph-Filter, die auf den Gruppen-Endpunkt angewendet werden)
- Hinweis: Sie müssen keine „$select“-Anweisung in die Abfrage aufnehmen
- Legen Sie eine Filteranweisung unter Verwendung der Microsoft Graph-Filterstruktur fest (weitere Informationen hier)
- Wählen Sie aus, ob Sie die AD-Synchronisierungsläufe planen oder manuell auslösen möchten
- Geben Sie die Client-ID, das Client-Geheimnis und die Verzeichnis-ID (Tenant-ID) ein, die Sie von der bei Azure/Entra AD registrierten App erhalten haben (siehe vorheriger Schritt)
- Beginnen Sie mit dem Mapping der Eigenschaften von Azure/Entra AD-Benutzern auf die „Benutzer“-Felder innerhalb von RESPONSUM
- Sie können so viele Zeilen für das Mapping hinzufügen, wie benötigt werden, um alle Details zuzuordnen
- Sie können jede benutzerdefinierte Eigenschaft im AD auswählen, indem Sie in der linken AD-Spalte „Benutzerdefiniertes Feld festlegen“ wählen
- Sie können benutzerdefinierte Felder innerhalb von RESPONSUM erstellen, denen Eigenschaften zugeordnet werden können, indem Sie die Schaltfläche „+“ in der rechten Spalte der RESPONSUM-Felder verwenden
- Legen Sie die Anfangseigenschaften fest
- Wenn Sie in den Anfangseigenschaften festgelegt haben, dass die Benutzer nicht als „Gastbenutzer“ hinzugefügt werden sollen, werden sie zu „Promoted Users“. Im nächsten Abschnitt können Sie „Standardberechtigungen“ definieren, die allen über diese AD-Synchronisierungskonfiguration hinzugefügten Benutzern zugewiesen werden.
- Speichern Sie die Konfiguration
- Wenn Sie einen Zeitplan ausgewählt haben, wird die AD-Konfiguration nun im festgelegten Intervall ausgeführt; im Falle von „Manuell“ klicken Sie auf „Manuelle Synchronisierung starten“, um die Benutzer mit RESPONSUM zu synchronisieren.
Wenn Sie Fragen zu dieser Anleitung oder der Arbeitsweise haben, wenden Sie sich bitte an support@responsum.eu, um Unterstützung zu erhalten.