Keri sisuni

Ekspordireeglite loomine/muutmine

Ekspordireegli eesmärk on määratleda hoidla põhjal eksporditavad objektid ja nende asukohad. Näiteks kataloogitüüpi hoidla puhul tuleb määratleda eksporditavad objektid ja OU-d, milles otsing tehakse.

Iga eksport loob XML-vormingus andmefaili.

Ekspordirežiime on kaks ja neid saab valida kasutusjuhu järgi:

  • Täielik: kõik ekspordireeglitele vastavad objektid eksporditakse väljundfaili. Väljundfail on XML-vormingus.
  • Üksik: ühe objekti eksport, mis on filtreeritud atribuudi väärtuse järgi.

Konfigureeritavad ekspordireeglid erinevad olenevalt hoidla tüübist.

Kataloogitüüpi hoidla eksportimine (LDAP, AD, AD/LDS, OpenLDAP jne)

  • Objekti tüüp: määrake eksporditava objekti tüüp (nt user, classes jne).
  • Otsingufilter: valikuline väli eksporditavatele objektidele filtrite rakendamiseks (nt „employeeID“ pole tühi).
  • Üksikfilter: atribuut, mis võimaldab objekti filtreerida selle väärtuse määramise kaudu.
  • Atribuudid: eksporditavate objektide atribuutide loend. See loend on täielikult konfigureeritav, vt allpool.
  • OU-d: määrake OU-d, kuhu objektid eksporditakse.
  • Rühmafiltrid: kustutamistoimingutes hallatavate või välistatavate rühmade loend:
    • Kui suvand „Remove the groups instead of keeping them“ pole märgitud: rühmade loend näitab neid, mida ei tohi kustutada.
    • Kui suvand „Remove the groups instead of keeping them“ on märgitud: rühmade loend näitab neid, mida võib kustutada.

Eksporditavate atribuutide valimine:

Alates versioonist 7.1 pakutakse atribuutide loendit, et hõlbustada eksporditavate atribuutide valimist kataloogitüüpi hoidlates. Eksporditava atribuudi lisamiseks kasutage nuppu „Update list“:

See toiming avab mallis loodud ja olemas olevate atribuutide loendi. Saate atribuute vastavalt vajadusele lisada või eemaldada:

Loendisse mittekuuluva atribuudi lisamiseks looge esmalt nupu „Templates“ abil uus atribuut:

Atribuutide loend on täielikult konfigureeritav: lisaks uute atribuutide loomisele saate loendis olevaid atribuute muuta või kustutada.

Rühmade haldamine Identity hoidla põhjal:

Kuni versioonini 7.0 tuli SIP-i hallatavate turberühmade loend või võrdlustest välistatavate rühmade loend sisestada käsitsi ning sisestada see nii hoidla ekspordis kui ka impordis.

Alates versioonist 7.1 saab uus kataloogikonnektor tugineda tootes CyberElements Identity loodud ja hallatavate rühmade loendile. Selleks märkige hoidla SIP-i konfiguratsioonis suvand „Synchronization of groups managed by Identity only“ ja sisestage ekspordikood, tavaliselt memberof@.

Tulemused ja suvandid:

Iga atribuut eksporditakse XML-märgendis, mille nimeks on kataloogi atribuudi nimi. Eksporditud andmete vaikevorming on märgistring.

Iga atribuudi jaoks saab määrata erineva tüübi järgmistest valikutest:

  • Binary
  • Date
  • Date_Filetime

Ekspordivormingu muutmiseks valige soovitud atribuut ja klõpsake nuppu „Modify“.

Lamefaili hoidla eksportimine (CSV)

  • Atribuudid: lamefaili moodustavate veergude loend (fail määratletakse hoidla loomisel).
    • Kirje lisamiseks klõpsake „Add“.
    • Valige atribuut selle muutmiseks või kustutamiseks.
    • Kui CSV-failis on veerupäised, saate veergude nimede automaatseks toomiseks klõpsata nuppu „Get Column Name“.
  • Võrdlusatribuut filtreeritud otsinguks: veerg, mis võimaldab eksportida üksiku objekti selle väärtuse määramise kaudu.

Tulemused ja suvandid:

Iga atribuut eksporditakse XML-märgendis, mille nimeks on määratud atribuudi nimi. Eksporditud andmete vaikevorming on märgistring.

Iga atribuudi jaoks saab määrata erineva tüübi järgmistest valikutest:

  • Binary
  • Date
  • Date_Filetime

Ekspordivormingu muutmiseks valige soovitud atribuut ja klõpsake nuppu „Modify“.

Andmebaasitüüpi hoidla eksportimine (SQL Server, Oracle jne)

  • Objekti tüüp: informatiivne väärtus, ei mõjuta konfiguratsiooni
  • SQL-päring: päring, mis ekstraktib kogu soovitud teabe
  • Üksikfilter: päring, milles on määratud filter, et tagastada ainult üks tulemus
  • Atribuudid: raam SQL-päringute lisamiseks lisateabe eksportimiseks. Iga päring saab eksportida ainult ühe atribuudi, kuid see võib olla mitmeväärtuseline (mitu rida tagastavad päringud)
  • Mitmerealine suvand: suvand, mis tuleb märkida, kui mõni põhipäringu eksporditavatest atribuutidest on mitmeväärtuseline. Selle atribuudi nimi tuleb märkida väljale „Multiline Matching Attribute“. Põhipäringus saab olla ainult üks mitmeväärtuseline atribuut.

Oluline märkus: kui see suvand on märgitud, tuleb päringus kindlasti teha „order by“, et sortida väljale „Multiline Matching Attribute“ sisestatud atribuudi järgi.

Tulemused ja suvandid:

Iga päringus määratletud veerg eksporditakse XML-märgendis, mille nimeks on määratud veeru nimi. Eksporditud andmete vorming on märgistring.

API-tüüpi hoidla eksportimine (REST – SIM-protokoll)

  • Objekti tüüp: klõpsake nuppu „Get Object Type List“, et tuua rakenduse hoidlast ekspordiks saadaolevate objektide loend.
  • Vastendusatribuut: klõpsake nuppu „Get Attributes List“, et tuua saadaolevate atribuutide loend. Atribuutide loend sõltub valitud objekti tüübist.
  • Muudatuste kinnitamiseks klõpsake nuppu „Set“.

Tulemused ja suvandid:

Iga API tagastatud objektitüübis määratletud atribuut eksporditakse XML-märgendis. Eksporditud andmete vorming on märgistring.

XML-hoidla eksportimine

XML-hoidla eksportimiseks tuleb teha XSLT-toiming.

XML-failidel võivad olla erinevad struktuurid, seega tuleb luua teisendusfail, et teisendada see SIP-i ettevalmistusmootoriga ühilduvasse XML-vormingusse.

Identity eksport: identiteedid

  • Objekti tüüp: sisestage väärtus „USERS“
  • Isikutüüp: määrake Identity hoidlast eksporditavate isikutüüpide kood
  • Võrdlusatribuut üksikekspordiks: „personne_uid“

Tulemused ja suvandid:

Iga identiteedi puhul eksporditakse kõik väärtusega atribuudid automaatselt XML-märgendisse, mille nimeks on atribuudi kood. Eksporditud andmete vorming on märgistring.

Identity eksport: loetelud

  • Objekti tüüp: sisestage väärtus „ENUMERATIONS“
  • Koodide loend: Identity hoidlast eksporditavate loetelude kood; korraga saab eksportida mitu loetelu.

Loetelude puhul üksikeksporte ei hallata.

Tulemused ja suvandid:

Iga loetelu kohta eksporditakse järgmised märgendid:

  • Type = atribuudi kood (või loetelutüübi kood), mis sisaldab väärtuste loendit
  • Code = loetelu väärtuse kood
  • Name = koodiga seotud nimetus
  • Description = loetelu väärtuse kirjeldus. See teave on valikuline ja eksporditakse ainult siis, kui see pole tühi.

Eksporditud andmete vorming on märgistring.

Identity eksport: vastavustabelid

  • Objekti tüüp: sisestage väärtus „MATCHINGTABLE“
  • Koodide loend: Identity hoidlast eksporditavate vastavustabelite kood; korraga saab eksportida mitu vastavustabelit.

Vastavustabelite puhul üksikeksporte ei hallata.

Tulemused ja suvandid:

Iga vastavustabeli kohta eksporditakse järgmised märgendid:

  • Type = vastavustabeli tüübi kood
  • Key = vastavustabeli võti
  • Value = võtmega seotud väärtus(ed). Väärtus võib olla mitmeväärtuseline.
  • Description = vastavustabeli väärtuse kirjeldus. See teave on valikuline ja eksporditakse ainult siis, kui see pole tühi.

Eksporditud andmete vorming on märgistring.

Identity eksport: eraldised (ressursid)

  • Objekti tüüp: sisestage väärtus „OBJECTS“
  • Koodide loend: määrake Identity hoidlast eksporditavate eraldisetüüpide (ressursside) kood
  • Suvand eraldisega seotud struktuuride eksportimiseks
  • Suvand eraldisega seotud identiteetide eksportimiseks
  • Võrdlusatribuut üksikekspordiks: „object_instance_code“

Tulemused ja suvandid:

Iga eraldise (ressursi) puhul eksporditakse kõik väärtusega atribuudid automaatselt XML-märgendisse, mille nimeks on atribuudi kood. Eksporditud andmete vorming on märgistring.

Identity eksport: ettevalmistusolekud

  • Objekti tüüp: sisestage väärtus „STATUS“
  • Hoidla: selle hoidla kood, kust soovite eksportida isikud ja nendega seotud kontod. Pange tähele, et see peab õigeks toimimiseks olema kordumatu.
  • Võrdlusatribuut üksikekspordiks: „Account.login“

Tulemused ja suvandid:

Iga hoidla konto kohta eksporditakse järgmised märgendid:

  • Account.Id: konto ID
  • Account.login: konto kasutajanimi. Kasutatakse võrdlemiseks
  • Account.state: konto ettevalmistusolek (0: ette valmistamata, 1: ette valmistatud)
  • Person.Id: peamise isiku ID
  • Person.uniqueId: peamise isiku UID
  • Iga kontoga seotud autoriseerimise kohta:
    • [code_mapping_right]#right.id: teabemärgend, millega tuuakse nende õiguste ID-de loend, millel on märgendi esimeses osas näidatud vastenduskoodi väärtus. Võimalikud on mitu väärtust.
    • [code_mapping_right]#[right.id]: seda tüüpi märgend iga autoriseerimise kohta, millel on märgendi esimeses osas näidatud vastenduskoodi väärtus. Sisaldab autoriseerimise väärtust
    • [code_mapping_right]: teabemärgend, millega tuuakse nende autoriseerimisväärtuste loend, millel on märgendi esimeses osas näidatud vastenduskoodi väärtus. Võimalikud on mitu väärtust.
    • [code_mapping_right]#state: ettevalmistusolekute loend iga autoriseerimise kohta, millel on märgendi esimeses osas näidatud vastenduskoodi väärtus.

Eksporditud andmete vorming on märgistring.

Identity eksport: struktuurid

  • Objekti tüüp: sisestage väärtus „STRUCTURES“
  • Koodide loend: määrake Identity hoidlast eksporditavate struktuuritüüpide kood
  • Võrdlusatribuut üksikekspordiks: „structure_code“

Tulemused ja suvandid:

Iga struktuuri puhul eksporditakse kõik väärtusega atribuudid automaatselt XML-märgendisse, mille nimeks on atribuudi kood. Eksporditud andmete vorming on märgistring.

Identity eksport: identiteedid + autoriseerimised

  • Objekti tüüp: sisestage väärtus „USERS+ACCESS“
  • Hoidla: selle hoidla kood, kust soovite eksportida isikud ja nendega seotud kontod. Pange tähele, et see peab õigeks toimimiseks olema kordumatu.
  • Isikutüüp: määrake Identity hoidlast eksporditavate isikutüüpide kood
  • Võrdlusatribuut üksikekspordiks: „personne_uid“

Tulemused ja suvandid:

Iga identiteedi puhul eksporditakse kõik väärtusega atribuudid automaatselt XML-märgendisse, mille nimeks on atribuudi kood. Eksporditud andmete vorming on märgistring.

Kui identiteedil on määratud hoidlas konto, eksporditakse täiendavad XML-märgendid:

  • HPPAccountLogin
  • HPPAccountPwd
  • HPPAccountState

Kui identiteedil on määratud hoidlas load, eksporditakse täiendavad XML-märgendid:

  • HPPAccessRight, mis sisaldab kõiki lubade „Group“ ja „Dynamic Group“ väärtusi
  • Üks XML-märgend iga erineva koodi kohta, mis on määratletud lubade „Attribute“ või „Dynamic Attribute“ vastenduses. Kui mitu autoriseerimist on konfigureeritud sama vastenduskoodiga, eksporditakse üks XML-märgend, mis sisaldab mitut väärtust.

Identity eksport: kontod + autoriseerimised

  • Objekti tüüp: valige väärtus „ACCOUNT“
  • Hoidla: määrake selle hoidla kood, kust kontod ja autoriseerimised eksporditakse. Pange tähele, et kuigi tehniliselt on võimalik sisestada mitu hoidla koodi, tuleb ettevalmistuskonnektori õigeks toimimiseks kindlasti sisestada ainult üks.

Tulemused ja suvandid: eksporditakse kõik valitud hoidla kontod.

Iga konto kohta eksporditakse järgmised märgendid:

  • ID = konto ID, kasutatakse värskendamisel ja kustutamisel
  • Account_login = konto kasutajanimi
  • password = konto parool, eksporditakse krüptitud kujul
  • Account_provisioning = konto ettevalmistusolek:
    • 1: ainult teoreetiline konto
    • 2: orbkonto
    • 3: teoreetiline ja ette valmistatud konto
  • Account_state = teoreetilise konto olek
    • -1: konto puudub (väärtus pole ekspordis võimalik)
    • 0: ainult teoreetiline konto
    • 1: aktiivne konto
    • 2: välja lülitatud konto
  • Account_type = kontotüübi ID
  • roles = kontoga seotud rollid
  • Atribuudid ja load eksporditakse märgenditesse, mille nimed tulenevad konfiguratsioonist.

Identity eksport: rollid

  • Objekti tüüp: valige väärtus „ROLE“
  • Hoidlad: määrake selle hoidla koodid, mille olemasolevad seotud rollid eksporditakse. Valikuline.

Tulemused ja suvandid: eksporditakse kõik olemasolevad rollid. Kui on määratud üks või mitu hoidlat, eksporditakse ainult nende hoidlatega seotud rollid.

Iga rolli kohta eksporditakse järgmised märgendid:

  • id = rolli ID
  • code = rolli kood
  • name = rolli nimi
  • description = rolli kirjeldus
  • repositories = rolliga seotud hoidlate kood
  • accountTypes = rolliga seotud kontotüüpide kood

Identity eksport: autoriseerimised

  • Objekti tüüp: valige väärtus „RIGHT“
  • Hoidlad: määrake selle hoidla koodid, mille olemasolevad seotud autoriseerimised tuleb eksportida. Valikuline.

Tulemused ja suvandid: eksporditakse kõik olemasolevad autoriseerimised. Kui on määratud üks või mitu kindlat hoidlat, eksporditakse ainult nende hoidlatega seotud autoriseerimised.

Iga autoriseerimise kohta eksporditakse järgmised märgendid:

  • Id = autoriseerimise ID
  • code = autoriseerimiskood
  • name = autoriseerimise nimi
  • category = autoriseerimise kategooria kood
  • application = autoriseerimise rakenduse kood
  • repository = autoriseerimise hoidla kood
  • type = autoriseerimise tüüp
    • 3 = group. Pange tähele, et seda tüüpi autoriseerimise kasutamine on alates versioonist 7.0 iganenud. Eelistage tüüpi „attribute“.
    • 6 = attribute
  • mode = autoriseerimise režiim
    • 0 = staatiline. Staatiline väärtus, mis tuleb määrata märgendis „value“
    • 1 = dünaamiline: atribuudi väärtus, mis on määratud märgendis nimega „template#[object_type_code]“
  • Märgendis „mappingCode“: kontode või isikutega seotud autoriseerimiste eksportimiseks kasutatava atribuudi nimi

Identity eksport: identiteedid + rollid

  • Objekti tüüp: valige väärtus „PERSON_ROLES“
  • Hoidlad: määrake selle hoidla koodid, mille olemasolevad seotud rollid eksporditakse.

Tulemused ja suvandid: eksporditakse kõik valitud hoidlatega seotud identiteedi-rolli seosed.

Iga identiteedi-rolli seose kohta eksporditakse järgmised märgendid:

  • person = identiteedi UID
  • role = määratava rolli kood
  • startdate = rolli alguskuupäev
  • enddate = rolli lõppkuupäev
  • id = identiteedi-rolli seose id

Identity eksport: identiteedid + rollid + autoriseerimised

  • Objekti tüüp: valige väärtus „PERSON_RIGHTS“
  • Hoidlad: määrake hoidlakoodid, mille jaoks soovite luua identiteedi/rolli-autoriseerimise seoseid.

Tulemused ja suvandid: eksporditakse kõik valitud hoidlatega seotud identiteedi/rolli-autoriseerimise seosed.

Iga identiteedi/rolli-autoriseerimise seose kohta eksporditakse järgmised märgendid:

  • person = identiteedi UID
  • role = rolli kood
  • right = autoriseerimiskood
  • startdate = autoriseerimise alguskuupäev
  • enddate = autoriseerimise lõppkuupäev
  • id = identiteedi-rolli-autoriseerimise seose id