Matching-reeglite loomine/muutmine¶

Matching-reeglid on tegelikult erinevad reeglid, millega ühelt poolt paaristatakse autoriteetse allika ja sihtallika objektid ning teiselt poolt määratletakse erinevate toimingute puhul tehtavad tegevused: loomine, muutmine, kustutamine.

Matching-reeglid koosnevad seega viiest osast:

Kahe objekti paaristamise reegel
Kahe paaristatud objekti atribuutide võrdlemise reegel
Objekti loomise reegel
Objekti muutmise reegel
Objekti kustutamise reegel

Paaristamisreeglite loomine/muutmine¶

Paaristamisreegel seisneb autoriteetse allika atribuutide ja sihtallika atribuutide määratlemises, mis peavad kattuma, et sedastada, et autoriteetse allika objekt vastab sihtallika objektile.

Reeglis „Matching“ määratletakse paaristamisreeglid kuva esimeses raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

Paaristamisreeglid luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte Saadaolevate operatsioonide loend reeglite kaupa.

Paaristamisreegli näide: väljundettevalmistuse (kontod ja autoriseerimised) jaoks on objektide paaristamine konfigureeritud kontode kasutajanimede alusel.

Võimalik on konfigureerida mitu paaristamisreeglit ja määratleda nende rakendamise järjekord.

Võrdlusreeglite loomine¶

Võrdlusreegel seisneb autoriteetse allika atribuutide ja sihtallika atribuutide määratlemises, mida võrreldakse omavahel, et määratleda tehtavad muudatused.

Reeglis „Matching“ määratletakse võrdlusreeglid kuva teises raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

Võrdlusreegel luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte Saadaolevate operatsioonide loend reeglite kaupa.

Võrdlusreegli näide: kahe allika vahel võrreldakse üheväärtuseliste atribuutide loendit.

Suvand „Full“: võrdlusreegli tulemusi saab mitmeväärtuseliste atribuutide puhul eksportida ja kirjutada kahel viisil:

Suvand märgitud: kui kahe atribuudi vahel tuvastatakse muudatus, sisaldab eksporditud märgend, mille nimeks on sihtallika atribuudi nimi, ainult atribuudi lõplikke väärtusi. Kustutatud väärtuste ja lisatud uute väärtuste üksikasju ega isegi muutmata väärtusi pole teada.
Suvand märkimata: kui kahe atribuudi vahel tuvastatakse muudatus, võib olla kaks eksporditud märgendit, mille nimeks on sihtallika atribuudi nimi. Esimene märgend sisaldab alamoperatsiooni „ADD“ ja teine märgend alamoperatsiooni „DEL“. Alamoperatsiooni „ADD“ märgend sisaldab ainult lisatavaid uusi väärtusi ja alamoperatsiooni „DEL“ märgend ainult kustutatavaid väärtusi. Sel juhul pole teada, kas on muutmata väärtusi.

Selle suvandi valik sõltub konnektorist ja operatsioonidest, mida tuleb teha erinevates loomis-, muutmis- või kustutamisreeglites.

Võimalik on konfigureerida mitu võrdlusreeglit, mida kõiki rakendatakse kõigile paaristatud objektidele.

Loomisreeglite loomine/muutmine¶

Loomisreegel seisneb ühelt poolt loomiste kirjutamisel kasutatava tuvastusatribuudi väärtuse määratlemises ja teiselt poolt nende atribuutide ja väärtuste määratlemises, mis valmistatakse sihtallikas ette kõigi loomistena määratletud objektide jaoks. Objekt määratletakse loomisena, kui see on olemas autoriteetses allikas, kuid mitte sihtallikas. Atribuutide väärtusi saab võtta autoriteetse allika atribuutidest; seda nimetatakse atribuutide vastendamiseks. Atribuutide väärtused võivad pärineda ka teisendusreeglites konfigureeritud atribuutidest või need võib määrata operatsioonide ja märksõnade abil.

Reeglis „Matching“ määratletakse loomisreeglid kuva kolmandas raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

Loomisreegel luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte Saadaolevate operatsioonide loend reeglite kaupa.

Loomisreegli näide: üheväärtuseliste või mitmeväärtuseliste atribuutide vastendamine autoriteetse allika ja sihtallika vahel.

Võimalik on konfigureerida mitu loomisreeglit, mida kõiki rakendatakse kõigile loodavateks tuvastatud objektidele.

Kataloogitüüpi hoidlate erijuht:

Uue kataloogikonnektori puhul tuleb loomisreeglis täita atribuut objectClass. Selleks looge atribuut objectClass allikale rakendatavas teisendusreeglis väärtustega, mis vastavad loodavale objektile:

kasutajatüüpi objekti puhul: Top, Person, organizationalPerson, user
turberühma puhul: Top, Group

SIP-i konfiguratsiooni näide:

Väljundfailis sync.xml saadud vorming:

Soovitus

Kontrollige kataloogis sarnase objekti atribuudi objectClass väärtusi, et veenduda õigete väärtuste kasutamises.

Konto parooli kataloogis ettevalmistamiseks tuleb täita atribuut unicodePwd.

Active Directory ootab atribuudis unicodePwd UTF-16 kodeeringus ja binaarkujul edastatud väärtust: konnektor teeb selle teisenduse ise nii loomisel kui ka muutmisel. Esitage parool reeglis lihttekstina, ilma eelneva kodeerimiseta. Atribuutide kopeerimisel säilib väärtuse „parooli“ olemus.

Tähelepanu

Active Directory aktsepteerib atribuudi unicodePwd kirjutamist ainult krüptitud ühenduse kaudu. Seetõttu tuleb hoidla konfigureerida kasutama protokolli LDAPS (vaikimisi port 636) kohe, kui paroole tuleb määrata või muuta, ja konnektori teenusekontol peab olema õigus asjaomaste objektide parooli lähtestada.

Märkus

Kui atribuut objectClass pole täidetud, rakendab konnektor kasutaja puhul vaikimisi väärtused top, person, organizationalPerson ja user Active Directory puhul või top, person, organizationalPerson ja inetOrgPerson OpenLDAP-i puhul. Ärge tuginege neile väärtustele: täitke atribuut objectClass alati selgesõnaliselt, nagu eespool näidatud.

Muutmisreeglite loomine/muutmine¶

Muutmisreegel seisneb ühelt poolt muudatuste kirjutamisel kasutatava tuvastusatribuudi väärtuse määratlemises ja teiselt poolt valikuliselt nende atribuutide ja väärtuste määratlemises, mis valmistatakse sihtallikas ette kõigi muutmiseks määratletud objektide puhul. Tuleb märkida, et muutmiseks määratletud objektides määratakse võrdlusreeglite tulemused muutmisreeglis automaatselt.

Reeglis „Matching“ määratletakse muutmisreeglid kuva neljandas raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

Muutmisreegel luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte Saadaolevate operatsioonide loend reeglite kaupa.

Muutmisreegli näide: sihtallikas (kataloogis) muudetava objekti tuvastusatribuudi määratlemine. Atribuut „DNuser“ määratakse avaldisega, mis kasutab märksõna „SyncAttDst“, et tuua sihtallikast DN-atribuudi väärtus.

Kustutamisreeglite loomine/muutmine¶

Kustutamisreegel seisneb ühelt poolt kustutamiste kirjutamisel kasutatava tuvastusatribuudi väärtuse määratlemises ja teiselt poolt valikuliselt nende atribuutide ja väärtuste määratlemises, mis edastatakse sihtallikasse kõigi kustutamiseks määratletud objektide puhul. Kustutamiseks määratletud objektide atribuute saab muuta ainult siis, kui objekti tegelikult ei kustutata. Objekt määratletakse kustutamiseks, kui see on olemas sihtallikas, kuid mitte autoriteetses allikas. Seetõttu saavad atribuutide väärtused pärineda ainult teisendusreeglites konfigureeritud atribuutidest või neid saab määrata otse kustutamisreeglites operatsioonide ja märksõnade abil.

Tähelepanu

Alates versioonist 7.1 ei saa kustutamisreegli operatsioonid enam viidata sihtallikale. Kuna kõik kustutamiseks tuvastatu on tingimata sihtallikas, pole enam kasulik määrata, et teavet otsitakse sealt. Kasutage märksõna „SyncAttSrc“ või operatsioone COPY, MULTCOPY jne. Versiooniuuenduse käigus migreeritakse olemasolevad konnektorid automaatselt.

See migreerimine toimub konfiguratsiooni laadimisel: mootor rakendab järgmist vastendust.

Kustutamisreeglis enne versiooni 7.1	Asendatakse märksõnaga
`SyncAttDst` (näiteks `<SyncAttDst:attribut>`)	`SyncAttSrc`
`DSTCOPY`	`COPY`
`MULTDSTCOPY`	`MULTCOPY`

Sellegipoolest parandage reeglid, mis neid märksõnu kasutavad: kuvatav konfiguratsioon vastab siis sellele, mida mootor täidab. ⚠ Asendus rakendub reegli tekstile tõstutundetult: see mõjutab ka märksõnu, mis neid termineid sisaldavad, näiteks SyncAttDstOperation või SyncAttDstType. Kontrollige neid juhtumeid pärast versiooniuuendust.

Reeglis „Matching“ määratletakse kustutamisreeglid kuva viiendas raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

Kustutamisreegel luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte Saadaolevate operatsioonide loend reeglite kaupa.

Kustutamisreegli näide: sihtallikas (kataloogis) kustutatava objekti tuvastusatribuudi määratlemine. Atribuut „DNuser“ määratakse avaldisega, mis kasutab märksõna „SyncAttSrc“, et tuua sihtallikast DN-atribuudi väärtus.

Võimalik on konfigureerida mitu kustutamisreeglit, mida kõiki rakendatakse kõigile kustutamiseks tuvastatud objektidele.