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

# Az összekötők futtatása

Egy kiépítési sorozat futtatására több módszer is létezik:

- Batch- vagy PowerShell-fájlokkal, amelyek parancssorai meghívják a HPPRunCli végrehajtható fájlt
- A feladatkezelő felületen
- SIP-webszolgáltatásokkal

## Kiépítési sorozatok futtatása a HPPRUNCLI.exe segítségével

Egy Batch- vagy PowerShell-fájlban a HppRunClie.exe végrehajtható fájlt kell meghívni, a következő kapcsolókkal:

| Kapcsolók | Funkció | Kötelező (Y/N) |
|---|---|---|
| -sec [Sequence Name] | Kapcsoló a futtatandó sorozat megadásához. | Y |
| -cfg [Config_file_name] | Kapcsoló a használandó konfigurációs fájl megadásához. | N. Alapértelmezés szerint a hpp.ini fájl használatos. |
| -obj [Val_attribute1\|Val_attribute2\|…] | Kapcsoló annak a megfeleltetési attribútumértéknek a megadásához, amellyel a sorozat egyedileg futtatható. Ha több attribútumértéket kell megadni, azokat az exportálások végrehajtási sorrendjében kell felsorolni. | N |
| -seq [Directory_nm] | Kapcsoló a naplófájlok kimeneti könyvtára nevének megadásához. | N |

## Kiépítési sorozatok futtatása a feladatkezelő felületen

A kiépítési sorozatok feladatpéldányait megjelenítő oldalon egy feladat egyedileg vagy tömegesen is futtatható.

Egy feladat tömeges indításához kattintson a „![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoPlay.png)” gombra.

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

Jelölje ki a kívánt feladatot vagy feladatokat, majd kattintson a „Validate” gombra a feladatok várólistára helyezéséhez.

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

Egy feladat egyedi indításához kattintson a „![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoUnitaire.png)” gombra.

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

Jelölje ki a kívánt feladatot, majd adja meg azt az értéket, amellyel kiválasztja az objektumot, amelyen a feladatot futtatni szeretné.

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

**Figyelmeztetés:** Ha a feladat több sorozatot tartalmaz, a feladat egyedi módban való futtatásához jelenleg a megfeleltetési attribútumnak minden sorozatban azonos értékűnek kell lennie.

## Kiépítési sorozatok futtatása SIP-webszolgáltatásokkal

Példaszkript egy kiépítési feladat PowerShell-szkripttel történő futtatására:

```
 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
```

Hasonlóképpen, ha egy importálási küszöbérték miatt leállított kiépítési feladatot PowerShell-szkripttel szeretne újraindítani, a /scim/v2/job-instance/ útvonal meghívásával (GET metódus) le kell kérnie a feladatpéldány azonosítóját.

További információt a Swagger-dokumentációban talál: https://[SIP_Server_URL]:44355/swagger/

## Az új bejövő betáplálási összekötő futtatása (a 7.0 SP3 verziótól)

A 7.0 SP3 verziótól kezdve egy új bejövő betáplálási összekötővel szerepkörök és/vagy engedélyek rendelhetők az identitásokhoz.

A hiteles forrásból létrehozott és/vagy törölt Identitások – szerepkörök és Identitások/szerepkörök – engedélyezések kapcsolatokat egy új kapcsolattípus kezeli az adatbázisban. Így az Identitások – szerepkörök és Identitások/szerepkörök – engedélyezések kapcsolatok Identity-tárházból való exportálása csak a SIP által hozzárendelt szerepköröket és engedélyezéseket adja vissza.

### Identitások - szerepkörök kapcsolatösszekötő konfigurálása

Egy Identitások - szerepkörök kapcsolatösszekötő konfigurálásához legalább a következőket kell létrehoznia:

- Egy hiteles forrásból származó exportálást, amelynek a következő információkat kell tartalmaznia:
- Az identitás UID-értéke (kötelező)
    - A hozzárendelendő szerepkör kódja (kötelező) – egyetlen érték.
    - A szerepkör kezdő dátuma (nem kötelező)
    - A szerepkör záró dátuma (nem kötelező)
- Egy PERSON_ROLES típusú exportálást az Identity-tárházból, amelyben meg kell adnia azokat a személytípusokat és tárházkódokat, amelyekhez identitás–szerepkör kapcsolatokat szeretne létrehozni.
- Egy szinkronizálási szabályt a Matching, a létrehozási, a módosítási és a törlési művelet meghatározásához
    - A Matching szabályban hasonlítsa össze az identitás UID-értékét és a szerepkör kódját
    - A létrehozási szabályban kötelező megadni az identitás UID-értékét és a szerepkör kódját. A kezdő és a záró dátum megadása nem kötelező
    - A módosítási szabályban kötelező megadni a személy–szerepkör kapcsolat azonosítóját, amely az Identity-tárház exportálásából származik. Csak a dátumok módosíthatók
    - A törlési szabályban kötelező megadni a személy–szerepkör kapcsolat azonosítóját, amely az Identity-tárház exportálásából származik.
    - Az Identity-kódok szinkronizálási szabályokban használandó szintaxisa:
        - person = az identitás UID-értéke
        - role = a szerepkör kódja
        - startdate = a szerepkör kezdő dátuma
        - enddate = a szerepkör záró dátuma
        - id = az identitás–szerepkör kapcsolat azonosítója (a sid.PersonRoles tábla id mezője)
- Egy PERSON_ROLES típusú importálást az Identity-tárházba. Bejelölheti a menet közbeni fiókszámítás kikapcsolására szolgáló beállítást, hogy nagy adatmennyiség esetén kézben tartsa az importálás időtartamát. Ha a beállítás be van kapcsolva, ACCOUNTCALC importálást kell végrehajtania az érintett tárház fiókjainak újraszámításához.

### Identitások - szerepkörök kapcsolatösszekötő konfigurálása

- Egy hiteles forrásból származó exportálást, amelynek a következő információkat kell tartalmaznia:
    - Az identitás UID-értéke (kötelező)
    - A szerepkör kódja (kötelező) – egyetlen érték.
    - Az identitás/szerepkör kapcsolathoz hozzárendelendő engedélyezés kódja (kötelező) – egyetlen érték
    - Az engedélyezés kezdő dátuma (nem kötelező)
    - Az engedélyezés záró dátuma (nem kötelező)

> **Figyelem**
>
> Az Identitás/szerepkör kapcsolatnak már léteznie kell ahhoz, hogy az Identitás/szerepkör – engedélyezések kapcsolatösszekötő megfelelően működjön

- Egy PERSON_RIGHTS típusú exportálást az Identity-tárházból, amelyben meg kell adnia azokat a személytípusokat és tárházkódokat, amelyekhez identitás/szerepkör–engedélyezés kapcsolatokat szeretne létrehozni.
- Egy szinkronizálási szabályt a Matching, a létrehozási, a módosítási és a törlési művelet meghatározásához
    - A Matching szabályban hasonlítsa össze az identitás UID-értékét, a szerepkör kódját és az engedélyezés kódját.
    - A létrehozási szabályban kötelező megadni az identitás UID-értékét, a szerepkör kódját és az engedélyezés kódját. A kezdő és a záró dátum megadása nem kötelező
    - A módosítási szabályban kötelező megadni a személy/szerepkör - engedélyezés kapcsolat azonosítóját, amely az Identity-tárház exportálásából származik. Csak a dátumok módosíthatók.
    - A törlési szabályban kötelező megadni a személy/szerepkör - engedélyezés kapcsolat azonosítóját, amely az Identity-tárház exportálásából származik.
    - Az Identity-kódok szinkronizálási szabályokban használandó szintaxisa:
    - person = az identitás UID-értéke
        - role = a szerepkör kódja
        - right = az engedélyezés kódja
        - startdate = az engedélyezés kezdő dátuma
        - enddate = az engedélyezés záró dátuma
    - id = az identitás–szerepkör–jog kapcsolat azonosítója (a sid.PersonRights tábla id mezője)
- Egy PERSON_RIGHTS típusú importálást az Identity-tárházba. Bejelölheti a menet közbeni fiókszámítás kikapcsolására szolgáló beállítást, hogy nagy adatmennyiség esetén kézben tartsa az importálás időtartamát. Ha a beállítás be van kapcsolva, ACCOUNTCALC importálást kell végrehajtania az érintett tárház fiókjainak újraszámításához.

## A nyomkövetés bekapcsolása

A 7.1 verziótól kezdve a kiépítési motor nyomkövetését már nem a beállításjegyzékben, hanem az `[Installation_Directory]\SIP\Config.ini` fájlban kell bekapcsolni.

> **Megjegyzés**
>
> Ez a fájl a kiépítési motor fájlja. Nem tévesztendő össze az összekötők konfigurációs fájljaival (`*.ini`), amelyeket a `-cfg` kapcsolóval kell átadni a HPPRunCli programnak.

A `General` szakaszban adja hozzá a következő három paramétert:

- `traceLevel`: `0` a nyomkövetés kikapcsolásához, `2FFFF` a bekapcsolásához.
- `traceModule`: a nyomon követendő modulok vesszővel elválasztott listája. A modulnevekben a kis- és nagybetűk nincsenek megkülönböztetve. A lehetséges értékek:
    - `HPPCfg`
    - `HPPCSV`
    - `HPPHP`
    - `HPPLDAP`
    - `HPPReference`
    - `HPPRunCli`
    - `HPPSQL`
    - `SIPSCIM`
    - `SIPLDAP`
    - `WrapperDLL`
    - `All`, az összes modul nyomkövetésének bekapcsolásához
- `traceOutputDir`: a naplók kimeneti könyvtára. Ez a paraméter nem kötelező: ha nincs megadva, a naplók a felhasználó `%tmp%` mappájában jönnek létre.

**Példa:**

```
1
2
3
4
```

> **Megjegyzés**
>
> A 7.1 verzió telepítője már beírja ezt a három paramétert a `Config.ini` fájlba, **kikapcsolt** nyomkövetéssel: `traceLevel=0`, a `traceModule` a modulok teljes listájával kitöltve, valamint `traceOutputDir=C:\Temp`. A nyomkövetés bekapcsolásához tehát csak a `traceLevel` értékét kell módosítania. Ellenőrizze, hogy a motort futtató fiók tud-e írni a kimeneti könyvtárba.

> **Tipp**
>
> Célzott diagnosztikához szűkítse a `traceModule` értékét csak az érintett modulokra – például `SIPSCIM` egy SCIM-célrendszerrel kapcsolatos csatlakozási probléma esetén. A diagnosztika befejezése után állítsa vissza a `traceLevel` értékét `0` értékre: a részletes nyomkövetés lemezterületet foglal, és lassítja a feldolgozást.

## A jelszavak és a titkos ügyfélkód titkosítása

A 7.1 verziótól kezdve a kiépítési motor által használt, az `[Installation_Directory]\SIP\Config.ini` fájlban található jelszavak és „client secrets” értékek titkosítva vannak.

Első telepítéskor a telepítő ezeket az adatokat a benne megadott paraméterek alapján automatikusan menti.

A két érték bármelyikének kézi módosításához használja az `[Installation_Directory]\SIP\SIPEncrypt.exe` végrehajtható fájlt. Parancssorban vagy PowerShell-ablakban futtassa a `SIPEncrypt.exe` parancsot, utána megadva a titkosítandó jelszót vagy titkos ügyfélkódot, majd másolja az eredményt a `Config.ini` fájlba.

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

A `SIPEncrypt.exe` **egyetlen paramétert** vár. Paraméter nélkül vagy több paraméterrel a `SIPEncrypt should be called with a single input parameter.` üzenetet jeleníti meg, és nem állít elő semmit. Ha az érték szóközöket vagy a parancssor által értelmezett karaktereket (`&`, `|`, `^`, `"`, `$`…) tartalmaz, tegye idézőjelek közé – PowerShellben lehetőleg egyszeres idézőjelek közé.

A titkos ügyfélkódot a `Config.ini` fájl `clientSecret` paraméterében kell megadni.

> **Figyelem**
>
> A SCIM-célrendszereknél történő hitelesítéshez a motor **változatlanul** használ minden olyan jelszót vagy titkos ügyfélkódot, amelyet nem tud visszafejteni. Egy véletlenül egyszerű szövegként hagyott érték tehát figyelmeztető üzenet nélkül működik, miközben a titkos kód a fájlban felfedve marad. Ellenőrizze, hogy a `Config.ini` minden titkos kódja valóban a `SIPEncrypt.exe` által előállított érték-e.

Ez a titkosítás visszafordítható, mivel a motor maga fejti vissza az értékeket: a titkos kód egyszerű szövegként való elolvasása ellen véd, nem a fájlhoz való hozzáférés ellen. Korlátozza a `Config.ini` fájlhoz való hozzáférést a felügyeleti fiókokra és a motort futtató fiókra. Parancssorba beírva az egyszerű szöveges érték a konzol előzményeiben is megmaradhat: használat után zárja be a munkamenetet.
