Vytvoření/úprava pravidel Matching

Pravidla Matching jsou ve skutečnosti různá pravidla, ve kterých na jedné straně provádíme pairing objektů z autoritativního a cílového zdroje a na druhé straně definujeme akce, které se mají provést u jednotlivých akcí: vytvoření, úprava, odstranění.

Pravidla Matching se tedy skládají z pěti částí:

• Pravidlo pro pairing dvou objektů
• Pravidlo pro porovnání atributů mezi dvěma objekty spojenými pairingem
• Pravidlo pro vytvoření objektu
• Pravidlo pro úpravu objektu
• Pravidlo pro odstranění objektu

Vytvoření/úprava pravidel pairingu

Pravidlo pairingu spočívá v definování atributů autoritativního zdroje a atributů cílového zdroje, které se musí shodovat, aby bylo možné stanovit, že objekt v autoritativním zdroji odpovídá objektu v cílovém zdroji.

V pravidle „Matching“ se pravidla pairingu definují v prvním oddílu na obrazovce. Klikněte na „New “ a vytvořte nové pravidlo. Vyberte pravidlo a klikněte na „Modify“ pro jeho úpravu nebo na „Delete“ pro jeho odstranění.

Pravidla pairingu se vytvářejí z operace. Na stránce Seznam dostupných operací podle pravidel vyberte operaci, kterou potřebujete pro svůj případ použití.

Příklad pravidla pairingu: Pro výstupní zřizování (účty a autorizace) jsme nakonfigurovali pairing objektů podle přihlašovacích jmen účtů.

Je možné nakonfigurovat více pravidel pairingu a definovat pořadí, ve kterém se použijí.

Vytvoření pravidel porovnání

Pravidlo porovnání spočívá v definování atributů autoritativního zdroje a atributů cílového zdroje, které budou vzájemně porovnány, aby se určily změny, které je třeba provést.

V pravidle „Matching“ se pravidla porovnání definují ve druhém oddílu na obrazovce. Klikněte na „New “ a vytvořte nové pravidlo. Vyberte pravidlo a klikněte na „Modify“ pro jeho úpravu nebo na „Delete“ pro jeho odstranění.

Pravidlo porovnání se vytváří z operace. Na stránce Seznam dostupných operací podle pravidel vyberte operaci, kterou potřebujete pro svůj případ použití.

Příklad pravidla porovnání: mezi oběma zdroji se porovnává seznam jednohodnotových atributů.

Možnost „Full“: výsledky pravidla porovnání lze u vícehodnotových atributů exportovat a zapisovat dvěma způsoby:

• Možnost zaškrtnuta: pokud je mezi dvěma atributy zjištěna změna, exportovaná značka, která ponese název atributu cílového zdroje, bude obsahovat pouze konečné hodnoty atributu. Neznáme podrobnosti o odstraněných hodnotách ani o nově přidaných hodnotách, a dokonce ani hodnoty, které nebyly změněny.
• Možnost nezaškrtnutá: pokud je mezi dvěma atributy zjištěna změna, mohou existovat dvě exportované značky nesoucí název atributu cílového zdroje. První značka obsahuje dílčí operaci „ADD“ a druhá značka dílčí operaci „DEL“. Značka dílčí operace „ADD“ bude obsahovat pouze nové hodnoty, které se mají přidat, a značka dílčí operace „DEL“ pouze hodnoty, které se mají odstranit. V takovém případě nelze zjistit, zda existují nezměněné hodnoty.

Tuto možnost je třeba zvolit podle konektoru a operací, které se mají provést v jednotlivých pravidlech vytvoření, úpravy nebo odstranění.

Je možné nakonfigurovat několik pravidel porovnání, která budou všechna použita na všechny objekty spojené pairingem.

Vytvoření/úprava pravidel vytvoření

Pravidlo vytvoření spočívá v definování jednak hodnoty identifikačního atributu, která se použije při zápisu vytvoření, a jednak atributů a jejich hodnot, které budou zřízeny v cílovém zdroji pro všechny objekty definované jako vytvoření. Objekt je definován jako vytvoření, pokud je přítomen v autoritativním zdroji, ale ne v cílovém zdroji. Hodnoty atributů mohou být plněny z atributů autoritativního zdroje; to se označuje jako mapování atributů. Hodnoty atributů mohou také pocházet z atributů nakonfigurovaných v pravidlech převodu nebo mohou být zadány pomocí operací a klíčových slov.

V pravidle „Matching“ se pravidla vytvoření definují ve třetím oddílu na obrazovce. Klikněte na „New “ a vytvořte nové pravidlo. Vyberte pravidlo a klikněte na „Modify“ pro jeho úpravu nebo na „Delete“ pro jeho odstranění.

Pravidlo vytvoření se vytváří z operace. Na stránce Seznam dostupných operací podle pravidel vyberte operaci, kterou potřebujete pro svůj případ použití.

Příklad pravidla vytvoření: Mapování jednohodnotových nebo vícehodnotových atributů mezi autoritativním zdrojem a cílovým zdrojem.

Je možné nakonfigurovat několik pravidel vytvoření, která budou všechna použita na všechny objekty identifikované jako vytvářené.

Zvláštní případ úložišť typu adresář:

U nového konektoru adresáře musí být atribut objectClass naplněn v pravidle vytvoření. Za tímto účelem vytvořte atribut objectClass v pravidle převodu použitém na zdroj, s hodnotami odpovídajícími objektu, který se má vytvořit:

• pro objekt typu uživatel: Top, Person, organizationalPerson, user
• pro skupinu zabezpečení: Top, Group

Příklad konfigurace v SIP:

Formát získaný ve výstupním souboru sync.xml:

Doporučení

Ověřte v adresáři hodnoty atributu objectClass u podobného objektu, abyste měli jistotu, že používáte správné hodnoty.

Pro zřízení hesla účtu v adresáři je třeba naplnit atribut unicodePwd.

Active Directory očekává v unicodePwd hodnotu kódovanou v UTF-16 a přenášenou v binární podobě: konektor tento převod provádí sám, při vytvoření i při úpravě. Zadejte heslo v pravidle v prostém textu, bez předchozího kódování. Povaha „hesla“ dané hodnoty se při kopírování atributů zachovává.

Upozornění

Active Directory přijímá zápis unicodePwd pouze přes šifrované připojení. Úložiště proto musí být nakonfigurováno v režimu LDAPS (ve výchozím nastavení port 636), jakmile je třeba nastavovat nebo měnit hesla, a účet služby konektoru musí mít právo resetovat heslo dotčených objektů.

Poznámka

Pokud objectClass není naplněn, konektor ve výchozím nastavení použije pro uživatele hodnoty top, person, organizationalPerson a user ve službě Active Directory nebo top, person, organizationalPerson a inetOrgPerson v OpenLDAP. Na tyto hodnoty se nespoléhejte: atribut objectClass vždy naplňte explicitně, jak je uvedeno výše.

Vytvoření/úprava pravidel úpravy

Pravidlo úpravy spočívá v definování jednak hodnoty identifikačního atributu, která se použije při zápisu úprav, a jednak volitelně atributů a jejich hodnot, které budou zřízeny v cílovém zdroji u všech objektů definovaných k úpravě. Je třeba poznamenat, že u objektů definovaných k úpravě se výsledky pravidel porovnání automaticky uvádějí v pravidle úpravy.

V pravidle „Matching“ se pravidla úpravy definují ve čtvrtém oddílu na obrazovce. Klikněte na „New “ a vytvořte nové pravidlo. Vyberte pravidlo a klikněte na „Modify“ pro jeho úpravu nebo na „Delete“ pro jeho odstranění.

Pravidlo úpravy se vytváří z operace. Na stránce Seznam dostupných operací podle pravidel vyberte operaci, kterou potřebujete pro svůj případ použití.

Příklad pravidla úpravy: Definice identifikačního atributu objektu, který se má upravit v cílovém zdroji (adresáři). Atribut „DNuser“ se zadává pomocí výrazu, který používá klíčové slovo „SyncAttDst“ k načtení hodnoty atributu DN v cílovém zdroji.

Vytvoření/úprava pravidel odstranění

Pravidlo odstranění spočívá v definování jednak hodnoty identifikačního atributu, která se použije při zápisu odstranění, a jednak volitelně atributů a jejich hodnot, které budou zapsány do cílového zdroje u všech objektů definovaných k odstranění. Změny atributů u objektů definovaných k odstranění jsou možné pouze tehdy, když nedochází ke skutečnému odstranění objektu. Objekt je definován k odstranění, pokud je přítomen v cílovém zdroji, ale ne v autoritativním zdroji. V důsledku toho mohou hodnoty atributů pocházet pouze z atributů nakonfigurovaných v pravidlech převodu nebo mohou být zadány přímo v pravidlech odstranění pomocí operací a klíčových slov.

Upozornění

Od verze 7.1 již operace pravidla odstranění nemohou odkazovat na cílový zdroj. Protože vše, co je zjištěno k odstranění, se nutně nachází v cílovém zdroji, již nemá smysl uvádět, že se informace budou hledat tam. Použijte klíčové slovo „SyncAttSrc“ nebo operace COPY, MULTCOPY atd. Při upgradu se existující konektory migrují automaticky.

Tato migrace probíhá při načtení konfigurace: jádro použije následující mapování.

V pravidle odstranění, před verzí 7.1	Nahrazeno
SyncAttDst (například <SyncAttDst:attribut>)	SyncAttSrc
DSTCOPY	COPY
MULTDSTCOPY	MULTCOPY

Přesto opravte svá pravidla, která tato klíčová slova používají: zobrazená konfigurace pak bude odpovídat tomu, co jádro provádí. ⚠ Nahrazení se uplatňuje na text pravidla bez ohledu na velikost písmen: týká se také klíčových slov, která tyto výrazy obsahují, například SyncAttDstOperation nebo SyncAttDstType. Po upgradu tyto případy zkontrolujte.

V pravidle „Matching“ se pravidla odstranění definují v pátém oddílu na obrazovce. Klikněte na „New “ a vytvořte nové pravidlo. Vyberte pravidlo a klikněte na „Modify“ pro jeho úpravu nebo na „Delete“ pro jeho odstranění.

Pravidlo odstranění se vytváří z operace. Na stránce Seznam dostupných operací podle pravidel vyberte operaci, kterou potřebujete pro svůj případ použití.

Příklad pravidla odstranění: Definice identifikačního atributu objektu, který se má odstranit v cílovém zdroji (adresáři). Atribut „DNuser“ se zadává pomocí výrazu, který používá klíčové slovo „SyncAttSrc“ k načtení hodnoty atributu DN v cílovém zdroji.

Je možné nakonfigurovat více pravidel odstranění, která budou všechna použita na všechny objekty identifikované k odstranění.