> Source: https://docs.cyberelements.io/identity/7.1/sk/UserDocumentation/AutomaticProvisioningConnectorsManagement/CreateModifyExportRules/

# 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ď.)

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportReferentielAnnuaire.png)

- 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“:

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-RN-ExportUpdateListButton.png)

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ť:

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-RN-ExportAttributesList.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-RN-ExportTemplatesMenu.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-RN-ExportTemplatesDialog.png)

**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@`.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-RN-LDAPIdentityManagedGroupsOption.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportReferentielAnnuaireModification.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportReferentielCSV.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportReferentielCSVModification.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportReferentielBDD.png)

- 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)

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportReferentielAPI.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityIdentites.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityEnumerations.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityTablesCorrespondance.png)

- 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)

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteursExportIdentityDotations.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityEtatsProvisioning.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityStructure.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityIdentitesHabilitations.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityComptesHabilitations.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityRoles.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityHabilitations.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_SIPDesactiverCalculComptesImport.png)

- 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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_ConnecteurExportIdentityIdentitesRolesHabilitations.png)

- 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
