SCIM Provisioning

SCIM mit Microsoft Entra ID (Azure AD)

Gleichen Sie Mitarbeitereinträge automatisch mit Benutzern aus Microsoft Entra ID (ehemals Azure AD) ab. Jede Änderung, die Sie in Entra ID an einem Benutzer vornehmen, wird nach AssetNode übernommen. Sollen auch Abteilung, Standort und/oder Vorgesetzte mitlaufen, aktivieren Sie die entsprechenden Optionen in Ihren AssetNode-SCIM-Einstellungen, bevor Sie die Bereitstellung starten.

Synchronisiert alle ca. 40 Minuten

Einrichtungsanleitung (12 Schritte)

Bei Azure anmelden und Entra ID öffnen

Rufen Sie portal.azure.com auf, melden Sie sich mit Ihrem Administratorkonto an und klicken Sie auf Microsoft Entra ID.

Neue Enterprise Application anlegen

Gehen Sie auf den Reiter Manage → Enterprise Applications → New Application → Create your own application.

Anwendung benennen

Tragen Sie als Namen „AssetNode SCIM“ ein, wählen Sie „Integrate any other application you don't find in the gallery (Non-gallery)“ und klicken Sie auf Create.

Provisioning-Einstellungen öffnen

Klicken Sie in der neu angelegten Anwendung links in der Seitenleiste auf Provisioning und dann erneut auf Provisioning, um die Konfiguration zu öffnen.

Provisioning Mode setzen und Zugangsdaten eintragen

Stellen Sie den Provisioning Mode auf „Automatic“. Tragen Sie unter Admin Credentials die Tenant URL und den Secret Token ein, die Sie in AssetNode unter Einstellungen → SCIM 2.0 finden. Prüfen Sie die Verbindung mit „Test Connection“ und klicken Sie dann auf Save.

Schlägt „Test Connection“ fehl, prüfen Sie noch einmal, ob Sie die vollständige SCIM-Endpunkt-URL und das Bearer-Token aus AssetNode kopiert haben.

Group Provisioning abschalten

Nach dem Speichern erscheint weiter unten auf derselben Seite der Abschnitt Mappings. Klicken Sie auf „Provision Microsoft Entra ID Groups“ und setzen Sie Enabled auf „No“. Klicken Sie auf Save.

AssetNode nutzt keine SCIM-Gruppenbereitstellung — unterstützt wird ausschließlich die Bereitstellung von Benutzern.

User Attribute Mappings öffnen

Klicken Sie zurück im Abschnitt Mappings auf „Provision Microsoft Entra ID Users“, um die Zuordnung der Benutzerattribute zu öffnen.

userName auf die E-Mail-Adresse umstellen

Suchen Sie die Zeile des Attributs „userName“ und klicken Sie auf Edit. Ändern Sie das Source attribute von „userPrincipalName“ auf „mail“ und klicken Sie auf Ok.

Das ist wichtig: userPrincipalName stimmt nicht zwangsläufig mit der tatsächlichen E-Mail-Adresse der Person überein. Mit „mail“ wird die richtige Adresse übernommen.

Attribut für den Standort ergänzen (optional)

Scrollen Sie nach unten, klicken Sie auf „Show advanced options“ und danach auf „Edit attribute list for customappsso“. Legen Sie ein neues Attribut mit dem Namen „urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:location“ vom Typ String an und klicken Sie auf Save.

Nur nötig, wenn Sie die Standorte der Mitarbeitenden aus Entra ID nach AssetNode übernehmen möchten.

Standortfeld zuordnen (optional)

Klicken Sie auf „Add New Mapping“. Wählen Sie als Source attribute das Entra-ID-Feld, das den Standort der Mitarbeitenden enthält (etwa „country“, „officeLocation“ oder „city“). Setzen Sie das Target attribute auf „urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:location“. Klicken Sie auf Ok und anschließend auf Save.

Nehmen Sie das Entra-ID-Feld, das den Arbeitsort in Ihrer Organisation am besten abbildet.

Benutzer und Gruppen zuweisen

Wechseln Sie zurück in die Übersicht der Anwendung. Klicken Sie links in der Seitenleiste auf „Users and groups“ und dann auf „Add user/group“. Wählen Sie alle Benutzer oder Gruppen aus, die als Mitarbeitende nach AssetNode synchronisiert werden sollen.

Bereitstellung starten

Gehen Sie zurück zu Provisioning und klicken Sie auf „Start provisioning“. Die erste Synchronisierung startet und dauert je nach Anzahl der Benutzer einige Minuten.

Den Status der Bereitstellung sehen Sie auf dieser Seite. Bei Fehlern finden Sie die Einzelheiten in den Provisioning-Logs.

Nach der Einrichtung

Die Synchronisierung läuft etwa alle 40 Minuten. Änderungen an Benutzern in Entra ID werden automatisch nach AssetNode übernommen.
Ändern Sie Name, E-Mail-Adresse oder Position einer Person in Entra ID, wird das in AssetNode automatisch nachgezogen.
Entfernen Sie einen Benutzer aus Entra ID, wird er in AssetNode als „Archiviert“ markiert und nicht gelöscht — möglicherweise sind ihm noch Assets zugewiesen.
Damit auch Abteilung und Vorgesetzte übernommen werden, aktivieren Sie die entsprechenden Optionen in Ihren AssetNode-SCIM-Einstellungen.