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

# Rith na nascóirí

Tá roinnt modhanna ann chun seicheamh soláthair a rith:

- Trí chomhaid Batch nó PowerShell ina bhfuil línte ordaithe a ghlaonn ar an gcomhad inrite HPPRunCli
- Trí chomhéadan bainistíochta na jabanna
- Trí sheirbhísí gréasáin SIP

## Seichimh soláthair a rith le HPPRUNCLI.exe

I gcomhad Batch nó PowerShell, ní mór duit glaoch ar an gcomhad inrite HppRunClie.exe agus na roghanna seo a leanas a chur ina dhiaidh:

| Roghanna | Feidhm | Éigeantach (Y/N) |
|---|---|---|
| -sec [Sequence Name] | Rogha chun an seicheamh atá le rith a shonrú. | Y |
| -cfg [Config_file_name] | Rogha chun an comhad cumraíochta atá le húsáid a shonrú. | N. De réir réamhshocraithe, úsáidtear an comhad hpp.ini. |
| -obj [Val_attribute1\|Val_attribute2\|…] | Rogha chun luach na tréithe meaitseála a shonrú chun an seicheamh a rith mar aonad. Más gá roinnt luachanna tréithe a shonrú, ní mór iad a liostú san ord ina gcaithfear na heaspórtálacha a rith. | N |
| -seq [Directory_nm] | Rogha chun ainm an fhillteáin aschuir do na comhaid loga a shonrú. | N |

## Seichimh soláthair a rith trí chomhéadan bainistíochta na jabanna

Ón leathanach amhairc d’ásca jab na seicheamh soláthair, is féidir leat jab a rith ina aonar nó ar an mórchóir.

Chun jab a sheoladh ar an mórchóir, cliceáil an cnaipe “![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)

Roghnaigh an jab nó na jabanna is mian leat, ansin cliceáil “Validate” chun na jabanna a chur sa scuaine.

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

Chun jab a sheoladh ina aonar, cliceáil an cnaipe “![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)

Roghnaigh an jab is mian leat, ansin iontráil an luach a roghnaíonn an réad ar mian leat an jab a rith air.

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

**Rabhadh:** Faoi láthair, má tá roinnt seicheamh i do jab, ní mór an luach céanna a bheith ag an tréith mheaitseála i ngach seicheamh chun an jab a rith i mód aonair.

## Seichimh soláthair a rith trí sheirbhísí gréasáin SIP

Sampla de script a ritheann jab soláthair trí 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
```

Ar an gcaoi chéanna, chun jab soláthair atá stoptha de bharr tairsí iompórtála a atosú le script PowerShell, ní mór duit aitheantóir ásc an jab a fháil trí ghlaoch ar an ród /scim/v2/job-instance/ (modh GET).

Le haghaidh tuilleadh faisnéise, féach doiciméadú Swagger: https://[SIP_Server_URL]:44355/swagger/

## An nascóir fotha ionchuir nua a rith (ó 7.0 SP3)

Ó leagan 7.0 SP3 ar aghaidh, is féidir róil agus/nó ceadanna a shannadh d’aitheantais trí nascóir fotha ionchuir nua.

Bainistíonn cineál nua naisc sa bhunachar sonraí na naisc Aitheantais – Róil agus Aitheantais/Róil – Údaruithe a chruthaítear agus/nó a scriostar ó fhoinse údarásach. Dá bhrí sin, ní thabharfaidh easpórtáil na nasc Aitheantais – Róil agus Aitheantais/Róil – Údaruithe ó stór Identity ar ais ach na róil agus na húdaruithe a shann SIP.

### Nascóir nasc Aitheantais - Róil a chumrú

Chun nascóir nasc Aitheantais - Róil a chumrú, ní mór duit na nithe seo a leanas ar a laghad a chruthú:

- Easpórtáil ó fhoinse údarásach a chaithfidh an fhaisnéis seo a leanas a bheith inti:
- UID an aitheantais (riachtanach)
    - Cód an róil atá le sannadh (riachtanach) – luach aonair.
    - Dáta tosaigh an róil (roghnach)
    - Dáta deiridh an róil (roghnach)
- Easpórtáil ó stór Identity den chineál PERSON_ROLES, ina gcaithfidh tú cineálacha na ndaoine agus cóid na stór a shonrú ar mian leat naisc aitheantas-ról a chruthú dóibh.
- Riail sioncrónaithe chun na hoibríochtaí Matching, Cruthú, Modhnú agus Scriosadh a shainiú
    - Sa riail Matching, cuir UID an aitheantais agus cód an róil i gcomparáid
    - Sa riail chruthaithe, tá sé éigeantach UID an aitheantais agus cód an róil a shonrú. Is roghnach iad na dátaí tosaigh agus deiridh
    - Sa riail mhodhnaithe, tá sé éigeantach aitheantóir an naisc duine-ról a shonrú, a fhaightear ó easpórtáil stór Identity. Ní féidir ach na dátaí a mhodhnú
    - Sa riail scriosta, tá sé éigeantach aitheantóir an naisc duine-ról a shonrú, a fhaightear ó easpórtáil stór Identity.
    - Comhréir na gcód Identity atá le húsáid i rialacha sioncrónaithe:
        - person = UID an aitheantais
        - role = cód an róil
        - startdate = dáta tosaigh an róil
        - enddate = dáta deiridh an róil
        - id = aitheantóir an naisc aitheantas-ról (réimse id sa tábla sid.PersonRoles)
- Iompórtáil isteach i stór Identity den chineál PERSON_ROLES. Is féidir leat an rogha a sheiceáil chun ríomh láithreach na gcuntas a dhíchumasú d’fhonn am na hiompórtála a bhainistiú i gcás méideanna móra sonraí. Má cumasaíodh an rogha, ní mór duit iompórtáil ACCOUNTCALC a dhéanamh chun na cuntais sa stór lena mbaineann a athríomh.

### Nascóir nasc Aitheantais - Róil a chumrú

- Easpórtáil ó fhoinse údarásach a chaithfidh an fhaisnéis seo a leanas a bheith inti:
    - UID an aitheantais (riachtanach)
    - Cód an róil (riachtanach) – luach aonair.
    - Cód an údaraithe atá le sannadh don nasc aitheantas/ról (riachtanach) – luach aonair
    - Dáta tosaigh an údaraithe (roghnach)
    - Dáta deiridh an údaraithe (roghnach)

> **Aire**
>
> Ní mór an nasc Aitheantas/Ról a bheith ann cheana féin chun go n-oibreoidh an nascóir nasc Aitheantas/Ról – Údaruithe i gceart

- Easpórtáil ó stór Identity den chineál PERSON_RIGHTS, ina gcaithfidh tú cineálacha na ndaoine agus cóid na stór a shonrú ar mian leat naisc aitheantas/ról-údarú a chruthú dóibh.
- Riail sioncrónaithe chun na hoibríochtaí Matching, Cruthú, Modhnú agus Scriosadh a shainiú
    - Sa riail Matching, cuir UID an aitheantais, cód an róil agus cód an údaraithe i gcomparáid.
    - Sa riail chruthaithe, tá sé éigeantach UID an aitheantais, cód an róil agus cód an údaraithe a shonrú. Is roghnach iad na dátaí tosaigh agus deiridh
    - Sa riail mhodhnaithe, tá sé éigeantach aitheantóir an naisc duine/ról - údarú a shonrú, a fhaightear ó easpórtáil stór Identity. Ní féidir ach na dátaí a mhodhnú.
    - Sa riail scriosta, tá sé éigeantach aitheantóir an naisc duine/ról - údarú a shonrú, a fhaightear ó easpórtáil stór Identity.
    - Comhréir na gcód Identity atá le húsáid i rialacha sioncrónaithe:
    - person = UID an aitheantais
        - role = cód an róil
        - right = cód an údaraithe
        - startdate = dáta tosaigh an údaraithe
        - enddate = dáta deiridh an údaraithe
    - id = aitheantóir an naisc aitheantas-ról-ceart (réimse id sa tábla sid.PersonRights)
- Iompórtáil isteach i stór Identity den chineál PERSON_RIGHTS. Is féidir leat an rogha a sheiceáil chun ríomh láithreach na gcuntas a dhíchumasú d’fhonn am na hiompórtála a bhainistiú i gcás méideanna móra sonraí. Má cumasaíodh an rogha, ní mór duit iompórtáil ACCOUNTCALC a dhéanamh chun na cuntais sa stór lena mbaineann a athríomh.

## Rianta a chumasú

Ó leagan 7.1 ar aghaidh, ní sa chlárlann a chumasaítear rianta an innill soláthair a thuilleadh, ach sa chomhad `[Installation_Directory]\SIP\Config.ini`.

> **Nóta**
>
> Is é an comhad seo comhad an innill soláthair. Níor cheart é a mheascadh le comhaid chumraíochta na nascóirí (`*.ini`), a thugtar do HPPRunCli leis an rogha `-cfg`.

Sa rannán `General`, cuir na trí pharaiméadar seo a leanas leis:

- `traceLevel`: `0` chun na rianta a dhíchumasú, `2FFFF` chun iad a chumasú.
- `traceModule`: liosta na modúl atá le rianú, scartha le camóga. Níl ainmneacha na modúl cás-íogair. Is iad seo na luachanna is féidir:
    - `HPPCfg`
    - `HPPCSV`
    - `HPPHP`
    - `HPPLDAP`
    - `HPPReference`
    - `HPPRunCli`
    - `HPPSQL`
    - `SIPSCIM`
    - `SIPLDAP`
    - `WrapperDLL`
    - `All`, chun rianta a chumasú do na modúil go léir
- `traceOutputDir`: fillteán aschuir na logaí. Tá an paraiméadar seo roghnach: mura sonraítear é, gintear na logaí i bhfillteán `%tmp%` an úsáideora.

**Sampla:**

```
1
2
3
4
```

> **Nóta**
>
> Scríobhann suiteálaí leagan 7.1 na trí pharaiméadar seo i `Config.ini` cheana féin, agus na rianta **díchumasaithe**: `traceLevel=0`, `traceModule` líonta leis an liosta iomlán modúl, agus `traceOutputDir=C:\Temp`. Chun rianta a chumasú, mar sin, ní gá duit ach `traceLevel` a mhodhnú. Seiceáil gur féidir leis an gcuntas a ritheann an t-inneall scríobh san fhillteán aschuir.

> **Leid**
>
> Le haghaidh diagnóis spriocdhírithe, laghdaigh `traceModule` go dtí na modúil ábhartha amháin — mar shampla `SIPSCIM` i gcás fadhb cheangail le sprioc SCIM. Nuair a bheidh an diagnóis críochnaithe, socraigh `traceLevel` ar ais go `0`: ídíonn rianta mionsonraithe spás diosca agus moillíonn siad an phróiseáil.

## Criptiú na bpasfhocal agus rún an chliaint

Ó leagan 7.1 ar aghaidh, tá na pasfhocail agus na “rúin chliaint” a úsáideann an t-inneall soláthair agus atá sa chomhad `[Installation_Directory]\SIP\Config.ini` criptithe.

Le linn na chéad suiteála, sábháiltear na sonraí seo go huathoibríoch de réir na bparaiméadar a iontráladh sa suiteálaí.

Chun ceachtar den dá luach seo a mhodhnú de láimh, úsáid an comhad inrite `[Installation_Directory]\SIP\SIPEncrypt.exe`. Ó leid ordaithe nó ó fhuinneog PowerShell, rith `SIPEncrypt.exe` agus an pasfhocal nó an rún cliaint atá le criptiú ina dhiaidh, ansin cóipeáil an toradh isteach sa chomhad `Config.ini`.

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

Tá **paraiméadar amháin** ag teastáil ó `SIPEncrypt.exe`. Gan paraiméadar, nó le níos mó ná paraiméadar amháin, taispeánann sé an teachtaireacht `SIPEncrypt should be called with a single input parameter.` agus ní tháirgeann sé aon rud. Má tá spásanna sa luach nó carachtair a léirmhíníonn an leid ordaithe (`&`, `|`, `^`, `"`, `$`…), cuir idir comharthaí athfhriotail é — comharthaí athfhriotail singile is fearr in PowerShell.

Iontráiltear rún an chliaint sa pharaiméadar `clientSecret` den chomhad `Config.ini`.

> **Aire**
>
> Chun fíordheimhniú le spriocanna SCIM, úsáideann an t-inneall **mar atá** aon phasfhocal nó rún cliaint nach féidir leis a dhíchriptiú. Oibríonn luach a fágadh i ngnáth-théacs de thimpiste, mar sin, gan aon teachtaireacht rabhaidh, agus an rún nochtaithe sa chomhad. Seiceáil gur luach a tháirg `SIPEncrypt.exe` é gach rún in `Config.ini`.

Is féidir an criptiú seo a aisiompú, ós rud é go ndíchriptíonn an t-inneall na luachanna é féin: cosnaíonn sé ar léamh an rúin i ngnáth-théacs, ní ar rochtain ar an gcomhad. Teorannaigh rochtain ar `Config.ini` do na cuntais riaracháin agus don chuntas a ritheann an t-inneall. Nuair a chlóscríobhtar é ar líne na n-orduithe, d’fhéadfadh an luach gnáth-théacs fanacht i stair an chonsóil freisin: dún an seisiún tar éis úsáide.
