AD Writeback Agent

AD Writeback Agent holder attributter på eksisterende AD-brugerkonti opdateret med data fra SOFD Core (fx navn, titel og telefonnummer) ud fra en konfigurerbar feltmapning. Dette dokument beskriver installation og konfiguration.

Indledning#

Forudsætninger#

Windows Server#

Servicen skal installeres på en Windows maskine med:

• Netværksmæssig adgang til kommunens AD
• Netværksmæssig adgang til SOFD Core i skyen via HTTPS.
• .NET Framework 4.6.1 eller nyere

Service konto i AD#

Der skal oprettes en service konto i kommunes AD.

Kontoen skal have skriveadgang til alle de bruger-attributter der skal opdateres fra SOFD Core, inkl CPR nummer attributten.

Bemærk at kontoen skal være medlem af Domain Admins hvis den skal kunne opdatere oplysninger på brugere som er eller har været medlem af en beskyttet gruppe (f.eks. andre domain admins). En konto som “kun” er Account Operator kan ikke opdatere oplysninger på en bruger som har attributten AdminCount sat til 1.

API bruger til SOFD Core backend#

Der skal i konfigurationen indtastes en API nøgle til SOFD Core. Denne kan oprettes i SOFD Cores administrative brugergrænseflade. Agenten kan nøjes med læseadgang.

Installation af Windows Service#

Der skal installeres og konfigureres en Windows Service på en server hvor der er netværksmæssig adgang til kommunens AD samt SOFD Core i skyen via HTTPS.

Download service#

Hent installeren via download-linket øverst på siden eller fra den samlede Download-oversigt.

Konfiguration af service#

Konfiguration af servicen foretages i applicationSettings sektionen i xml-filen SOFD Core AD Writeback Agent.exe.config som ligger i roden af installationsmappen (default C:\Program Files (x86)\Digital Identity\SofdCoreAdWritebackAgent).

Start af service#

Efter servicen er konfigureret startes den via Windows Services eller tilsvarende kommandolinjeværktøjer. Her er det vigtigt at servicen konfigureres til at starte med den AD konto som har de fornødne rettigheder.

Konfiguration af attribute-opdatering#

Konfigurationen af hvilke attributter der skal holdes opdateret hedder

ad-mapping.xml

Denne fil indeholder en konfiguration af hvilke felter fra SOFD der skal kopieres til hvilke felter i AD.

Der følger en eksempelfil med, som man bør tilrette. Eksempelfilen ser sådan her ud

<?xml version="1.0" encoding="utf-8" ?>
<mappings>
  <mapping sofd="firstname" ad="givenName" />
  <mapping sofd="affiliation.positionName" ad="title" />
  <mapping sofd="affiliation.orgUnit.ean" ad="extensionattribute4" />
</mappings>

For hver attribut fra SOFD man ønsker kopieret til en attribut i AD, skal der være en <mapping> i filen. Denne peger på hhv en attribut i SOFD, og en attribut på bruger-objekterne i AD.

Attributnavnene i AD kan man finde i sit AD, og attributterne i SOFD kan man finde ved at lave API opslag i SOFD (det er API attribut-navnene der skal anvendes).

Digital Identity kan også hjælpe med udfyldelsen af filen.

Hvor der er flere mulige værdier i SOFD, vælges altid den primære at kopiere til AD. Fx den tredje mapping i eksempelfilen, hvor der står

<mapping sofd="affiliation.orgUnit.ean" ad="extensionattribute4" />

En “affiliation” er et tilhørsforhold, og en medarbejder kan have flere tilhørsforhold (fx flere ansættelser). Når man laver en mapning på denne måde, så vælges det tilhørsforhold som er opmærket som det primære i SOFD.

“affiliation.orgUnit.ean” fortolkes som

• Vælg det primære tilhørsforhold for brugeren
• Find den enhed som tilhørsforholdet er knyttet til
• Udlæse EAN nummeret på den enhed
• Kopier værdien over i extensionattribute4 på bruger-objektet i AD

Bemærk det er kun muligt at kopiere enkelt-attributter fra SOFD Core til AD via denne mekanisme. Man kan ikke flette flere SOFD Core attributter og kopiere dem til ét felt i AD, og man kan ikke flette attributter fra SOFD Core med attributter i AD, og kopiere dem til et nyt felt i AD.

Ændringslog#

Ændringslog for AD Writeback Agent. Nyeste version øverst.