Synkroniser brugere med Azure AD | Gluu Documentation 📘

Mål: Hold Gluu-brugere, planer og roller synkroniseret med Azure AD ved hjælp af CSV-baserede masseopdateringer og bruger-API’et.

Hent jeres API-token, og læs grundlæggende om API’et, før I begynder.

Før I går i gang #

Plan: Denne synkronisering bruger Gluu API’et, som kræver tilføjelsen Integrationer og API.
Rolle: I skal have adgang som kontoejer/admin (Administrer konto) for at generere et API-token og udføre synkroniseringen.
Opsætning: Hav jeres Gluu API-token klar samt PowerShell med Microsoft Graph-modulet, hvis I henter brugere direkte fra Azure AD.

Masseopdater brugere (CSV) #

Brug CSV (RFC 4180). Navnene på kolonneoverskrifterne er ikke versalfølsomme.

Understøttede kolonner #

Email: brugerens e-mail.
Fullname: fornavn og efternavn. Ignoreres, hvis Firstname og Lastname er til stede.
Firstname, Lastname: foretrækkes frem for Fullname.
Plan: ESSENTIAL, ADVANCED eller NONE.
Location: sted, afdeling osv.
Roles: kommaseparerede rollenavne (ikke versalfølsomme). Ukendte navne ignoreres (vises i tørkørslen).
RoleOperation: add (tilføj kun nye) eller replace (standard; fjerner roller, der ikke er på listen).
ExtId: jeres unikke ID. Vi matcher først på ExtId og falder derefter tilbage til Email.

Slet brugere #

Brug IncludeAllUsers, når I sender den fulde aktuelle liste. Brugere, der ikke er i CSV’en, fjernes. Kontoejere og procesejere kan ikke slettes, før de er omfordelt. Tørkørslen rapporterer dette.

Tørkørsel (dry run): Test importen, og se de tilsigtede ændringer, før de anvendes.

API-operation #

Brug det token, I hentede ovenfor. Start med dryrun. I kan hente de nuværende brugere via liste over brugere.

I er færdige, når en tørkørsel viser de forventede ændringer, og I har sendt anmodningen igen uden dryrun for at anvende dem.

Hent brugere fra Azure Graph #

Connect-MgGraph -Scopes "User.Read.All"
get-mguser -all | select displayname, givenName, Surname, Mail | Export-Csv -Encoding UTF8 -Path temp.csv

Omdøb kolonneoverskrifterne til:

"Fullname","Firstname","Lastname","Email"

Eksempel på POST med flere kolonner:

$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

Så er I færdige.

FAQ: Synkroniser brugere med Azure AD #

Hvilken plan eller tilføjelse skal jeg bruge for at synkronisere brugere via API’et?

Denne synkronisering bruger Gluu API’et, som kræver tilføjelsen Integrationer og API. Den er ikke inkluderet i Core-, Essential- eller Advanced-planen i sig selv.

Hvordan matcher Gluu en række i min CSV med en eksisterende bruger?

Gluu matcher først på ExtId, hvis I angiver et, og falder ellers tilbage til at matche på e-mail. Det betyder, at I kan bruge jeres egen eksterne identifikator som den stabile nøgle på tværs af synkroniseringer.

Vil synkronisering slette brugere, som ikke er i min CSV?

Kun hvis I angiver IncludeAllUsers, som fortæller Gluu, at I sender den fulde aktuelle liste. Så fjernes enhver bruger, der ikke er med. Kontoejere og procesejere kan ikke slettes, før de er omfordelt. En tørkørsel rapporterer dette.

Hvad er forskellen på RoleOperation add og replace?

add tilføjer kun de roller, der er angivet i CSV’en, uden at røre brugerens øvrige roller. replace er standard og fjerner alle roller, der ikke er angivet i CSV’en, så brugerens roller matcher præcis det, I har sendt.

Bør jeg teste en synkronisering, før jeg anvender den?

Ja. Brug dryrun til at se de tilsigtede ændringer, herunder eventuelle ukendte rollenavne eller brugere, der ikke kan slettes, før I udfører synkroniseringen for alvor.