Vytvorenie/úprava pravidiel Matching

Pravidlá Matching sú v skutočnosti rôzne pravidlá, v ktorých na jednej strane spárujeme objekty z autoritatívneho a cieľového zdroja a na druhej strane definujeme činnosti, ktoré sa majú vykonať pri jednotlivých akciách: vytvorenie, úprava, odstránenie.

Pravidlá Matching sa teda skladajú z piatich častí:

• Pravidlo na spárovanie dvoch objektov
• Pravidlo na porovnanie atribútov medzi dvoma spárovanými objektmi
• Pravidlo na vytvorenie objektu
• Pravidlo na úpravu objektu
• Pravidlo na odstránenie objektu

Vytvorenie/úprava pravidiel párovania

Pravidlo párovania spočíva v definovaní atribútov autoritatívneho zdroja a atribútov cieľového zdroja, ktoré sa musia zhodovať, aby sa dalo určiť, že objekt v autoritatívnom zdroji zodpovedá objektu v cieľovom zdroji.

V pravidle „Matching“ sa pravidlá párovania definujú v prvom oddiele obrazovky. Kliknutím na „New “ vytvoríte nové pravidlo. Vyberte pravidlo a kliknite na „Modify“, ak ho chcete upraviť, alebo na „Delete“, ak ho chcete odstrániť.

Pravidlá párovania sa vytvárajú z operácie. Operáciu, ktorá zodpovedá vášmu prípadu použitia, si vyberte na stránke Zoznam dostupných operácií podľa pravidiel.

Príklad pravidla párovania: Pri výstupnom zriaďovaní (účty a autorizácie) sme nakonfigurovali párovanie objektov podľa prihlasovacích mien účtov.

Je možné nakonfigurovať viacero pravidiel párovania a definovať poradie, v akom sa použijú.

Vytvorenie pravidiel porovnania

Pravidlo porovnania spočíva v definovaní atribútov autoritatívneho zdroja a atribútov cieľového zdroja, ktoré sa budú navzájom porovnávať, aby sa určili zmeny, ktoré treba vykonať.

V pravidle „Matching“ sa pravidlá porovnania definujú v druhom oddiele obrazovky. Kliknutím na „New “ vytvoríte nové pravidlo. Vyberte pravidlo a kliknite na „Modify“, ak ho chcete upraviť, alebo na „Delete“, ak ho chcete odstrániť.

Pravidlo porovnania sa vytvára z operácie. Operáciu, ktorá zodpovedá vášmu prípadu použitia, si vyberte na stránke Zoznam dostupných operácií podľa pravidiel.

Príklad pravidla porovnania: medzi dvoma zdrojmi sa porovnáva zoznam jednohodnotových atribútov.

Možnosť „Full“: výsledky pravidla porovnania možno pri viachodnotových atribútoch exportovať a zapisovať dvoma spôsobmi:

• Možnosť začiarknutá: ak sa medzi dvoma atribútmi zistí zmena, exportovaná značka, ktorá bude mať názov atribútu cieľového zdroja, bude obsahovať iba konečné hodnoty atribútu. Nepoznáme podrobnosti o odstránených hodnotách a nových pridaných hodnotách, ani hodnoty, ktoré sa nezmenili.
• Možnosť nezačiarknutá: ak sa medzi dvoma atribútmi zistí zmena, môžu sa exportovať dve značky s názvom atribútu cieľového zdroja. Prvá značka obsahuje podoperáciu „ADD“ a druhá značka podoperáciu „DEL“. Značka podoperácie „ADD“ bude obsahovať iba nové hodnoty, ktoré sa majú pridať, a značka podoperácie „DEL“ iba hodnoty, ktoré sa majú odstrániť. V tomto prípade nevieme, či existujú nezmenené hodnoty.

Túto možnosť treba zvoliť podľa konektora a operácií, ktoré sa majú vykonať v jednotlivých pravidlách vytvorenia, úpravy alebo odstránenia.

Je možné nakonfigurovať viacero pravidiel porovnania a všetky sa použijú na všetky spárované objekty.

Vytvorenie/úprava pravidiel vytvorenia

Pravidlo vytvorenia spočíva v definovaní na jednej strane hodnoty identifikačného atribútu, ktorá sa použije pri zápise vytvorení, a na druhej strane atribútov a ich hodnôt, ktoré sa zriadia v cieľovom zdroji pre všetky objekty definované ako vytvorenia. Objekt je definovaný ako vytvorenie, keď sa nachádza v autoritatívnom zdroji, ale nie v cieľovom zdroji. Hodnoty atribútov možno napĺňať z atribútov autoritatívneho zdroja; hovorí sa tomu mapovanie atribútov. Hodnoty atribútov môžu pochádzať aj z atribútov nakonfigurovaných v pravidlách konverzie alebo môžu byť zadané pomocou operácií a kľúčových slov.

V pravidle „Matching“ sa pravidlá vytvorenia definujú v treťom oddiele obrazovky. Kliknutím na „New “ vytvoríte nové pravidlo. Vyberte pravidlo a kliknite na „Modify“, ak ho chcete upraviť, alebo na „Delete“, ak ho chcete odstrániť.

Pravidlo vytvorenia sa vytvára z operácie. Operáciu, ktorá zodpovedá vášmu prípadu použitia, si vyberte na stránke Zoznam dostupných operácií podľa pravidiel.

Príklad pravidla vytvorenia: Mapovanie jednohodnotových alebo viachodnotových atribútov medzi autoritatívnym zdrojom a cieľovým zdrojom.

Je možné nakonfigurovať viacero pravidiel vytvorenia a všetky sa použijú na všetky objekty identifikované ako vytvárané.

Osobitný prípad úložísk typu adresár:

Pri novom konektore adresára treba v pravidle vytvorenia vyplniť atribút objectClass. Na tento účel vytvorte atribút objectClass v pravidle konverzie použitom na zdroj, a to s hodnotami, ktoré zodpovedajú vytváranému objektu:

• pre objekt typu používateľ: Top, Person, organizationalPerson, user
• pre skupinu zabezpečenia: Top, Group

Príklad konfigurácie v SIP:

Formát získaný vo výstupnom súbore sync.xml:

Odporúčanie

Overte v adresári hodnoty atribútu objectClass, ktoré má podobný objekt, aby ste mali istotu, že používate správne hodnoty.

Na zriadenie hesla účtu v adresári treba vyplniť atribút unicodePwd.

Active Directory očakáva v unicodePwd hodnotu zakódovanú v UTF-16 a prenesenú v binárnej podobe: konektor túto konverziu vykonáva sám, a to pri vytvorení aj pri úprave. Heslo v pravidle zadajte ako nešifrovaný text, bez predchádzajúceho kódovania. Povaha hodnoty ako „hesla“ sa pri kopírovaní atribútov zachováva.

Pozor

Active Directory prijíma zápis unicodePwd iba cez šifrované pripojenie. Úložisko preto musí byť nakonfigurované v režime LDAPS (predvolene port 636) vždy, keď treba nastavovať alebo upravovať heslá, a účet služby konektora musí mať právo obnoviť heslo príslušných objektov.

Poznámka

Ak atribút objectClass nie je vyplnený, konektor predvolene použije pre používateľa hodnoty top, person, organizationalPerson a user v Active Directory alebo top, person, organizationalPerson a inetOrgPerson v OpenLDAP. Na tieto hodnoty sa nespoliehajte: atribút objectClass vždy vyplňte explicitne, ako je uvedené vyššie.

Vytvorenie/úprava pravidiel úpravy

Pravidlo úpravy spočíva v definovaní na jednej strane hodnoty identifikačného atribútu, ktorá sa použije pri zápise úprav, a na druhej strane, voliteľne, atribútov a ich hodnôt, ktoré sa zriadia v cieľovom zdroji pre všetky objekty definované na úpravu. Treba poznamenať, že pri objektoch definovaných na úpravu sa výsledky pravidiel porovnania automaticky uvedú v pravidle úpravy.

V pravidle „Matching“ sa pravidlá úpravy definujú vo štvrtom oddiele obrazovky. Kliknutím na „New “ vytvoríte nové pravidlo. Vyberte pravidlo a kliknite na „Modify“, ak ho chcete upraviť, alebo na „Delete“, ak ho chcete odstrániť.

Pravidlo úpravy sa vytvára z operácie. Operáciu, ktorá zodpovedá vášmu prípadu použitia, si vyberte na stránke Zoznam dostupných operácií podľa pravidiel.

Príklad pravidla úpravy: Definícia identifikačného atribútu objektu, ktorý sa má upraviť v cieľovom zdroji (adresári). Atribút „DNuser“ sa zadáva pomocou výrazu, ktorý používa kľúčové slovo „SyncAttDst“ na získanie hodnoty atribútu DN v cieľovom zdroji.

Vytvorenie/úprava pravidiel odstránenia

Pravidlo odstránenia spočíva v definovaní na jednej strane hodnoty identifikačného atribútu, ktorá sa použije pri zápise odstránení, a na druhej strane, voliteľne, atribútov a ich hodnôt, ktoré sa zapíšu do cieľového zdroja pre všetky objekty definované na odstránenie. Zmeny atribútov objektov definovaných na odstránenie sú možné iba vtedy, keď sa objekt v skutočnosti neodstraňuje. Objekt je definovaný na odstránenie, keď sa nachádza v cieľovom zdroji, ale nie v autoritatívnom zdroji. Hodnoty atribútov preto môžu pochádzať iba z atribútov nakonfigurovaných v pravidlách konverzie alebo môžu byť zadané priamo v pravidlách odstránenia pomocou operácií a kľúčových slov.

Pozor

Od verzie 7.1 sa operácie pravidla odstránenia už nemôžu odvolávať na cieľový zdroj. Keďže všetko, čo sa zistí na odstránenie, sa nevyhnutne nachádza v cieľovom zdroji, už nemá zmysel uvádzať, že sa tam budú informácie hľadať. Použite kľúčové slovo „SyncAttSrc“ alebo operácie COPY, MULTCOPY atď. Pri upgrade sa existujúce konektory migrujú automaticky.

Táto migrácia prebieha pri načítaní konfigurácie: modul použije nasledujúce mapovanie.

V pravidle odstránenia, pred verziou 7.1	Nahradené
SyncAttDst (napríklad <SyncAttDst:attribut>)	SyncAttSrc
DSTCOPY	COPY
MULTDSTCOPY	MULTCOPY

Napriek tomu opravte svoje pravidlá, ktoré používajú tieto kľúčové slová: zobrazená konfigurácia bude potom zodpovedať tomu, čo modul vykonáva. ⚠ Nahradenie sa týka textu pravidla bez ohľadu na veľkosť písmen: zasahuje aj kľúčové slová, ktoré tieto výrazy obsahujú, napríklad SyncAttDstOperation alebo SyncAttDstType. Po upgrade tieto prípady skontrolujte.

V pravidle „Matching“ sa pravidlá odstránenia definujú v piatom oddiele obrazovky. Kliknutím na „New “ vytvoríte nové pravidlo. Vyberte pravidlo a kliknite na „Modify“, ak ho chcete upraviť, alebo na „Delete“, ak ho chcete odstrániť.

Pravidlo odstránenia sa vytvára z operácie. Operáciu, ktorá zodpovedá vášmu prípadu použitia, si vyberte na stránke Zoznam dostupných operácií podľa pravidiel.

Príklad pravidla odstránenia: Definícia identifikačného atribútu objektu, ktorý sa má odstrániť v cieľovom zdroji (adresári). Atribút „DNuser“ sa zadáva pomocou výrazu, ktorý používa kľúčové slovo „SyncAttSrc“ na získanie hodnoty atribútu DN v cieľovom zdroji.

Je možné nakonfigurovať viacero pravidiel odstránenia a všetky sa použijú na všetky objekty identifikované na odstránenie.