Preskočiť na obsah

Vytvorenie/úprava pravidiel exportu

Účelom pravidla exportu je definovať na základe úložiska objekty, ktoré sa majú exportovať, a ich umiestnenia. Napríklad pri úložisku typu adresár bude potrebné definovať objekty, ktoré sa majú exportovať, a OU, v ktorých sa bude vyhľadávať.

Každý export vygeneruje dátový súbor vo formáte XML.

K dispozícii sú dva režimy exportu, ktoré možno vybrať podľa prípadu použitia:

  • Úplný: všetky objekty, ktoré vyhovujú pravidlám exportu, sa exportujú do výstupného súboru. Výstupný súbor je vo formáte XML.
  • Jednotkový: export jedného objektu filtrovaného podľa hodnoty atribútu.

Pravidlá exportu, ktoré treba nakonfigurovať, sa líšia podľa typu úložiska.

Export úložiska typu adresár (LDAP, AD, AD/LDS, OpenLDAP atď.)

  • Typ objektu: zadajte typ objektu, ktorý sa má exportovať (napr. user, classes atď.).
  • Filter vyhľadávania: voliteľné pole na použitie filtrov na objekty, ktoré sa majú exportovať (napr. „employeeID“ nie je prázdne).
  • Jednotkový filter: atribút, ktorý umožňuje filtrovať objekt zadaním jeho hodnoty.
  • Atribúty: zoznam atribútov objektov, ktoré sa majú exportovať. Tento zoznam je plne konfigurovateľný, pozrite nižšie.
  • OU: zadajte OU, do ktorých sa budú objekty exportovať.
  • Filtre skupín: zoznam skupín, ktoré sa majú spravovať alebo vylúčiť pri akciách odstránenia:
    • Ak možnosť „Remove the groups instead of keeping them“ nie je začiarknutá: zoznam skupín uvádza tie, ktoré sa nemajú odstrániť.
    • Ak je možnosť „Remove the groups instead of keeping them“ začiarknutá: zoznam skupín uvádza tie, ktoré možno odstrániť.

Výber atribútov na export:

Od verzie 7.1 je k dispozícii zoznam atribútov, ktorý uľahčuje výber atribútov na export v úložiskách typu adresár. Ak chcete pridať atribút na export, použite tlačidlo „Update list“:

Táto akcia otvorí zoznam atribútov vytvorených a prítomných v šablóne. Atribúty môžete podľa potreby pridávať alebo odoberať:

Ak chcete pridať atribút, ktorý nie je v zozname, najprv vytvorte nový atribút pomocou tlačidla „Templates“:

Zoznam atribútov je plne konfigurovateľný: okrem vytvárania nových atribútov môžete atribúty v zozname upravovať alebo odstraňovať.

Správa skupín na základe úložiska Identity:

Do verzie 7.0 bolo potrebné manuálne zadať zoznam skupín zabezpečenia, ktoré má spravovať SIP, alebo zoznam skupín vylúčených z porovnaní, a to v exporte aj v importe úložiska.

Od verzie 7.1 sa nový konektor adresára môže opierať o zoznam skupín vytvorených a spravovaných v CyberElements Identity. Na tento účel začiarknite možnosť „Synchronization of groups managed by Identity only“ v konfigurácii SIP úložiska a zadajte kód exportu, zvyčajne memberof@.

Výsledky a možnosti:

Každý atribút sa exportuje do značky XML, ktorej názov je názvom atribútu adresára. Predvoleným formátom exportovaných údajov je reťazec znakov.

Pre každý atribút je možné zadať iný typ z týchto možností:

  • Binary
  • Date
  • Date_Filetime

Ak chcete zmeniť formát exportu, vyberte požadovaný atribút a kliknite na tlačidlo „Modify“.

Export úložiska typu plochý súbor (CSV)

  • Atribúty: zoznam stĺpcov, z ktorých sa skladá plochý súbor (súbor sa definuje pri vytváraní úložiska).
    • Kliknutím na „Add“ pridáte záznam.
    • Vyberte atribút, ak ho chcete upraviť alebo odstrániť.
    • Ak má súbor CSV hlavičky stĺpcov, môžete kliknúť na tlačidlo „Get Column Name“ a automaticky tak získať názvy stĺpcov.
  • Atribút porovnania pre filtrované vyhľadávanie: stĺpec, ktorý umožňuje exportovať jeden objekt zadaním jeho hodnoty.

Výsledky a možnosti:

Každý atribút sa exportuje do značky XML, ktorej názov je zadaný názov atribútu. Predvoleným formátom exportovaných údajov je reťazec znakov.

Pre každý atribút je možné zadať iný typ z týchto možností:

  • Binary
  • Date
  • Date_Filetime

Ak chcete zmeniť formát exportu, vyberte požadovaný atribút a kliknite na tlačidlo „Modify“.

Export úložiska typu databáza (SQL Server, Oracle atď.)

  • Typ objektu: orientačná hodnota bez vplyvu na konfiguráciu
  • Dotaz SQL: dotaz, ktorý extrahuje všetky požadované informácie
  • Jednotkový filter: dotaz, v ktorom je zadaný filter, aby sa vrátil iba jeden výsledok
  • Atribúty: oddiel určený na pridávanie dotazov SQL na export ďalších informácií. Každý dotaz môže exportovať iba jeden atribút, ten však môže byť viachodnotový (dotazy, ktoré vracajú viacero riadkov)
  • Viacriadková možnosť: možnosť, ktorú treba začiarknuť, ak je jeden z exportovaných atribútov hlavného dotazu viachodnotový. Názov tohto atribútu treba uviesť v poli „Multiline Matching Attribute“. V hlavnom dotaze môže byť iba jeden viachodnotový atribút.

Dôležitá poznámka: ak je táto možnosť začiarknutá, je nevyhnutné vykonať v dotaze „order by“ na zoradenie podľa atribútu zadaného v poli „Multiline Matching Attribute“.

Výsledky a možnosti:

Každý stĺpec definovaný v dotaze sa exportuje do značky XML s názvom zadaného stĺpca. Formátom exportovaných údajov je reťazec znakov.

Export úložiska typu API (protokol REST – SIM)

  • Typ objektu: kliknutím na tlačidlo „Get Object Type List“ získate zoznam objektov, ktoré úložisko aplikácie sprístupňuje na export.
  • Atribút mapovania: kliknutím na tlačidlo „Get Attributes List“ získate zoznam dostupných atribútov. Zoznam atribútov závisí od vybraného typu objektu.
  • Kliknutím na tlačidlo „Set“ potvrdíte aktualizácie.

Výsledky a možnosti:

Každý atribút definovaný v type objektu, ktorý vrátilo API, sa exportuje do značky XML. Formátom exportovaných údajov je reťazec znakov.

Export úložiska XML

Ak chcete exportovať úložisko XML, musíte vykonať akciu XSLT.

Súbory XML môžu mať rôzne štruktúry, preto musíte vytvoriť súbor transformácie, ktorý ich skonvertuje na formát XML kompatibilný s modulom zriaďovania SIP.

Export Identity: identity

  • Typ objektu: zadajte hodnotu „USERS“
  • Typ osoby: zadajte kód typov osôb, ktoré sa majú exportovať z úložiska Identity
  • Atribút porovnania pre jednotkový export: „personne_uid“

Výsledky a možnosti:

Pri každej identite sa všetky atribúty, ktoré majú hodnotu, automaticky exportujú do značky XML, ktorej názov je kód atribútu. Formátom exportovaných údajov je reťazec znakov.

Export Identity: výčty

  • Typ objektu: zadajte hodnotu „ENUMERATIONS“
  • Zoznam kódov: kód výčtov, ktoré sa majú exportovať z úložiska Identity; naraz možno exportovať viacero výčtov.

Pri výčtoch sa jednotkový export nepodporuje.

Výsledky a možnosti:

Pri každom výčte sa exportujú tieto značky:

  • Type = kód atribútu (alebo kód typu výčtu), ktorý obsahuje zoznam hodnôt
  • Code = kód hodnoty výčtu
  • Name = označenie priradené ku kódu
  • Description = popis hodnoty výčtu. Táto informácia je voliteľná a exportuje sa, iba ak nie je prázdna.

Formátom exportovaných údajov je reťazec znakov.

Export Identity: mapovacie tabuľky

  • Typ objektu: zadajte hodnotu „MATCHINGTABLE“
  • Zoznam kódov: kód mapovacích tabuliek, ktoré sa majú exportovať z úložiska Identity; naraz možno exportovať viacero mapovacích tabuliek.

Pri mapovacích tabuľkách sa jednotkový export nepodporuje.

Výsledky a možnosti:

Pri každej mapovacej tabuľke sa exportujú tieto značky:

  • Type = kód typu mapovacej tabuľky
  • Key = kľúč mapovacej tabuľky
  • Value = hodnota alebo hodnoty priradené ku kľúču. Hodnota môže byť viachodnotová.
  • Description = popis hodnoty mapovacej tabuľky. Táto informácia je voliteľná a exportuje sa, iba ak nie je prázdna.

Formátom exportovaných údajov je reťazec znakov.

Export Identity: pridelenia (prostriedky)

  • Typ objektu: zadajte hodnotu „OBJECTS“
  • Zoznam kódov: zadajte kód typov pridelení (prostriedkov), ktoré sa majú exportovať z úložiska Identity
  • Možnosť exportovať štruktúry, ktoré majú prepojenie s pridelením
  • Možnosť exportovať identity, ktoré majú prepojenie s pridelením
  • Atribút porovnania pre jednotkový export: „object_instance_code“

Výsledky a možnosti:

Pri každom pridelení (prostriedku) sa všetky atribúty, ktoré majú hodnotu, automaticky exportujú do značky XML, ktorej názov je kód atribútu. Formátom exportovaných údajov je reťazec znakov.

Export Identity: stavy zriaďovania

  • Typ objektu: zadajte hodnotu „STATUS“
  • Repository: kód úložiska, z ktorého chcete exportovať osoby a ich priradené účty. Upozorňujeme, že musí byť jedinečný, aby všetko fungovalo správne.
  • Atribút porovnania pre jednotkový export: „Account.login“

Výsledky a možnosti:

Pri každom účte v úložisku sa exportujú tieto značky:

  • Account.Id: ID účtu
  • Account.login: prihlasovacie meno účtu. Použije sa na porovnanie
  • Account.state: stav zriadenia účtu (0: nezriadený, 1: zriadený)
  • Person.Id: ID primárnej osoby
  • Person.uniqueId: UID primárnej osoby
  • Pre každú autorizáciu prepojenú s účtom:
    • [code_mapping_right]#right.id: informačná značka na získanie zoznamu ID práv, ktoré majú hodnotu kódu mapovania uvedenú v prvej časti značky. Možných je viacero hodnôt.
    • [code_mapping_right]#[right.id]: značka tohto typu pre každú autorizáciu, ktorá má hodnotu kódu mapovania uvedenú v prvej časti značky. Obsahuje hodnotu autorizácie
    • [code_mapping_right]: informačná značka na získanie zoznamu hodnôt autorizácií, ktoré majú hodnotu kódu mapovania uvedenú v prvej časti značky. Možných je viacero hodnôt.
    • [code_mapping_right]#state: zoznam stavov zriadenia každej autorizácie, ktorá má hodnotu kódu mapovania uvedenú v prvej časti značky.

Formátom exportovaných údajov je reťazec znakov.

Export Identity: štruktúry

  • Typ objektu: zadajte hodnotu „STRUCTURES“
  • Zoznam kódov: zadajte kód typov štruktúr, ktoré sa majú exportovať z úložiska Identity
  • Atribút porovnania pre jednotkový export: „structure_code“

Výsledky a možnosti:

Pri každej štruktúre sa všetky atribúty, ktoré majú hodnotu, automaticky exportujú do značky XML, ktorej názov je kód atribútu. Formátom exportovaných údajov je reťazec znakov.

Export Identity: identity + autorizácie

  • Typ objektu: zadajte hodnotu „USERS+ACCESS“
  • Repository: kód úložiska, z ktorého chcete exportovať osoby a ich priradené účty. Upozorňujeme, že musí byť jedinečný, aby všetko fungovalo správne.
  • Typ osoby: zadajte kód typov osôb, ktoré sa majú exportovať z úložiska Identity
  • Atribút porovnania pre jednotkový export: „personne_uid“

Výsledky a možnosti:

Pri každej identite sa všetky atribúty, ktoré majú hodnotu, automaticky exportujú do značky XML, ktorej názov je kód atribútu. Formátom exportovaných údajov je reťazec znakov.

Ak má identita účet v zadanom úložisku, exportujú sa ďalšie značky XML:

  • HPPAccountLogin
  • HPPAccountPwd
  • HPPAccountState

Ak má identita povolenia v zadanom úložisku, exportujú sa ďalšie značky XML:

  • HPPAccessRight, ktorá bude obsahovať všetky hodnoty povolení „Group“ a „Dynamic Group“
  • Jedna značka XML pre každý odlišný kód definovaný v mapovaní povolení „Attribute“ alebo „Dynamic Attribute“. Ak je s rovnakým kódom mapovania nakonfigurovaných viacero autorizácií, exportuje sa jediná značka XML s viacerými hodnotami.

Export Identity: účty + autorizácie

  • Typ objektu: vyberte hodnotu „ACCOUNT“
  • Repository: zadajte kód úložiska, z ktorého sa majú exportovať účty a autorizácie. Upozorňujeme, že hoci je technicky možné zadať viacero kódov úložísk, na správne fungovanie konektora zriaďovania je nevyhnutné zadať iba jeden.

Výsledky a možnosti: Exportujú sa všetky účty vybraného úložiska.

Pri každom účte sa exportujú tieto značky:

  • ID = ID účtu, ktoré sa použije pri aktualizáciách a odstraňovaní
  • Account_login = prihlasovacie meno účtu
  • password = heslo účtu exportované v zašifrovanej podobe
  • Account_provisioning = stav zriadenia účtu:
    • 1: iba teoretický účet
    • 2: osirotený účet
    • 3: teoretický a zriadený účet
  • Account_state = stav teoretického účtu
    • -1: žiadny účet (hodnota, ktorá sa v exporte nemôže vyskytnúť)
    • 0: iba teoretický účet
    • 1: aktívny účet
    • 2: zakázaný účet
  • Account_type = ID typu účtu
  • roles = roly priradené k účtu
  • Atribúty a povolenia sa exportujú do značiek s názvami podľa konfigurácie.

Export Identity: roly

  • Typ objektu: vyberte hodnotu „ROLE“
  • Repositories: zadajte kódy úložiska, ktorého existujúce súvisiace roly sa majú exportovať. Voliteľné.

Výsledky a možnosti: Exportujú sa všetky existujúce roly. Ak je zadané jedno alebo viacero úložísk, exportujú sa iba roly súvisiace s týmito úložiskami.

Pri každej role sa exportujú tieto značky:

  • id = ID roly
  • code = kód roly
  • name = názov roly
  • description = popis roly
  • repositories = kód úložísk prepojených s rolou
  • accountTypes = kód typov účtov prepojených s rolou

Export Identity: autorizácie

  • Typ objektu: vyberte hodnotu „RIGHT“
  • Repositories: zadajte kódy úložiska, ktorého existujúce súvisiace autorizácie sa musia exportovať. Voliteľné.

Výsledky a možnosti: Exportujú sa všetky existujúce autorizácie. Ak je zadané jedno alebo viacero konkrétnych úložísk, exportujú sa iba autorizácie súvisiace s týmito úložiskami.

Pri každej autorizácii sa exportujú tieto značky:

  • Id = ID autorizácie
  • code = kód autorizácie
  • name = názov autorizácie
  • category = kód kategórie autorizácie
  • application = kód aplikácie autorizácie
  • repository = kód úložiska autorizácie
  • type = typ autorizácie
    • 3 = group. Upozorňujeme, že používanie tohto typu autorizácie je od verzie 7.0 zastarané. Uprednostnite typ „attribute“.
    • 6 = attribute
  • mode = režim autorizácie
    • 0 = statický. Statická hodnota, ktorá sa má zadať v značke „value“
    • 1 = dynamický: hodnota atribútu zadaného v značke s názvom „template#[object_type_code]“
  • Názov atribútu na export autorizácií prepojených s účtami alebo osobami v značke „mappingCode“

Export Identity: identity + roly

  • Typ objektu: vyberte hodnotu „PERSON_ROLES“
  • Repositories: zadajte kódy úložiska, ktorého existujúce súvisiace roly sa majú exportovať.

Výsledky a možnosti: exportujú sa všetky prepojenia identita-rola súvisiace s vybranými úložiskami.

Pri každom prepojení identita-rola sa exportujú tieto značky:

  • person = UID identity
  • role = kód roly na priradenie
  • startdate = dátum začiatku roly
  • enddate = dátum konca roly
  • id = ID prepojenia identita-rola

Export Identity: identity + roly + autorizácie

  • Typ objektu: vyberte hodnotu „PERSON_RIGHTS“
  • Repositories: zadajte kódy úložísk, pre ktoré chcete vytvoriť prepojenia identita/rola-autorizácia.

Výsledky a možnosti: exportujú sa všetky prepojenia identita/rola-autorizácia súvisiace s vybranými úložiskami.

Pri každom prepojení identita/rola-autorizácia sa exportujú tieto značky:

  • person = UID identity
  • role = kód roly
  • right = kód autorizácie
  • startdate = dátum začiatku autorizácie
  • enddate = dátum konca autorizácie
  • id = ID prepojenia identita-rola-autorizácia