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

# Ħolqien/modifika tar-regoli ta’ Matching

Ir-regoli ta’ Matching huma fil-fatt ir-regoli differenti li bihom, minn naħa, nakkoppjaw l-oġġetti mis-sors awtorevoli u mis-sors tal-mira u, min-naħa l-oħra, niddefinixxu l-azzjonijiet li għandhom jitwettqu fuq l-azzjonijiet differenti: ħolqien, modifika, tħassir.

Għalhekk, ir-regoli ta’ Matching jikkonsistu f’ħames partijiet:

- Regola għall-akkoppjar ta’ żewġ oġġetti
- Regola għall-paragun tal-attributi bejn żewġ oġġetti akkoppjati
- Regola għall-ħolqien ta’ oġġett
- Regola għall-modifika ta’ oġġett
- Regola għat-tħassir ta’ oġġett

## Ħolqien/modifika tar-regoli tal-akkoppjar

Regola tal-akkoppjar tikkonsisti fid-definizzjoni tal-attributi tas-sors awtorevoli u tal-attributi tas-sors tal-mira li għandhom jaqblu biex jiġi stipulat li l-oġġett fis-sors awtorevoli jikkorrispondi għall-oġġett fis-sors tal-mira.

Fir-regola “Matching”, ir-regoli tal-akkoppjar huma definiti fl-ewwel kaxxa fuq l-iskrin. Ikklikkja “New” biex toħloq regola ġdida. Agħżel regola u kklikkja “Modify” biex timmodifikaha jew “Delete” biex tħassarha.

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

Ir-regoli tal-akkoppjar jinħolqu minn operazzjoni. Ara l-paġna [Lista tal-operazzjonijiet disponibbli skont ir-regola](https://docs.cyberelements.io/identity/7.1/mt/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) biex tagħżel l-operazzjoni li għandek bżonn għall-każ tal-użu tiegħek.

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

**Eżempju ta’ regola tal-akkoppjar:** Għall-provvediment ta’ ħruġ (kontijiet u awtorizzazzjonijiet), ikkonfigurajna l-akkoppjar tal-oġġetti fuq il-logins tal-kontijiet.

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

Huwa possibbli li tikkonfigura diversi regoli tal-akkoppjar u tiddefinixxi l-ordni li fiha jiġu applikati.

## Ħolqien tar-regoli tal-paragun

Regola tal-paragun tikkonsisti fid-definizzjoni tal-attributi tas-sors awtorevoli u tal-attributi tas-sors tal-mira li se jitqabblu ma’ xulxin sabiex jiġu definiti l-bidliet li għandhom isiru.

Fir-regola “Matching”, ir-regoli tal-paragun huma definiti fit-tieni kaxxa fuq l-iskrin. Ikklikkja “New” biex toħloq regola ġdida. Agħżel regola u kklikkja “Modify” biex timmodifikaha jew “Delete” biex tħassarha.

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

Regola tal-paragun tinħoloq minn operazzjoni. Ara l-paġna [Lista tal-operazzjonijiet disponibbli skont ir-regola](https://docs.cyberelements.io/identity/7.1/mt/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) biex tagħżel l-operazzjoni li għandek bżonn għall-każ tal-użu tiegħek.

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

**Eżempju ta’ regola tal-paragun:** lista ta’ attributi b’valur wieħed titqabbel bejn iż-żewġ sorsi.

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

**Għażla “Full”:** ir-riżultati ta’ regola tal-paragun jistgħu jiġu esportati u miktuba b’żewġ modi għall-attributi b’ħafna valuri:

- Għażla mmarkata: jekk tiġi skoperta bidla bejn żewġ attributi, it-tikketta esportata, li se ġġib l-isem tal-attribut tas-sors tal-mira, se jkun fiha biss il-valuri finali tal-attribut. Ma nafux id-dettalji tal-valuri mħassra u tal-valuri l-ġodda miżjuda, u lanqas il-valuri li ma ġewx modifikati.
- Għażla mhux immarkata: jekk tiġi skoperta bidla bejn żewġ attributi, jista’ jkun hemm żewġ tikketti esportati li jġibu l-isem tal-attribut tas-sors tal-mira. L-ewwel tikketta li fiha sotto-operazzjoni “ADD” u t-tieni tikketta li fiha sotto-operazzjoni “DEL”. It-tikketta tas-sotto-operazzjoni “ADD” se jkun fiha biss il-valuri l-ġodda li għandhom jiżdiedu, u t-tikketta tas-sotto-operazzjoni “DEL” se jkun fiha biss il-valuri li għandhom jitħassru. F’dan il-każ, ma nafux jekk hemmx valuri mhux modifikati.

Din l-għażla għandha tintgħażel skont il-konnettur u l-operazzjonijiet li għandhom jitwettqu fir-regoli differenti tal-ħolqien, tal-modifika jew tat-tħassir.

Huwa possibbli li tikkonfigura diversi regoli tal-paragun, li lkoll se jiġu applikati għall-oġġetti akkoppjati kollha.

## Ħolqien/modifika tar-regoli tal-ħolqien

Regola tal-ħolqien tikkonsisti fid-definizzjoni, minn naħa, tal-valur tal-attribut tal-identifikazzjoni li se jintuża meta jinkitbu l-ħolqien, u min-naħa l-oħra, tal-attributi u tal-valuri tagħhom li se jiġu pprovduti fis-sors tal-mira għall-oġġetti kollha definiti bħala ħolqien. Oġġett jiġi definit bħala ħolqien meta jkun preżenti fis-sors awtorevoli iżda mhux fis-sors tal-mira. Il-valuri tal-attributi jistgħu jiġu mitmugħa mill-attributi tas-sors awtorevoli; dan jissejjaħ immappjar tal-attributi. Il-valuri tal-attributi jistgħu wkoll jiġu minn attributi kkonfigurati fir-regoli tal-konverżjoni jew jiġu speċifikati permezz ta’ operazzjonijiet u kliem ewlieni.

Fir-regola “Matching”, ir-regoli tal-ħolqien huma definiti fit-tielet kaxxa fuq l-iskrin. Ikklikkja “New” biex toħloq regola ġdida. Agħżel regola u kklikkja “Modify” biex timmodifikaha jew “Delete” biex tħassarha.

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

Regola tal-ħolqien tinħoloq minn operazzjoni. Ara l-paġna [Lista tal-operazzjonijiet disponibbli skont ir-regola](https://docs.cyberelements.io/identity/7.1/mt/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) biex tagħżel l-operazzjoni li għandek bżonn għall-każ tal-użu tiegħek.

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

**Eżempju ta’ regola tal-ħolqien:** Immappjar ta’ attributi b’valur wieħed jew b’ħafna valuri bejn is-sors awtorevoli u s-sors tal-mira.

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

Huwa possibbli li tikkonfigura diversi regoli tal-ħolqien, li lkoll se jiġu applikati għall-oġġetti kollha identifikati bħala ħolqien.

**Każ speċjali tar-repożitorji tat-tip direttorju:**

Bil-konnettur il-ġdid tad-direttorju, l-attribut `objectClass` irid jimtela fir-regola tal-ħolqien. Biex tagħmel dan, oħloq l-attribut `objectClass` f’regola tal-konverżjoni applikata għas-sors, bil-valuri li jikkorrispondu għall-oġġett li għandu jinħoloq:

- għal oġġett tat-tip utent: `Top`, `Person`, `organizationalPerson`, `user`
- għal grupp tas-sigurtà: `Top`, `Group`

Eżempju ta’ konfigurazzjoni f’SIP:

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

Format miksub fil-fajl tal-output `sync.xml`:

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

> **Rakkomandazzjoni**
>
> Iċċekkja fid-direttorju l-valuri tal-attribut `objectClass` ta’ oġġett simili, biex tiżgura li tuża l-valuri korretti.

Biex tagħmel il-provvediment tal-password ta’ kont f’direttorju, l-attribut li għandu jimtela huwa `unicodePwd`.

Active Directory jistenna fl-attribut `unicodePwd` valur ikkodifikat f’UTF-16 u trażmess f’forma binarja: il-konnettur iwettaq din il-konverżjoni waħdu, kemm fil-ħolqien kif ukoll fil-modifika. Ipprovdi l-password f’test ċar fir-regola, mingħajr kodifikazzjoni minn qabel. In-natura ta’ “password” tal-valur tinżamm meta l-attributi jiġu kkupjati.

> **Attenzjoni**
>
> Active Directory jaċċetta l-kitba ta’ `unicodePwd` biss fuq **konnessjoni kriptata**. Għalhekk, ir-repożitorju għandu jiġi kkonfigurat f’**LDAPS** (port 636 b’mod default) hekk kif il-passwords iridu jiġu ssettjati jew modifikati, u l-kont tas-servizz tal-konnettur irid ikollu d-dritt li jirrisettja l-password tal-oġġetti kkonċernati.

> **Nota**
>
> Jekk `objectClass` ma jimteliex, il-konnettur japplika b’mod default, għal utent, `top`, `person`, `organizationalPerson` u `user` fuq Active Directory, jew `top`, `person`, `organizationalPerson` u `inetOrgPerson` fuq OpenLDAP. Tiddependix minn dawn il-valuri: imla dejjem `objectClass` b’mod espliċitu, kif indikat hawn fuq.

## Ħolqien/modifika tar-regoli tal-modifika

Regola tal-modifika tikkonsisti fid-definizzjoni, minn naħa, tal-valur tal-attribut tal-identifikazzjoni li se jintuża meta jinkitbu l-modifiki u, min-naħa l-oħra, b’mod fakultattiv, tal-attributi u tal-valuri tagħhom li se jiġu pprovduti fis-sors tal-mira fuq l-oġġetti kollha definiti għall-modifika. Innota li, fl-oġġetti definiti għall-modifika, ir-riżultati tar-regoli tal-paragun jiġu speċifikati awtomatikament fir-regola tal-modifika.

Fir-regola “Matching”, ir-regoli tal-modifika huma definiti fir-raba’ kaxxa fuq l-iskrin. Ikklikkja “New” biex toħloq regola ġdida. Agħżel regola u kklikkja “Modify” biex timmodifikaha jew “Delete” biex tħassarha.

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

Regola tal-modifika tinħoloq minn operazzjoni. Ara l-paġna [Lista tal-operazzjonijiet disponibbli skont ir-regola](https://docs.cyberelements.io/identity/7.1/mt/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) biex tagħżel l-operazzjoni li għandek bżonn għall-każ tal-użu tiegħek.

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

**Eżempju ta’ regola tal-modifika:** Definizzjoni tal-attribut tal-identifikazzjoni tal-oġġett li għandu jiġi modifikat fis-sors tal-mira (direttorju). L-attribut “DNuser” jiġi speċifikat permezz ta’ espressjoni li tuża l-kelma ewlenija “SyncAttDst” biex tikseb il-valur tal-attribut DN fis-sors tal-mira.

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

## Ħolqien/modifika tar-regoli tat-tħassir

Regola tat-tħassir tikkonsisti fid-definizzjoni, minn naħa, tal-valur tal-attribut tal-identifikazzjoni li se jintuża meta jinkitbu t-tħassiriet, u min-naħa l-oħra, b’mod fakultattiv, tal-attributi u tal-valuri tagħhom li se jiddaħħlu fis-sors tal-mira fuq l-oġġetti kollha definiti għat-tħassir. Il-bidliet fl-attributi fuq oġġetti definiti għat-tħassir huma possibbli biss meta l-oġġett ma jitħassarx fil-fatt. Oġġett jiġi definit għat-tħassir meta jkun preżenti fis-sors tal-mira iżda mhux fis-sors awtorevoli. Konsegwentement, il-valuri tal-attributi jistgħu jiġu biss minn attributi kkonfigurati fir-regoli tal-konverżjoni jew jiġu speċifikati direttament fir-regoli tat-tħassir permezz ta’ operazzjonijiet u kliem ewlieni.

> **Attenzjoni**
>
> Mill-verżjoni 7.1, l-operazzjonijiet ta’ regola tat-tħassir ma jistgħux jibqgħu jirreferu għas-sors tal-mira. Peress li dak kollu li jiġi skopert għat-tħassir jinsab neċessarjament fis-sors tal-mira, m’għadux utli li jiġi speċifikat li l-informazzjoni se tiġi mfittxija hemmhekk. Uża l-kelma ewlenija “SyncAttSrc” jew l-operazzjonijiet COPY, MULTCOPY, eċċ. Waqt titjib tal-verżjoni, il-konnetturi eżistenti jiġu migrati awtomatikament.
>
> Din il-migrazzjoni sseħħ **meta titgħabba l-konfigurazzjoni**: il-magna tapplika l-immappjar li ġej.
>
> | F’regola tat-tħassir, qabel il-verżjoni 7.1 | Sostitwit bi |
> |---|---|
> | `SyncAttDst` (pereżempju `<SyncAttDst:attribut>`) | `SyncAttSrc` |
> | `DSTCOPY` | `COPY` |
> | `MULTDSTCOPY` | `MULTCOPY` |
>
> Madankollu, ikkoreġi r-regoli tiegħek li jużaw dan il-kliem ewlieni: il-konfigurazzjoni murija imbagħad se taqbel ma’ dak li teżegwixxi l-magna. ⚠ Is-sostituzzjoni tapplika għat-test tar-regola, irrispettivament mill-ittri kbar u żgħar: taffettwa wkoll il-kliem ewlieni li **fih** dawn it-termini, bħal `SyncAttDstOperation` jew `SyncAttDstType`. Iċċekkja dawn il-każijiet wara titjib tal-verżjoni.

Fir-regola “Matching”, ir-regoli tat-tħassir huma definiti fil-ħames kaxxa fuq l-iskrin. Ikklikkja “New” biex toħloq regola ġdida. Agħżel regola u kklikkja “Modify” biex timmodifikaha jew “Delete” biex tħassarha.

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

Regola tat-tħassir tinħoloq minn operazzjoni. Ara l-paġna [Lista tal-operazzjonijiet disponibbli skont ir-regola](https://docs.cyberelements.io/identity/7.1/mt/UserDocumentation/AutomaticProvisioningConnectorsManagement/ListOfAvailableOperationsByRules/) biex tagħżel l-operazzjoni li għandek bżonn għall-każ tal-użu tiegħek.

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

**Eżempju ta’ regola tat-tħassir:** Definizzjoni tal-attribut tal-identifikazzjoni tal-oġġett li għandu jitħassar fis-sors tal-mira (direttorju). L-attribut “DNuser” jiġi speċifikat permezz ta’ espressjoni li tuża l-kelma ewlenija “SyncAttSrc” biex tikseb il-valur tal-attribut DN fis-sors tal-mira.

![]()

Huwa possibbli li tikkonfigura diversi regoli tat-tħassir, li lkoll se jiġu applikati għall-oġġetti kollha identifikati għat-tħassir.
