Denne artikkelen beskriver vanlige årsaker til at eFeide ikke klarer å opprette en bruker i Active Directory (AD), og gir fremgangsmåter for å identifisere og løse problemet. Artikkelen gjelder systemadministratorer og Feide-koordinatorer i kommuner som bruker eFeide med AD-integrasjon.
Slik leser du eksportloggen
Gå til den aktuelle brukeren i eFeide og åpne Brukerhistorikk. Tabellen viser alle eksportoperasjoner mot tilknyttede systemer.
|
Kolonne |
Beskrivelse |
|---|---|
|
Operasjon |
Type operasjon: |
|
System |
Målsystemet, f.eks. AD-domenet ( |
|
Eksportert |
Tidsstempel for vellykket eksport. Tom dersom eksport feilet. |
|
Feil |
Feilmelding fra målsystemet dersom eksport mislyktes. |
Dersom kolonnen Eksportert er tom og kolonnen Feil inneholder en feilmelding for en Create-operasjon, har AD avvist opprettelsen. Les feilmeldingen og bruk seksjonene nedenfor til å identifisere årsaken.
Feilmelding: «Exception has been thrown by the target of an invocation»
Denne generiske .NET-feilmeldingen fra AD betyr at selve kallet mot AD ble utført, men at AD avviste forespørselen internt. Det finnes fire vanlige årsaker.
1. Rettighetsproblemer (Access Denied)
Tjenestekontoen som eFeide bruker mot AD, mangler nødvendige rettigheter til å opprette objekter i den aktuelle OU eller til å skrive til spesifikke attributter.
Vanlige årsaker:
-
Tjenestekontoen har ikke rettigheter til å opprette objekter i den aktuelle OU (Organizational Unit).
-
Tjenestekontoen mangler skrivetilgang til spesifikke attributter, f.eks.
proxyAddressesellermanager.
Løsning: Kontroller at tjenestekontoen eFeide bruker mot AD, har riktige delegerte rettigheter i AD-strukturen. Ta kontakt med AD-administrator i kommunen for å justere tillatelsene.
2. Passordkrav ikke oppfylt
Dersom eFeide forsøker å opprette en bruker med et standardpassord, vil AD avvise forespørselen dersom passordet ikke tilfredsstiller domenets passordpolicy — for eksempel krav til lengde, kompleksitet eller passordhistorikk.
Løsning: Juster passordkravene i eFeide slik at de er minst like strenge som passordpolicyen i AD-domenet. Alternativt kan passordpolicyen i AD forenkles, men dette krever endring i AD-administrasjonsverktøyet.
Merk: Passordkrav i eFeide må alltid være minimum like strenge som alle tilknyttede målsystem for den brukertypen det gjelder (elev eller ansatt).
3. Duplikat eller konflikt på unikt attributt
Active Directory avviser opprettelsen dersom et attributt som må være unikt i domenet, allerede er i bruk på en annen konto.
Vanlige årsaker:
-
UserPrincipalName(UPN) er allerede i bruk på en annen AD-konto. -
sAMAccountNameer allerede i bruk på en annen AD-konto. -
proxyAddresses(e-postadresse) finnes allerede på et annet objekt i AD.
Løsning:
-
Søk etter den aktuelle
sAMAccountNameeller UPN i AD for å identifisere konflikten. -
Avklar om det eksisterer en gammel eller inaktiv konto med samme verdi.
-
Omdøp eller deaktiver den konflikterende kontoen i AD, eller juster navnelogikken for den aktuelle brukeren i eFeide.
4. Ugyldige data eller skjemabrudd
eFeide forsøker å skrive en verdi til et AD-attributt som ikke er tillatt i henhold til AD-skjemaet for det aktuelle domenet.
Vanlige årsaker:
-
Et felt mottar feil datatype (f.eks. tekst der AD forventer tall).
-
Et felt inneholder tegn som ikke støttes av attributtet (f.eks. spesialtegn i
sAMAccountName). -
Et obligatorisk attributt mangler verdi og AD kan ikke opprette objektet.
Løsning: Kontroller hvilke attributter eFeide forsøker å skrive for den aktuelle brukeren under Brukerhistorikk → Detaljer. Identifiser feltet med ugyldig verdi og korriger datakilden (SAS) eller konfigurasjonsmappingen i eFeide.
5. Ambiguøs match — samme mergeattributt-verdi delt av to AD-kontoer
Merk: Mergeattributten er attributten eFeide bruker for å matche en Feidebruker mot en eksisterende AD-konto ved synkronisering — vanligvis employeeNumber, som normalt inneholder fødselsnummer, D-nummer eller DUF-nummer. Attributten er konfigurert i c:\efeide\efeide.client.exe.config og må inneholde en unik verdi per person, siden eFeide bruker den til å avgjøre om en bruker skal kobles til en eksisterende konto eller opprettes som ny.
Dersom to AD-kontoer allerede har samme verdi i mergeattributten, kan ikke eFeide entydig avgjøre hvilken konto som tilhører brukeren som skal provisjoneres. Avhengig av situasjonen kan dette enten blokkere opprettelsen eller føre til at eFeide oppdaterer feil konto i stedet for å opprette en ny.
Dette kan skje når:
-
Mergeattributt-verdien er satt manuelt på en AD-konto, utenom eFeides normale synkronisering.
-
En tidligere ansatt eller elev fortsatt har en AD-konto med samme
employeeNumbersom en ny person har fått tildelt. -
To personer i kildesystemet har fått samme fødselsnummer, D-nummer eller ansattnummer på grunn av en registreringsfeil.
-
En AD-konto ble migrert eller gjenopprettet fra sikkerhetskopi med en foreldet mergeattributt-verdi som senere er tildelt en annen person i SAS eller HR-systemet.
Løsning:
-
Søk i AD etter alle kontoer med mergeattributt-verdien fra eFeide-loggen eller brukeroppslaget, for eksempel:
Get-ADUser -Filter {employeeNumber -eq "verdi"} -Properties employeeNumber. -
Avklar hvilken konto som er riktig, gjeldende match. Korriger eller fjern mergeattributt-verdien på kontoen som feilaktig deler verdien.
-
Kjør en ny synkronisering når kun én AD-konto har mergeattributt-verdien.
Merk: Fordi mergeattributten styrer matching og ikke opprettelsen direkte, kan denne årsaken være vanskeligere å oppdage enn en tydelig feilmelding. Dersom loggen viser en uventet oppdatering av en eksisterende konto i stedet for et opprettelsesforsøk, eller ingen tydelig AD-feil i det hele tatt, bør du sjekke for en duplikat mergeattributt-verdi før du antar at det er en nettverks- eller rettighetsfeil.
6. Mergeattributt-verdi på en eksisterende konto matcher en annen person
I motsetning til årsak 5 er det her kun én AD-konto involvert — men verdien i mergeattributten på denne kontoen tilfeldigvis matcher identifikatoren til en annen person, som regel en som nå skal opprettes som ny bruker. eFeide finner denne ene eksisterende kontoen som en sikker match og oppdaterer den, i stedet for å opprette en ny konto til den nye brukeren. Det oppstår ingen tvetydighet fra eFeides ståsted, så dette gir som regel ingen feilmelding i det hele tatt: synkroniseringen fremstår som vellykket, men feil person blir koblet til kontoen.
Dette kan skje når:
-
Skoleadministrativt system (SAS) eller HR-systemet gjenbruker ansattnummer etter at en person har sluttet, og en ny person senere får tildelt samme nummer som fortsatt ligger igjen på den tidligere personens AD-konto.
-
Noen har lagt inn feil fødselsnummer, D-nummer eller ansattnummer manuelt på en eksisterende AD-konto, og denne verdien tilfeldigvis samsvarer med en annen persons faktiske identifikator.
-
En datamigrering eller gjenoppretting har etterlatt en utdatert mergeattributt-verdi på en konto som SAS eller HR-systemet senere har tildelt til en annen person.
Løsning:
-
Gå til den nye brukeren i eFeide → Bruker → Brukeranker, og identifiser hvilken eksisterende AD-konto brukeren faktisk er blitt matchet og koblet mot.
-
Avklar hvem denne AD-kontoen egentlig tilhører, og hva riktig mergeattributt-verdi skal være for begge personene det gjelder.
-
Korriger mergeattributt-verdien på den feilaktig matchede AD-kontoen slik at den gjenspeiler sin faktiske eier, slik at verdien frigjøres for riktig person.
-
Gjenopprett brukeranker for den nye brukeren, og kjør en ny synkronisering slik at eFeide oppretter en ny AD-konto.
Merk: Denne årsaken gir normalt ingen feilmelding i eksportloggen — Brukerhistorikk vil vise en vellykket Update-operasjon i stedet for en Create-operasjon, med tom Feil-kolonne. Dersom en bruker mangler egen AD-konto, men Brukerhistorikk ikke viser noen feilmelding, bør du alltid kontrollere brukerankeret og bekrefte at mergeattributt-verdien faktisk tilhører riktig person, før du antar at synkroniseringen ikke har kjørt.
Andre feilmeldinger ved Create-operasjoner
Dersom feilmeldingen i eksportloggen ikke er Exception has been thrown by the target of an invocation, kan det dreie seg om:
-
LDAP-feilkoder (f.eks.
LDAP: error code 49) — indikerer autentiseringssvikt for tjenestekontoen. -
Nettverksfeil — eFeide når ikke AD-agenten. Kontroller at eFeide AD Agent kjører og at brannmurregler tillater trafikk.
-
Tidsavbrudd — AD svarer ikke innen forventet tid. Kontroller AD-agentens logg og serverbelastning.
Ta kontakt med support@identum.no dersom feilen ikke lar seg løse med fremgangsmåtene over.
Relaterte artikler
-
Hvordan kontrollere at passordsynkronisering fra eFeide til AD fungerer
-
Hva gjør jeg dersom synkroniseringen til eFeide har stanset?