Benutzer mit Azure AD synchronisieren

Ziel: Gluu-Benutzer, -Pläne und -Rollen mit Azure AD synchron halten, indem CSV-basierte Massenaktualisierungen und die Benutzer-API verwendet werden.

Holen Sie sich Ihr API-Token und lesen Sie unsere API-Grundlagen, bevor Sie beginnen.

Benutzer per Massenaktualisierung aktualisieren (CSV) #

Verwenden Sie CSV (RFC 4180). Bei Header-Namen wird die Groß-/Kleinschreibung nicht beachtet.

Unterstützte Spalten #

• E-Mail – E-Mail-Adresse des Benutzers.
• Vollständiger Name – Vor- + Nachname; wird ignoriert, wenn Vorname/Nachname vorhanden sind.
• Vorname, Nachname – wird dem vollständigen Namen vorgezogen.
• Plan – ESSENTIAL, ADVANCED oder NONE.
• Standort – Standort/Abteilung usw.
• Rollen – durch Kommas getrennte Rollennamen (Groß-/Kleinschreibung wird nicht beachtet). Unbekannte Namen werden ignoriert (im Dry-Run angezeigt).
• Rollenoperation – add (nur neue hinzufügen) oder replace (Standard; entfernt nicht aufgeführte Rollen).
• ExtId – Ihre eindeutige ID. Wir gleichen zuerst ExtId ab und greifen dann auf E-Mail 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 Prozessinhaber 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.

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

Header umbenennen 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";PRO'

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