> Source: https://docs.cyberelements.io/identity/7.0/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/CreateModifyMatchingRules/

# 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í.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleAppairageMatchingRule.png)

Pravidla pairingu se vytvářejí z operace. Na stránce [Seznam dostupných operací podle pravidel](https://docs.cyberelements.io/identity/7.0/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleAppairage.png)

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

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ExempleRegleAppairage.png)

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í.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleComparaisonCompareRules.png)

Pravidlo porovnání se vytváří z operace. Na stránce [Seznam dostupných operací podle pravidel](https://docs.cyberelements.io/identity/7.0/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleComparaison.png)

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

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ExempleRegleComparaison.png)

**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í.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleCreationOnCreateRule.png)

Pravidlo vytvoření se vytváří z operace. Na stránce [Seznam dostupných operací podle pravidel](https://docs.cyberelements.io/identity/7.0/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleCreation.png)

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

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ExempleRegleCreation.png)

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

## 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í.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleModificationOnModifyRule.png)

Pravidlo úpravy se vytváří z operace. Na stránce [Seznam dostupných operací podle pravidel](https://docs.cyberelements.io/identity/7.0/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleModification.png)

**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.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ExempleRegleModification.png)

## 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.

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í.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleSuppressionOnDeleteRule.png)

Pravidlo odstranění se vytváří z operace. Na stránce [Seznam dostupných operací podle pravidel](https://docs.cyberelements.io/identity/7.0/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_RegleSuppression.png)

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

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ExempleRegleSuppression.png)

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