Eksporto taisyklių kūrimas/keitimas¶

Eksporto taisyklės paskirtis – remiantis saugykla apibrėžti eksportuotinus objektus ir jų vietas. Pavyzdžiui, katalogo tipo saugyklai reikės apibrėžti eksportuotinus objektus ir OU, kuriuose bus atliekama paieška.

Kiekvienu eksportu bus sugeneruotas XML formato duomenų failas.

Galimi du eksporto režimai, kuriuos galima pasirinkti pagal naudojimo atvejį:

Visas: visi eksporto taisykles atitinkantys objektai eksportuojami į išvesties failą. Išvesties failas yra XML formato.
Vienetinis: vieno objekto, atfiltruoto pagal atributo reikšmę, eksportas.

Konfigūruotinos eksporto taisyklės skiriasi priklausomai nuo saugyklos tipo.

Katalogo tipo saugyklos eksportavimas (LDAP, AD, AD/LDS, OpenLDAP ir kt.)¶

Objekto tipas: nurodykite eksportuotino objekto tipą (pvz., user, classes ir kt.).
Paieškos filtras: neprivalomas laukas, skirtas filtrams eksportuotiniems objektams taikyti (pvz., „employeeID“ netuščias).
Vienetinis filtras: atributas, leidžiantis filtruoti objektą apibrėžiant jo reikšmę.
Atributai: eksportuotinų objektų atributų sąrašas. Šį sąrašą galima visiškai konfigūruoti, žr. toliau.
OU: nurodykite OU, į kuriuos bus eksportuojami objektai.
Grupių filtrai: grupių, kurias reikia valdyti arba neįtraukti naikinimo veiksmuose, sąrašas:
- Jei parinktis „Remove the groups instead of keeping them“ nepažymėta: grupių sąraše nurodomos grupės, kurių negalima naikinti.
- Jei parinktis „Remove the groups instead of keeping them“ pažymėta: grupių sąraše nurodomos grupės, kurias galima naikinti.

Eksportuotinų atributų pasirinkimas:

Nuo 7.1 versijos siūlomas atributų sąrašas, kad būtų lengviau pasirinkti eksportuotinus atributus katalogo tipo saugyklose. Norėdami pridėti eksportuotiną atributą, naudokite mygtuką „Update list“:

Šis veiksmas atidaro sukurtų ir šablone esančių atributų sąrašą. Prireikus galite pridėti arba pašalinti atributus:

Norėdami pridėti atributą, kurio nėra sąraše, pirmiausia sukurkite naują atributą naudodami mygtuką „Templates“:

Atributų sąrašą galima visiškai konfigūruoti: be naujų atributų kūrimo, galite keisti arba naikinti sąrašo atributus.

Grupių valdymas iš Identity saugyklos:

Iki 7.0 versijos saugos grupių, kurias turi valdyti SIP, sąrašą arba grupių, kurias reikia neįtraukti į palyginimus, sąrašą reikėjo įvesti rankiniu būdu – ir saugyklos eksporte, ir importe.

Nuo 7.1 versijos naujoji katalogo jungtis gali remtis CyberElements Identity sukurtų ir valdomų grupių sąrašu. Tam saugyklos SIP konfigūracijoje pažymėkite parinktį „Synchronization of groups managed by Identity only“ ir įveskite eksporto kodą, paprastai memberof@.

Rezultatai ir parinktys:

Kiekvienas atributas eksportuojamas XML žymėje, kurios pavadinimas yra katalogo atributo pavadinimas. Numatytasis eksportuotų duomenų formatas – simbolių eilutė.

Kiekvienam atributui galima nurodyti kitą tipą, pasirenkant iš šių variantų:

Binary
Date
Date_Filetime

Norėdami pakeisti eksporto formatą, pasirinkite norimą atributą ir spustelėkite mygtuką „Modify“.

Plokščiojo failo saugyklos eksportavimas (CSV)¶

Atributai: plokščiąjį failą sudarančių stulpelių sąrašas (failas apibrėžiamas kuriant saugyklą).
- Spustelėkite „Add“, kad pridėtumėte įrašą.
- Pasirinkite atributą, kad jį pakeistumėte arba panaikintumėte.
- Jei CSV faile yra stulpelių antraštės, galite spustelėti mygtuką „Get Column Name“, kad stulpelių pavadinimai būtų gauti automatiškai.
Palyginimo atributas filtruotai paieškai: stulpelis, leidžiantis eksportuoti vieną objektą apibrėžiant jo reikšmę.

Rezultatai ir parinktys:

Kiekvienas atributas eksportuojamas XML žymėje, kurios pavadinimas yra nurodytas atributo pavadinimas. Numatytasis eksportuotų duomenų formatas – simbolių eilutė.

Kiekvienam atributui galima nurodyti kitą tipą, pasirenkant iš šių variantų:

Binary
Date
Date_Filetime

Norėdami pakeisti eksporto formatą, pasirinkite norimą atributą ir spustelėkite mygtuką „Modify“.

Duomenų bazės tipo saugyklos eksportavimas (SQL Server, Oracle ir kt.)¶

Objekto tipas: orientacinė reikšmė, neturinti įtakos konfigūracijai
SQL užklausa: užklausa, išgaunanti visą norimą informaciją
Vienetinis filtras: užklausa, kurioje nurodytas filtras, kad būtų grąžintas tik vienas rezultatas
Atributai: rėmelis, skirtas SQL užklausoms, eksportuojančioms papildomą informaciją, pridėti. Kiekviena užklausa gali eksportuoti tik vieną atributą, tačiau jis gali būti kelių reikšmių (užklausos, grąžinančios kelias eilutes)
Kelių eilučių parinktis: parinktis, kurią reikia pažymėti, jei vienas iš pagrindinės užklausos eksportuojamų atributų yra kelių reikšmių. Šio atributo pavadinimą reikia įrašyti lauke „Multiline Matching Attribute“. Pagrindinėje užklausoje gali būti tik vienas kelių reikšmių atributas.

Svarbi pastaba: jei ši parinktis pažymėta, užklausoje būtina atlikti „order by“, kad būtų rikiuojama pagal lauke „Multiline Matching Attribute“ įvestą atributą.

Rezultatai ir parinktys:

Kiekvienas užklausoje apibrėžtas stulpelis eksportuojamas XML žymėje, pavadintoje nurodyto stulpelio pavadinimu. Eksportuotų duomenų formatas – simbolių eilutė.

API tipo saugyklos eksportavimas (REST – SIM protokolas)¶

Objekto tipas: spustelėkite mygtuką „Get Object Type List“, kad iš taikomosios programos saugyklos gautumėte eksportuoti galimų objektų sąrašą.
Susiejimo atributas: spustelėkite mygtuką „Get Attributes List“, kad gautumėte galimų atributų sąrašą. Atributų sąrašas priklauso nuo pasirinkto objekto tipo.
Spustelėkite mygtuką „Set“, kad patvirtintumėte pakeitimus.

Rezultatai ir parinktys:

Kiekvienas API grąžinamame objekto tipe apibrėžtas atributas eksportuojamas XML žymėje. Eksportuotų duomenų formatas – simbolių eilutė.

XML saugyklos eksportavimas¶

Norint eksportuoti XML saugyklą, reikia atlikti XSLT veiksmą.

XML failų struktūros gali skirtis, todėl reikia parengti transformavimo failą, kad juos būtų galima konvertuoti į XML formatą, suderinamą su SIP aprūpinimo moduliu.

Identity eksportas: tapatybės¶

Objekto tipas: įveskite reikšmę „USERS“
Asmens tipas: nurodykite asmenų tipų, eksportuotinų iš Identity saugyklos, kodą
Palyginimo atributas vienetiniam eksportui: „personne_uid“

Rezultatai ir parinktys:

Kiekvienos tapatybės visi atributai, turintys reikšmę, automatiškai eksportuojami į XML žymę, kurios pavadinimas yra atributo kodas. Eksportuotų duomenų formatas – simbolių eilutė.

Identity eksportas: išvardijimai¶

Objekto tipas: įveskite reikšmę „ENUMERATIONS“
Kodų sąrašas: iš Identity saugyklos eksportuotinų išvardijimų kodas; vienu metu galima eksportuoti kelis išvardijimus.

Išvardijimams vienetiniai eksportai nepalaikomi.

Rezultatai ir parinktys:

Kiekvienam išvardijimui eksportuojamos šios žymės:

Type = atributo kodas (arba išvardijimo tipo kodas), kuriame yra reikšmių sąrašas
Code = išvardijimo reikšmės kodas
Name = su kodu susietas pavadinimas
Description = išvardijimo reikšmės aprašas. Ši informacija neprivaloma ir eksportuojama tik tada, kai ji netuščia.

Eksportuotų duomenų formatas – simbolių eilutė.

Identity eksportas: atitikmenų lentelės¶

Objekto tipas: įveskite reikšmę „MATCHINGTABLE“
Kodų sąrašas: iš Identity saugyklos eksportuotinų atitikmenų lentelių kodas; vienu metu galima eksportuoti kelias atitikmenų lenteles.

Atitikmenų lentelėms vienetiniai eksportai nepalaikomi.

Rezultatai ir parinktys:

Kiekvienai atitikmenų lentelei eksportuojamos šios žymės:

Type = atitikmenų lentelės tipo kodas
Key = atitikmenų lentelės raktas
Value = su raktu susieta (-os) reikšmė (-ės). Reikšmė gali būti kelių reikšmių.
Description = atitikmenų lentelės reikšmės aprašas. Ši informacija neprivaloma ir eksportuojama tik tada, kai ji netuščia.

Eksportuotų duomenų formatas – simbolių eilutė.

Identity eksportas: priskyrimai (ištekliai)¶

Objekto tipas: įveskite reikšmę „OBJECTS“
Kodų sąrašas: nurodykite priskyrimų (išteklių) tipų, eksportuotinų iš Identity saugyklos, kodą
Parinktis eksportuoti struktūras, susietas su priskyrimu
Parinktis eksportuoti tapatybes, susietas su priskyrimu
Palyginimo atributas vienetiniam eksportui: „object_instance_code“

Rezultatai ir parinktys:

Kiekvieno priskyrimo (ištekliaus) visi atributai, turintys reikšmę, automatiškai eksportuojami į XML žymę, kurios pavadinimas yra atributo kodas. Eksportuotų duomenų formatas – simbolių eilutė.

Identity eksportas: aprūpinimo būsenos¶

Objekto tipas: įveskite reikšmę „STATUS“
Saugykla: saugyklos, iš kurios norite eksportuoti asmenis ir jų susietas paskyras, kodas. Atkreipkite dėmesį, kad jis turi būti unikalus, kad funkcija veiktų tinkamai.
Palyginimo atributas vienetiniam eksportui: „Account.login“

Rezultatai ir parinktys:

Kiekvienai saugyklos paskyrai eksportuojamos šios žymės:

Account.Id: paskyros ID
Account.login: paskyros prisijungimo vardas. Bus naudojamas palyginimui
Account.state: paskyros aprūpinimo būsena (0: neaprūpinta, 1: aprūpinta)
Person.Id: pagrindinio asmens ID
Person.uniqueId: pagrindinio asmens UID
Kiekvienam su paskyra susietam autorizavimui:
- [code_mapping_right]#right.id: informacinė žymė, skirta teisių, turinčių pirmojoje žymės dalyje nurodytą susiejimo kodo reikšmę, ID sąrašui gauti. Galimos kelios reikšmės.
- [code_mapping_right]#[right.id]: po vieną tokio tipo žymę kiekvienam autorizavimui, turinčiam pirmojoje žymės dalyje nurodytą susiejimo kodo reikšmę. Joje yra autorizavimo reikšmė
- [code_mapping_right]: informacinė žymė, skirta autorizavimo reikšmių, turinčių pirmojoje žymės dalyje nurodytą susiejimo kodo reikšmę, sąrašui gauti. Galimos kelios reikšmės.
- [code_mapping_right]#state: kiekvieno autorizavimo, turinčio pirmojoje žymės dalyje nurodytą susiejimo kodo reikšmę, aprūpinimo būsenų sąrašas.

Eksportuotų duomenų formatas – simbolių eilutė.

Identity eksportas: struktūros¶

Objekto tipas: įveskite reikšmę „STRUCTURES“
Kodų sąrašas: nurodykite struktūrų tipų, eksportuotinų iš Identity saugyklos, kodą
Palyginimo atributas vienetiniam eksportui: „structure_code“

Rezultatai ir parinktys:

Kiekvienos struktūros visi atributai, turintys reikšmę, automatiškai eksportuojami į XML žymę, kurios pavadinimas yra atributo kodas. Eksportuotų duomenų formatas – simbolių eilutė.

Identity eksportas: tapatybės + autorizavimai¶

Objekto tipas: įveskite reikšmę „USERS+ACCESS“
Saugykla: saugyklos, iš kurios norite eksportuoti asmenis ir jų susietas paskyras, kodas. Atkreipkite dėmesį, kad jis turi būti unikalus, kad funkcija veiktų tinkamai.
Asmens tipas: nurodykite asmenų tipų, eksportuotinų iš Identity saugyklos, kodą
Palyginimo atributas vienetiniam eksportui: „personne_uid“

Rezultatai ir parinktys:

Kiekvienos tapatybės visi atributai, turintys reikšmę, automatiškai eksportuojami į XML žymę, kurios pavadinimas yra atributo kodas. Eksportuotų duomenų formatas – simbolių eilutė.

Jei tapatybė turi paskyrą nurodytoje saugykloje, eksportuojamos papildomos XML žymės:

HPPAccountLogin
HPPAccountPwd
HPPAccountState

Jei tapatybė turi leidimų nurodytoje saugykloje, eksportuojamos papildomos XML žymės:

HPPAccessRight, kurioje bus visos leidimų „Group“ ir „Dynamic Group“ reikšmės
Po vieną XML žymę kiekvienam skirtingam kodui, apibrėžtam leidimų „Attribute“ arba „Dynamic Attribute“ susiejime. Jei keli autorizavimai sukonfigūruoti su tuo pačiu susiejimo kodu, bus eksportuota viena XML žymė su keliomis reikšmėmis.

Identity eksportas: paskyros + autorizavimai¶

Objekto tipas: pasirinkite reikšmę „ACCOUNT“
Saugykla: nurodykite saugyklos, iš kurios turi būti eksportuojamos paskyros ir autorizavimai, kodą. Atkreipkite dėmesį: nors techniškai galima įvesti kelis saugyklų kodus, kad aprūpinimo jungtis veiktų tinkamai, būtina įvesti tik vieną.

Rezultatai ir parinktys: eksportuojamos visos pasirinktos saugyklos paskyros.

Kiekvienai paskyrai eksportuojamos šios žymės:

ID = paskyros ID, naudotinas keitimams ir naikinimams
Account_login = paskyros prisijungimo vardas
password = paskyros slaptažodis, eksportuojamas šifruotas
Account_provisioning = paskyros aprūpinimo būsena:
- 1: tik teorinė paskyra
- 2: našlaitinė paskyra
- 3: teorinė ir aprūpinta paskyra
Account_state = teorinės paskyros būsena
- -1: paskyros nėra (eksporte ši reikšmė negalima)
- 0: tik teorinė paskyra
- 1: aktyvi paskyra
- 2: išjungta paskyra
Account_type = paskyros tipo ID
roles = su paskyra susieti vaidmenys
Atributai ir leidimai eksportuojami žymėse, kurių pavadinimai nustatomi konfigūracijoje.

Identity eksportas: vaidmenys¶

Objekto tipas: pasirinkite reikšmę „ROLE“
Saugyklos: nurodykite saugyklos, kurios esami susiję vaidmenys turi būti eksportuojami, kodus. Neprivaloma.

Rezultatai ir parinktys: eksportuojami visi esami vaidmenys. Jei nurodyta viena ar daugiau saugyklų, bus eksportuojami tik su tomis saugyklomis susiję vaidmenys.

Kiekvienam vaidmeniui eksportuojamos šios žymės:

id = vaidmens ID
code = vaidmens kodas
name = vaidmens pavadinimas
description = vaidmens aprašas
repositories = su vaidmeniu susietų saugyklų kodas
accountTypes = su vaidmeniu susietų paskyrų tipų kodas

Identity eksportas: autorizavimai¶

Objekto tipas: pasirinkite reikšmę „RIGHT“
Saugyklos: nurodykite saugyklos, kurios esami susiję autorizavimai turi būti eksportuojami, kodus. Neprivaloma.

Rezultatai ir parinktys: eksportuojami visi esami autorizavimai. Jei nurodyta viena ar daugiau konkrečių saugyklų, bus eksportuojami tik su tomis saugyklomis susiję autorizavimai.

Kiekvienam autorizavimui eksportuojamos šios žymės:

Id = autorizavimo ID
code = autorizavimo kodas
name = autorizavimo pavadinimas
category = autorizavimo kategorijos kodas
application = autorizavimo taikomosios programos kodas
repository = autorizavimo saugyklos kodas
type = autorizavimo tipas
- 3 = group. Atkreipkite dėmesį, kad nuo 7.0 versijos šio tipo autorizavimas laikomas nebenaudojamu. Rinkitės tipą „attribute“.
- 6 = attribute
mode = autorizavimo režimas
- 0 = statinis. Statinė reikšmė, kurią reikia nurodyti žymėje „value“
- 1 = dinaminis: atributo, nurodyto žymėje pavadinimu „template#[object_type_code]“, reikšmė
Atributo, skirto su paskyromis ar asmenimis susietiems autorizavimams eksportuoti, pavadinimas žymėje „mappingCode“

Identity eksportas: tapatybės + vaidmenys¶

Objekto tipas: pasirinkite reikšmę „PERSON_ROLES“
Saugyklos: nurodykite saugyklos, kurios esami susiję vaidmenys turi būti eksportuojami, kodus.

Rezultatai ir parinktys: eksportuojami visi su pasirinktomis saugyklomis susiję tapatybės ir vaidmens saitai.

Kiekvienam tapatybės ir vaidmens saitui eksportuojamos šios žymės:

person = tapatybės UID
role = priskirtino vaidmens kodas
startdate = vaidmens pradžios data
enddate = vaidmens pabaigos data
id = tapatybės ir vaidmens saito ID

Identity eksportas: tapatybės + vaidmenys + autorizavimai¶

Objekto tipas: pasirinkite reikšmę „PERSON_RIGHTS“
Saugyklos: nurodykite saugyklų, kurioms norite sukurti tapatybės/vaidmens ir autorizavimo saitus, kodus.

Rezultatai ir parinktys: eksportuojami visi su pasirinktomis saugyklomis susiję tapatybės/vaidmens ir autorizavimo saitai.

Kiekvienam tapatybės/vaidmens ir autorizavimo saitui eksportuojamos šios žymės:

person = tapatybės UID
role = vaidmens kodas
right = autorizavimo kodas
startdate = autorizavimo pradžios data
enddate = autorizavimo pabaigos data
id = tapatybės, vaidmens ir autorizavimo saito ID