Přeskočit obsah

Vytvoření/úprava pravidel exportu

Účelem pravidla exportu je na základě úložiště definovat objekty, které se mají exportovat, a jejich umístění. Například u úložiště typu adresář budete muset definovat objekty, které se mají exportovat, a OU, ve kterých bude probíhat vyhledávání.

Každý export vygeneruje datový soubor ve formátu XML.

Existují dva možné režimy exportu, které lze zvolit podle případu použití:

  • Úplný: všechny objekty, které vyhovují pravidlům exportu, se exportují do výstupního souboru. Výstupní soubor je ve formátu XML.
  • Jednotkový: Export jediného objektu filtrovaného podle hodnoty atributu.

Pravidla exportu, která je třeba nakonfigurovat, se liší podle typu úložiště.

Export úložiště typu adresář (LDAP, AD, AD/LDS, OpenLDAP atd.)

  • Typ objektu: zadejte typ objektu, který se má exportovat (např. user, classes atd.).
  • Filtr vyhledávání: volitelné pole pro použití filtrů na objekty, které se mají exportovat (např. „employeeID“ není prázdné).
  • Jednotkový filtr: atribut, který umožňuje filtrovat objekt definováním jeho hodnoty.
  • Atributy: seznam atributů objektů, které se mají exportovat. Tento seznam je plně konfigurovatelný, viz níže.
  • OU: zadejte OU, do kterých budou objekty exportovány.
  • Filtry skupin: Seznam skupin, které se mají spravovat nebo vyloučit při akcích odstranění:
    • Pokud není zaškrtnuta možnost „Remove the groups instead of keeping them“: seznam skupin uvádí ty, které se nemají odstraňovat.
    • Pokud je zaškrtnuta možnost „Remove the groups instead of keeping them“: seznam skupin uvádí ty, které lze odstranit.

Výběr atributů k exportu:

Od verze 7.1 je k dispozici seznam atributů, který usnadňuje výběr atributů k exportu v úložištích typu adresář. Chcete-li přidat atribut k exportu, použijte tlačítko „Update list“:

Tato akce otevře seznam atributů vytvořených a přítomných v šabloně. Atributy můžete podle potřeby přidávat nebo odebírat:

Chcete-li přidat atribut, který není součástí seznamu, nejprve vytvořte nový atribut pomocí tlačítka „Templates“:

Seznam atributů je plně konfigurovatelný: kromě vytváření nových atributů můžete atributy v seznamu upravovat nebo odstraňovat.

Správa skupin z úložiště Identity:

Až do verze 7.0 bylo nutné ručně zadat seznam skupin zabezpečení, které má spravovat SIP, nebo seznam skupin vyloučených z porovnávání, a to v exportu i v importu úložiště.

Od verze 7.1 se nový konektor adresáře může opírat o seznam skupin vytvořených a spravovaných v CyberElements Identity. Za tímto účelem zaškrtněte v konfiguraci SIP úložiště možnost „Synchronization of groups managed by Identity only“ a zadejte kód exportu, obvykle memberof@.

Výsledky a možnosti:

Každý atribut se exportuje do značky XML, jejímž názvem je název atributu adresáře. Výchozím formátem exportovaných dat je řetězec znaků.

Pro každý atribut je možné zadat jiný typ s následujícími možnostmi:

  • Binary
  • Date
  • Date_Filetime

Chcete-li změnit formát exportu, vyberte požadovaný atribut a klikněte na tlačítko „Modify“.

Export úložiště typu plochý soubor (CSV)

  • Atributy: seznam sloupců, které tvoří plochý soubor (soubor se definuje při vytváření úložiště).
    • Klikněte na „Add“ a přidejte položku.
    • Vyberte atribut, který chcete upravit nebo odstranit.
    • Pokud má soubor CSV záhlaví sloupců, můžete kliknout na tlačítko „Get Column Name“ a automaticky načíst názvy sloupců.
  • Atribut porovnání pro filtrované vyhledávání: sloupec, který umožňuje exportovat jediný objekt definováním jeho hodnoty.

Výsledky a možnosti:

Každý atribut se exportuje do značky XML, jejímž názvem je zadaný název atributu. Výchozím formátem exportovaných dat je řetězec znaků.

Pro každý atribut je možné zadat jiný typ s následujícími možnostmi:

  • Binary
  • Date
  • Date_Filetime

Chcete-li změnit formát exportu, vyberte požadovaný atribut a klikněte na tlačítko „Modify“.

Export úložiště typu databáze (SQL Server, Oracle atd.)

  • Typ objektu: orientační hodnota, nemá vliv na konfiguraci
  • Dotaz SQL: dotaz, který extrahuje všechny požadované informace
  • Jednotkový filtr: dotaz, ve kterém je zadán filtr, aby vrátil pouze jeden výsledek
  • Atributy: oddíl určený pro přidání dotazů SQL, které exportují další informace. Každý dotaz může exportovat pouze jeden atribut, ten však může být vícehodnotový (dotazy vracející více řádků)
  • Možnost více řádků: možnost, kterou je třeba zaškrtnout, pokud je jeden z exportovaných atributů hlavního dotazu vícehodnotový. Název tohoto atributu je nutné uvést v poli „Multiline Matching Attribute“. V hlavním dotazu může být pouze jeden vícehodnotový atribut.

Důležitá poznámka: pokud je tato možnost zaškrtnuta, je nezbytné provést v dotazu „order by“ pro řazení podle atributu zadaného v poli „Multiline Matching Attribute“.

Výsledky a možnosti:

Každý sloupec definovaný v dotazu se exportuje do značky XML s názvem zadaného sloupce. Formátem exportovaných dat je řetězec znaků.

Export úložiště typu API (REST – protokol SIM)

  • Typ objektu: klikněte na tlačítko „Get Object Type List“ a načtěte seznam objektů dostupných k exportu z úložiště aplikace.
  • Atribut mapování: klikněte na tlačítko „Get Attributes List“ a načtěte seznam dostupných atributů. Seznam atributů závisí na vybraném typu objektu.
  • Klikněte na tlačítko „Set“ a potvrďte aktualizace.

Výsledky a možnosti:

Každý atribut definovaný v typu objektu vráceném rozhraním API se exportuje do značky XML. Formátem exportovaných dat je řetězec znaků.

Export úložiště XML

Chcete-li exportovat úložiště XML, musíte provést akci XSLT.

Soubory XML mohou mít různé struktury, proto je nutné vytvořit soubor transformace, který je převede do formátu XML kompatibilního s modulem zřizování SIP.

Export Identity: identity

  • Typ objektu: Zadejte hodnotu „USERS“
  • Typ osoby: zadejte kód typů osob, které se mají exportovat z úložiště Identity
  • Atribut porovnání pro jednotkový export: „personne_uid“

Výsledky a možnosti:

Pro každou identitu se všechny atributy, které mají hodnotu, automaticky exportují do značky XML, jejímž názvem je kód atributu. Formátem exportovaných dat je řetězec znaků.

Export Identity: výčty

  • Typ objektu: Zadejte hodnotu „ENUMERATIONS“
  • Seznam kódů: Kód výčtů, které se mají exportovat z úložiště Identity; současně lze exportovat několik výčtů.

Pro výčty není jednotkový export podporován.

Výsledky a možnosti:

Pro každý výčet se exportují následující značky:

  • Type = Kód atributu (nebo kód typu výčtu) obsahujícího seznam hodnot
  • Code = Kód hodnoty výčtu
  • Name = Popisek přiřazený ke kódu
  • Description = Popis hodnoty výčtu. Tato informace je volitelná a exportuje se pouze v případě, že není prázdná.

Formátem exportovaných dat je řetězec znaků.

Export Identity: převodní tabulky

  • Typ objektu: Zadejte hodnotu „MATCHINGTABLE“
  • Seznam kódů: Kód převodních tabulek, které se mají exportovat z úložiště Identity; současně lze exportovat několik převodních tabulek.

Pro převodní tabulky není jednotkový export podporován.

Výsledky a možnosti:

Pro každou převodní tabulku se exportují následující značky:

  • Type = Kód typu převodní tabulky
  • Key = Klíč převodní tabulky
  • Value = Hodnota nebo hodnoty přiřazené ke klíči. Hodnota může být vícehodnotová.
  • Description = Popis hodnoty převodní tabulky. Tato informace je volitelná a exportuje se pouze v případě, že není prázdná.

Formátem exportovaných dat je řetězec znaků.

Export Identity: přidělení (prostředky)

  • Typ objektu: Zadejte hodnotu „OBJECTS“
  • Seznam kódů: zadejte kód typů přidělení (prostředků), které se mají exportovat z úložiště Identity
  • Možnost exportovat struktury, které mají vazbu na přidělení
  • Možnost exportovat identity, které mají vazbu na přidělení
  • Atribut porovnání pro jednotkový export: „object_instance_code“

Výsledky a možnosti:

Pro každé přidělení (prostředek) se všechny atributy, které mají hodnotu, automaticky exportují do značky XML, jejímž názvem je kód atributu. Formátem exportovaných dat je řetězec znaků.

Export Identity: stavy zřízení

  • Typ objektu: Zadejte hodnotu „STATUS“
  • Repository: kód úložiště, ze kterého chcete exportovat osoby a jejich přidružené účty. Upozorňujeme, že pro správné fungování musí být jedinečný.
  • Atribut porovnání pro jednotkový export: „Account.login“

Výsledky a možnosti:

Pro každý účet v úložišti se exportují následující značky:

  • Account.Id: ID účtu
  • Account.login: Přihlašovací jméno účtu. Bude použito pro účely porovnání
  • Account.state: Stav zřízení účtu (0: nezřízeno, 1: zřízeno)
  • Person.Id: ID primární osoby
  • Person.uniqueId: UID primární osoby
  • Pro každou autorizaci propojenou s účtem:
    • [code_mapping_right]#right.id: informační značka pro načtení seznamu ID práv, která mají hodnotu kódu mapování uvedenou v první části značky. Je možné více hodnot.
    • [code_mapping_right]#[right.id]: Značka tohoto typu pro každou autorizaci, která má hodnotu kódu mapování uvedenou v první části značky. Obsahuje hodnotu autorizace
    • [code_mapping_right]: informační značka pro načtení seznamu hodnot autorizací, které mají hodnotu kódu mapování uvedenou v první části značky. Je možné více hodnot.
    • [code_mapping_right]#state: Seznam stavů zřízení pro každou autorizaci, která má hodnotu kódu mapování uvedenou v první části značky.

Formátem exportovaných dat je řetězec znaků.

Export Identity: struktury

  • Typ objektu: Zadejte hodnotu „STRUCTURES“
  • Seznam kódů: zadejte kód typů struktur, které se mají exportovat z úložiště Identity
  • Atribut porovnání pro jednotkový export: „structure_code“

Výsledky a možnosti:

Pro každou strukturu se všechny atributy, které mají hodnotu, automaticky exportují do značky XML, jejímž názvem je kód atributu. Formátem exportovaných dat je řetězec znaků.

Export Identity: identity + autorizace

  • Typ objektu: Zadejte hodnotu „USERS+ACCESS“
  • Repository: kód úložiště, ze kterého chcete exportovat osoby a jejich přidružené účty. Upozorňujeme, že pro správné fungování musí být jedinečný.
  • Typ osoby: zadejte kód typů osob, které se mají exportovat z úložiště Identity
  • Atribut porovnání pro jednotkový export: „personne_uid“

Výsledky a možnosti:

Pro každou identitu se všechny atributy, které mají hodnotu, automaticky exportují do značky XML, jejímž názvem je kód atributu. Formátem exportovaných dat je řetězec znaků.

Pokud má identita účet v zadaném úložišti, exportují se další značky XML:

  • HPPAccountLogin
  • HPPAccountPwd
  • HPPAccountState

Pokud má identita oprávnění v zadaném úložišti, exportují se další značky XML:

  • HPPAccessRight, který bude obsahovat všechny hodnoty oprávnění „Group“ a „Dynamic Group“
  • Jedna značka XML pro každý odlišný kód definovaný v mapování oprávnění „Attribute“ nebo „Dynamic Attribute“. Pokud je několik autorizací nakonfigurováno se stejným kódem mapování, exportuje se jediná značka XML s několika hodnotami uvnitř.

Export Identity: účty + autorizace

  • Typ objektu: vyberte hodnotu „ACCOUNT“
  • Repository: zadejte kód úložiště, ze kterého se mají exportovat účty a autorizace. Upozorňujeme, že i když je technicky možné zadat více kódů úložišť, pro správné fungování konektoru zřizování je nezbytné zadat pouze jeden.

Výsledky a možnosti: Exportují se všechny účty ve vybraném úložišti.

Pro každý účet se exportují následující značky:

  • ID = ID účtu, které se používá pro aktualizace a odstranění
  • Account_login = Přihlašovací jméno účtu
  • password = Heslo účtu exportované v zašifrované podobě
  • Account_provisioning = Stav zřízení účtu:
    • 1: pouze teoretický účet
    • 2: osiřelý účet
    • 3: teoretický a zřízený účet
  • Account_state = Stav teoretického účtu
    • -1: Žádný účet (hodnota v exportu není možná)
    • 0: pouze teoretický účet
    • 1: aktivní účet
    • 2: zakázaný účet
  • Account_type = ID typu účtu
  • roles = Role přidružené k účtu
  • Atributy a oprávnění se exportují do značek pojmenovaných podle konfigurace.

Export Identity: role

  • Typ objektu: vyberte hodnotu „ROLE“
  • Repositories: zadejte kódy úložiště, jehož existující související role se mají exportovat. Volitelné.

Výsledky a možnosti: Exportují se všechny existující role. Pokud je zadáno jedno nebo více úložišť, exportují se pouze role související s těmito úložišti.

Pro každou roli se exportují následující značky:

  • id = ID role
  • code = kód role
  • name = název role
  • description = popis role
  • repositories = kód úložišť propojených s rolí
  • accountTypes = kód typů účtů propojených s rolí

Export Identity: autorizace

  • Typ objektu: vyberte hodnotu „RIGHT“
  • Repositories: zadejte kódy úložiště, jehož existující související autorizace se mají exportovat. Volitelné.

Výsledky a možnosti: Exportují se všechny existující autorizace. Pokud je zadáno jedno nebo více konkrétních úložišť, exportují se pouze autorizace související s těmito úložišti.

Pro každou autorizaci se exportují následující značky:

  • Id = ID autorizace
  • code = Kód autorizace
  • name = Název autorizace
  • category = Kód kategorie autorizace
  • application = Kód aplikace autorizace
  • repository = Kód úložiště autorizace
  • type = Typ autorizace
    • 3 = group. Upozorňujeme, že použití tohoto typu autorizace je od verze 7.0 zastaralé. Upřednostňujte typ „attribute“.
    • 6 = attribute
  • mode = Režim autorizace
    • 0 = Statický. Statická hodnota, která se zadává ve značce „value“
    • 1 = dynamický: hodnota atributu zadaného ve značce s názvem „template#[object_type_code]“
  • Název atributu pro export autorizací propojených s účty nebo osobami ve značce „mappingCode“

Export Identity: identity + role

  • Typ objektu: vyberte hodnotu „PERSON_ROLES“
  • Repositories: zadejte kódy úložiště, jehož existující související role se mají exportovat.

Výsledky a možnosti: exportují se všechny vazby identita-role související s vybranými úložišti.

Pro každou vazbu identita-role se exportují následující značky:

  • person = UID identity
  • role = kód role, která se má přiřadit
  • startdate = datum začátku role
  • enddate = datum konce role
  • id = ID vazby identita-role

Export Identity: identity + role + autorizace

  • Typ objektu: vyberte hodnotu „PERSON_RIGHTS“
  • Repositories: zadejte kódy úložišť, pro které chcete vytvořit vazby identita/role-autorizace.

Výsledky a možnosti: exportují se všechny vazby identita/role-autorizace související s vybranými úložišti.

Pro každou vazbu identita/role-autorizace se exportují následující značky:

  • person = UID identity
  • role = kód role
  • right = kód autorizace
  • startdate = datum začátku autorizace
  • enddate = datum konce autorizace
  • id = ID vazby identita-role-autorizace