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

# Matching-reeglite loomine/muutmine

Matching-reeglid on tegelikult erinevad reeglid, millega ühelt poolt paaristatakse autoriteetse allika ja sihtallika objektid ning teiselt poolt määratletakse erinevate toimingute puhul tehtavad tegevused: loomine, muutmine, kustutamine.

Matching-reeglid koosnevad seega viiest osast:

- Kahe objekti paaristamise reegel
- Kahe paaristatud objekti atribuutide võrdlemise reegel
- Objekti loomise reegel
- Objekti muutmise reegel
- Objekti kustutamise reegel

## Paaristamisreeglite loomine/muutmine

Paaristamisreegel seisneb autoriteetse allika atribuutide ja sihtallika atribuutide määratlemises, mis peavad kattuma, et sedastada, et autoriteetse allika objekt vastab sihtallika objektile.

Reeglis „Matching“ määratletakse paaristamisreeglid kuva esimeses raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

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

Paaristamisreeglid luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte [Saadaolevate operatsioonide loend reeglite kaupa](https://docs.cyberelements.io/identity/7.0/et/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

**Paaristamisreegli näide:** väljundettevalmistuse (kontod ja autoriseerimised) jaoks on objektide paaristamine konfigureeritud kontode kasutajanimede alusel.

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

Võimalik on konfigureerida mitu paaristamisreeglit ja määratleda nende rakendamise järjekord.

## Võrdlusreeglite loomine

Võrdlusreegel seisneb autoriteetse allika atribuutide ja sihtallika atribuutide määratlemises, mida võrreldakse omavahel, et määratleda tehtavad muudatused.

Reeglis „Matching“ määratletakse võrdlusreeglid kuva teises raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

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

Võrdlusreegel luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte [Saadaolevate operatsioonide loend reeglite kaupa](https://docs.cyberelements.io/identity/7.0/et/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

**Võrdlusreegli näide:** kahe allika vahel võrreldakse üheväärtuseliste atribuutide loendit.

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

**Suvand „Full“:** võrdlusreegli tulemusi saab mitmeväärtuseliste atribuutide puhul eksportida ja kirjutada kahel viisil:

- Suvand märgitud: kui kahe atribuudi vahel tuvastatakse muudatus, sisaldab eksporditud märgend, mille nimeks on sihtallika atribuudi nimi, ainult atribuudi lõplikke väärtusi. Kustutatud väärtuste ja lisatud uute väärtuste üksikasju ega isegi muutmata väärtusi pole teada.
- Suvand märkimata: kui kahe atribuudi vahel tuvastatakse muudatus, võib olla kaks eksporditud märgendit, mille nimeks on sihtallika atribuudi nimi. Esimene märgend sisaldab alamoperatsiooni „ADD“ ja teine märgend alamoperatsiooni „DEL“. Alamoperatsiooni „ADD“ märgend sisaldab ainult lisatavaid uusi väärtusi ja alamoperatsiooni „DEL“ märgend ainult kustutatavaid väärtusi. Sel juhul pole teada, kas on muutmata väärtusi.

Selle suvandi valik sõltub konnektorist ja operatsioonidest, mida tuleb teha erinevates loomis-, muutmis- või kustutamisreeglites.

Võimalik on konfigureerida mitu võrdlusreeglit, mida kõiki rakendatakse kõigile paaristatud objektidele.

## Loomisreeglite loomine/muutmine

Loomisreegel seisneb ühelt poolt loomiste kirjutamisel kasutatava tuvastusatribuudi väärtuse määratlemises ja teiselt poolt nende atribuutide ja väärtuste määratlemises, mis valmistatakse sihtallikas ette kõigi loomistena määratletud objektide jaoks. Objekt määratletakse loomisena, kui see on olemas autoriteetses allikas, kuid mitte sihtallikas. Atribuutide väärtusi saab võtta autoriteetse allika atribuutidest; seda nimetatakse atribuutide vastendamiseks. Atribuutide väärtused võivad pärineda ka teisendusreeglites konfigureeritud atribuutidest või need võib määrata operatsioonide ja märksõnade abil.

Reeglis „Matching“ määratletakse loomisreeglid kuva kolmandas raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

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

Loomisreegel luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte [Saadaolevate operatsioonide loend reeglite kaupa](https://docs.cyberelements.io/identity/7.0/et/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

**Loomisreegli näide:** üheväärtuseliste või mitmeväärtuseliste atribuutide vastendamine autoriteetse allika ja sihtallika vahel.

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

Võimalik on konfigureerida mitu loomisreeglit, mida kõiki rakendatakse kõigile loodavateks tuvastatud objektidele.

## Muutmisreeglite loomine/muutmine

Muutmisreegel seisneb ühelt poolt muudatuste kirjutamisel kasutatava tuvastusatribuudi väärtuse määratlemises ja teiselt poolt valikuliselt nende atribuutide ja väärtuste määratlemises, mis valmistatakse sihtallikas ette kõigi muutmiseks määratletud objektide puhul. Tuleb märkida, et muutmiseks määratletud objektides määratakse võrdlusreeglite tulemused muutmisreeglis automaatselt.

Reeglis „Matching“ määratletakse muutmisreeglid kuva neljandas raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

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

Muutmisreegel luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte [Saadaolevate operatsioonide loend reeglite kaupa](https://docs.cyberelements.io/identity/7.0/et/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

**Muutmisreegli näide:** sihtallikas (kataloogis) muudetava objekti tuvastusatribuudi määratlemine. Atribuut „DNuser“ määratakse avaldisega, mis kasutab märksõna „SyncAttDst“, et tuua sihtallikast DN-atribuudi väärtus.

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

## Kustutamisreeglite loomine/muutmine

Kustutamisreegel seisneb ühelt poolt kustutamiste kirjutamisel kasutatava tuvastusatribuudi väärtuse määratlemises ja teiselt poolt valikuliselt nende atribuutide ja väärtuste määratlemises, mis edastatakse sihtallikasse kõigi kustutamiseks määratletud objektide puhul. Kustutamiseks määratletud objektide atribuute saab muuta ainult siis, kui objekti tegelikult ei kustutata. Objekt määratletakse kustutamiseks, kui see on olemas sihtallikas, kuid mitte autoriteetses allikas. Seetõttu saavad atribuutide väärtused pärineda ainult teisendusreeglites konfigureeritud atribuutidest või neid saab määrata otse kustutamisreeglites operatsioonide ja märksõnade abil.

Reeglis „Matching“ määratletakse kustutamisreeglid kuva viiendas raamis. Uue reegli loomiseks klõpsake „New “. Valige reegel ja klõpsake selle muutmiseks „Modify“ või kustutamiseks „Delete“.

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

Kustutamisreegel luuakse operatsiooni põhjal. Kasutusjuhu jaoks vajaliku operatsiooni valimiseks vaadake lehte [Saadaolevate operatsioonide loend reeglite kaupa](https://docs.cyberelements.io/identity/7.0/et/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/).

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

**Kustutusreegli näide:** kustutatava objekti identifitseerimisatribuudi määratlus sihtallikas (kataloog). Atribuut „DNuser“ määratakse avaldisega, mis kasutab võtmesõna „SyncAttDst“, et tuua sihtallikast atribuudi DN väärtus.

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

Võimalik on konfigureerida mitu kustutamisreeglit, mida kõiki rakendatakse kõigile kustutamiseks tuvastatud objektidele.
