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

# Matching szabályok létrehozása/módosítása

A Matching szabályok valójában azok a különböző szabályok, amelyekkel egyrészt párosítjuk a hiteles forrás és a célforrás objektumait, másrészt meghatározzuk a különböző műveletek – létrehozás, módosítás, törlés – során végrehajtandó tevékenységeket.

A Matching szabályok tehát öt részből állnak:

- Két objektum párosításának szabálya
- Két párosított objektum attribútumainak összehasonlítási szabálya
- Objektum létrehozásának szabálya
- Objektum módosításának szabálya
- Objektum törlésének szabálya

## Párosítási szabályok létrehozása/módosítása

A párosítási szabály a hiteles forrás és a célforrás azon attribútumainak meghatározásából áll, amelyeknek egyezniük kell ahhoz, hogy a hiteles forrás objektuma megfeleltethető legyen a célforrás objektumának.

A „Matching” szabályban a párosítási szabályok a képernyő első keretében határozhatók meg. Új szabály létrehozásához kattintson a „New ” gombra. Jelöljön ki egy szabályt, és kattintson a „Modify” gombra a módosításához, vagy a „Delete” gombra a törléséhez.

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

A párosítási szabályok egy műveletből jönnek létre. A használati esetéhez szükséges művelet kiválasztásához tekintse meg a [Szabályonként elérhető műveletek listája](https://docs.cyberelements.io/identity/7.1/hu/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) oldalt.

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

**Példa párosítási szabályra:** A kimenő kiépítéshez (fiókok és engedélyezések) az objektumok párosítását a fiókok bejelentkezési nevei alapján konfiguráltuk.

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

Több párosítási szabály is konfigurálható, és meghatározható az alkalmazásuk sorrendje.

## Összehasonlítási szabályok létrehozása

Az összehasonlítási szabály a hiteles forrás és a célforrás azon attribútumainak meghatározásából áll, amelyeket a rendszer a végrehajtandó módosítások meghatározása érdekében egymással összehasonlít.

A „Matching” szabályban az összehasonlítási szabályok a képernyő második keretében határozhatók meg. Új szabály létrehozásához kattintson a „New ” gombra. Jelöljön ki egy szabályt, és kattintson a „Modify” gombra a módosításához, vagy a „Delete” gombra a törléséhez.

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

Az összehasonlítási szabály egy műveletből jön létre. A használati esetéhez szükséges művelet kiválasztásához tekintse meg a [Szabályonként elérhető műveletek listája](https://docs.cyberelements.io/identity/7.1/hu/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) oldalt.

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

**Példa összehasonlítási szabályra:** egyértékű attribútumok listájának összehasonlítása a két forrás között.

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

**„Full” beállítás:** egy összehasonlítási szabály eredményei többértékű attribútumok esetén kétféleképpen exportálhatók és írhatók:

- Bejelölt beállítás: ha a rendszer két attribútum között változást észlel, az exportált címke, amely a célforrás attribútumának nevét viseli, csak az attribútum végleges értékeit tartalmazza. A törölt és az újonnan hozzáadott értékek részletei, sőt a nem módosított értékek sem ismertek.
- Nem bejelölt beállítás: ha a rendszer két attribútum között változást észlel, két exportált címke is lehet, amely a célforrás attribútumának nevét viseli. Az első címke egy „ADD” alműveletet, a második egy „DEL” alműveletet tartalmaz. Az „ADD” alművelet címkéje csak a hozzáadandó új értékeket, a „DEL” alművelet címkéje pedig csak a törlendő értékeket tartalmazza. Ebben az esetben nem ismert, hogy vannak-e nem módosított értékek.

Ezt a beállítást az összekötő, valamint a különböző létrehozási, módosítási vagy törlési szabályokban végrehajtandó műveletek alapján kell kiválasztani.

Több összehasonlítási szabály is konfigurálható, és mindegyiket az összes párosított objektumra alkalmazza a rendszer.

## Létrehozási szabályok létrehozása/módosítása

A létrehozási szabály egyrészt a létrehozások írásakor használt azonosító attribútum értékének, másrészt azoknak az attribútumoknak és értékeiknek a meghatározásából áll, amelyek a létrehozásként meghatározott összes objektum esetében kiépítésre kerülnek a célforrásban. Egy objektum akkor minősül létrehozásnak, ha a hiteles forrásban szerepel, a célforrásban azonban nem. Az attribútumértékek a hiteles forrás attribútumaiból is betáplálhatók; ezt nevezzük attribútumleképezésnek. Az attribútumértékek származhatnak az átalakítási szabályokban konfigurált attribútumokból is, vagy megadhatók műveletek és kulcsszavak segítségével.

A „Matching” szabályban a létrehozási szabályok a képernyő harmadik keretében határozhatók meg. Új szabály létrehozásához kattintson a „New ” gombra. Jelöljön ki egy szabályt, és kattintson a „Modify” gombra a módosításához, vagy a „Delete” gombra a törléséhez.

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

A létrehozási szabály egy műveletből jön létre. A használati esetéhez szükséges művelet kiválasztásához tekintse meg a [Szabályonként elérhető műveletek listája](https://docs.cyberelements.io/identity/7.1/hu/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) oldalt.

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

**Példa létrehozási szabályra:** Egyértékű vagy többértékű attribútumok leképezése a hiteles forrás és a célforrás között.

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

Több létrehozási szabály is konfigurálható, és mindegyiket a létrehozandóként azonosított összes objektumra alkalmazza a rendszer.

**A címtár típusú tárházak speciális esete:**

Az új címtár-összekötő esetén az `objectClass` attribútumot a létrehozási szabályban ki kell tölteni. Ehhez hozza létre az `objectClass` attribútumot egy, a forrásra alkalmazott átalakítási szabályban, a létrehozandó objektumnak megfelelő értékekkel:

- felhasználó típusú objektum esetén: `Top`, `Person`, `organizationalPerson`, `user`
- biztonsági csoport esetén: `Top`, `Group`

Konfigurációs példa a SIP-ben:

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

A kimeneti `sync.xml` fájlban kapott formátum:

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

> **Javaslat**
>
> A megfelelő értékek használatának biztosításához ellenőrizze a címtárban egy hasonló objektum `objectClass` attribútumának értékeit.

Egy fiók jelszavának címtárban való kiépítéséhez az `unicodePwd` attribútumot kell kitölteni.

Az Active Directory az `unicodePwd` attribútumban UTF-16 kódolású, bináris formában továbbított értéket vár: ezt az átalakítást az összekötő maga végzi el, létrehozáskor és módosításkor egyaránt. A jelszót egyszerű szövegként, előzetes kódolás nélkül adja meg a szabályban. Az érték „jelszó” jellege az attribútumok másolásakor megmarad.

> **Figyelem**
>
> Az Active Directory csak **titkosított kapcsolaton** keresztül fogadja el az `unicodePwd` írását. A tárházat ezért **LDAPS** módban kell konfigurálni (alapértelmezés szerint a 636-os porton), amint jelszavakat kell beállítani vagy módosítani, és az összekötő szolgáltatásfiókjának joggal kell rendelkeznie az érintett objektumok jelszavának alaphelyzetbe állításához.

> **Megjegyzés**
>
> Ha az `objectClass` nincs kitöltve, az összekötő felhasználó esetén alapértelmezés szerint Active Directory esetén a `top`, `person`, `organizationalPerson` és `user`, OpenLDAP esetén pedig a `top`, `person`, `organizationalPerson` és `inetOrgPerson` értékeket alkalmazza. Ne hagyatkozzon ezekre az értékekre: mindig adja meg kifejezetten az `objectClass` értékét a fentiek szerint.

## Módosítási szabályok létrehozása/módosítása

A módosítási szabály egyrészt a módosítások írásakor használt azonosító attribútum értékének, másrészt – nem kötelezően – azoknak az attribútumoknak és értékeiknek a meghatározásából áll, amelyek a módosításra meghatározott összes objektum esetében kiépítésre kerülnek a célforrásban. Megjegyzendő, hogy a módosításra meghatározott objektumoknál az összehasonlítási szabályok eredményei automatikusan bekerülnek a módosítási szabályba.

A „Matching” szabályban a módosítási szabályok a képernyő negyedik keretében határozhatók meg. Új szabály létrehozásához kattintson a „New ” gombra. Jelöljön ki egy szabályt, és kattintson a „Modify” gombra a módosításához, vagy a „Delete” gombra a törléséhez.

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

A módosítási szabály egy műveletből jön létre. A használati esetéhez szükséges művelet kiválasztásához tekintse meg a [Szabályonként elérhető műveletek listája](https://docs.cyberelements.io/identity/7.1/hu/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) oldalt.

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

**Példa módosítási szabályra:** A célforrásban (címtárban) módosítandó objektum azonosító attribútumának meghatározása. A „DNuser” attribútum egy olyan kifejezéssel van megadva, amely a „SyncAttDst” kulcsszóval kéri le a célforrásbeli DN-attribútum értékét.

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

## Törlési szabályok létrehozása/módosítása

A törlési szabály egyrészt a törlések írásakor használt azonosító attribútum értékének, másrészt – nem kötelezően – azoknak az attribútumoknak és értékeiknek a meghatározásából áll, amelyek a törlésre meghatározott összes objektum esetében betáplálásra kerülnek a célforrásba. A törlésre meghatározott objektumok attribútumai csak akkor módosíthatók, ha az objektum ténylegesen nem törlődik. Egy objektum akkor minősül törlendőnek, ha a célforrásban szerepel, a hiteles forrásban azonban nem. Ennek következtében az attribútumértékek csak az átalakítási szabályokban konfigurált attribútumokból származhatnak, vagy közvetlenül a törlési szabályokban adhatók meg műveletek és kulcsszavak segítségével.

> **Figyelem**
>
> A 7.1 verziótól kezdve a törlési szabályok műveletei már nem hivatkozhatnak a célforrásra. Mivel minden, amit a rendszer törlésre észlel, szükségszerűen a célforrásban található, már nincs értelme megadni, hogy az információt ott kell keresni. Használja a „SyncAttSrc” kulcsszót vagy a COPY, MULTCOPY stb. műveleteket. Verziófrissítéskor a meglévő összekötők automatikusan migrálódnak.
>
> Ez a migrálás **a konfiguráció betöltésekor** történik: a motor a következő leképezést alkalmazza.
>
> | Törlési szabályban, a 7.1 verzió előtt | Helyettesítő érték |
> |---|---|
> | `SyncAttDst` (például `<SyncAttDst:attribut>`) | `SyncAttSrc` |
> | `DSTCOPY` | `COPY` |
> | `MULTDSTCOPY` | `MULTCOPY` |
>
> Ennek ellenére javítsa ki azokat a szabályait, amelyek ezeket a kulcsszavakat használják: így a megjelenített konfiguráció megegyezik majd azzal, amit a motor végrehajt. ⚠ A csere a szabály szövegére vonatkozik, a kis- és nagybetűktől függetlenül: azokat a kulcsszavakat is érinti, amelyek **tartalmazzák** ezeket a kifejezéseket, például a `SyncAttDstOperation` vagy a `SyncAttDstType` kulcsszót. Verziófrissítés után ellenőrizze ezeket az eseteket.

A „Matching” szabályban a törlési szabályok a képernyő ötödik keretében határozhatók meg. Új szabály létrehozásához kattintson a „New ” gombra. Jelöljön ki egy szabályt, és kattintson a „Modify” gombra a módosításához, vagy a „Delete” gombra a törléséhez.

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

A törlési szabály egy műveletből jön létre. A használati esetéhez szükséges művelet kiválasztásához tekintse meg a [Szabályonként elérhető műveletek listája](https://docs.cyberelements.io/identity/7.1/hu/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) oldalt.

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

**Példa törlési szabályra:** A célforrásban (címtárban) törlendő objektum azonosító attribútumának meghatározása. A „DNuser” attribútum egy olyan kifejezéssel van megadva, amely a „SyncAttSrc” kulcsszóval kéri le a célforrásbeli DN-attribútum értékét.

![]()

Több törlési szabály is konfigurálható, és mindegyiket a törlésre azonosított összes objektumra alkalmazza a rendszer.
