Opsætning af importreferencer til rettighedsgrupper
Formål:
Hvis du automatisk vil have opdateret, hvilke brugere der er medlem af jeres rettighedsgrupper, kan du gøre det via brugerimporterne til XFlow. Funktionen understøtter i dag følgende brugerkilder: Active Directory, CSV-import og Public API.
Se hvordan du sætter det op generelt og specifikt i forhold til de enkelte brugerkilder nedenfor.
Sidst redigeret: 18/06-26
1. Vejledning til opsætning af importreferencer til rettighedsgrupper
Bemærk: Når en rettighedsgruppe har en eller flere importreferencer, betragtes den som "låst". Det betyder, at medlemskab af gruppen udelukkende styres via brugerimporten og ikke kan ændres manuelt.
For at tilføje importreference til en rettighedsgruppe skal du være på administratordelen og gøre følgende:
Gå til Rettigheder > Rettighedsgrupper
Klik på den rettighedsgruppe, du vil koble til en ekstern gruppe
Udvid sektionen Importreferencer (klik for at udvide)
Indtast den referencestreng, der svarer til gruppen i dit eksterne system
Klik Tilføj
Her skal referencestrengen indsættes
For hver rettighedsgruppe gælder, at du kan tilknytte et vilkårligt antal importreferencer. Du kan dermed have flere steder i din brugerkilde, der leverer brugere, som skal være medlem af én og samme rettighedsgruppe.
Matchingen af importreferencer er ikke casesensitiv. Det vil sige, at importreferencen "Økonomi-Team" matcher "økonomi-team".
2. AD-import
Brugeres gruppemedlemskaber hentes fra AD-propertien memberOf. Importreferencen skal matche den fulde distinguished name (DN) på den AD-gruppe, der indeholder de brugere, som skal knyttes til rettighedsgruppen i XFlow.
Den fulde DN kan eksempelvis se sådan ud: CN=Ledere,OU=Gruppe,DC=domain,DC=Local
Indsæt denne streng som importreference på den ønskede rettighedsgruppe i XFlow. Herefter vil alle brugere, der er direkte medlem af AD-gruppen, blive flyttet ind i/ud af rettighedsgruppen ved hver gennemførsel af brugerimporten, afhængigt af om brugerne befinder sig i gruppen i AD'et.
Som nævnt ovenfor kan du godt sætte mere end én importreference på hver rettighedsgruppe.
Bemærk: Brugerne skal være direkte medlemmer af den gruppe i AD'et, der mappes op mod rettighedsgruppen. Importen kan ikke håndtere indirekte medlemskaber.
3. CSV-import
For CSV-import angiver du, hvilken kolonne i CSV-filen der indeholder brugernes gruppemedlemskaber. Dette konfigureres under organisationens CSV-importindstillinger i feltet "Mapning brugergrupper".
Værdien i den angivne kolonne i CSV-filen bruges som importreference. Denne værdi skal matche den importreference, der er sat på rettighedsgruppen i XFlow.
Hvis der er sat flueben i "Opret og slet brugergrupper automatisk" under CSV-importens konfiguration, vil XFlow automatisk:
Oprette nye rettighedsgrupper for importreferencer, der ikke allerede findes
Slette (deaktivere) rettighedsgrupper med importreferencer, som ingen brugere længere tilhører i importkilden
Bemærk: Hvis automatisk sletning er aktiveret, vil grupper uden tilknyttede brugere i importkilden blive slettet.
4. Public API
Når du sender brugere til XFlow via Public API'et, angiver du importreferencer i feltet GroupImportReferences som en liste af strenge:
Tilgængelige API-endpoints:
EndpointBeskrivelsePOST /UserImport/ImportUsers
Importerer brugere og inaktiverer brugere, der ikke er med i requesten
POST /UserImport/ImportUsersNoInactivating
Importerer brugere uden at inaktivere fraværende brugere
POST /UserImport/TestImport
Tester importen uden at ændre data
POST /UserImport/TestImportNoInactivating
Tester importen uden inaktivering og uden at ændre data
Bemærk at GroupImportReferences er en liste af importreferencer — ikke gruppenavne. Referencerne skal matche de importreferencer, der er sat på rettighedsgrupperne i XFlow.
Eksempel på request body:
{
"users": [
{
"FirstName": "Hans",
"LastName": "Jensen",
"Email": "hans@kommune.dk",
"GroupImportReferences": ["Økonomi-team", "Ledere"]
}
],
"failedUsers": []
}