Matching-sääntöjen luominen/muokkaaminen

Matching-säännöt ovat todellisuudessa ne eri säännöt, joilla yhtäältä pariutetaan autoritatiivisen ja kohdelähteen kohteet ja toisaalta määritellään eri toiminnoissa suoritettavat toiminnot: luonti, muokkaus, poisto.

Matching-säännöt koostuvat siis viidestä osasta:

• Sääntö kahden kohteen pariuttamiseen
• Sääntö attribuuttien vertaamiseen kahden pariutetun kohteen välillä
• Sääntö kohteen luomiseen
• Sääntö kohteen muokkaamiseen
• Sääntö kohteen poistamiseen

Pariutussääntöjen luominen/muokkaaminen

Pariutussääntö tarkoittaa sitä, että määritellään autoritatiivisen lähteen attribuutit ja kohdelähteen attribuutit, joiden on täsmättävä, jotta todetaan autoritatiivisen lähteen kohteen vastaavan kohdelähteen kohdetta.

Säännössä ”Matching” pariutussäännöt määritellään näytön ensimmäisessä kehyksessä. Napsauta ”New ”, jotta voit luoda uuden säännön. Valitse sääntö ja napsauta ”Modify” muokataksesi sitä tai ”Delete” poistaaksesi sen.

Pariutussäännöt luodaan operaatiosta. Katso sivu Säännöittäin käytettävissä olevien operaatioiden luettelo, jotta voit valita operaation, jota käyttötapauksesi vaatii.

Esimerkki pariutussäännöstä: alavirran provisioinnissa (tilit ja valtuutukset) kohteiden pariutus on määritetty tilien kirjautumisnimien perusteella.

Pariutussääntöjä voi määrittää useita ja määritellä järjestyksen, jossa niitä sovelletaan.

Vertailusääntöjen luominen

Vertailusääntö tarkoittaa sitä, että määritellään autoritatiivisen lähteen attribuutit ja kohdelähteen attribuutit, joita verrataan keskenään tehtävien muutosten määrittämiseksi.

Säännössä ”Matching” vertailusäännöt määritellään näytön toisessa kehyksessä. Napsauta ”New ”, jotta voit luoda uuden säännön. Valitse sääntö ja napsauta ”Modify” muokataksesi sitä tai ”Delete” poistaaksesi sen.

Vertailusääntö luodaan operaatiosta. Katso sivu Säännöittäin käytettävissä olevien operaatioiden luettelo, jotta voit valita operaation, jota käyttötapauksesi vaatii.

Esimerkki vertailusäännöstä: yksiarvoisten attribuuttien luetteloa verrataan kahden lähteen välillä.

Vaihtoehto ”Full”: vertailusäännön tulokset voidaan viedä ja kirjoittaa moniarvoisille attribuuteille kahdella tavalla:

• Vaihtoehto valittu: jos kahden attribuutin välillä havaitaan muutos, viety tagi, jonka nimenä on kohdelähteen attribuutin nimi, sisältää vain attribuutin lopulliset arvot. Poistettujen arvojen, uusien lisättyjen arvojen tai muuttumattomien arvojen yksityiskohtia ei tiedetä.
• Vaihtoehto ei valittuna: jos kahden attribuutin välillä havaitaan muutos, vietyjä tageja voi olla kaksi, ja kummankin nimenä on kohdelähteen attribuutin nimi. Ensimmäinen tagi sisältää alioperaation ”ADD” ja toinen alioperaation ”DEL”. Alioperaation ”ADD” tagi sisältää vain lisättävät uudet arvot, ja alioperaation ”DEL” tagi vain poistettavat arvot. Tässä tapauksessa ei tiedetä, onko muuttumattomia arvoja.

Tämä vaihtoehto on valittava liittimen ja niiden operaatioiden mukaan, jotka on suoritettava eri luonti-, muokkaus- tai poistosäännöissä.

Vertailusääntöjä voi määrittää useita, ja niitä kaikkia sovelletaan kaikkiin pariutettuihin kohteisiin.

Luontisääntöjen luominen/muokkaaminen

Luontisääntö tarkoittaa sitä, että määritellään yhtäältä sen tunnistusattribuutin arvo, jota käytetään luonteja kirjoitettaessa, ja toisaalta attribuutit ja niiden arvot, jotka provisioidaan kohdelähteeseen kaikille luonneiksi määritellyille kohteille. Kohde määritellään luonniksi, kun se on autoritatiivisessa lähteessä mutta ei kohdelähteessä. Attribuuttien arvot voivat tulla autoritatiivisen lähteen attribuuteista; tätä kutsutaan attribuuttien yhdistämiseksi. Attribuuttien arvot voivat tulla myös muunnossäännöissä määritetyistä attribuuteista, tai ne voi määrittää operaatioilla ja avainsanoilla.

Säännössä ”Matching” luontisäännöt määritellään näytön kolmannessa kehyksessä. Napsauta ”New ”, jotta voit luoda uuden säännön. Valitse sääntö ja napsauta ”Modify” muokataksesi sitä tai ”Delete” poistaaksesi sen.

Luontisääntö luodaan operaatiosta. Katso sivu Säännöittäin käytettävissä olevien operaatioiden luettelo, jotta voit valita operaation, jota käyttötapauksesi vaatii.

Esimerkki luontisäännöstä: yksiarvoisten tai moniarvoisten attribuuttien yhdistäminen autoritatiivisen lähteen ja kohdelähteen välillä.

Luontisääntöjä voi määrittää useita, ja niitä kaikkia sovelletaan kaikkiin luonneiksi tunnistettuihin kohteisiin.

Hakemistotyyppisten repository'iden erityistapaus:

Uutta hakemistoliitintä käytettäessä objectClass-attribuutti on täytettävä luontisäännössä. Luo tätä varten objectClass-attribuutti lähteeseen sovellettavassa muunnossäännössä niillä arvoilla, jotka vastaavat luotavaa objektia:

• käyttäjätyyppiselle objektille: Top, Person, organizationalPerson, user
• suojausryhmälle: Top, Group

Esimerkki SIP-määrityksestä:

Tulostiedostossa sync.xml saatava muoto:

Suositus

Tarkista hakemistosta samankaltaisen objektin objectClass-attribuutin arvot varmistaaksesi, että käytät oikeita arvoja.

Kun tilin salasana provisioidaan hakemistoon, täytettävä attribuutti on unicodePwd.

Active Directory odottaa unicodePwd-attribuutissa UTF-16-koodattua ja binäärimuodossa välitettyä arvoa: liitin tekee tämän muunnoksen itse sekä luonnissa että muokkauksessa. Anna salasana säännössä selväkielisenä ilman ennakkokoodausta. Arvon ”salasana”-luonne säilyy, kun attribuutteja kopioidaan.

Huomio

Active Directory hyväksyy unicodePwd-attribuutin kirjoittamisen vain salatun yhteyden kautta. Repository on siis määritettävä LDAPS-yhteydelle (oletuksena portti 636) heti, kun salasanoja on asetettava tai muutettava, ja liittimen palvelutilillä on oltava oikeus nollata kyseisten objektien salasana.

Huomautus

Jos objectClass-attribuuttia ei täytetä, liitin käyttää käyttäjälle oletuksena arvoja top, person, organizationalPerson ja user Active Directory -hakemistossa tai top, person, organizationalPerson ja inetOrgPerson OpenLDAP-hakemistossa. Älä luota näihin arvoihin: täytä objectClass aina eksplisiittisesti, kuten edellä on kuvattu.

Muokkaussääntöjen luominen/muokkaaminen

Muokkaussääntö tarkoittaa sitä, että määritellään yhtäältä sen tunnistusattribuutin arvo, jota käytetään muokkauksia kirjoitettaessa, ja toisaalta valinnaisesti attribuutit ja niiden arvot, jotka provisioidaan kohdelähteeseen kaikille muokattaviksi määritellyille kohteille. On huomattava, että muokattaviksi määritellyissä kohteissa vertailusääntöjen tulokset merkitään automaattisesti muokkaussääntöön.

Säännössä ”Matching” muokkaussäännöt määritellään näytön neljännessä kehyksessä. Napsauta ”New ”, jotta voit luoda uuden säännön. Valitse sääntö ja napsauta ”Modify” muokataksesi sitä tai ”Delete” poistaaksesi sen.

Muokkaussääntö luodaan operaatiosta. Katso sivu Säännöittäin käytettävissä olevien operaatioiden luettelo, jotta voit valita operaation, jota käyttötapauksesi vaatii.

Esimerkki muutossäännöstä: kohdelähteessä (hakemistossa) muutettavan objektin tunnistusattribuutin määritys. Attribuutti ”DNuser” määritetään lausekkeella, joka käyttää avainsanaa ”SyncAttDst” hakeakseen DN-attribuutin arvon kohdelähteestä.

Poistosääntöjen luonti/muokkaus

Poistosääntö tarkoittaa yhtäältä sen tunnistusattribuutin arvon määrittämistä, jota käytetään poistojen kirjoittamisessa, ja toisaalta valinnaisesti niiden attribuuttien ja arvojen määrittämistä, jotka syötetään kohdelähteeseen kaikille poistettaviksi määritetyille objekteille. Poistettaviksi määritettyjen objektien attribuutteja voi muuttaa vain silloin, kun objektia ei todellisuudessa poisteta. Objekti määritetään poistettavaksi, kun se on kohdelähteessä mutta ei auktoritatiivisessa lähteessä. Näin ollen attribuuttien arvot voivat tulla vain muunnossäännöissä määritetyistä attribuuteista tai ne voidaan ilmoittaa suoraan poistosäännöissä toimintojen ja avainsanojen avulla.

Huomio

Versiosta 7.1 alkaen poistosäännön operaatiot eivät voi enää viitata kohdelähteeseen. Koska kaikki poistettavaksi havaittu on välttämättä kohdelähteessä, ei ole enää hyödyllistä määrittää, että tietoja haetaan sieltä. Käytä avainsanaa ”SyncAttSrc” tai operaatioita COPY, MULTCOPY jne. Versiopäivityksen yhteydessä olemassa olevat liittimet siirretään automaattisesti.

Tämä siirto tapahtuu määritystä ladattaessa: moottori soveltaa seuraavaa vastaavuutta.

Poistosäännössä ennen versiota 7.1	Korvataan avainsanalla
SyncAttDst (esimerkiksi <SyncAttDst:attribut>)	SyncAttSrc
DSTCOPY	COPY
MULTDSTCOPY	MULTCOPY

Korjaa kuitenkin sääntösi, joissa näitä avainsanoja käytetään: näytettävä määritys vastaa silloin sitä, mitä moottori suorittaa. ⚠ Korvaus koskee säännön tekstiä kirjainkoosta riippumatta: se koskee myös avainsanoja, jotka sisältävät nämä termit, kuten SyncAttDstOperation tai SyncAttDstType. Tarkista nämä tapaukset versiopäivityksen jälkeen.

Säännössä ”Matching” poistosäännöt määritetään näytön viidennessä lohkossa. Napsauta ”New ” luodaksesi uuden säännön. Valitse sääntö ja napsauta ”Modify” muokataksesi sitä tai ”Delete” poistaaksesi sen.

Poistosääntö luodaan toiminnosta. Katso sivua Sääntökohtaisten käytettävissä olevien toimintojen luettelo valitessasi käyttötapaukseesi sopivaa toimintoa.

Esimerkki poistosäännöstä: poistettavan objektin tunnisteattribuutin määrittely kohdelähteessä (hakemisto). Attribuutti ”DNuser” määritetään lausekkeella, joka käyttää avainsanaa ”SyncAttSrc” DN-attribuutin arvon hakemiseen kohdelähteestä.

Poistosääntöjä voi määrittää useita, ja ne kaikki kohdistuvat kaikkiin poistettaviksi tunnistettuihin objekteihin.