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.
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 oldalt.
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.
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.
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 oldalt.
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.
„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.
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 oldalt.
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.
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:
A kimeneti sync.xml fájlban kapott formátum:
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.
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 oldalt.
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.
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.
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 oldalt.
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.















