Aqbeż għall-kontenut

Ħolqien/modifika tar-regoli tal-esportazzjoni

L-għan ta’ regola tal-esportazzjoni huwa li tiddefinixxi, abbażi ta’ repożitorju, l-oġġetti li għandhom jiġu esportati u l-postijiet tagħhom. Pereżempju, għal repożitorju tat-tip direttorju, ikollok bżonn tiddefinixxi l-oġġetti li għandhom jiġu esportati u l-OUs li fihom se ssir it-tfittxija.

Kull esportazzjoni se tiġġenera fajl tad-dejta f’format XML.

Hemm żewġ modalitajiet ta’ esportazzjoni possibbli, li jistgħu jintgħażlu skont il-każ tal-użu:

  • Sħiħa: l-oġġetti kollha li jikkonformaw mar-regoli tal-esportazzjoni jiġu esportati fil-fajl tal-output. Il-fajl tal-output huwa f’format XML.
  • Unitarja: Esportazzjoni ta’ oġġett wieħed iffiltrat fuq il-valur ta’ attribut.

Ir-regoli tal-esportazzjoni li għandhom jiġu kkonfigurati jvarjaw skont it-tip ta’ repożitorju.

Esportazzjoni ta’ repożitorju tat-tip direttorju (LDAP, AD, AD/LDS, OpenLDAP, eċċ.)

  • Tip ta’ oġġett: speċifika t-tip ta’ oġġett li għandu jiġi esportat (eż., user, classes, eċċ.).
  • Filtru tat-tfittxija: qasam fakultattiv biex tapplika filtri fuq l-oġġetti li għandhom jiġu esportati (eż., “employeeID” mhux vojt).
  • Filtru unitarju: attribut li jħallik tiffiltra oġġett billi tiddefinixxi l-valur tiegħu.
  • Attributi: lista tal-attributi tal-oġġetti li għandhom jiġu esportati. Din il-lista hija kompletament konfigurabbli, ara hawn taħt.
  • OUs: speċifika l-OUs li lejhom se jiġu esportati l-oġġetti.
  • Filtri tal-gruppi: Lista tal-gruppi li għandhom jiġu ġestiti jew esklużi fl-azzjonijiet tat-tħassir:
    • Jekk l-għażla “Remove the groups instead of keeping them” mhix immarkata: il-lista tal-gruppi tindika dawk li m’għandhomx jitħassru.
    • Jekk l-għażla “Remove the groups instead of keeping them” hija mmarkata: il-lista tal-gruppi tindika dawk li jistgħu jitħassru.

Għażla tal-attributi li għandhom jiġu esportati:

Mill-verżjoni 7.1, tiġi offruta lista ta’ attributi biex tiffaċilita l-għażla tal-attributi li għandhom jiġu esportati fir-repożitorji tat-tip direttorju. Biex iżżid attribut għall-esportazzjoni, uża l-buttuna “Update list”:

Din l-azzjoni tiftaħ il-lista tal-attributi maħluqa u preżenti fil-mudell. Tista’ żżid jew tneħħi attributi skont il-ħtieġa:

Biex iżżid attribut li mhuwiex parti mil-lista, l-ewwel oħloq attribut ġdid bl-użu tal-buttuna “Templates”:

Il-lista tal-attributi hija kompletament konfigurabbli: minbarra l-ħolqien ta’ attributi ġodda, tista’ timmodifika jew tħassar attributi fil-lista.

Ġestjoni tal-gruppi mir-repożitorju Identity:

Sal-verżjoni 7.0, kellek iddaħħal manwalment il-lista tal-gruppi tas-sigurtà li għandhom jiġu ġestiti minn SIP, jew il-lista tal-gruppi li għandhom jiġu esklużi mill-paragunar, u ddaħħalha kemm fl-esportazzjoni kif ukoll fl-importazzjoni tar-repożitorju.

Mill-verżjoni 7.1, il-konnettur il-ġdid tad-direttorju jista’ jistrieħ fuq il-lista tal-gruppi maħluqa u ġestiti f’CyberElements Identity. Biex tagħmel dan, immarka l-għażla “Synchronization of groups managed by Identity only” fil-konfigurazzjoni SIP tar-repożitorju u daħħal il-kodiċi tal-esportazzjoni, normalment memberof@.

Riżultati u għażliet:

Kull attribut jiġi esportat f’tikketta XML li isimha huwa l-isem tal-attribut tad-direttorju. Il-format default tad-dejta esportata huwa sekwenza ta’ karattri.

Għal kull attribut, huwa possibbli li tispeċifika tip differenti b’dawn l-għażliet:

  • Binary
  • Date
  • Date_Filetime

Biex tibdel il-format tal-esportazzjoni, agħżel l-attribut mixtieq u kklikkja fuq il-buttuna “Modify”.

Esportazzjoni ta’ repożitorju ta’ fajl ċatt (CSV)

  • Attributi: lista tal-kolonni li jiffurmaw il-fajl ċatt (il-fajl jiġi definit meta jinħoloq ir-repożitorju).
    • Ikklikkja fuq “Add” biex iżżid entrata.
    • Agħżel attribut biex timmodifikah jew tħassru.
    • Jekk il-fajl CSV għandu intestaturi tal-kolonni, tista’ tikklikkja fuq il-buttuna “Get Column Name” biex tikseb awtomatikament l-ismijiet tal-kolonni.
  • Attribut ta’ paragun għal tfittxija ffiltrata: kolonna li tħallik tesporta oġġett wieħed billi tiddefinixxi l-valur tagħha.

Riżultati u għażliet:

Kull attribut jiġi esportat f’tikketta XML li isimha huwa l-isem tal-attribut speċifikat. Il-format default tad-dejta esportata huwa sekwenza ta’ karattri.

Għal kull attribut, huwa possibbli li tispeċifika tip differenti b’dawn l-għażliet:

  • Binary
  • Date
  • Date_Filetime

Biex tibdel il-format tal-esportazzjoni, agħżel l-attribut mixtieq u kklikkja fuq il-buttuna “Modify”.

Esportazzjoni ta’ repożitorju tat-tip bażi tad-dejta (SQL Server, Oracle, eċċ.)

  • Tip ta’ oġġett: valur indikattiv, l-ebda impatt fuq il-konfigurazzjoni
  • Query SQL: query li tiġbed l-informazzjoni kollha mixtieqa
  • Filtru unitarju: query li fiha jiġi speċifikat filtru biex tirritorna riżultat wieħed biss
  • Attributi: kaxxa pprovduta biex iżżid queries SQL ħalli tesporta informazzjoni addizzjonali. Kull query tista’ tesporta attribut wieħed biss, iżda dan jista’ jkun b’ħafna valuri (queries li jirritornaw diversi linji)
  • Għażla multi-linja: għażla li għandha tiġi mmarkata jekk wieħed mill-attributi esportati tal-query prinċipali huwa b’ħafna valuri. L-isem ta’ dan l-attribut għandu jitniżżel fil-qasam “Multiline Matching Attribute”. Jista’ jkun hemm attribut wieħed biss b’ħafna valuri fil-query prinċipali.

Nota importanti: jekk din l-għażla hija mmarkata, huwa essenzjali li twettaq “order by” fil-query biex tissortja bl-użu tal-attribut imdaħħal fil-qasam “Multiline Matching Attribute”.

Riżultati u għażliet:

Kull kolonna definita fil-query tiġi esportata f’tikketta XML bl-isem tal-kolonna speċifikata. Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Esportazzjoni ta’ repożitorju tat-tip API (REST – protokoll SIM)

  • Tip ta’ oġġett: ikklikkja fuq il-buttuna “Get Object Type List” biex tikseb il-lista tal-oġġetti disponibbli għall-esportazzjoni mir-repożitorju tal-applikazzjoni.
  • Attribut tal-immappjar: ikklikkja fuq il-buttuna “Get Attributes List” biex tikseb il-lista tal-attributi disponibbli. Il-lista tal-attributi tiddependi fuq it-tip ta’ oġġett magħżul.
  • Ikklikkja fuq il-buttuna “Set” biex tikkonferma l-aġġornamenti.

Riżultati u għażliet:

Kull attribut definit fit-tip ta’ oġġett li jirritorna l-API jiġi esportat f’tikketta XML. Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Esportazzjoni ta’ repożitorju XML

Biex tesporta repożitorju XML, trid twettaq azzjoni XSLT.

Il-fajls XML jista’ jkollhom strutturi differenti, għalhekk trid tipproduċi fajl tat-trasformazzjoni biex tikkonvertih f’format XML kompatibbli mal-magna tal-provvediment SIP.

Esportazzjoni Identity: identitajiet

  • Tip ta’ oġġett: Daħħal il-valur “USERS”
  • Tip ta’ persuna: speċifika l-kodiċi tat-tipi ta’ persuni li għandhom jiġu esportati mir-repożitorju Identity
  • Attribut ta’ paragun għall-esportazzjoni unitarja: “personne_uid”

Riżultati u għażliet:

Għal kull identità, l-attributi kollha li għandhom valur jiġu esportati awtomatikament f’tikketta XML li isimha huwa l-kodiċi tal-attribut. Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Esportazzjoni Identity: enumerazzjonijiet

  • Tip ta’ oġġett: Daħħal il-valur “ENUMERATIONS”
  • Lista tal-kodiċijiet: Kodiċi tal-enumerazzjonijiet li għandhom jiġu esportati mir-repożitorju Identity; diversi enumerazzjonijiet jistgħu jiġu esportati fl-istess ħin.

L-ebda esportazzjoni unitarja ma hi ġestita għall-enumerazzjonijiet.

Riżultati u għażliet:

Għal kull enumerazzjoni, jiġu esportati t-tikketti li ġejjin:

  • Type = Kodiċi tal-attribut (jew kodiċi tat-tip ta’ enumerazzjoni) li fih il-lista tal-valuri
  • Code = Kodiċi ta’ valur tal-enumerazzjoni
  • Name = Isem muri assoċjat mal-kodiċi
  • Description = Deskrizzjoni tal-valur tal-enumerazzjoni. Din l-informazzjoni hija fakultattiva u tiġi esportata biss jekk mhix vojta.

Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Esportazzjoni Identity: tabelli ta’ korrispondenza

  • Tip ta’ oġġett: Daħħal il-valur “MATCHINGTABLE”
  • Lista tal-kodiċijiet: Kodiċi tat-tabelli ta’ korrispondenza li għandhom jiġu esportati mir-repożitorju Identity; diversi tabelli ta’ korrispondenza jistgħu jiġu esportati fl-istess ħin.

L-ebda esportazzjoni unitarja ma hi ġestita fuq it-tabelli ta’ korrispondenza.

Riżultati u għażliet:

Għal kull tabella ta’ korrispondenza, jiġu esportati t-tikketti li ġejjin:

  • Type = Kodiċi tat-tip ta’ tabella ta’ korrispondenza
  • Key = Ċavetta tat-tabella ta’ korrispondenza
  • Value = Valur jew valuri assoċjati maċ-ċavetta. Il-valur jista’ jkun b’ħafna valuri.
  • Description = Deskrizzjoni tal-valur tat-tabella ta’ korrispondenza. Din l-informazzjoni hija fakultattiva u tiġi esportata biss jekk mhix vojta.

Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Esportazzjoni Identity: allokazzjonijiet (riżorsi)

  • Tip ta’ oġġett: Daħħal il-valur “OBJECTS”
  • Lista tal-kodiċijiet: speċifika l-kodiċi tat-tipi ta’ allokazzjonijiet (riżorsi) li għandhom jiġu esportati mir-repożitorju Identity
  • Għażla biex jiġu esportati l-istrutturi li għandhom rabta mal-allokazzjoni
  • Għażla biex jiġu esportati l-identitajiet li għandhom rabta mal-allokazzjoni
  • Attribut ta’ paragun għall-esportazzjoni unitarja: “object_instance_code”

Riżultati u għażliet:

Għal kull allokazzjoni (riżorsa), l-attributi kollha li għandhom valur jiġu esportati awtomatikament f’tikketta XML li isimha huwa l-kodiċi tal-attribut. Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Esportazzjoni Identity: stati tal-provvediment

  • Tip ta’ oġġett: Daħħal il-valur “STATUS”
  • Repożitorju: kodiċi tar-repożitorju li minnu trid tesporta l-persuni u l-kontijiet assoċjati magħhom. Innota li għandu jkun uniku biex jaħdem kif suppost.
  • Attribut ta’ paragun għall-esportazzjoni unitarja: “Account.login”

Riżultati u għażliet:

Għal kull kont fir-repożitorju, jiġu esportati t-tikketti li ġejjin:

  • Account.Id: Id tal-kont
  • Account.login: Login tal-kont. Se jintuża għall-finijiet ta’ paragun
  • Account.state: Stat tal-provvediment tal-kont (0: mhux ipprovdut, 1: ipprovdut)
  • Person.Id: ID tal-persuna primarja
  • Person.uniqueId: UID tal-persuna primarja
  • Għal kull awtorizzazzjoni marbuta mal-kont:
    • [code_mapping_right]#right.id: tikketta ta’ informazzjoni biex tikseb il-lista tal-IDs tad-drittijiet li għandhom il-valur tal-kodiċi tal-immappjar indikat fl-ewwel parti tat-tikketta. Huma possibbli diversi valuri.
    • [code_mapping_right]#[right.id]: Tikketta ta’ dan it-tip għal kull awtorizzazzjoni li għandha l-valur tal-kodiċi tal-immappjar indikat fl-ewwel parti tat-tikketta. Fiha l-valur tal-awtorizzazzjoni
    • [code_mapping_right]: tikketta ta’ informazzjoni biex tikseb il-lista tal-valuri tal-awtorizzazzjoni li għandhom il-valur tal-kodiċi tal-immappjar indikat fl-ewwel parti tat-tikketta. Huma possibbli diversi valuri.
    • [code_mapping_right]#state: Lista tal-istati tal-provvediment għal kull awtorizzazzjoni li għandha l-valur tal-kodiċi tal-immappjar indikat fl-ewwel parti tat-tikketta.

Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Esportazzjoni Identity: strutturi

  • Tip ta’ oġġett: Daħħal il-valur “STRUCTURES”
  • Lista tal-kodiċijiet: speċifika l-kodiċi tat-tipi ta’ strutturi li għandhom jiġu esportati mir-repożitorju Identity
  • Attribut ta’ paragun għall-esportazzjoni unitarja: “structure_code”

Riżultati u għażliet:

Għal kull struttura, l-attributi kollha li għandhom valur jiġu esportati awtomatikament f’tikketta XML li isimha huwa l-kodiċi tal-attribut. Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Esportazzjoni Identity: identitajiet + awtorizzazzjonijiet

  • Tip ta’ oġġett: Daħħal il-valur “USERS+ACCESS”
  • Repożitorju: kodiċi tar-repożitorju li minnu trid tesporta l-persuni u l-kontijiet assoċjati magħhom. Innota li għandu jkun uniku biex jaħdem kif suppost.
  • Tip ta’ persuna: speċifika l-kodiċi tat-tipi ta’ persuni li għandhom jiġu esportati mir-repożitorju Identity
  • Attribut ta’ paragun għall-esportazzjoni unitarja: “personne_uid”

Riżultati u għażliet:

Għal kull identità, l-attributi kollha li għandhom valur jiġu esportati awtomatikament f’tikketta XML li isimha huwa l-kodiċi tal-attribut. Il-format tad-dejta esportata huwa sekwenza ta’ karattri.

Jekk l-identità għandha kont fir-repożitorju speċifikat, jiġu esportati tikketti XML addizzjonali:

  • HPPAccountLogin
  • HPPAccountPwd
  • HPPAccountState

Jekk l-identità għandha permessi fuq ir-repożitorju speċifikat, jiġu esportati tikketti XML addizzjonali:

  • HPPAccessRight, li se jkun fiha l-valuri kollha tal-permessi “Group” u “Dynamic Group”
  • Tikketta XML waħda għal kull kodiċi differenti definit fl-immappjar tal-permessi “Attribute” jew “Dynamic Attribute”. Jekk diversi awtorizzazzjonijiet huma kkonfigurati bl-istess kodiċi tal-immappjar, tiġi esportata tikketta XML waħda b’diversi valuri fiha.

Esportazzjoni Identity: kontijiet + awtorizzazzjonijiet

  • Tip ta’ oġġett: agħżel il-valur “ACCOUNT”
  • Repożitorju: speċifika l-kodiċi tar-repożitorju li minnu għandhom jiġu esportati l-kontijiet u l-awtorizzazzjonijiet. Innota li għalkemm teknikament huwa possibbli li ddaħħal diversi kodiċijiet tar-repożitorji, huwa essenzjali li ddaħħal wieħed biss biex il-konnettur tal-provvediment jaħdem kif suppost.

Riżultati u għażliet: Il-kontijiet kollha fir-repożitorju magħżul jiġu esportati.

Għal kull kont, jiġu esportati t-tikketti li ġejjin:

  • ID = ID tal-kont, li għandu jintuża għall-aġġornamenti u għat-tħassir
  • Account_login = Login tal-kont
  • password = Password tal-kont, esportata f’forma kriptata
  • Account_provisioning = Stat tal-provvediment tal-kont:
    • 1: kont teoretiku biss
    • 2: kont orfni
    • 3: kont teoretiku u pprovdut
  • Account_state = Stat tal-kont teoretiku
    • -1: L-ebda kont (valur mhux possibbli fl-esportazzjoni)
    • 0: kont teoretiku biss
    • 1: kont attiv
    • 2: kont diżattivat
  • Account_type = ID tat-tip ta’ kont
  • roles = Rwoli assoċjati mal-kont
  • L-attributi u l-permessi jiġu esportati f’tikketti msemmija mill-konfigurazzjoni.

Esportazzjoni Identity: rwoli

  • Tip ta’ oġġett: agħżel il-valur “ROLE”
  • Repożitorji: speċifika l-kodiċijiet tar-repożitorju li r-rwoli relatati eżistenti tiegħu għandhom jiġu esportati. Fakultattiv.

Riżultati u għażliet: Ir-rwoli eżistenti kollha jiġu esportati. Jekk jiġu speċifikati repożitorju wieħed jew aktar, jiġu esportati biss ir-rwoli relatati ma’ dawk ir-repożitorji.

Għal kull rwol, jiġu esportati t-tikketti li ġejjin:

  • id = ID tar-rwol
  • code = il-kodiċi tar-rwol
  • name = l-isem tar-rwol
  • description = id-deskrizzjoni tar-rwol
  • repositories = kodiċi tar-repożitorji marbuta mar-rwol
  • accountTypes = kodiċi tat-tipi ta’ kontijiet marbuta mar-rwol

Esportazzjoni Identity: awtorizzazzjonijiet

  • Tip ta’ oġġett: agħżel il-valur “RIGHT”
  • Repożitorji: speċifika l-kodiċijiet tar-repożitorju li l-awtorizzazzjonijiet relatati eżistenti tiegħu għandhom jiġu esportati. Fakultattiv.

Riżultati u għażliet: L-awtorizzazzjonijiet eżistenti kollha jiġu esportati. Jekk jiġu speċifikati repożitorju speċifiku wieħed jew aktar, jiġu esportati biss l-awtorizzazzjonijiet relatati ma’ dawk ir-repożitorji.

Għal kull awtorizzazzjoni, jiġu esportati t-tikketti li ġejjin:

  • Id = L-ID tal-awtorizzazzjoni
  • code = Il-kodiċi tal-awtorizzazzjoni
  • name = L-isem tal-awtorizzazzjoni
  • category = Il-kodiċi tal-kategorija tal-awtorizzazzjoni
  • application = Il-kodiċi tal-applikazzjoni tal-awtorizzazzjoni
  • repository = Il-kodiċi tar-repożitorju tal-awtorizzazzjoni
  • type = It-tip ta’ awtorizzazzjoni
    • 3 = group. Innota li l-użu ta’ dan it-tip ta’ awtorizzazzjoni huwa deprekat mill-verżjoni 7.0. Ippreferi t-tip “attribute”.
    • 6 = attribute
  • mode = Il-modalità tal-awtorizzazzjoni
    • 0 = Statiku. Valur statiku li għandu jiġi speċifikat fit-tikketta “value”
    • 1 = dinamiku: valur ta’ attribut speċifikat fit-tikketta msemmija “template#[object_type_code]”
  • L-isem tal-attribut għall-esportazzjoni tal-awtorizzazzjonijiet marbuta mal-kontijiet jew mal-persuni, fit-tikketta “mappingCode”

Esportazzjoni Identity: identitajiet + rwoli

  • Tip ta’ oġġett: agħżel il-valur “PERSON_ROLES”
  • Repożitorji: speċifika l-kodiċijiet tar-repożitorju li r-rwoli relatati eżistenti tiegħu għandhom jiġu esportati.

Riżultati u għażliet: ir-rabtiet identità-rwol kollha relatati mar-repożitorji magħżula jiġu esportati.

Għal kull rabta identità-rwol, jiġu esportati t-tikketti li ġejjin:

  • person = UID tal-identità
  • role = kodiċi tar-rwol li għandu jiġi assenjat
  • startdate = data tal-bidu tar-rwol
  • enddate = data tat-tmiem tar-rwol
  • id = id tar-rabta identità-rwol

Esportazzjoni Identity: identitajiet + rwoli + awtorizzazzjonijiet

  • Tip ta’ oġġett: agħżel il-valur “PERSON_RIGHTS”
  • Repożitorji: speċifika l-kodiċijiet tar-repożitorji li għalihom trid toħloq rabtiet identità/rwol-awtorizzazzjoni.

Riżultati u għażliet: ir-rabtiet identità/rwol-awtorizzazzjoni kollha relatati mar-repożitorji magħżula jiġu esportati.

Għal kull rabta identità/rwol-awtorizzazzjoni, jiġu esportati t-tikketti li ġejjin:

  • 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-awtorizzazzjoni