> Source: https://docs.cyberelements.io/identity/7.1/sk/UserDocumentation/AutomaticProvisioningConnectorsManagement/CreateModifyMatchingRules/

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

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

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](https://docs.cyberelements.io/identity/7.1/sk/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

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

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

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

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

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](https://docs.cyberelements.io/identity/7.1/sk/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

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

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

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

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

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](https://docs.cyberelements.io/identity/7.1/sk/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

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

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

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:

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

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

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

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

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

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](https://docs.cyberelements.io/identity/7.1/sk/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

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

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

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

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

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](https://docs.cyberelements.io/identity/7.1/sk/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

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