Crearea/modificarea regulilor de Matching¶

Regulile de Matching sunt în realitate diferitele reguli prin care, pe de o parte, se împerechează obiectele din sursa autoritară și din sursa de destinație și, pe de altă parte, se definesc acțiunile care trebuie realizate: creare, modificare, ștergere.

Regulile de Matching se compun, prin urmare, din cinci părți:

Regula de împerechere a două obiecte
Regula de comparare a atributelor între două obiecte împerecheate
Regula de creare a unui obiect
Regula de modificare a unui obiect
Regula de ștergere a unui obiect

Crearea/modificarea regulilor de împerechere¶

O regulă de împerechere constă în definirea atributelor sursei autoritare și a atributelor sursei de destinație care trebuie să corespundă pentru a stabili că obiectul din sursa autoritară corespunde obiectului din sursa de destinație.

În regula „Matching”, regulile de împerechere se definesc în prima casetă a ecranului. Faceți clic pe „New” pentru a crea o regulă nouă. Selectați o regulă și faceți clic pe „Modify” pentru a o modifica sau pe „Delete” pentru a o șterge.

Regulile de împerechere se creează pornind de la o operațiune. Consultați pagina Lista operațiunilor disponibile în funcție de regulă pentru a alege operațiunea de care aveți nevoie pentru cazul dumneavoastră de utilizare.

Exemplu de regulă de împerechere: pentru provizionarea descendentă (conturi și autorizări), împerecherea obiectelor a fost configurată pe numele de conectare ale conturilor.

Este posibil să configurați mai multe reguli de împerechere și să definiți ordinea în care se aplică.

Crearea regulilor de comparare¶

O regulă de comparare constă în definirea atributelor sursei autoritare și a atributelor sursei de destinație care vor fi comparate între ele pentru a determina modificările care trebuie realizate.

În regula „Matching”, regulile de comparare se definesc în a doua casetă a ecranului. Faceți clic pe „New” pentru a crea o regulă nouă. Selectați o regulă și faceți clic pe „Modify” pentru a o modifica sau pe „Delete” pentru a o șterge.

O regulă de comparare se creează pornind de la o operațiune. Consultați pagina Lista operațiunilor disponibile în funcție de regulă pentru a alege operațiunea de care aveți nevoie pentru cazul dumneavoastră de utilizare.

Exemplu de regulă de comparare: se compară o listă de atribute monovaloare între cele două surse.

Opțiunea „Full”: rezultatele unei reguli de comparare pot fi exportate și scrise în două moduri pentru atributele multivaloare:

Opțiune bifată: dacă se detectează o modificare între două atribute, eticheta exportată, care va purta numele atributului sursei de destinație, va conține numai valorile finale ale atributului. Nu se cunoaște detaliul valorilor șterse și al noilor valori adăugate, nici măcar valorile care nu au fost modificate.
Opțiune nebifată: dacă se detectează o modificare între două atribute, pot fi exportate două etichete care poartă numele atributului sursei de destinație. O primă etichetă care conține o suboperațiune „ADD” și o a doua care conține o suboperațiune „DEL”. Eticheta cu suboperațiunea „ADD” va conține numai noile valori care trebuie adăugate, iar eticheta cu suboperațiunea „DEL” numai valorile care trebuie șterse. În acest caz, nu se știe dacă există valori nemodificate.

Această opțiune trebuie aleasă în funcție de conector și de operațiunile care trebuie realizate în diferitele reguli de creare, de modificare sau de ștergere.

Este posibil să configurați mai multe reguli de comparare, care se vor aplica toate tuturor obiectelor împerecheate.

Crearea/modificarea regulilor de creare¶

O regulă de creare constă în definirea, pe de o parte, a valorii atributului de identificare care va fi utilizat la scrierea creărilor și, pe de altă parte, a atributelor și a valorilor lor care vor fi aprovizionate în sursa de destinație pentru toate obiectele definite ca creări. Un obiect este definit ca o creare atunci când este prezent în sursa autoritară, dar nu în sursa de destinație. Valorile atributelor pot fi alimentate din atributele sursei autoritare; aceasta se numește mapare de atribute. Valorile atributelor pot proveni și din atribute configurate în regulile de conversie sau pot fi indicate prin operațiuni și cuvinte-cheie.

În regula „Matching”, regulile de creare se definesc în a treia casetă a ecranului. Faceți clic pe „New” pentru a crea o regulă nouă. Selectați o regulă și faceți clic pe „Modify” pentru a o modifica sau pe „Delete” pentru a o șterge.

O regulă de creare se creează pornind de la o operațiune. Consultați pagina Lista operațiunilor disponibile în funcție de regulă pentru a alege operațiunea de care aveți nevoie pentru cazul dumneavoastră de utilizare.

Exemplu de regulă de creare: maparea atributelor monovaloare sau multivaloare între sursa autoritară și sursa de destinație.

Este posibil să configurați mai multe reguli de creare, care se vor aplica toate tuturor obiectelor identificate ca fiind creări.

Cazul particular al repository-urilor de tip director:

Cu noul conector de director, atributul objectClass trebuie completat în regula de creare. Pentru aceasta, creați atributul objectClass într-o regulă de conversie aplicată sursei, cu valorile corespunzătoare obiectului de creat:

pentru un obiect de tip utilizator: Top, Person, organizationalPerson, user
pentru un grup de securitate: Top, Group

Exemplu de configurare în SIP:

Formatul obținut în fișierul de ieșire sync.xml:

Recomandare

Verificați în director valorile atributului objectClass purtate de un obiect similar, pentru a vă asigura că utilizați valorile corecte.

Pentru a proviziona parola unui cont într-un director, atributul de completat este unicodePwd.

Active Directory așteaptă în unicodePwd o valoare codificată în UTF-16 și transmisă în formă binară: conectorul efectuează el însuși această conversie, atât la creare, cât și la modificare. Furnizați parola în clar în regulă, fără codificare prealabilă. Natura de „parolă” a valorii este păstrată la copierea atributelor.

Atenție

Active Directory acceptă scrierea unicodePwd numai printr-o conexiune criptată. Prin urmare, repository-ul trebuie configurat în LDAPS (portul 636 în mod implicit) de îndată ce trebuie definite sau modificate parole, iar contul de serviciu al conectorului trebuie să aibă dreptul de a reseta parola obiectelor vizate.

Notă

Dacă objectClass nu este completat, conectorul aplică în mod implicit, pentru un utilizator, top, person, organizationalPerson și user pe Active Directory, sau top, person, organizationalPerson și inetOrgPerson pe OpenLDAP. Nu vă bazați pe aceste valori: completați întotdeauna objectClass în mod explicit, așa cum s-a indicat mai sus.

Crearea/modificarea regulilor de modificare¶

O regulă de modificare constă în definirea, pe de o parte, a valorii atributului de identificare care va fi utilizat la scrierea modificărilor și, pe de altă parte, în mod opțional, a atributelor și a valorilor lor care vor fi aprovizionate în sursa de destinație pentru toate obiectele definite ca modificări. Trebuie remarcat că, în obiectele definite ca modificări, rezultatele regulilor de comparare sunt indicate automat în regula de modificare.

În regula „Matching”, regulile de modificare se definesc în a patra casetă a ecranului. Faceți clic pe „New” pentru a crea o regulă nouă. Selectați o regulă și faceți clic pe „Modify” pentru a o modifica sau pe „Delete” pentru a o șterge.

O regulă de modificare se creează pornind de la o operațiune. Consultați pagina Lista operațiunilor disponibile în funcție de regulă pentru a alege operațiunea de care aveți nevoie pentru cazul dumneavoastră de utilizare.

Exemplu de regulă de modificare: definirea atributului de identificare al obiectului care va fi modificat în sursa de destinație (director). Atributul „DNuser” este indicat printr-o expresie care utilizează cuvântul-cheie „SyncAttDst” pentru a recupera valoarea atributului DN din sursa de destinație.

Crearea/modificarea regulilor de ștergere¶

O regulă de ștergere constă în definirea, pe de o parte, a valorii atributului de identificare care va fi utilizat la scrierea ștergerilor și, pe de altă parte, în mod opțional, a atributelor și a valorilor lor care vor fi alimentate în sursa de destinație pentru toate obiectele definite ca ștergeri. Modificarea atributelor pentru obiectele definite ca ștergeri este posibilă numai atunci când obiectul nu este șters efectiv. Un obiect este definit ca o ștergere atunci când este prezent în sursa de destinație, dar nu în sursa autoritară. În consecință, valorile atributelor pot proveni numai din atribute configurate în regulile de conversie sau pot fi indicate direct în regulile de ștergere prin operațiuni și cuvinte-cheie.

Atenție

Începând cu versiunea 7.1, operațiunile unei reguli de ștergere nu mai pot face referire la sursa de destinație. Deoarece tot ce este detectat pentru ștergere se află în mod necesar în sursa de destinație, nu mai este util să se precizeze că informațiile vor fi căutate acolo. Utilizați cuvântul-cheie „SyncAttSrc” sau operațiunile COPY, MULTCOPY etc. La trecerea la o versiune superioară, conectorii existenți sunt migrați automat.

Această migrare are loc la încărcarea configurării: motorul aplică următoarea corespondență.

Într-o regulă de ștergere, înainte de 7.1	Înlocuit cu
`SyncAttDst` (de exemplu `<SyncAttDst:attribut>`)	`SyncAttSrc`
`DSTCOPY`	`COPY`
`MULTDSTCOPY`	`MULTCOPY`

Corectați totuși regulile care utilizează aceste cuvinte-cheie: configurarea afișată va corespunde atunci cu ceea ce execută motorul. ⚠ Înlocuirea se aplică textului regulii, indiferent de majuscule sau minuscule: afectează și cuvintele-cheie care conțin acești termeni, cum ar fi SyncAttDstOperation sau SyncAttDstType. Verificați aceste cazuri după o trecere la o versiune superioară.

În regula „Matching”, regulile de ștergere se definesc în a cincea casetă a ecranului. Faceți clic pe „New” pentru a crea o regulă nouă. Selectați o regulă și faceți clic pe „Modify” pentru a o modifica sau pe „Delete” pentru a o șterge.

O regulă de ștergere se creează pornind de la o operațiune. Consultați pagina Lista operațiunilor disponibile în funcție de regulă pentru a alege operațiunea de care aveți nevoie pentru cazul dumneavoastră de utilizare.

Exemplu de regulă de ștergere: definirea atributului de identificare al obiectului de șters în sursa de destinație (director). Atributul „DNuser” este specificat printr-o expresie care utilizează cuvântul-cheie „SyncAttSrc” pentru a recupera valoarea atributului DN în sursa de destinație.

Este posibil să configurați mai multe reguli de ștergere, care se vor aplica toate tuturor obiectelor identificate ca ștergeri.