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 “”.

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

Biex tniedi xogħol individwalment, ikklikkja l-buttuna “”.

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.

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:

$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
    }
}

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:

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

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.

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.