> Source: https://docs.cyberelements.io/identity/7.1/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.1/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.1/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.1/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.1/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.1/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.1/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.1/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.1/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.1/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.1/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.1/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.1/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é.

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-RN-ObjectClassConversionRule.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-RN-ObjectClassSyncXml.png)

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

![](https://docs.cyberelements.io/identity/7.1/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.1/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.1/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.1/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.

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

![](https://docs.cyberelements.io/identity/7.1/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.1/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) vyberte operaci, kterou potřebujete pro svůj případ použití.

![](https://docs.cyberelements.io/identity/7.1/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“ 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í.
