Ziel: Gluu-Benutzer, -Pläne und -Rollen mit Azure AD synchron halten, mithilfe von CSV-basierten Massenaktualisierungen und der Benutzer-API.
Besorgen Sie sich Ihr API-Token und lesen Sie vor dem Start unsere API-Grundlagen.
Bevor Sie starten #
- Plan: Diese Synchronisierung nutzt die Gluu-API, die das Add-on APIs und Schnittstellen erfordert.
- Rolle: Sie benötigen Zugriff als Kontoinhaber/Administrator (Konto verwalten), um ein API-Token zu generieren und die Synchronisierung auszuführen.
- Setup: Halten Sie Ihr Gluu-API-Token bereit sowie PowerShell mit dem Microsoft-Graph-Modul, falls Sie Benutzer direkt aus Azure AD abrufen.
Benutzer per Massenaktualisierung aktualisieren (CSV) #
Verwenden Sie CSV (RFC 4180). Bei Header-Namen wird die Groß-/Kleinschreibung nicht beachtet.
Unterstützte Spalten #
- Email: E-Mail-Adresse des Benutzers.
- Fullname: Vor- und Nachname; wird ignoriert, wenn Firstname/Lastname vorhanden sind.
- Firstname, Lastname: werden dem vollständigen Namen vorgezogen.
- Plan: ESSENTIAL, ADVANCED oder
NONE. - Location: Standort/Abteilung usw.
- Roles: durch Kommas getrennte Rollennamen (Groß-/Kleinschreibung wird nicht beachtet). Unbekannte Namen werden ignoriert (im Dry-Run angezeigt).
- RoleOperation:
add(nur neue hinzufügen) oderreplace(Standard; entfernt nicht aufgeführte Rollen). - ExtId: Ihre eindeutige ID. Wir gleichen zuerst anhand der ExtId ab und greifen dann auf die E-Mail-Adresse zurück.
Benutzer löschen #
Verwenden Sie IncludeAllUsers, wenn Sie die vollständige aktuelle Liste übergeben; Benutzer, die nicht in der CSV-Datei enthalten sind, werden entfernt. Kontoinhaber und Prozesseigentümer können erst gelöscht werden, wenn sie neu zugewiesen wurden. Der Dry-Run meldet dies.
Dry-Run: Testen Sie den Import und sehen Sie sich die beabsichtigten Änderungen an, bevor Sie sie anwenden.
API-Operation #
Verwenden Sie das Token von oben. Beginnen Sie mit dryrun. Um aktuelle Benutzer abzurufen, siehe Benutzerliste.
Sie sind fertig, sobald ein Dry-Run die erwarteten Änderungen anzeigt und Sie die Anfrage ohne dryrun erneut ausgeführt haben, um sie anzuwenden.
Benutzer aus Azure Graph abrufen #
Connect-MgGraph -Scopes "User.Read.All" get-mguser -all | select displayname, givenName, Surname, Mail | Export-Csv -Encoding UTF8 -Path temp.csv
Benennen Sie die Header um in:
„Fullname“,„Firstname“,„Lastname“,„Email“
Beispiel für POST mit weiteren Spalten:
$content =
'fullname;firstname;lastname;email;roles;plan
John Wayne;John;Wayne;user1@local.test;"my role 1, my role 2";ADVANCED'
Invoke-RestMethod -Uri "https://api.gluu.biz/users/sync" -Method POST `
-ContentType "csv/text" -Headers @{ "content-encoding" = "utf-8"; "Authorization" = "Bearer g_xxxx"} `
-Body $content
Das war’s.
FAQ: Benutzer mit Azure AD synchronisieren #
Diese Synchronisierung nutzt die Gluu-API, die das Add-on APIs und Schnittstellen erfordert. Es ist nicht in den Plänen Core, Essential oder Advanced enthalten.
Gluu gleicht zuerst anhand der ExtId ab, falls Sie eine angeben, und greift andernfalls auf die E-Mail-Adresse zurück. So können Sie Ihre eigene externe Kennung als stabilen Schlüssel über Synchronisierungen hinweg verwenden.
Nur wenn Sie IncludeAllUsers setzen. Damit teilen Sie Gluu mit, dass Sie die vollständige aktuelle Liste übergeben, und alle nicht enthaltenen Benutzer werden dann entfernt. Kontoinhaber und Prozesseigentümer können erst gelöscht werden, nachdem sie neu zugewiesen wurden; ein Dry-Run meldet dies.
add fügt nur die in der CSV aufgeführten Rollen hinzu, ohne die anderen Rollen eines Benutzers zu ändern. replace ist die Standardeinstellung und entfernt alle Rollen, die nicht in der CSV aufgeführt sind, sodass die Rollen des Benutzers genau dem entsprechen, was Sie gesendet haben.
Ja. Verwenden Sie dryrun, um die beabsichtigten Änderungen zu sehen (einschließlich unbekannter Rollennamen oder Benutzer, die nicht gelöscht werden können), bevor Sie die Synchronisierung tatsächlich ausführen.
