Mallar för AD-synkronisering | Identums kunskapsbas

Den här artikeln beskriver hur AD-synkroniseringsmallar för användare fungerar i eADM, vad de olika flikarna och fälten styr samt hur man konfigurerar mappningar för export och import. Den behandlar de två standardmallar som medföljer eADM: AD: Aktiva användare och AD: Inaktiverade användare.

Vad är en synkroniseringsmall?

En synkroniseringsmall är det konfigurationsobjekt som styr vad eADM skriver till Active Directory – och läser ut från det – under en synkroniseringscykel. Den definierar:

Vilket synkroniseringssteg kör mallen (t.ex. Export AD)?
Vilken regeluppsättning avgör vilka användare som omfattas?
Var i AD-OU-strukturen användarobjekten placeras (objektväg)
Vilka AD-attribut skrivs ut och med vilka värden (exportmappningar)
Vilka AD-attribut läses in i eADM (importmappningar)

Mallarna finns under Automatisering → Synkronisering i navigeringsmenyn till vänster. Varje mall visas med sitt namn under rubriken Synkronisering.

Mallflikar

Varje synkroniseringsmall har fem flikar: Information, Objektväg, Visma, Export och Import.

Information om

Fliken ”Information” visar mallens grundläggande inställningar.

Fält	Beskrivning
Id	Internt numeriskt identifieringsnummer för mallen.
Namn	Visningsnamn, t.ex. AD: Aktiva användare eller AD: Inaktiverade användare.
Aktiv	Om mallen är aktiv. Inaktiva mallar körs inte under synkroniseringscyklerna.
Objekttyp	Objekttypen eADM som den här mallen är avsedd för. Båda standardmallarna för AD använder User.
Beskrivning	Valfri beskrivning i fritext.
Synkroniseringssteg	Synkroniseringssteget som kör den här mallen, vanligtvis ”Export AD”.
Regelverk	Den regeluppsättning som avgör vilka användare som ska behandlas av den här mallen. Mallen för aktiva användare använder en regeluppsättning som matchar aktiva medarbetare; mallen för inaktiverade användare använder en regeluppsättning som matchar uppsagda eller inaktiverade medarbetare.
Permanent radering	Om funktionen är aktiverad raderar eADM AD-objektet när användaren lämnar tillämpningsområdet. I mallen för inaktiverade användare är detta vanligtvis inställt på Ja, med en väntetid för radering (t.ex. 90 dagar) innan objektet tas bort permanent.
Ta bort hemkatalogen	Om funktionen är aktiverad raderar eADM användarens hemkatalog vid permanent radering.
Skicka en fullständig uppdatering för objektet vid ändringar	Om denna funktion är aktiverad skrivs alla exportmappningar om varje gång en förändring upptäcks hos användaren, istället för endast när attribut ändras.

Objektets sökväg

Fliken ”Objektväg” definierar OU-mappningen – det vill säga var i Active Directory som eADM skapar eller flyttar användarobjekt. Varje post har beteckningen ”Objektväg #N” och visar en absolut väg som består av OU- och DC-komponenter.

Exempel från standardmallarna:

Mall	Exempel på absolut sökväg
AD: Aktiva användare	`OU=Brukere,OU=Brukerkontoer,DC=eksempel,DC=kommune,DC=no`
AD: Inaktiverade användare	`OU=Disabled users,OU=Brukerkontoer,DC=eksempel,DC=kommune,DC=no`

När en användare flyttas från ett aktivt till ett inaktiverat tillämpningsområde flyttar eADM automatiskt AD-objektet från den aktiva organisationsenheten till den inaktiverade organisationsenheten.

Obs! OU-sökvägen måste stämma överens med den faktiska OU-strukturen i organisationens Active Directory. Felaktiga sökvägar leder till att exporten misslyckas. Kontrollera sökvägen med organisationens AD-administratör innan du gör inställningarna.

Export

På fliken ”Export” visas alla exportmappningar – de attributskrivningar som eADM utför på AD-användarobjektet under varje synkroniseringscykel. Varje rad mappar ett källuttryck till ett AD-målattribut.

Exportera kolumner för mappning

Kolumn	Beskrivning
Id	Intern kartläggningsidentifierare.
Källa	Det värde eller uttryck som skrivs till målet. Kan vara ett statiskt värde (t.ex. `512`, `TRUE`, `NO`), en platshållare för ett fält (t.ex. `[UserName]`), eller ett sammansatt uttryck som skapats med hjälp av regeluttrycksmotorn (t.ex. `[givenname] [surname]`).
Mål	Namnet på det AD-attribut som tilldelas värdet (t.ex. `samAccountName`, `userPrincipalName`, `displayName`).
Tomt mål	Om svaret är ja, skriver eADM in värdet även om källuttrycket ger ett tomt resultat – vilket i praktiken rensar attributet i AD.
Referensnyckel	Används för relationsbaserade uppslag, t.ex. för att fastställa attributet ”chef” via `User.Manager`.
Regelverk	Om denna inställning är aktiverad utförs denna mappning endast när användaren uppfyller den angivna regeluppsättningen, t.ex. `HRM-brukere`.

Standardmappningar för export — AD: Aktiva användare

Källa	Mål	Anmärkningar
`[UserName]`	`samAccountName`
`[surname]`	`sn`
`[givenname] [surname]`	`displayName`
`[userpassword]`	`userPwd`
`512`	`userAccountControl`	512 = normalt aktiverat konto
`[Company]`	`company`
`[givenname] [surname]`	`cn`
`[Mobile]`	`mobile`	Tomt mål: Ja
`[title]`	`title`
`NO`	`c`	Landskod, fast värde
`[Socialsecuritynumber]`	`employeeID`
`[EmployeeNumber]`	`employeeNumber`	Regeluppsättning: HRM-användare
`UserId`	`manager`	Referensnyckel: User.Manager
`[WorkPhone]`	`telephoneNumber`	Tomt mål: Ja
`[givenname]`	`givenName`
`[Department] - [Title]`	`description`
`[Email]`	`mail`
`[WebUserId]`	`extensionAttribute14`
`[UserName]@eksempelkommune.no`	`userPrincipalName`	Domänändelsen är organisationsspecifik
`[Department]`	`department`
`[DepartmentNumber]`	`departmentNumber`

Standardmappningar för export — AD: Inaktiverade användare

Källa	Mål	Anmärkningar
`TRUE`	`msExchHideFromAddressLists`	Döljer kontot från adressboken i Exchange/M365
`Deaktivert av eAdm [SUBSTRING;0;10;[Deleted]]`	`description`	Skriver en avaktiveringsnotering med tidsstämpel till attributet ”description” i Active Directory
`514`	`userAccountControl`	514 = inaktiverat konto

Importera

På fliken ”Import” visas importmappningar – attribut som läses in från AD till eADM efter exporten. Detta används för att hålla eADM synkroniserat med värden som AD kan uppdatera på egen hand.

Standardmallen för aktiva användare importerar ett attribut:

Källa (AD-attribut)	Mål (fältet eADM)	Anmärkningar
`lastLogonTimestamp`	`ExtensionAttribute12`	Starta delta-synkronisering: Nej

Konfigurera UPN och namngivningsstandarden för e-postadresser

Den userPrincipalName och mail Mappningarna styr hur eADM skapar inloggningsnamn och e-postadresser. Källuttrycket utvärderas mot varje användares HR-data vid synkroniseringstillfället.

I det rekommenderade produktionsuttrycket används [SPLIT] för att endast extrahera det första förnamnet, [CLEAN] och [LOWER] för att normalisera resultatet, två [REPLACE] uppmaningar att rensa avgränsningstecken, och [UNIQUE] för att förhindra adresskonflikter:

[UNIQUE;[LOWER;[REPLACE;[REPLACE;[LOWER;[CLEAN;[SPLIT;[GivenName]; ;0]]].[LOWER;[CLEAN;[Surname]]];-;.];...;.]]@eksempelkommune.no;Upn;@eksempelkommune.no]

Uttrycket beräknas enligt följande:

Steg	Funktion	Syfte
1	`[SPLIT;[GivenName]; ;0]`	Hämtar det första ordet i fältet för förnamn och utelämnar eventuella ytterligare förnamn.
2	`[CLEAN;...]`	Tar bort tecken som inte är tillåtna i användarnamn. Obs! `[CLEAN]` behåller bindestreck.
3	`[LOWER;...]`	Omvandlar varje namndel till gemener innan sammanfogningen.
4	`firstgivenname.surname`	En punkt som avgränsare mellan de två namndelarna läggs till som en konstant i uttrycket.
5	`[REPLACE;...;-;.]`	Ersätter eventuella kvarvarande bindestreck (t.ex. från efternamn med bindestreck) med punkter.
6	`[REPLACE;...;...;.]`	Sammanfogar alla sekvenser med tre punkter (som uppstår när en namndel är tom eller kort) till en enda punkt.
7	`[UNIQUE;...;Upn;@eksempelkommune.no]`	Jämför det genererade värdet med `Upn` attribut för alla användare. Om det redan är upptaget läggs ett löpnummer till. Den tredje parametern anger e-postdomänen så att `[UNIQUE]` utför kollisionskontrollen på hela adressen.

Exempel: GivenName = Anne Karin, Surname = Eksempel → anne.eksempel@eksempelkommune.no

Exempel med efternamn med bindestreck: GivenName = Per, Surname = Ås-Eksempel → per.as.eksempel@eksempelkommune.no

Obs! Byt ut @eksempelkommune.no med organisationens faktiska domän både i adressvärdet och i [UNIQUE] domänparameter. Båda förekomsterna måste stämma överens.

Testa uttryck med uttrycksbyggaren

Använd Sysadmin-verktyg → Uttrycksbyggare för att förhandsgranska ett källuttryck innan du tillämpar det på en synkroniseringsmall.

Välj ”Användare” som primär objekttyp.
Välj en testanvändare via Sök eller Välj slumpmässigt.
Skriv in uttrycket i redigeraren och klicka på ”Execute”.
Granska resultatet och upprepa testet med användare som representerar specialfall: namn med bindestreck, förnamn som består av ett enda ord, namn med specialtecken samt användare där en namnskollision förväntas.

Redigera en synkroniseringsmall

Gå till Automatisering → Synkronisering och välj mallen i menyn till vänster.
Klicka på Redigera (längst ner till höger) för att gå till redigeringsläget, eller använd pennikonen (längst upp till höger) för att redigera direkt i texten.
För att lägga till eller ändra en exportmappning går du till fliken ”Export” i redigeringsläget och uppdaterar källuttrycket för den aktuella raden.
Spara mallen och kör en manuell synkronisering på en testgrupp för att kontrollera resultatet innan du aktiverar funktionen för alla användare.

Senast uppdaterad: 26 juni 2026