AD-ryhmien tuominen Identum eADM:ään
Tässä oppaassa kerrotaan yksityiskohtaisesti, miten olemassa olevat Active Directory (AD) -ryhmät tuodaan Identum eADM:ään. Näin eADM voi ottaa näiden ryhmien hallinnan haltuunsa poistamatta tai luomatta niitä uudelleen. Prosessi sisältää ryhmätietojen viennin CSV-tiedostoon, synkronointimallien määrityksen ja tietojen tuonnin eADM:ään.
Edellytykset
Hallinnollinen käyttöoikeus Active Directory -toimialueen ohjaimeen.
Hallinnollinen pääsy eADM-vuokralaiselle.
PowerShell asennettuna palvelimelle, jolla vienti suoritetaan.
Vaihe 1: AD-ryhmien vienti CSV-tiedostoksi
Jos haluat tuoda ryhmiä, sinun on ensin luotava muotoiltu CSV-tiedosto, joka sisältää ryhmän tiedot. Käytämme PowerShell-skriptiä tarvittavien tietojen poimimiseen Active Directorysta.
Avaa PowerShell ISE tai tekstieditori koneessa, johon on asennettu Active Directory -moduulit.
Kopioi alla oleva skripti.
Tärkeää: Päivitä muuttujat kohdissa Yleiset asetukset, Järjestelmäarvot ja Ryhmät / OY:t vastaamaan ympäristöäsi.
Varmista, että muuttuja
$exportmembersasetetaan"false"tätä erityistä tuontiskenaariota varten.
PowerShell
<#
Description: Exports AD groups to CSV for eADM import.
Usage: Update variables in the "Setup" section before running.
#>
#------ General Setup ------
$customer = "utfjord" # Short customer name, used in file extensions.
$eadm_path = "C:\eadm" # Path to eAdm installation.
$outputfolder = "C:\eadm\tmp\groupexport" # Output directory. Folder must exist.
$exportmembers = "false" # Set to "false" for initial group import.
# ------ System Values ------
$domaincontroller = "DC01" # Name of the DC used for extraction.
$domain = "domain.local"
$mergeAttribute = "employeeNumber" # Unique user attribute (e.g., samaccountName or employeeNumber).
$sourceId = "objectGuid" # Source ID type (objectGuid or samaccountName).
#------ Groups / OUs ------
# Define OUs to export. Add specific OUs to the array below.
$groupOUs = @()
# Add an object for each OU
$groupOUs += @{
DN = "OU=Grupper,OU=Resurser,DC=utfjord,DC=local" # Full DN of the OU.
alias = "Felles" # Short name for the OU (used in filenames).
scope = "SubTree" # Search scope: "SubTree" or "OneLevel".
synctemplateid = "ImportedGroups" # ID of the sync template.
}
#------ Members ------
$userSearchBase = "OU=Brukere,DC=utfjord,DC=local" # Parent OU for member fetch.
<#
Limit user selection to specific OUs if necessary.
Set equal to $userSearchbase if no limitations are needed.
#>
$userOUs = @(
"OU=Brukere,DC=utfjord,DC=local"
)
# // End of Setup
#------ Export Logic ------
# Create Regex for User OU validation
$regex = ""
$userOUs | ForEach-Object { $regex += ".*," + [Regex]::Escape($_) + "$|" }
$regex = $regex.Substring(0,$regex.Length-1)
foreach ($ou in $groupOUs) {
Write-Host "Fetching groups for OU $($ou.DN)"
$groups = Get-ADGroup -filter '*' -searchbase "$($ou.DN)" -searchscope "$($ou.scope)" -properties name,samaccountname,description,ManagedBy,mailnickname,grouptype,groupscope,GroupCategory,Mail,distinguishedName,ObjectGuid
Write-Host "Writing group list to file for OU $($ou.DN) --> $($outputfolder)"
$groups | Select-Object @{Label="name";Expression = {("$($_.samaccountname)")}},`
@{Label="displayname";Expression = {("$($_.name)")}},`
@{Label="sourceid";Expression = {("$($_.$($sourceid))")}},`
mail,description,`
@{Label="GroupType";Expression = {("$($_.groupScope)$($_.GroupCategory)")}},`
@{n='parentPath';e={$_.DistinguishedName -replace '^.*?,(?=[A-Z]{2}=)'}},`
@{Label="groupScope";Expression = {("OnPremAD")}},`
@{Label="ImportedAnchor";Expression = {($_.objectguid)}},`
@{Label="parent";Expression = {($ou.synctemplateid)}} |
ConvertTo-Csv -NoTypeInformation -Delimiter ";" |
ForEach-Object { $_ -replace '"' } |
Out-file -Encoding utf8 -filepath "$($outputfolder)\groups-$($ou.alias).csv"
# Member export logic (Skipped if $exportmembers is false)
if($exportmembers -eq "true") {
foreach ($group in $groups) {
Write-Host "Fetching and writing members to file for group $($group.samaccountname) --> $($outputfolder)"
(Get-ADGroupMember -identity $group.samaccountname -Recursive |
Where-Object {$_.objectClass -eq "user"} |
Get-ADUser -Properties $($mergeattribute) |
Where-Object { $_.DistinguishedName -match $regex -and $_.enabled -eq $True -and $($mergeattribute) -like "*"} |
ForEach-Object { $_.$($mergeattribute) }) -join "," |
Out-file -filepath "$($outputfolder)\members-$($group.samaccountname)_$($customer).csv" -Encoding UTF8
}
}
}
Vaihe 2: Päivitä olemassa olevat synkronointisäännöt
Ennen uusien ryhmien tuontia on varmistettava, että nykyiset ryhmien synkronointimallit eivät yritä viedä näitä ryhmiä takaisin AD:hen, mikä aiheuttaisi päällekkäisyyksiä tai virheitä.
Tarkista kaikki aktiiviset ryhmäsynkronointimallien mallit.
Etsi kuhunkin malliin liittyvä sääntökokonaisuus.
Lisää sääntö sulje pois ryhmät, joissa
Parentattribuutti on yhtä kuinImportedGroups.
Varoitus: Tämän vaiheen laiminlyönti voi johtaa ryhmien päällekkäisyyteen Active Directoryssa.
Vaihe 3: Tuo synkronointimallien määrittäminen
Tarvitset eADM:ssä erityisen synkronointimallien mallin, jotta voit käsitellä tuotuja ryhmiä. Voit joko kopioida valmiiksi tehdyn mallin tai luoda sellaisen manuaalisesti.
Vaihtoehto A: Kopioi mallin vuokralaiselta
Jos sinulla on pääsy "Mallit"-vuokralle, kopioi malli nimeltä "Mallit". AD: Imported groups (sourceid = objectguid). Sääntökokonaisuus AD: Imported groups from OnPremAD objectguid myös kopioidaan.
Vaihtoehto B: Manuaalinen konfigurointi
Jos et voi kopioida mallia, luo uusi malli seuraavilla asetuksilla:
Mallin asetukset:
Nimi:
AD: Imported groups (sourceid = objectguid)Aktiivinen: Kyllä
Esineen tyyppi: Ryhmä:
Synkronointivaihe: AD:n vienti
Kohteen polku:
[IFEMPTYUSE;[ExtensionAttribute2];OU=Groups DC=domain DC=local]Huomautus: Korvaa yllä oleva DN oletusarvoisen ryhmän OU:lla.
Vientiominaisuudet:

Lähde | Kohde | Tyhjä kohde | Ulkoinen avain |
| kuvaus | Ei | |
| cn | Ei | |
| samAccountName | Ei | |
| GroupType | Ei | |
| extensionAttribute1 | Ei | |
| managedBy | Ei | User.Manager |
| displayName | Ei | |
| extensionAttribute3 | Ei | |
| extensionAttribute4 | Ei |
Sääntöjoukon määritys:

Luo sääntökokonaisuus nimeltä "AD: Tuodut ryhmät OnPremAD:stä" ja linkitä se malliin.
Attribuutti: Parent
Termi: On yhtä suuri kuin jokin seuraavista
Väite:
ManualGroupWizard,ImportedGroups
Vaihe 4: Tuo CSV-tiedosto eADM:ään.
Kun CSV-tiedostot on luotu ja mallit määritetty, jatka tuontia.
Kirjaudu sisään eADM:ään.
Siirry sivupalkin kohtaan Ryhmät.
Valitse Manuaalisten ryhmien lähdetiedot.
Käynnistä ohjattu toiminto manuaalisten ryhmien lataamista varten.
Lataa vaiheessa 1 luotu CSV-tiedosto (tiedostot).
Huomautus: Oikeat sarakekuvioinnit tunnistetaan automaattisesti.
Suorita ohjatun toiminnon loppuun viimeistelemällä tuonti.
Tulos: Seuraavassa synkronointisyklissä luodaan ankkuri, joka yhdistää eADM-objektit olemassa oleviin AD-ryhmiin niiden objectGuidin kautta. Voit nyt hallita näitä ryhmiä eADM:n avulla.
4. Yhteenveto tekoälyä ja hakua varten
Tässä asiakirjassa annetaan ohjeet olemassa olevien Active Directory -ryhmien tuomiseen Identum eADM:ään hallintaa varten. Siinä kuvataan PowerShell-skriptin suorittaminen AD-ryhmien viemiseksi CSV-tiedostoon, olemassa olevien synkronointisääntöjen muuttaminen päällekkäisyyksien estämiseksi, oman "Tuodut ryhmät" -synkronointimallin konfigurointi ja "Ohjattu manuaalisten ryhmien lataaminen" eADM:ssä. Tällä menettelyllä luodaan pysyvä yhteys (ankkuri) eADM:n ja AD:n välille poistamatta olemassa olevia tietoja.