AD-synkroniseringsmaler | Identum kunnskapsbase

Denne artikkelen beskriver hvordan AD-synkroniseringsmaler for brukere fungerer i eADM, hva de ulike fanene og feltene styrer, og hvordan man konfigurerer tilordninger for eksport og import. Den omhandler de to standardmalene som følger med eADM: «AD: Aktive brukere » og «AD: Deaktiverte brukere».

Hva er en synkroniseringsmal?

En synkroniseringsmal er konfigurasjonsobjektet som styrer hva eADM skriver til Active Directory – og leser ut fra det – i løpet av en synkroniseringssyklus. Den definerer:

Hvilket synkroniseringstrinn utfører malen (f.eks. «Eksporter AD»)?
Hvilket regelsett avgjør hvilke brukere som omfattes av reglene?
Hvor i AD-OU-strukturen brukerobjektene er plassert (objektbane)
Hvilke AD-attributter skrives, og med hvilke verdier (eksporttilordninger)
Hvilke AD-attributter leses inn i eADM igjen (importtilordninger)

Malene finner du under «Automatisering» → «Synkronisering » i navigasjonsmenyen til venstre. Hver mal er oppført etter navn under overskriften «Synkronisering».

Malfiler

Hver synkroniseringsmal har fem faner: Informasjon, Objektbane, Visma, Eksport og Import.

Informasjon

Fanen «Informasjon» viser malens viktigste innstillinger.

Felt	Beskrivelse
Id	Intern numerisk identifikator for malen.
Navn	Visningsnavn, f.eks. AD: Aktive brukere eller AD: Deaktiverte brukere.
Aktiv	Om malen er aktiv. Inaktive maler blir ikke kjørt under synkroniseringssykluser.
Objekttype	Objekttypen eADM som denne malen bruker. Begge standard-AD-malene bruker «User».
Beskrivelse	Valgfri beskrivelse i fritekst.
Synkroniseringstrinn	Synkroniseringstrinnet som kjører denne malen, vanligvis «Eksporter AD».
Regelsett	Regelsettet som avgjør hvilke brukere som behandles av denne malen. Malen «aktive brukere» bruker et regelsett som samsvarer med aktive ansatte, mens malen «deaktiverte brukere» bruker et regelsett som samsvarer med ansatte som er sagt opp eller deaktivert.
Permanent sletting	Hvis denne funksjonen er aktivert, sletter eADM AD-objektet når brukeren går ut av omfanget. I malen for deaktiverte brukere er dette vanligvis satt til «Ja», med en ventetid før sletting (f.eks. 90 dager) før objektet fjernes permanent.
Slett hjemmekatalogen	Hvis denne funksjonen er aktivert, sletter eADM brukerens hjemmekatalog ved permanent sletting.
Send fullstendig oppdatering for objektet ved endringer	Hvis denne funksjonen er aktivert, skrives alle eksporttilordninger om hver gang det oppdages en endring hos brukeren, i stedet for bare for de endrede attributtene.

Objektbane

Fanen «Objektbane» definerer OU-tilordningen – altså hvor i Active Directory eADM oppretter eller flytter brukerobjekter. Hver oppføring er merket «Objektbane #N» og viser en absolutt bane som er sammensatt av OU- og DC-komponenter.

Eksempler fra standardmalene:

Mal	Eksempel på absolutt sti
AD: Aktive brukere	`OU=Brukere,OU=Brukerkontoer,DC=eksempel,DC=kommune,DC=no`
AD: Deaktiverte brukere	`OU=Disabled users,OU=Brukerkontoer,DC=eksempel,DC=kommune,DC=no`

Når en bruker flyttes fra et aktivt til et deaktivert område, flytter eADM automatisk AD-objektet fra den aktive organisasjonsenheten (OU) til den deaktiverte organisasjonsenheten (OU).

Merk: OU-banen må samsvare med den faktiske OU-strukturen i organisasjonens Active Directory. Feilaktige baner vil føre til feil i eksporten. Kontroller banen med organisasjonens AD-administrator før du konfigurerer.

Eksport

Fanen «Eksport» viser alle eksporttilordninger – altså attributtoppføringene som eADM utfører på AD-brukerobjektet under hver synkroniseringssyklus. Hver rad tilordner ett kildeuttrykk til ett AD-målattributt.

Eksporter kolonner i tilordningsskjemaet

Spalte	Beskrivelse
Id	Intern kartleggingsidentifikator.
Kilde	Verdien eller uttrykket som skrives til målet. Kan være en statisk verdi (f.eks. `512`, `TRUE`, `NO`), en plassholder for et felt (f.eks. `[UserName]`), eller et sammensatt uttrykk ved hjelp av regeluttrykkmotoren (f.eks. `[givenname] [surname]`).
Mål	Navnet på AD-attributtet som får tildelt verdien (f.eks. `samAccountName`, `userPrincipalName`, `displayName`).
Tomt mål	Hvis svaret er «Ja», skriver eADM inn verdien selv om kildeuttrykket gir et tomt resultat – noe som i praksis tømmer attributtet i AD.
Fremmednøkkel	Brukes til relasjonelle oppslag, f.eks. for å finne attributtet «manager» via `User.Manager`.
Regelsett	Hvis denne tilordningen er angitt, utføres den kun når brukeren oppfyller det angitte regelsettet, f.eks. `HRM-brukere`.

Standard eksporttilordninger — AD: Aktive brukere

Kilde	Mål	Merknader
`[UserName]`	`samAccountName`
`[surname]`	`sn`
`[givenname] [surname]`	`displayName`
`[userpassword]`	`userPwd`
`512`	`userAccountControl`	512 = konto med normal tilgang
`[Company]`	`company`
`[givenname] [surname]`	`cn`
`[Mobile]`	`mobile`	Tomt mål: Ja
`[title]`	`title`
`NO`	`c`	Landskode, fast verdi
`[Socialsecuritynumber]`	`employeeID`
`[EmployeeNumber]`	`employeeNumber`	Regelsett: HRM-brukere
`UserId`	`manager`	Fremmednøkkel: User.Manager
`[WorkPhone]`	`telephoneNumber`	Tomt mål: Ja
`[givenname]`	`givenName`
`[Department] - [Title]`	`description`
`[Email]`	`mail`
`[WebUserId]`	`extensionAttribute14`
`[UserName]@eksempelkommune.no`	`userPrincipalName`	Domenesuffikset er organisasjonsspesifikt
`[Department]`	`department`
`[DepartmentNumber]`	`departmentNumber`

Standard eksporttilordninger — AD: Deaktiverte brukere

Kilde	Mål	Merknader
`TRUE`	`msExchHideFromAddressLists`	Skjuler kontoen fra adresseboken i Exchange/M365
`Deaktivert av eAdm [SUBSTRING;0;10;[Deleted]]`	`description`	Skriver en deaktiveringsmerknad med tidsstempel til AD-beskrivelsesattributtet
`514`	`userAccountControl`	514 = deaktivert konto

Import

Fanen «Import» viser importtilordninger – attributter som leses tilbake fra AD til eADM etter eksporttrinnet. Dette brukes til å holde eADM synkronisert med verdier som AD kan oppdatere uavhengig av eADM.

Standardmalen for aktive brukere importerer ett attributt:

Kilde (AD-attributt)	Mål (eADM-felt)	Merknader
`lastLogonTimestamp`	`ExtensionAttribute12`	Start delta-synkronisering: Nei

Konfigurering av UPN og navngivningsstandard for e-post

Den userPrincipalName og mail Tilordningene styrer hvordan eADM setter sammen påloggingsnavn og e-postadresser. Kildeuttrykket blir vurdert opp mot hver brukers HR-data ved synkronisering.

Det anbefalte produksjonsuttrykket bruker [SPLIT] for å hente ut kun det første fornavnet, [CLEAN] og [LOWER] for å normalisere resultatet, to [REPLACE] anmodninger om å rense skilletegn, og [UNIQUE] for å unngå adressekollisjoner:

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

Uttrykket beregnes som følger:

Trinn	Funksjon	Formål
1	`[SPLIT;[GivenName]; ;0]`	Henter ut det første ordet i feltet for fornavn og utelater eventuelle ytterligere fornavn.
2	`[CLEAN;...]`	Fjerner tegn som ikke er tillatt i brukernavn. Merk: `[CLEAN]` beholder bindestreker.
3	`[LOWER;...]`	Konverterer hver del av navnet til små bokstaver før sammenkobling.
4	`firstgivenname.surname`	Punktet som skiller de to delene av navnet, legges til som en bokstavelig verdi i uttrykket.
5	`[REPLACE;...;-;.]`	Erstatt eventuelle gjenværende bindestreker (f.eks. fra etternavn med bindestrek) med prikker.
6	`[REPLACE;...;...;.]`	Samler sammen enhver sekvens på tre prikker (som oppstår når en del av navnet er tom eller kort) til én enkelt prikk.
7	`[UNIQUE;...;Upn;@eksempelkommune.no]`	Sammenligner den genererte verdien med `Upn` attributtet for alle brukere. Hvis det allerede er opptatt, legges det til et løpende nummer. Den tredje parameteren angir e-postdomenet, slik at `[UNIQUE]` utfører kollisjonssjekken på hele adressen.

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

Eksempel med etternavn med bindestrek: GivenName = Per, Surname = Ås-Eksempel → per.as.eksempel@eksempelkommune.no

Merk: Skift ut @eksempelkommune.no med organisasjonens faktiske domene både i adresselitteralet og i [UNIQUE] domeneparameter. Begge forekomstene må stemme overens.

Teste uttrykk med uttrykksbyggeren

Bruk Sysadmin-verktøy → Uttrykksbygger for å forhåndsvise et hvilket som helst kildeuttrykk før du bruker det i en synkroniseringsmal.

Velg «Bruker» som primær objekttype.
Velg en testbruker via «Søk » eller «Velg tilfeldig».
Skriv inn uttrykket i redigeringsfeltet og klikk på «Utfør».
Gå gjennom resultatet og gjenta prosessen med brukere som representerer spesielle tilfeller: navn med bindestrek, fornavn bestående av ett ord, navn med spesialtegn og brukere der det forventes navnekollisjon.

Redigere en synkroniseringsmal

Gå til «Automatisering» → «Synkronisering» og velg malen fra menyen til venstre.
Klikk på «Rediger» (nederst til høyre) for å gå inn i redigeringsmodus, eller bruk blyantikonet (øverst til høyre) for å redigere direkte i teksten.
For å legge til eller endre en eksporttilordning, gå til fanen «Eksport» i redigeringsmodus og oppdater kildeuttrykket for den aktuelle raden.
Lagre malen og utfør en manuell synkronisering på en testgruppe for å kontrollere resultatet før du aktiverer den for alle brukere.

Sist oppdatert: 26. juni 2026