Buuky bietet eine Verbindung zu Identity Providern (z.B. Microsoft Entra ID, ehemals Active Directory) über SCIM an, sodass eine automatische Synchronisation mit den Nutzer:innendaten des Unternehmens möglich ist und diese nicht manuell in Buuky gepflegt werden müssen.
So werden neue Nutzer:innen automatisch in Buuky angelegt, sobald sie beim Identity Provider angelegt oder der einer vorher definierter Gruppe hinzugefügt wurden. Dasselbe gilt auch für die Änderung oder Löschung von Nutzerdaten. Andersherum gilt dieses Verhalten jedoch selbstverständlich nicht: Löscht ein Admin z.B. eine:n Benutzer:in in Buuky, so wird diese Änderung nicht zum Identity Provider übertragen.
In der Buuky Konfiguration befindet sich in der linken Navigation unter dem Punkt Benutzersynchronisation (SCIM) die Einrichtung.
Für die Einrichtung muss meist ein Administrator des Identity Providers aus Deinem Unternehmen die Daten in diesem eintragen. Die meisten Schritte passieren innerhalb des Identity Providers. Aktuell unterstützt Buuky die Verbindung zu Microsoft Entra ID über SCIM. Falls Du einen anderen Identity Provider nutzt, kontaktiere bitte unseren Support, um die Möglichkeit einer Anbindung zu prüfen.
Navigiere in der Buuky Administration zu Integrationen > Benutzersynchronisation (SCIM).
Wähle den passenden Identity Provider aus. Aktuell ist nur Microsoft Entra ID verfügbar. Bestätige, dass Du die angezeigten Hinweise alle gelesen hast und klicke anschließend auf SCIM-Einrichtung starten.
Du bekommst nun alle notwendigen Daten angezeigt, die Du für die Einrichtung in Deinem Identity Provider benötigst.
Wichtig! Der Client Schlüssel muss unbedingt geheim bleiben und darf nur in Deinem Identity Provider hinterlegt werden. Teile diesen Schlüssel nicht mit anderen Personen oder Dritten.
Damit ist in Buuky alles erledigt. Die restliche Einrichtung muss in deinem Identity Provider erfolgen. Du kannst an dieser Stelle auf Fertig klicken oder erst die Einrichtung in Deinem Identity Provider abschließen. Die Daten bleiben gespeichert und sind auch im Nachhinein jederzeit wieder abrufbar.
Für Microsoft Entra ID kannst du der offiziellen Microsoft Anleitung folgen:
Alternativ beschreiben wir die notwendigen Schritte hier. Egal welchen Weg du wählst, die Attribut-Mappings (die in beiden Varianten gezeigt werden) müssen in jedem Fall wie folgt konfiguriert werden:
Gruppen (Groups): Enabled -> No
Benutzer (Users):
| customappsso Attribute | Microsoft Entra ID Attribute | Matching precedence |
|---|---|---|
| userName | userPrincipalName | 1 |
| active | Switch([IsSoftDeleted], , "False", "true", "True", "false") | |
| displayName | displayName | |
| externalId | objectId |
Achtung: Das Attribut active ist vom Mapping Type Expression. Die anderen Attribute sind vom Typ Direct.
Solltest Du Deinen Client Schlüssel oder die Buuky SCIM URL (Tenant URL) aus der Konfiguration zu einem späteren Zeitpunkt erneut benötigen, findest Du sie hier. Sie verbirgt sich hinter dem Button Zeige Konfigurationsdetails.
Unter dem Punkt Synchronisation siehst Du den Zeitpunkt, an dem zuletzt Daten von an Buuky übertragen wurden. In den Details der Synchronisation kannst Du die genauen Anfragen sehen, die der Identity Provider bislang an Buuky geschickt hat. Dort siehst Du außerdem, ob die Änderungen erfolgreich durchgeführt wurden und wann sie ausgeführt wurden.
Es ist jederzeit möglich, die Synchronisation wieder zu löschen. Klicke dafür auf SCIM-Verbindung beenden und löschen und bestätige, dass die Verbindung getrennt werden soll. Deine Benutzer:innen bleiben bestehen und müssen separat gelöscht werden. Es werden nur die Verknüpfung und die automatische Synchronisation entfernt.
