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

# Eżekuzzjoni tal-konnetturi

Hemm diversi metodi biex titħaddem sekwenza ta’ provvediment:

- Bl-użu ta’ fajls Batch jew PowerShell b’linji ta’ kmand li jsejħu l-eżegwibbli HPPRunCli
- Bl-użu tal-interfaċċja tal-ġestjoni tax-xogħlijiet
- Bl-użu tas-servizzi web SIP

## Eżekuzzjoni tas-sekwenzi ta’ provvediment permezz ta’ HPPRUNCLI.exe

F’fajl Batch jew PowerShell, trid issejjaħ l-eżegwibbli HppRunClie.exe segwit mill-għażliet li ġejjin:

| Għażliet | Funzjoni | Obbligatorju (Y/N) |
|---|---|---|
| -sec [Sequence Name] | Għażla biex tispeċifika s-sekwenza li għandha tiġi eżegwita. | Y |
| -cfg [Config_file_name] | Għażla biex tispeċifika l-fajl tal-konfigurazzjoni li għandu jintuża. | N. B’mod default, jintuża l-fajl hpp.ini. |
| -obj [Val_attribute1\|Val_attribute2\|…] | Għażla biex tispeċifika l-valur tal-attribut ta’ korrispondenza biex is-sekwenza tiġi eżegwita b’mod unitarju. Jekk iridu jiġu speċifikati diversi valuri tal-attributi, dawn għandhom jiġu elenkati fl-ordni li fiha għandhom jiġu eżegwiti l-esportazzjonijiet. | N |
| -seq [Directory_nm] | Għażla biex tispeċifika l-isem tad-direttorju tal-output għall-fajls tar-reġistru. | N |

## Eżekuzzjoni tas-sekwenzi ta’ provvediment permezz tal-interfaċċja tal-ġestjoni tax-xogħlijiet

Mill-paġna tal-wiri tal-istanzi tax-xogħlijiet tas-sekwenzi ta’ provvediment, tista’ tħaddem xogħol jew individwalment jew bl-ingrossa.

Biex tniedi xogħol bl-ingrossa, ikklikkja l-buttuna “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoPlay.png)”.

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

Agħżel ix-xogħol jew ix-xogħlijiet mixtieqa, imbagħad ikklikkja “Validate” biex tqiegħed ix-xogħlijiet fil-kju.

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

Biex tniedi xogħol individwalment, ikklikkja l-buttuna “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoUnitaire.png)”.

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

Agħżel ix-xogħol mixtieq, imbagħad daħħal il-valur biex tagħżel l-oġġett li fuqu trid tħaddem ix-xogħol.

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

**Twissija:** Bħalissa, jekk ix-xogħol tiegħek fih diversi sekwenzi, biex tħaddem xogħol f’modalità unitarja, l-attribut ta’ korrispondenza għandu jkollu l-istess valur għas-sekwenzi kollha.

## Eżekuzzjoni tas-sekwenzi ta’ provvediment permezz tas-servizzi web SIP

Eżempju ta’ script biex jitħaddem xogħol ta’ provvediment permezz ta’ script PowerShell:

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
```

Bl-istess mod, biex terġa’ tibda xogħol ta’ provvediment li twaqqaf minħabba limitu ta’ importazzjoni bl-użu ta’ script PowerShell, trid tikseb l-ID tal-istanza tax-xogħol billi ssejjaħ ir-rotta /scim/v2/job-instance/ (metodu GET).

Għal aktar informazzjoni, ara d-dokumentazzjoni Swagger: https://[SIP_Server_URL]:44355/swagger/

## Eżekuzzjoni tal-konnettur il-ġdid tal-alimentazzjoni ta’ dħul (minn 7.0 SP3)

Mill-verżjoni 7.0 SP3 ’il quddiem, huwa possibbli li jiġu assenjati rwoli u/jew permessi lill-identitajiet permezz ta’ konnettur ġdid tal-alimentazzjoni ta’ dħul.

Ir-rabtiet Identitajiet – Rwoli u Identitajiet/Rwoli – Awtorizzazzjonijiet maħluqa u/jew imħassra minn sors awtorevoli huma ġestiti minn tip ġdid ta’ rabta fil-bażi tad-dejta. Għalhekk, l-esportazzjoni tar-rabtiet Identitajiet – Rwoli u Identitajiet/Rwoli – Awtorizzazzjonijiet mir-repożitorju Identity se tagħti biss ir-rwoli u l-awtorizzazzjonijiet assenjati minn SIP.

### Konfigurazzjoni ta’ konnettur tar-rabtiet Identitajiet - Rwoli

Biex tikkonfigura konnettur tar-rabtiet Identitajiet - Rwoli, trid toħloq mill-inqas:

- Esportazzjoni minn sors awtorevoli li għandu jkun fiha l-informazzjoni li ġejja:
- UID tal-identità (meħtieġ)
    - Kodiċi tar-rwol li għandu jiġi assenjat (meħtieġ) – valur wieħed.
    - Data tal-bidu tar-rwol (fakultattiva)
    - Data tat-tmiem tar-rwol (fakultattiva)
- Esportazzjoni tar-repożitorju Identity tat-tip PERSON_ROLES li fiha trid tispeċifika t-tipi ta’ persuni u l-kodiċijiet tar-repożitorji li għalihom trid toħloq rabtiet identità-rwol.
- Regola ta’ sinkronizzazzjoni biex tiddefinixxi l-operazzjonijiet ta’ Matching, ħolqien, modifika u tħassir
    - Fir-regola ta’ Matching, qabbel l-uid tal-identità u l-kodiċi tar-rwol
    - Fir-regola tal-ħolqien, huwa obbligatorju li tispeċifika l-uid tal-identità u l-kodiċi tar-rwol. Id-dati tal-bidu u tat-tmiem huma fakultattivi
    - Fir-regola tal-modifika, huwa obbligatorju li tispeċifika l-ID tar-rabta persuna-rwol, miksub mill-esportazzjoni tar-repożitorju Identity. Id-dati biss jistgħu jiġu modifikati
    - Fir-regola tat-tħassir, huwa obbligatorju li tispeċifika l-ID tar-rabta persuna-rwol, miksub mill-esportazzjoni tar-repożitorju Identity.
    - Sintassi tal-kodiċijiet Identity li għandhom jintużaw fir-regoli ta’ sinkronizzazzjoni:
        - person = UID tal-identità
        - role = kodiċi tar-rwol
        - startdate = data tal-bidu tar-rwol
        - enddate = data tat-tmiem tar-rwol
        - id = ID tar-rabta identità-rwol (qasam id fit-tabella sid.PersonRoles)
- Importazzjoni fir-repożitorju Identity tat-tip PERSON_ROLES. Tista’ timmarka l-għażla li tiddiżattiva l-kalkolu tal-kontijiet fil-ħin sabiex tikkontrolla l-ħin tal-importazzjoni f’każ ta’ volumi kbar. Jekk l-għażla ġiet attivata, trid twettaq importazzjoni ACCOUNTCALC biex terġa’ tikkalkula l-kontijiet fir-repożitorju kkonċernat.

### Konfigurazzjoni ta’ konnettur tar-rabtiet Identitajiet - Rwoli

- Esportazzjoni minn sors awtorevoli li għandu jkun fiha l-informazzjoni li ġejja:
    - UID tal-identità (meħtieġ)
    - Kodiċi tar-rwol (meħtieġ) – valur wieħed.
    - Kodiċi tal-awtorizzazzjoni li għandu jiġi assenjat lir-rabta identità/rwol (meħtieġ) – valur wieħed
    - Data tal-bidu tal-awtorizzazzjoni (fakultattiva)
    - Data tat-tmiem tal-awtorizzazzjoni (fakultattiva)

> **Attenzjoni**
>
> Ir-rabta Identità/Rwol għandha diġà teżisti biex il-konnettur tar-rabtiet Identità/Rwol – Awtorizzazzjonijiet jaħdem b’mod korrett

- Esportazzjoni tar-repożitorju Identity tat-tip PERSON_RIGHTS li fiha trid tispeċifika t-tipi ta’ persuni u l-kodiċijiet tar-repożitorji li għalihom trid toħloq rabtiet identità/rwol-awtorizzazzjoni.
- Regola ta’ sinkronizzazzjoni biex tiddefinixxi l-operazzjonijiet ta’ Matching, ħolqien, modifika u tħassir
    - Fir-regola ta’ Matching, qabbel l-uid tal-identità, il-kodiċi tar-rwol u l-kodiċi tal-awtorizzazzjoni.
    - Fir-regola tal-ħolqien, huwa obbligatorju li tispeċifika l-uid tal-identità, il-kodiċi tar-rwol u l-kodiċi tal-awtorizzazzjoni. Id-dati tal-bidu u tat-tmiem huma fakultattivi
    - Fir-regola tal-modifika, huwa obbligatorju li tispeċifika l-ID tar-rabta persuna/rwol - awtorizzazzjoni, miksub mill-esportazzjoni tar-repożitorju Identity. Id-dati biss jistgħu jiġu modifikati.
    - Fir-regola tat-tħassir, huwa obbligatorju li tispeċifika l-ID tar-rabta persuna/rwol - awtorizzazzjoni, miksub mill-esportazzjoni tar-repożitorju Identity.
    - Sintassi tal-kodiċijiet Identity li għandhom jintużaw fir-regoli ta’ sinkronizzazzjoni:
    - person = UID tal-identità
        - role = kodiċi tar-rwol
        - right = kodiċi tal-awtorizzazzjoni
        - startdate = data tal-bidu tal-awtorizzazzjoni
        - enddate = data tat-tmiem tal-awtorizzazzjoni
    - id = ID tar-rabta identità-rwol-dritt (qasam id fit-tabella sid.PersonRights)
- Importazzjoni fir-repożitorju Identity tat-tip PERSON_RIGHTS. Tista’ timmarka l-għażla li tiddiżattiva l-kalkolu tal-kontijiet fil-ħin sabiex tikkontrolla l-ħin tal-importazzjoni f’każ ta’ volumi kbar. Jekk l-għażla ġiet attivata, trid twettaq importazzjoni ACCOUNTCALC biex terġa’ tikkalkula l-kontijiet fir-repożitorju kkonċernat.

## Attivazzjoni tat-traċċi

Mill-verżjoni 7.1, it-traċċi tal-magna tal-provvediment ma għadhomx jiġu attivati fir-Registry ta’ Windows iżda fil-fajl `[Installation_Directory]\SIP\Config.ini`.

> **Nota**
>
> Dan il-fajl huwa l-fajl tal-magna tal-provvediment. M’għandux jiġi konfuż mal-fajls tal-konfigurazzjoni tal-konnetturi (`*.ini`), li jingħataw lil HPPRunCli bl-għażla `-cfg`.

Fit-taqsima `General`, żid it-tliet parametri li ġejjin:

- `traceLevel`: `0` biex tiddiżattiva t-traċċi, `2FFFF` biex tattivahom.
- `traceModule`: lista tal-moduli li għandhom jiġu traċċati, separati b’virgoli. L-ismijiet tal-moduli mhumiex sensittivi għall-ittri kbar u żgħar. Il-valuri possibbli huma:
    - `HPPCfg`
    - `HPPCSV`
    - `HPPHP`
    - `HPPLDAP`
    - `HPPReference`
    - `HPPRunCli`
    - `HPPSQL`
    - `SIPSCIM`
    - `SIPLDAP`
    - `WrapperDLL`
    - `All`, biex tattiva t-traċċi għall-moduli kollha
- `traceOutputDir`: direttorju tal-output għar-reġistri. Dan il-parametru huwa fakultattiv: jekk ma jiġix speċifikat, ir-reġistri jiġu ġġenerati fil-folder `%tmp%` tal-utent.

**Eżempju:**

```
1
2
3
4
```

> **Nota**
>
> L-installatur tal-verżjoni 7.1 diġà jikteb dawn it-tliet parametri f’`Config.ini`, bit-traċċi **diżattivati**: `traceLevel=0`, `traceModule` mimli bil-lista sħiħa tal-moduli, u `traceOutputDir=C:\Temp`. Għalhekk, biex tattiva t-traċċi, trid timmodifika biss `traceLevel`. Iċċekkja li l-kont li jħaddem il-magna jista’ jikteb fid-direttorju tal-output.

> **Parir**
>
> Għal dijanjosi mmirata, naqqas `traceModule` għall-moduli rilevanti biss — pereżempju `SIPSCIM` għal problema ta’ konnessjoni ma’ mira SCIM. Ladarba titlesta d-dijanjosi, erġa’ ssettja `traceLevel` għal `0`: it-traċċi dettaljati jikkunsmaw spazju fuq id-diska u jnaqqsu l-veloċità tal-ipproċessar.

## Kriptaġġ tal-passwords u tal-client secret

Mill-verżjoni 7.1, il-passwords u l-“client secrets” użati mill-magna tal-provvediment u preżenti fil-fajl `[Installation_Directory]\SIP\Config.ini` huma kriptati.

Waqt l-ewwel installazzjoni, din id-dejta tiġi ssejvjata awtomatikament skont il-parametri mdaħħla fl-installatur.

Biex timmodifika manwalment wieħed minn dawn iż-żewġ valuri, uża l-eżegwibbli `[Installation_Directory]\SIP\SIPEncrypt.exe`. Minn prompt tal-kmandi jew minn tieqa PowerShell, ħaddem `SIPEncrypt.exe` segwit mill-password jew mill-client secret li għandu jiġi kriptat, imbagħad ikkopja r-riżultat fil-fajl `Config.ini`.

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

`SIPEncrypt.exe` jistenna **parametru wieħed biss**. Mingħajr parametru, jew b’diversi parametri, juri l-messaġġ `SIPEncrypt should be called with a single input parameter.` u ma jipproduċi xejn. Jekk il-valur fih spazji jew karattri interpretati mill-prompt tal-kmandi (`&`, `|`, `^`, `"`, `$`…), poġġih bejn virgoletti — preferibbilment virgoletti singli f’PowerShell.

Il-client secret jiddaħħal fil-parametru `clientSecret` tal-fajl `Config.ini`.

> **Attenzjoni**
>
> Għall-awtentikazzjoni mal-miri SCIM, il-magna tuża **kif inhi** kwalunkwe password jew client secret li ma tistax tiddekripta. Għalhekk, valur li jitħalla bi żball f’test ċar jaħdem mingħajr ebda messaġġ ta’ twissija, filwaqt li s-sigriet ikun espost fil-fajl. Iċċekkja li kull sigriet f’`Config.ini` huwa tassew valur prodott minn `SIPEncrypt.exe`.

Dan il-kriptaġġ huwa riversibbli, peress li l-magna nnifisha tiddekripta l-valuri: jipproteġi kontra l-qari tas-sigriet f’test ċar, mhux kontra l-aċċess għall-fajl. Illimita l-aċċess għal `Config.ini` għall-kontijiet tal-amministrazzjoni u għall-kont li jħaddem il-magna. Meta jiġi ttajpjat fil-linja tal-kmand, il-valur f’test ċar jista’ jibqa’ wkoll fl-istorja tal-konsol: agħlaq is-sessjoni wara l-użu.
