Към съдържанието

Създаване/промяна на правила за експортиране

Целта на правилото за експортиране е да дефинира, въз основа на хранилище, обектите, които да бъдат експортирани, и тяхното местоположение. Например за хранилище от тип директория трябва да дефинирате обектите, които да бъдат експортирани, и OU, в които ще се извърши търсенето.

Всяко експортиране ще генерира файл с данни във формат XML.

Има два възможни режима на експортиране, които могат да се избират според случая на употреба:

  • Пълен: всички обекти, които отговарят на правилата за експортиране, се експортират в изходния файл. Изходният файл е във формат XML.
  • Единичен: експортиране на един обект, филтриран по стойността на атрибут.

Правилата за експортиране, които трябва да се конфигурират, се различават според типа на хранилището.

Експортиране на хранилище от тип директория (LDAP, AD, AD/LDS, OpenLDAP и т.н.)

  • Тип обект: укажете типа на обекта, който да бъде експортиран (напр. user, classes и т.н.).
  • Филтър за търсене: незадължително поле за прилагане на филтри към обектите, които да бъдат експортирани (напр. непразен „employeeID“).
  • Единичен филтър: атрибут, който ви позволява да филтрирате обект чрез определяне на стойността му.
  • Атрибути: списък на атрибутите на обектите, които да бъдат експортирани. Този списък е напълно конфигурируем, вижте по-долу.
  • OU: укажете OU, в които ще бъдат експортирани обектите.
  • Филтри за групи: списък на групите, които да бъдат управлявани или изключени при действията за изтриване:
    • Ако опцията „Remove the groups instead of keeping them“ не е отметната: списъкът с групи указва тези, които не трябва да бъдат изтривани.
    • Ако опцията „Remove the groups instead of keeping them“ е отметната: списъкът с групи указва тези, които могат да бъдат изтрити.

Избор на атрибутите за експортиране:

От версия 7.1 се предлага списък с атрибути, който улеснява избора на атрибутите за експортиране в хранилищата от тип директория. За да добавите атрибут за експортиране, използвайте бутона „Update list“:

Това действие отваря списъка с атрибутите, създадени и налични в шаблона. Можете да добавяте или премахвате атрибути според нуждите:

За да добавите атрибут, който не е част от списъка, първо създайте нов атрибут с бутона „Templates“:

Списъкът с атрибути е напълно конфигурируем: освен да създавате нови атрибути, можете да променяте или изтривате атрибути от списъка.

Управление на групите от хранилището на Identity:

До версия 7.0 трябваше ръчно да въвеждате списъка с групите за защита, които да се управляват от SIP, или списъка с групите, изключени от сравненията, и да го въвеждате както в експортирането, така и в импортирането на хранилището.

От версия 7.1 новият конектор за директории може да разчита на списъка с групите, създадени и управлявани в CyberElements Identity. За целта поставете отметка в опцията „Synchronization of groups managed by Identity only“ в конфигурацията на SIP за хранилището и въведете кода за експортиране, обикновено memberof@.

Резултати и опции:

Всеки атрибут се експортира в XML етикет, чието име е името на атрибута на директорията. Форматът по подразбиране на експортираните данни е низ от знаци.

За всеки атрибут е възможно да се укаже различен тип със следните възможности:

  • Binary
  • Date
  • Date_Filetime

За да промените формата на експортиране, изберете желания атрибут и щракнете върху бутона „Modify“.

Експортиране на хранилище от тип плосък файл (CSV)

  • Атрибути: списък на колоните, които съставят плоския файл (файлът се дефинира при създаването на хранилището).
    • Щракнете върху „Add“, за да добавите запис.
    • Изберете атрибут, за да го промените или изтриете.
    • Ако CSV файлът има заглавия на колоните, можете да щракнете върху бутона „Get Column Name“, за да извлечете автоматично имената на колоните.
  • Атрибут за сравнение при филтрирано търсене: колона, която ви позволява да експортирате един обект чрез определяне на стойността ѝ.

Резултати и опции:

Всеки атрибут се експортира в XML етикет, чието име е указаното име на атрибута. Форматът по подразбиране на експортираните данни е низ от знаци.

За всеки атрибут е възможно да се укаже различен тип със следните възможности:

  • Binary
  • Date
  • Date_Filetime

За да промените формата на експортиране, изберете желания атрибут и щракнете върху бутона „Modify“.

Експортиране на хранилище от тип база данни (SQL Server, Oracle и т.н.)

  • Тип обект: ориентировъчна стойност, без влияние върху конфигурацията
  • SQL заявка: заявка, която извлича цялата желана информация
  • Единичен филтър: заявка, в която е указан филтър, за да се върне само един резултат
  • Атрибути: рамка, предвидена за добавяне на SQL заявки за експортиране на допълнителна информация. Всяка заявка може да експортира само един атрибут, но той може да бъде многозначен (заявки, които връщат няколко реда)
  • Многоредова опция: опция, която се отмята, ако някой от експортираните атрибути на основната заявка е многозначен. Името на този атрибут трябва да се посочи в полето „Multiline Matching Attribute“. В основната заявка може да има само един многозначен атрибут.

Важна забележка: ако тази опция е отметната, задължително е в заявката да се изпълни „order by“, за да се сортира по атрибута, въведен в полето „Multiline Matching Attribute“.

Резултати и опции:

Всяка колона, дефинирана в заявката, се експортира в XML етикет с името на указаната колона. Форматът на експортираните данни е низ от знаци.

Експортиране на хранилище от тип API (REST – протокол SIM)

  • Тип обект: щракнете върху бутона „Get Object Type List“, за да извлечете списъка с обектите, налични за експортиране от хранилището на приложението.
  • Атрибут за съпоставяне: щракнете върху бутона „Get Attributes List“, за да извлечете списъка с наличните атрибути. Списъкът с атрибути зависи от избрания тип обект.
  • Щракнете върху бутона „Set“, за да потвърдите актуализациите.

Резултати и опции:

Всеки атрибут, дефиниран в типа обект, върнат от API, се експортира в XML етикет. Форматът на експортираните данни е низ от знаци.

Експортиране на XML хранилище

За да експортирате XML хранилище, трябва да изпълните действие XSLT.

XML файловете може да имат различни структури, затова трябва да създадете файл за преобразуване, за да ги преобразувате във формат XML, съвместим с механизма за осигуряване на SIP.

Експортиране от Identity: самоличности

  • Тип обект: въведете стойността „USERS“
  • Тип лице: укажете кода на типовете лица, които да бъдат експортирани от хранилището на Identity
  • Атрибут за сравнение при единично експортиране: „personne_uid“

Резултати и опции:

За всяка самоличност всички атрибути, които имат стойност, се експортират автоматично в XML етикет, чието име е кодът на атрибута. Форматът на експортираните данни е низ от знаци.

Експортиране от Identity: изброявания

  • Тип обект: въведете стойността „ENUMERATIONS“
  • Списък с кодове: код на изброяванията, които да бъдат експортирани от хранилището на Identity; няколко изброявания могат да се експортират едновременно.

За изброяванията не се поддържа единично експортиране.

Резултати и опции:

За всяко изброяване се експортират следните етикети:

  • Type = код на атрибута (или код на типа изброяване), съдържащ списъка със стойности
  • Code = код на стойност от изброяването
  • Name = етикет, свързан с кода
  • Description = описание на стойността от изброяването. Тази информация не е задължителна и се експортира само ако не е празна.

Форматът на експортираните данни е низ от знаци.

Експортиране от Identity: таблици за съответствие

  • Тип обект: въведете стойността „MATCHINGTABLE“
  • Списък с кодове: код на таблиците за съответствие, които да бъдат експортирани от хранилището на Identity; няколко таблици за съответствие могат да се експортират едновременно.

За таблиците за съответствие не се поддържа единично експортиране.

Резултати и опции:

За всяка таблица за съответствие се експортират следните етикети:

  • Type = код на типа на таблицата за съответствие
  • Key = ключ на таблицата за съответствие
  • Value = стойност или стойности, свързани с ключа. Стойността може да бъде многозначна.
  • Description = описание на стойността от таблицата за съответствие. Тази информация не е задължителна и се експортира само ако не е празна.

Форматът на експортираните данни е низ от знаци.

Експортиране от Identity: предоставяния (ресурси)

  • Тип обект: въведете стойността „OBJECTS“
  • Списък с кодове: укажете кода на типовете предоставяния (ресурси), които да бъдат експортирани от хранилището на Identity
  • Опция за експортиране на структурите, които имат връзка с предоставянето
  • Опция за експортиране на самоличностите, които имат връзка с предоставянето
  • Атрибут за сравнение при единично експортиране: „object_instance_code“

Резултати и опции:

За всяко предоставяне (ресурс) всички атрибути, които имат стойност, се експортират автоматично в XML етикет, чието име е кодът на атрибута. Форматът на експортираните данни е низ от знаци.

Експортиране от Identity: състояния на осигуряването

  • Тип обект: въведете стойността „STATUS“
  • Repository: код на хранилището, от което искате да експортирате лицата и свързаните с тях акаунти. Имайте предвид, че той трябва да бъде уникален, за да работи правилно.
  • Атрибут за сравнение при единично експортиране: „Account.login“

Резултати и опции:

За всеки акаунт в хранилището се експортират следните етикети:

  • Account.Id: Id на акаунта
  • Account.login: име за влизане на акаунта. Ще се използва за сравнение
  • Account.state: състояние на осигуряването на акаунта (0: неосигурен, 1: осигурен)
  • Person.Id: ID на основното лице
  • Person.uniqueId: UID на основното лице
  • За всяко упълномощаване, свързано с акаунта:
    • [code_mapping_right]#right.id: информационен етикет за извличане на списъка с ID на правата, които имат стойността на кода за съпоставяне, указана в първата част на етикета. Възможни са няколко стойности.
    • [code_mapping_right]#[right.id]: по един етикет от този тип за всяко упълномощаване, което има стойността на кода за съпоставяне, указана в първата част на етикета. Съдържа стойността на упълномощаването
    • [code_mapping_right]: информационен етикет за извличане на списъка със стойностите на упълномощаванията, които имат стойността на кода за съпоставяне, указана в първата част на етикета. Възможни са няколко стойности.
    • [code_mapping_right]#state: списък на състоянията на осигуряването за всяко упълномощаване, което има стойността на кода за съпоставяне, указана в първата част на етикета.

Форматът на експортираните данни е низ от знаци.

Експортиране от Identity: структури

  • Тип обект: въведете стойността „STRUCTURES“
  • Списък с кодове: укажете кода на типовете структури, които да бъдат експортирани от хранилището на Identity
  • Атрибут за сравнение при единично експортиране: „structure_code“

Резултати и опции:

За всяка структура всички атрибути, които имат стойност, се експортират автоматично в XML етикет, чието име е кодът на атрибута. Форматът на експортираните данни е низ от знаци.

Експортиране от Identity: самоличности + упълномощавания

  • Тип обект: въведете стойността „USERS+ACCESS“
  • Repository: код на хранилището, от което искате да експортирате лицата и свързаните с тях акаунти. Имайте предвид, че той трябва да бъде уникален, за да работи правилно.
  • Тип лице: укажете кода на типовете лица, които да бъдат експортирани от хранилището на Identity
  • Атрибут за сравнение при единично експортиране: „personne_uid“

Резултати и опции:

За всяка самоличност всички атрибути, които имат стойност, се експортират автоматично в XML етикет, чието име е кодът на атрибута. Форматът на експортираните данни е низ от знаци.

Ако самоличността има акаунт в указаното хранилище, се експортират допълнителни XML етикети:

  • HPPAccountLogin
  • HPPAccountPwd
  • HPPAccountState

Ако самоличността има разрешения в указаното хранилище, се експортират допълнителни XML етикети:

  • HPPAccessRight, който ще съдържа всички стойности на разрешенията „Group“ и „Dynamic Group“
  • По един XML етикет за всеки отделен код, дефиниран в съпоставянето на разрешенията „Attribute“ или „Dynamic Attribute“. Ако няколко упълномощавания са конфигурирани със същия код за съпоставяне, ще бъде експортиран един XML етикет с няколко стойности в него.

Експортиране от Identity: акаунти + упълномощавания

  • Тип обект: изберете стойността „ACCOUNT“
  • Repository: укажете кода на хранилището, от което да бъдат експортирани акаунтите и упълномощаванията. Имайте предвид, че макар технически да е възможно да се въведат няколко кода на хранилища, за правилната работа на конектора за осигуряване е задължително да се въведе само един.

Резултати и опции: Експортират се всички акаунти в избраното хранилище.

За всеки акаунт се експортират следните етикети:

  • ID = ID на акаунта, което да се използва за актуализиране и изтриване
  • Account_login = име за влизане на акаунта
  • password = парола на акаунта, експортирана в шифрован вид
  • Account_provisioning = състояние на осигуряването на акаунта:
    • 1: само теоретичен акаунт
    • 2: осиротял акаунт
    • 3: теоретичен и осигурен акаунт
  • Account_state = състояние на теоретичния акаунт
    • -1: Няма акаунт (стойност, невъзможна при експортиране)
    • 0: само теоретичен акаунт
    • 1: активен акаунт
    • 2: деактивиран акаунт
  • Account_type = ID на типа акаунт
  • roles = роли, свързани с акаунта
  • Атрибутите и разрешенията се експортират в етикети, чиито имена се определят от конфигурацията.

Експортиране от Identity: роли

  • Тип обект: изберете стойността „ROLE“
  • Repositories: укажете кодовете на хранилището, чиито съществуващи свързани роли да бъдат експортирани. Незадължително.

Резултати и опции: Експортират се всички съществуващи роли. Ако е указано едно или няколко хранилища, ще бъдат експортирани само ролите, свързани с тези хранилища.

За всяка роля се експортират следните етикети:

  • id = ID на ролята
  • code = кодът на ролята
  • name = името на ролята
  • description = описанието на ролята
  • repositories = код на хранилищата, свързани с ролята
  • accountTypes = код на типовете акаунти, свързани с ролята

Експортиране от Identity: упълномощавания

  • Тип обект: изберете стойността „RIGHT“
  • Repositories: укажете кодовете на хранилището, чиито съществуващи свързани упълномощавания трябва да бъдат експортирани. Незадължително.

Резултати и опции: Експортират се всички съществуващи упълномощавания. Ако е указано едно или няколко конкретни хранилища, ще бъдат експортирани само упълномощаванията, свързани с тези хранилища.

За всяко упълномощаване се експортират следните етикети:

  • Id = ID на упълномощаването
  • code = кодът на упълномощаването
  • name = името на упълномощаването
  • category = кодът на категорията на упълномощаването
  • application = кодът на приложението на упълномощаването
  • repository = кодът на хранилището на упълномощаването
  • type = типът на упълномощаването
    • 3 = group. Имайте предвид, че използването на този тип упълномощаване е обявено за остаряло от версия 7.0. Предпочитайте типа „attribute“.
    • 6 = attribute
  • mode = режимът на упълномощаването
    • 0 = статичен. Статична стойност, която да се укаже в етикета „value“
    • 1 = динамичен: стойност на атрибут, указан в етикета с име „template#[object_type_code]“
  • Името на атрибута за експортиране на упълномощаванията, свързани с акаунти или лица, в етикета „mappingCode“

Експортиране от Identity: самоличности + роли

  • Тип обект: изберете стойността „PERSON_ROLES“
  • Repositories: укажете кодовете на хранилището, чиито съществуващи свързани роли да бъдат експортирани.

Резултати и опции: експортират се всички връзки „самоличност – роля“, свързани с избраните хранилища.

За всяка връзка „самоличност – роля“ се експортират следните етикети:

  • person = UID на самоличността
  • role = код на ролята, която да бъде присвоена
  • startdate = начална дата на ролята
  • enddate = крайна дата на ролята
  • id = id на връзката „самоличност – роля“

Експортиране от Identity: самоличности + роли + упълномощавания

  • Тип обект: изберете стойността „PERSON_RIGHTS“
  • Repositories: укажете кодовете на хранилищата, за които искате да създадете връзки „самоличност/роля – упълномощаване“.

Резултати и опции: експортират се всички връзки „самоличност/роля – упълномощаване“, свързани с избраните хранилища.

За всяка връзка „самоличност/роля – упълномощаване“ се експортират следните етикети:

  • person = UID на самоличността
  • role = код на ролята
  • right = код на упълномощаването
  • startdate = начална дата на упълномощаването
  • enddate = крайна дата на упълномощаването
  • id = id на връзката „самоличност – роля – упълномощаване“