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 „” gombra.

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

Egy feladat egyedi indításához kattintson a „” gombra.

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é.

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:

$urlGenToken = "https://[URL_serveur_SID]:44350/connect/token"
$BodyJsonPostToken = "grant_type=password&client_id=sip&client_secret=sip&username=[login_cpt]&password=[mot_de_passe_compte]"
$MonHeader = @{
        "Content-Type" = "application/x-www-form-urlencoded"
        "accept" = "Application/Json"
        "Host" = "[URL_serveur_SID]:44350"
    }

$MonHeaderReq = @{
        "Content-Type" = "application/x-www-form-urlencoded"
        "accept" = "Application/Json"
        "Host" = "[URL_serveur_SID]:44350"
        "Authorization" = "Bearer $($token_gen)" 
    }

try {

    $result = Invoke-RestMethod -Uri $urlGenToken -Method Post -Headers $MonHeader -Body $BodyJsonPostToken 
    $token_gen = $result.access_token
    #ajouter logs
}
catch {
    $token_gen = ""
    #ajouter logs
}

if ($token_gen -ne "")
{
    $job_code = [code_du_job_à_exécuter]
    $MonHeaderReq = @{
        "Content-Type" = "application/x-www-form-urlencoded"
        "accept" = "Application/Json"
        "Host" = "sid.iam-test.ght49.intra:44355"
        "Authorization" = "Bearer $($token_gen)"
    }
    $urlExecutionJob="https://sid.iam-test.ght49.intra:44355/scim/v2/job/run/$job_code"

    try {
        $res = Invoke-RestMethod -Uri $urlExecutionJob -Method Post -Headers $MonHeaderReq  
        #ajouter logs
    }
    catch {
        #ajouter logs et traitement
    }
}

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:

[General]
traceLevel=2ffff
traceModule=HPPCSV,HPPCfg,HPPLDAP
traceOutputDir=c:/myLog

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.

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.