Anbindung SCIM - Kunden (Synchronisation)

Voraussetzung

Die Dokumentation setzt voraus, dass Microsoft Entra ID (nachfolgend kurz Entra ID genannt) konfiguriert und eingerichtet ist. Sie benötigen in der Entra ID administrative Berechtigung, um die Anwendung konfigurieren zu können. Die Anbindung funktioniert mit jeder Version von Entra ID.

Unternehmensanwendung konfigurieren

Falls für e-mergency noch keine Unternehmensanwendung konfiguriert wurde (andernfalls überspringen Sie dieses Kapitel):

Melden Sie sich im Microsoft Entra Admin Center mit einem Administratorkonto an und öffnen Sie Entra ID.

• Wechseln Sie in Microsoft Entra ID in den Bereich Enterprise applications.

• Fügen Sie über New application eine neue Anwendung hinzu.
• Anschliessend öffnet sich die Microsoft Entra Gallery, über die Sie eine Anwendung aus dem Katalog auswählen können.

• Klicken Sie auf den Button Create your own application, um eine neue Anwendung zu erstellen.

• Geben Sie als Namen für die Applikation "e-mergency" ein.
• Wählen Sie zwingend die Option Integrate any other application you don't find in the gallery (Non-gallery).
• Klicken Sie auf Erstellen um die Anwendung in Entra ID anzulegen.

Konfiguration SCIM

• Klicken Sie auf die soeben erstellte Applikation für e-mergency.

• Klicken Sie auf den Menüpunkt Provisioning.

• Konfigurieren Sie in den Provisioning Einstellungen die Tenant URL und das Secret Token wie folgt:

  • e-mergency: https://api-scim.e-mergency.ch/scim
  • Secret Token: Gem. unseren Angaben

• Klicken Sie anschliessen auf Provision Microsoft Entra Users, um das Mapping der gelieferten Daten anzupassen.

• Definieren Sie alle Felder, in welchen Sie Daten halten, die für die Synchronisation mit e-mergency notwendig sind. Entfernen Sie Felder, die Sie nicht übermitteln möchten. Zwingende Informationen für das Erstellen eines Benutzers sind: Name, Vorname, E-Mail-Adresse, Benutzername, Mobilnummer und Standort. Die Festnetznummer ist optional.
• Speichern Sie anschliessend alle Einstellungen und kehren Sie zur Übersicht der Applikation zurück.
• Wechseln Sie nun in den Menüpunkt Users and Groups.

Hier definieren Sie, welche Benutzer und Gruppen an e-mergency übermittelt werden sollen. Definieren Sie den Filter so, dass alle Benutzer übermittelt werden, welche mit e-mergency synchronisiert werden sollen. In der Regel sollten hier somit alle AD Gruppen angegeben werden, welche die entsprechende Berechtigung für e-mergency haben.

Wenn der Filter konfiguriert wurde, wechseln Sie in die Overview.

• Starten Sie nun das Provisioning der Benutzer. Es dauert jeweils eine Weile, bis die Benutzer übermittelt werden.