In diesem Artikel findest du eine Schritt-für-Schritt-Anleitung, wie du die SCIM-Verbindung zwischen Microsoft Entra ID und deskbird einrichtest, um eine nahtlose Synchronisierung von User- und Gruppen-Daten zu ermöglichen.
💡 Hinweis: Nach dem Einrichten von SCIM kann die erste Synchronisierung 1–2 Stunden dauern. Bitte warte ab und prüfe es später erneut.
⚠️ Es dürfen nur User und/oder Gruppen für die Bereitstellung ausgewählt werden, die Zugriff auf deskbird benötigen. Alle Objekte, die in die Synchronisierung aufgenommen werden, werden automatisch bereitgestellt.
1. SCIM-Token in deskbird erstellen
- Gehe zu Admin > Unternehmen: API-Schlüssel.
- Klicke auf Generate key, gib einen Name ein und wähle SCIM aus.
3. Wähle deinen SCIM-Anbieter aus und generiere deinen Token (es gibt nur einen Token pro Unternehmen)
4. Kopiere deinen SCIM-Token und speichere ihn an einem sicheren Ort (der Token wird in der UI nicht mehr angezeigt)
5. Du kannst einen bestehenden Schlüssel jederzeit widerrufen und einen neuen generieren
Jetzt hast du alles, was du für die Einrichtung deiner SCIM-Anwendung brauchst
2. SCIM-Anwendung einrichten
- Gehe zu https://entra.microsoft.com/ und klicke auf Enterprise applications
- Klicke auf New application
- Klicke auf Create your own application
- Gib der Anwendung einen Namen und stelle sicher, dass Integrate any other application you don't find in the gallery (Non-gallery) ausgewählt ist:
- Klicke auf Create
- Du solltest jetzt zur neu erstellten Anwendung weitergeleitet werden
- Gehe zu Provisioning
- Klicke auf Get started
- Wähle Automatic aus dem Dropdown-Menü
- Füge im Feld Tenant URL folgende URL ein: https://api.deskbird.app/v2/scim
- Gib im Feld Secret Token den Unternehmens-SCIM-Token ein, den du im ersten Schritt generiert hast
- Klicke auf Test Connection
Wenn alles wie erwartet funktioniert, erscheint ein Bestätigungs-Pop-up.
- Klicke auf Save
- Klicke unter Mappings auf Provision Microsoft Entra ID Users
- Scrolle ganz nach unten und lösche das Attribut mailNickname
- Klicke unten auf der Seite auf Add New Mapping
- Gehe zum Quellattribut und wähle objectId aus dem Dropdown-Menü
- Gehe zum Zielattribut und wähle externalId aus dem Dropdown-Menü
- Klicke auf Save
- Jetzt solltest du das hinzugefügte Mapping in der Liste sehen:
- Klicke unter Mappings auf Provision Microsoft Entra ID Users
💡 Empfohlene Prüfung für gruppenbasierte Bereitstellung:
Wenn du gruppenbasierte SCIM-Bereitstellung verwendest, empfehlen wir dringend, die Gruppenattribut-Mappings zu überprüfen, damit User in deskbird korrekt deaktiviert werden, wenn sie aus einer Entra ID Gruppe entfernt werden.
- Wähle im Bereich Mappings aus dem Dropdown Provision Microsoft Entra ID Groups aus.
- Scrolle nach unten und klicke auf Show advanced options.
- Finde das Attribut mit dem Zielattribut members.
Stelle folgende Konfiguration sicher:
- ❌ urn:ietf:params:scim:schemas:core:2.0:Group ist nicht ausgewählt
- ✅ urn:ietf:params:scim:schemas:extension:enterprise:2.0:User bleibt ausgewählt
Speichere die Änderungen und warte ein paar Minuten, bis Microsoft Entra ID sie übernommen hat. Mit dieser Konfiguration werden User, die aus Entra ID Gruppen entfernt werden, beim nächsten Bereitstellungszyklus in deskbird korrekt auf Inaktiv gesetzt.
- Gehe zu Enterprise Applications und wähle Users and Groups aus
- Klicke auf Add user/group
- Klicke auf None selected
- Suche und wähle die Gruppen/User aus, die du bereitstellen möchtest. Klicke auf Select
- Klicke auf Assign
Jetzt sollte alles konfiguriert sein!
3. Ausgewählte Objekte bereitstellen
- Gehe zu deiner SCIM-Anwendung und klicke auf Provisioning
- Gehe zu Start provisioning
- Der Prozess wird im Hintergrund gestartet. Nach Abschluss sollte es so aussehen:
💡 Hinweis: Nach dem Einrichten von SCIM kann die erste Synchronisierung 1–2 Stunden dauern. Bitte warte ab und prüfe es später erneut. Nach der Ersteinrichtung erfolgt alle 40 Minuten eine Synchronisierung.