Tässä artikkelissa kuvataan yleisimmät syyt, joiden vuoksi eADM ei onnistu luomaan käyttäjätiliä Active Directoryyn (AD), ja annetaan ohjeet kunkin syyn tunnistamiseen ja korjaamiseen. Artikkeli on tarkoitettu eADM-järjestelmänvalvojille ja IT-kumppaneille, jotka hallinnoivat paikallisia AD-integraatioita.
Kuinka lukea eADM AD -vientilokia
eADM:n paikallinen asiakasohjelma tallentaa yksityiskohtaisen lokitiedoston jokaisesta vientitoiminnosta. Tämä lokitiedosto on tärkein vianmääritystyökalu, kun käyttäjätiliä ei ole luotu AD:hen.
Lokitiedostot voi ladata valitsemalla Synkronointi → Tila → Lisää → Lataa eADM-asiakasohjelman loki. Vaihtoehtoisesti ne löytyvät yleensä kansiosta C:\eADM\ tai asennuksen yhteydessä määritetty alikansio. Jokainen merkintä noudattaa seuraavaa kaavaa:
DD.MM.YYYY HH:MM:SS - [action or result message]
Onnistuneessa Create-operaatiossa kirjataan lokiin jokainen asetettu attribuutti, minkä jälkeen ei tule virheriviä. Epäonnistuneessa Create-operaatiossa kirjataan lokiin attribuuttien järjestys, minkä jälkeen operaatio päättyy virhekoodiin ja virheilmoitukseen. Esimerkki epäonnistuneesta luomisesta tunnetusta tukitapauksesta:
23.07.2025 14:20:41 - Creating with LDAP://DC-SERVER/cn=Ola Nordmann,OU=eAdm,OU=Brukere,...\n23.07.2025 14:20:41 - Setting samAccountName to value 1001on\n23.07.2025 14:20:41 - Checking if upn is unique in domain ola.nordmann@eksempel.kommune.no\n23.07.2025 14:20:41 - Setting userPrincipalName to value ola.nordmann@eksempel.kommune.no\n23.07.2025 14:20:41 - 173585349|The object already exists.
Virherivit noudattavat seuraavaa muotoa ERROR_CODE|Error message text. Virhekoodi ja virheilmoitus yhdessä paljastavat syyn. Kirjoita muistiin viimeinen onnistunut attribuuttirivi ennen virhettä — tämä auttaa rajaamaan, missä vaiheessa AD hylkäsi toiminnon.
Huomautus: Jos tietyn synkronointijakson osalta lokimerkintöjä ei näy lainkaan, vika saattaa johtua eADM:n paikallisesta asiakasohjelmasta eikä AD:stä. Katso ohjeet kohdasta ”System.ServiceModel.FaultException -virheen vianmääritys eADM:n paikallisen asiakasohjelman lokitiedostoissa”.
Yleisiä syitä ja ratkaisuja
1. Kaksoiskappale — käyttäjä on jo olemassa AD:ssä
eADM yrittää luoda objektin, jolla on erottuva nimi (DN) tai jolla on sAMAccountName joka on jo olemassa AD:ssä. AD hylkää toiminnon ja antaa virheilmoituksen, kuten The object already exists.
Tämä voi tapahtua, kun:
-
Kaksi työntekijää jakaa saman luodun
sAMAccountName(esim. molemmat johtavat tulokseen1001on). -
Aiemmin poistettu käyttäjätili ei ole poistettu kokonaan AD:stä, ja siitä on jäljellä tombstone-merkintä tai kierrätetty objekti.
-
Käyttäjä luotiin manuaalisesti AD:ssä ennen kuin eADM yritti suorittaa käyttöönoton.
-
Kahdella käyttäjällä on sama syntymäpäivä, mikä aiheuttaa ristiriidan päivämäärään perustuvassa käyttäjätunnuksen luontisäännössä.
Päätös:
-
Etsi AD:stä
sAMAccountNametai lokissa näkyvä CN, jonka avulla ristiriidassa oleva kohde voidaan tunnistaa. -
Avaa eADM:ssä kyseinen käyttäjä ja tarkista AD-käyttäjänimi-kenttä. Jos kahdella käyttäjällä on sama arvo, korjaa toisen käyttäjän arvo joko eADM:n asetusten kautta tai muokkaamalla käyttäjänimen luontisääntöä.
-
Jos AD:ssä on vanhentunut objekti, poista se tai siirrä se pois kohde-OU:sta ja käynnistä sitten uusi synkronointikierros.
Huom: The sAMAccountName sen on oltava ainutlaatuinen koko AD-toimialueella, ei pelkästään kohde-OU:ssa. Tarkista, onko ristiriitoja muissa OU:issa, vaikka ilmeinen reitti vaikuttaisi vapaalta.
2. Palvelutilin käyttöoikeudet eivät ole riittävät
Palvelutilillä, jota eADM käyttää yhteyden muodostamiseen AD:hen, ei ole oikeuksia luoda objekteja kohde-OU:ssa tai sillä ei ole kirjoitusoikeutta yhteen tai useampaan attribuuttiin, jotka määritetään luomisen yhteydessä.
Yleisimmät syyt:
-
Palvelutilillä ei ole ”Luo aliobjekteja” -oikeutta kohde-OU:ssa.
-
Palvelutilillä ei ole kirjoitusoikeutta tiettyihin attribuutteihin, kuten
proxyAddresses,manager, taiemployeeNumber. -
OU-rakenne muuttui sen jälkeen, kun alkuperäinen valtuutus oli määritetty, eikä palvelutilin käyttöoikeudet enää kata uutta kohde-OU:ta.
Ratkaisu: Tarkista AD:n kohde-OU:ssa olevat delegoidut käyttöoikeudet. Varmista, että eADM-palvelutilillä on vähintään seuraavat oikeudet:
-
Luo ja poista käyttäjäobjekteja kohde-OU:ssa.
-
Kirjoitusoikeus kaikkiin kyseisen käyttäjätyypin eADM-vientimallissa määritettyihin attribuutteihin.
Ota yhteyttä asiakkaan AD-järjestelmänvalvojaan valtuutettujen käyttöoikeuksien muokkaamiseksi. Älä myönnä eADM-palvelutilille toimialueen järjestelmänvalvojan oikeuksia.
3. Salasanan monimutkaisuusvaatimukset eivät täyty
Jos eADM on määritetty asettamaan salasana uuden tilin luomisen yhteydessä, AD hylkää tilin luomisen, jos salasana ei täytä toimialueen salasanakäytäntöä – mukaan lukien vähimmäispituus, monimutkaisuusvaatimukset tai salasanahistoriaa koskevat vaatimukset.
Ratkaisu: Tarkista eADM-vientimallissa määritetty oletussalasana ja vertaa sitä toimialueen tarkkaan salasanaohjeeseen (jos sellainen on) tai toimialueen oletusohjeeseen. eADM:n tilin luomisen yhteydessä asettaman salasanan on täytettävä kaikki ohjeiden vaatimukset.
Varoitus: Älä heikennä AD-toimialueen salasanakäytäntöä vastaamaan eADM:ää. Päivitä sen sijaan eADM:n asetuksia niin, että se luo tai asettaa vaatimusten mukaisen salasanan. Toimialueen käytäntöjen heikentäminen vaikuttaa kaikkiin toimialueen tileihin.
4. Virheelliset tiedot tai skeemarikkomus
eADM yrittää kirjoittaa AD-attribuuttiin arvon, jota skeema ei salli kyseiselle toimialueelle — esimerkiksi arvon, jonka tietotyyppi on väärä, arvon, joka sisältää tuettuja merkkejä, tai puuttuvan pakollisen attribuutin.
Yleisimmät syyt:
-
The
sAMAccountNamesisältää merkkejä, joita AD ei salli (esim. välilyöntejä, kauttaviivoja tai laajennettuja merkkejä). -
Schema-laajennuksen edellyttämää pakollista AD-attribuuttia ei ole määritetty eADM-vientimallissa.
-
The
managerattribuutti viittaa DN:ään, jota ei ole AD:ssä, kuten seuraavasta käy ilmiAn invalid dn syntax has been specifiedlokissa. -
The Yläpolku (
parentPath) aktiivisten käyttäjien eADM-vientimallissa määritetty tieto on virheellinen tai puuttuu kyseisen käyttäjän osalta, minkä seurauksena kohde-DN on virheellinen. -
Käyttäjä luodaan käyttämällä
CNarvo, joka ei ole AD:ssä sallittu, esimerkiksi sellainen, joka sisältää merkkejä, joita AD ei salli suhteellisessa erottavassa nimessä. -
Vientimallin numeerinen kenttä lähettää merkkijonoarvon.
Ratkaisu: Selvitä, mikä on viimeinen attribuuttirivi, joka on kirjattu lokiin ennen virhettä. Tarkista kyseiselle attribuutille asetettu arvo eADM-vientimallissa sekä HR-järjestelmän lähdetiedoissa. Korjaa joko tietojen kartoitus eADM:ssä tai lähdearvo HR-järjestelmässä ja käynnistä sitten uusi synkronointi.
Huom: Jos lokitiedostossa näkyy nimenomaan An invalid dn syntax has been specified, tarkista ensin eADM-vientimalli aktiivisten käyttäjien osalta. Varmista, että parentPath arvo on oikea ja täytetty kyseisen käyttäjän osalta, ja että käyttäjää ei luoda virheellisellä CN.
Tämä on yleinen syy vientimallipohjissa, joissa määritellään useita erilaisia parentPath säännöt eri käyttäjäryhmille tai organisaatioyksiköille. Jos säännöt eivät kata kaikkia käyttäjäominaisuuksien yhdistelmiä, käyttäjä voi jäädä kaikkien määriteltyjen sääntöjen ulkopuolelle eikä saa kelvollista parentPath. Tutustu koko sarjaan parentPath vientimallin säännöt, jotta voidaan varmistaa, että niissä otetaan huomioon kaikki mahdolliset tilanteet, ei pelkästään yleisimmät tapaukset.
5. Verkko- tai yhteysongelma AD-agenttiin
eADM-pilvipalvelu ei pääse yhteyteen paikallisen eADM-asiakasohjelman kanssa, tai paikallinen asiakasohjelma ei pääse yhteyteen AD-toimialueen ohjauskoneen kanssa. Tällöin kyseiselle synkronointikierrokselle ei tallenneta lokimerkintöjä, tai lokissa näkyy aikakatkaisu- tai yhteysvirhe AD-kohtaisen virhekoodin sijaan.
Päätös:
-
Varmista, että eADM:n paikallinen asiakaspalvelu tai ajoitettu tehtävä on käynnissä paikallisella palvelimella.
-
Tarkista, että ulospäin suuntautuva HTTPS-liikenne (portti 443) on sallittu palvelimelta eADM-pilvipalvelun päätepisteeseen.
-
Varmista, että palvelin pystyy muodostamaan yhteyden AD-toimialueen ohjauskoneeseen vaaditulla LDAP-portilla (389 tai 636).
-
Tarkista palvelimen Windowsin tapahtumienvalvonnasta, onko siellä yhteys- tai palveluvirheitä.
6. Epäselvä vastaavuus — kahdella AD-tilillä on sama mergeattribute-arvo
Huom: The mergeattribute on se AD-attribuutti, jota eADM käyttää synkronoinnin aikana vastaamaan saapuvaa HR-tietuetta olemassa olevaan AD-tiliin — yleensä employeeID tai employeeNumber. Se määritetään vientimallissa, ja sen on oltava yksilöllinen arvo jokaiselle AD-tilille, sillä eADM käyttää sitä päättäessään, vastaako tietue tiliä, jota sen tulisi päivittää, vai luoda.
Jos kahdella AD-tilillä on jo sama arvo määritetyssä mergeattribute-attribuutissa, eADM ei pysty yksiselitteisesti määrittämään, mikä tili vastaa luotavaa käyttäjää. Tilanteesta riippuen tämä voi joko estää luontitoiminnon tai johtaa siihen, että eADM päivittää väärän tilin uuden tilin luomisen sijaan.
Tämä voi tapahtua, kun:
-
Mergeattribute-arvo on määritetty manuaalisesti AD-tilille eADM:n käyttöönottoprosessin ulkopuolella.
-
Aiemmasta työsuhteesta jäljelle jäänyt AD-tili on edelleen voimassa
employeeIDtaiemployeeNumberuudeksi työntekijäksi. -
Kahdessa henkilöstötietueessa on sama työntekijätunnus (employeeID) tai työntekijänumero (employeeNumber) lähdehenkilöstöjärjestelmässä tapahtuneen tietojen syöttövirheen vuoksi.
-
AD-tili on siirretty tai palautettu varmuuskopiosta, ja sen mergeattribute-arvo oli vanhentunut, minkä jälkeen se on myöhemmin määritetty uudelleen toiselle työntekijälle henkilöstöhallinnossa.
Päätös:
-
Etsi AD:stä kaikki tilit, joiden mergeattribute-arvo on sama kuin eADM-lokissa tai käyttäjätietueessa näkyvä arvo, esimerkiksi:
Get-ADUser -Filter {employeeID -eq "value"} -Properties employeeID. -
Varmista, mikä tili vastaa oikein ja ajantasaisesti HR-tietuetta. Poista tai korjaa mergeattribute-arvo kaikista muista tileistä, joilla on virheellisesti sama arvo.
-
Palauta kyseiset käyttäjät eADM-järjestelmään, jotta linkit vastaaviin AD-käyttäjiin korjautuvat.
Huom: Koska mergeattribute ohjaa pikemminkin vastaavuuksien etsimistä kuin suoraan luomista, tämän syyn havaitseminen voi olla vaikeampaa kuin suoraviivaisen The object already exists virhe. Jos lokissa näkyy odottamaton päivitys olemassa olevaan tiliin sen sijaan, että kyseessä olisi luontiyritys, tai jos lokissa ei näy lainkaan selkeää AD-virhettä, tarkista, onko mergeattribute-arvoa käytetty kahdesti, ennen kuin oletat, että kyseessä on yhteys- tai käyttöoikeusongelma.
7. Olemassa olevan tilin Mergeattribute-arvo vastaa toista käyttäjää
Toisin kuin syy 6:ssa, tässä on kyseessä vain yksi AD-tili – mutta sen mergeattribute-arvo sattuu vastaamaan toisen henkilön tunnistetta, yleensä juuri käyttöönotettavan käyttäjän tunnistetta. eADM tunnistaa tämän olemassa olevan tilin luotettavaksi vastaavuudeksi ja päivittää sen sen sijaan, että luo uuden tilin uudelle käyttäjälle. eADM:n näkökulmasta tilanteessa ei ole epäselvyyttä, joten tämä ei yleensä aiheuta lainkaan virhettä: synkronointi näyttää onnistuneen, mutta tilille liitetään lopulta väärä henkilö.
Tämä voi tapahtua, kun:
-
HR-järjestelmä käyttää työntekijänumeroita uudelleen työntekijän lähdettyä, ja uudelle työntekijälle annetaan myöhemmin sama numero, joka on edelleen entisen työntekijän vanhentuneella AD-tilillä.
-
Joku on syöttänyt virheellisen tiedon manuaalisesti
employeeIDtaiemployeeNumberarvo olemassa olevassa AD-tilissä, ja kyseinen arvo sattuu vastaamaan toisen työntekijän todellista tunnistetta. -
Tietojen siirron tai palautuksen seurauksena tilille jäi vanhentunut mergeattribute-arvo, vaikka henkilöstöosasto on sittemmin siirtänyt kyseisen tilin toiselle henkilölle.
Päätös:
-
Määritä eADM-järjestelmässä, mihin olemassa olevaan AD-tiliin uuden käyttäjän tiedot on yhdistetty ja päivitetty, sen sijaan että luotaisiin uusi tili.
-
Varmista, kenelle kyseinen AD-tili tosiasiassa kuuluu, ja mikä on oikea mergeattribute-arvo molemmille osapuolille.
-
Korjaa virheellisesti yhdistettyyn AD-tiliin liitetty mergeattribute-arvo niin, että se vastaa tilin todellista omistajaa, jolloin arvo vapautuu oikealle henkilölle.
-
Palauta kyseiset käyttäjät eADM-järjestelmään, jotta linkit vastaaviin AD-käyttäjiin korjautuvat.
Huom: Vientilokissa näkyy Update tämän käyttäjän sarja sen sijaan, että Create järjestyksessä, ilman virheriviä. Jos käyttäjä ilmoitetaan kadonneeksi AD:stä, mutta lokista käy ilmi, että attribuutteja päivitetään sen sijaan, että objekti luotaisiin, tarkista, kuuluuko vastaavan tilin mergeattribute-arvo todellisuudessa jollekin toiselle, ennen kuin oletat, että synkronointia ei ole suoritettu.
Diagnoosiluettelo
|
Tarkista |
Mistä etsiä |
|---|---|
|
Näkyykö lokissa kyseisen käyttäjän luontiyritys? |
eADM:n paikallisen asiakassovelluksen loki, |
|
Mikä on virhekoodi viallisella rivillä? |
Logline-kuvaus seuraavassa muodossa |
|
Onko esine, jolla on sama CN-numero, vai |
AD-käyttäjät ja tietokoneet / PowerShell |
|
Näkyykö eADM:n AD-käyttäjätunnuskentässä kahden käyttäjän tiedot päällekkäin? |
eADM-käyttäjäprofiili → AD-käyttäjänimi-kenttä |
|
Onko kahdella AD-tilillä sama mergeattribute-arvo (esim. employeeID)? |
PowerShell |
|
Näkyykö lokissa ”Update”-merkintä ”Create”-merkinnän sijaan käyttäjän kohdalla, jonka pitäisi olla uusi – ja kuuluuko vastaavan tilin mergeattribute-arvo itse asiassa jollekin toiselle? |
eADM:n paikallisen asiakassovelluksen loki, ja vahvista sitten tilin omistaja seuraavasti: |
|
Onko palvelutilillä luontioikeudet kohde-OU:ssa? |
AD:n hallinnan siirto kohde-OU:ssa |
|
Onko paikallinen asiakasohjelma käynnissä? |
Windowsin tehtävien ajoitusohjelma tai palvelut paikallisella palvelimella |
Aiheeseen liittyvät artikkelit