Scripts i AD2-synk

1   Introduksjon

Cerebrum sin integrasjon med AD har støtte for å starte powershell-skript. Dette kan brukes av de som drifter AD som hooks for å gjøre ekstra endringer på de objektene som Cerebrum oppretter, endrer på og avvikler.

Eksempler på endringer som kan gjøres gjennom script-kjøringen:

• For alle nye brukerkontoer: Opprett mailboks i Exchange og legg til i Lync.
• For brukerkontoer som får oppdatert sitt e-postadresse-attributt (ProxyAddresses): Legg til adressene i Exchange.

Script utføres etter at AD-objektet har blitt endret på.

Skriptet må finnes på Windows-maskinen som Cerebrum kommuniserer med (member server). Cerebrum må få vite hvor skriptet befinner seg, dette skal stå i spesifikasjonen til den spesifikke integrasjonen.

2   Hendelser

Følgende hendelser finnes i AD2-synken, og kan få konfigurert script-kjøring:

pre_sync

Kjøres ved synk-start, før data hentes fra AD.

Input: Action, UUID

post_sync

Kjøres ved synk-slutt, etter alle oppdateringer i AD er ferdig.

Input: Action, UUID

new_object

Kjøres etter et objekt har blitt opprettet i AD.

Input: Action, UUID, Identity

move_object

Kjøres ved flytting av objekt.

Input: Action, UUID, Identity, Move_from

Merk at move_object utføres før eventuelle objekt-attributter har blitt oppdatert.

modify_object

Kjøres etter et objekt har fått endret attributter.

Input: Action, UUID, Identity, Changes

Merk at modify_object ikke utføres ved endring av passord.

3   Script

Eksempelscript:

param (
    [string]$action = $(throw "-action is required"),
    [string]$uuid = "no uuid",
    [string]$identity = $null,
    [string]$move_from = $null,
    [string[]]$changes = @()
)

$scptname = “remote-crb-script”
New-EventLog –LogName Application –Source “$scptname" -ErrorAction 'silentlycontinue'
function log # <level> <msg>
{
    Write-EventLog –LogName Application –Source $scptname -ErrorAction 'silentlycontinue' –EventID 1 -EntryType $args[0] –Message “${action}(${uuid}): $($args[1])"
}

try {
    $dump = @{Action="$action";Identity="$identity";AttrChanges="$changes";"Old OU"="$move_from";}
    if ($identity) {
        $dump += @{Type="$(Get-ADObject -Identity $identity | Select -ExpandProperty objectClass)"}
    }
    ConvertTo-Json -Compress $dump
    log Information "success"
} catch {
    log Error "$_"
    throw
}

Merk at AD-synkroniseringen ikke tar hensyn til om script-kjøringen feiler – eventuelle feil må håndteres på domenekontrolleren. Dersom et script feiler, vil synkroniseringen fortsette som normalt.

Det anbefales at script-kjøring logges, og at loggmeldinger inneholder verdien som angies som -UUID til scriptet.

4   Cerebrum drift

Dette avsnittet er ment for de som drifter Cerebrum.

SYNCS['my_sync_type'] = {
    …
    'script': {
        'new_object': r'c:\my_script.ps1',
        'move_object': r'c:\my_script.ps1',
    },
}