Pāriet uz saturu

Eksporta kārtulu izveide/modificēšana

Eksporta kārtulas mērķis ir, pamatojoties uz krātuvi, definēt eksportējamos objektus un to atrašanās vietas. Piemēram, direktorija tipa krātuvei būs jādefinē eksportējamie objekti un OU, kurās tiks veikta meklēšana.

Katrs eksports ģenerēs datu failu XML formātā.

Ir divi iespējamie eksporta režīmi, kurus var atlasīt atkarībā no lietošanas gadījuma:

  • Pilnais: visi objekti, kas atbilst eksporta kārtulām, tiek eksportēti izvades failā. Izvades fails ir XML formātā.
  • Atsevišķais: viena objekta eksports, kas filtrēts pēc atribūta vērtības.

Konfigurējamās eksporta kārtulas atšķiras atkarībā no krātuves tipa.

Direktorija tipa krātuves eksportēšana (LDAP, AD, AD/LDS, OpenLDAP utt.)

  • Objekta tips: norādiet eksportējamā objekta tipu (piemēram, user, classes utt.).
  • Meklēšanas filtrs: neobligāts lauks filtru lietošanai eksportējamiem objektiem (piemēram, „employeeID“ nav tukšs).
  • Atsevišķais filtrs: atribūts, kas ļauj filtrēt objektu, definējot tā vērtību.
  • Atribūti: eksportējamo objektu atribūtu saraksts. Šis saraksts ir pilnībā konfigurējams, skatiet tālāk.
  • OU: norādiet OU, uz kurām tiks eksportēti objekti.
  • Grupu filtri: to grupu saraksts, kas jāpārvalda vai jāizslēdz dzēšanas darbībās:
    • Ja opcija „Remove the groups instead of keeping them“ nav atzīmēta: grupu sarakstā ir norādītas tās grupas, kuras nedrīkst dzēst.
    • Ja opcija „Remove the groups instead of keeping them“ ir atzīmēta: grupu sarakstā ir norādītas tās grupas, kuras drīkst dzēst.

Eksportējamo atribūtu atlase:

Sākot ar versiju 7.1, tiek piedāvāts atribūtu saraksts, lai atvieglotu eksportējamo atribūtu atlasi direktorija tipa krātuvēs. Lai pievienotu eksportējamu atribūtu, izmantojiet pogu „Update list“:

Šī darbība atver sarakstu ar atribūtiem, kas izveidoti un atrodas veidnē. Varat pievienot vai noņemt atribūtus pēc vajadzības:

Lai pievienotu atribūtu, kas nav sarakstā, vispirms izveidojiet jaunu atribūtu, izmantojot pogu „Templates“:

Atribūtu saraksts ir pilnībā konfigurējams: papildus jaunu atribūtu izveidei varat modificēt vai dzēst saraksta atribūtus.

Grupu pārvaldība no Identity krātuves:

Līdz versijai 7.0 bija manuāli jāievada to drošības grupu saraksts, kuras jāpārvalda SIP, vai to grupu saraksts, kas jāizslēdz no salīdzināšanas, turklāt tas bija jāievada gan krātuves eksportā, gan importā.

Sākot ar versiju 7.1, jaunais direktorija savienotājs var izmantot to grupu sarakstu, kas izveidotas un tiek pārvaldītas risinājumā CyberElements Identity. Lai to izdarītu, krātuves SIP konfigurācijā atzīmējiet opciju „Synchronization of groups managed by Identity only“ un ievadiet eksporta kodu, parasti memberof@.

Rezultāti un opcijas:

Katrs atribūts tiek eksportēts XML tagā, kura nosaukums ir direktorija atribūta nosaukums. Eksportēto datu noklusējuma formāts ir rakstzīmju virkne.

Katram atribūtam var norādīt citu tipu, izvēloties kādu no šīm iespējām:

  • Binary
  • Date
  • Date_Filetime

Lai mainītu eksporta formātu, atlasiet vajadzīgo atribūtu un noklikšķiniet uz pogas „Modify“.

Plakanā faila krātuves eksportēšana (CSV)

  • Atribūti: kolonnu saraksts, no kurām sastāv plakanais fails (fails tiek definēts, veidojot krātuvi).
    • Noklikšķiniet uz „Add“, lai pievienotu ierakstu.
    • Atlasiet atribūtu, lai to modificētu vai dzēstu.
    • Ja CSV failam ir kolonnu galvenes, varat noklikšķināt uz pogas „Get Column Name“, lai automātiski izgūtu kolonnu nosaukumus.
  • Salīdzināšanas atribūts filtrētai meklēšanai: kolonna, kas ļauj eksportēt vienu objektu, definējot tās vērtību.

Rezultāti un opcijas:

Katrs atribūts tiek eksportēts XML tagā, kura nosaukums ir norādītais atribūta nosaukums. Eksportēto datu noklusējuma formāts ir rakstzīmju virkne.

Katram atribūtam var norādīt citu tipu, izvēloties kādu no šīm iespējām:

  • Binary
  • Date
  • Date_Filetime

Lai mainītu eksporta formātu, atlasiet vajadzīgo atribūtu un noklikšķiniet uz pogas „Modify“.

Datu bāzes tipa krātuves eksportēšana (SQL Server, Oracle utt.)

  • Objekta tips: informatīva vērtība, neietekmē konfigurāciju
  • SQL vaicājums: vaicājums, kas izgūst visu vajadzīgo informāciju
  • Atsevišķais filtrs: vaicājums, kurā norādīts filtrs, lai atgrieztu tikai vienu rezultātu
  • Atribūti: rāmis, kas paredzēts SQL vaicājumu pievienošanai, lai eksportētu papildu informāciju. Katrs vaicājums var eksportēt tikai vienu atribūtu, taču tas var būt daudzvērtīgs (vaicājumi, kas atgriež vairākas rindas)
  • Vairākrindu opcija: opcija, kas jāatzīmē, ja kāds no galvenā vaicājuma eksportētajiem atribūtiem ir daudzvērtīgs. Šī atribūta nosaukums jānorāda laukā „Multiline Matching Attribute“. Galvenajā vaicājumā var būt tikai viens daudzvērtīgs atribūts.

Svarīga piezīme: ja šī opcija ir atzīmēta, vaicājumā obligāti jāveic „order by“, lai kārtotu pēc atribūta, kas ievadīts laukā „Multiline Matching Attribute“.

Rezultāti un opcijas:

Katra vaicājumā definētā kolonna tiek eksportēta XML tagā ar norādītās kolonnas nosaukumu. Eksportēto datu formāts ir rakstzīmju virkne.

API tipa krātuves eksportēšana (REST – SIM protokols)

  • Objekta tips: noklikšķiniet uz pogas „Get Object Type List“, lai izgūtu to objektu sarakstu, kurus lietojumprogrammas krātuve piedāvā eksportēšanai.
  • Kartēšanas atribūts: noklikšķiniet uz pogas „Get Attributes List“, lai izgūtu pieejamo atribūtu sarakstu. Atribūtu saraksts ir atkarīgs no atlasītā objekta tipa.
  • Noklikšķiniet uz pogas „Set“, lai apstiprinātu atjauninājumus.

Rezultāti un opcijas:

Katrs atribūts, kas definēts API atgrieztajā objekta tipā, tiek eksportēts XML tagā. Eksportēto datu formāts ir rakstzīmju virkne.

XML krātuves eksportēšana

Lai eksportētu XML krātuvi, jāizpilda darbība XSLT.

XML failiem var būt dažādas struktūras, tāpēc jāizveido transformācijas fails, lai tos pārvērstu XML formātā, kas ir saderīgs ar SIP nodrošināšanas dzinēju.

Identity eksports: identitātes

  • Objekta tips: ievadiet vērtību „USERS“
  • Personas tips: norādiet to personu tipu kodu, kas jāeksportē no Identity krātuves
  • Salīdzināšanas atribūts atsevišķam eksportam: „personne_uid“

Rezultāti un opcijas:

Katrai identitātei visi atribūti, kuriem ir vērtība, tiek automātiski eksportēti XML tagā, kura nosaukums ir atribūta kods. Eksportēto datu formāts ir rakstzīmju virkne.

Identity eksports: uzskaitījumi

  • Objekta tips: ievadiet vērtību „ENUMERATIONS“
  • Kodu saraksts: no Identity krātuves eksportējamo uzskaitījumu kods; vienlaikus var eksportēt vairākus uzskaitījumus.

Uzskaitījumiem atsevišķie eksporti netiek atbalstīti.

Rezultāti un opcijas:

Katram uzskaitījumam tiek eksportēti šādi tagi:

  • Type = atribūta kods (vai uzskaitījuma tipa kods), kas satur vērtību sarakstu
  • Code = uzskaitījuma vērtības kods
  • Name = ar kodu saistītā etiķete
  • Description = uzskaitījuma vērtības apraksts. Šī informācija nav obligāta un tiek eksportēta tikai tad, ja tā nav tukša.

Eksportēto datu formāts ir rakstzīmju virkne.

Identity eksports: atbilstības tabulas

  • Objekta tips: ievadiet vērtību „MATCHINGTABLE“
  • Kodu saraksts: no Identity krātuves eksportējamo atbilstības tabulu kods; vienlaikus var eksportēt vairākas atbilstības tabulas.

Atbilstības tabulām atsevišķie eksporti netiek atbalstīti.

Rezultāti un opcijas:

Katrai atbilstības tabulai tiek eksportēti šādi tagi:

  • Type = atbilstības tabulas tipa kods
  • Key = atbilstības tabulas atslēga
  • Value = ar atslēgu saistītā vērtība vai vērtības. Vērtība var būt daudzvērtīga.
  • Description = atbilstības tabulas vērtības apraksts. Šī informācija nav obligāta un tiek eksportēta tikai tad, ja tā nav tukša.

Eksportēto datu formāts ir rakstzīmju virkne.

Identity eksports: piešķīrumi (resursi)

  • Objekta tips: ievadiet vērtību „OBJECTS“
  • Kodu saraksts: norādiet to piešķīrumu (resursu) tipu kodu, kas jāeksportē no Identity krātuves
  • Opcija eksportēt struktūras, kurām ir saite ar piešķīrumu
  • Opcija eksportēt identitātes, kurām ir saite ar piešķīrumu
  • Salīdzināšanas atribūts atsevišķam eksportam: „object_instance_code“

Rezultāti un opcijas:

Katram piešķīrumam (resursam) visi atribūti, kuriem ir vērtība, tiek automātiski eksportēti XML tagā, kura nosaukums ir atribūta kods. Eksportēto datu formāts ir rakstzīmju virkne.

Identity eksports: nodrošināšanas stāvokļi

  • Objekta tips: ievadiet vērtību „STATUS“
  • Krātuve: tās krātuves kods, no kuras vēlaties eksportēt personas un ar tām saistītos kontus. Ņemiet vērā, ka tam jābūt unikālam, lai funkcija darbotos pareizi.
  • Salīdzināšanas atribūts atsevišķam eksportam: „Account.login“

Rezultāti un opcijas:

Katram krātuves kontam tiek eksportēti šādi tagi:

  • Account.Id: konta ID
  • Account.login: konta pieteikšanās vārds. Tiks izmantots salīdzināšanai
  • Account.state: konta nodrošināšanas statuss (0: nav nodrošināts, 1: nodrošināts)
  • Person.Id: primārās personas ID
  • Person.uniqueId: primārās personas UID
  • Katrai ar kontu saistītajai autorizācijai:
    • [code_mapping_right]#right.id: informatīvs tags, lai izgūtu to tiesību ID sarakstu, kurām ir taga pirmajā daļā norādītā kartēšanas koda vērtība. Iespējamas vairākas vērtības.
    • [code_mapping_right]#[right.id]: šāda tipa tags katrai autorizācijai, kurai ir taga pirmajā daļā norādītā kartēšanas koda vērtība. Satur autorizācijas vērtību
    • [code_mapping_right]: informatīvs tags, lai izgūtu to autorizāciju vērtību sarakstu, kurām ir taga pirmajā daļā norādītā kartēšanas koda vērtība. Iespējamas vairākas vērtības.
    • [code_mapping_right]#state: nodrošināšanas stāvokļu saraksts katrai autorizācijai, kurai ir taga pirmajā daļā norādītā kartēšanas koda vērtība.

Eksportēto datu formāts ir rakstzīmju virkne.

Identity eksports: struktūras

  • Objekta tips: ievadiet vērtību „STRUCTURES“
  • Kodu saraksts: norādiet to struktūru tipu kodu, kas jāeksportē no Identity krātuves
  • Salīdzināšanas atribūts atsevišķam eksportam: „structure_code“

Rezultāti un opcijas:

Katrai struktūrai visi atribūti, kuriem ir vērtība, tiek automātiski eksportēti XML tagā, kura nosaukums ir atribūta kods. Eksportēto datu formāts ir rakstzīmju virkne.

Identity eksports: identitātes + autorizācijas

  • Objekta tips: ievadiet vērtību „USERS+ACCESS“
  • Krātuve: tās krātuves kods, no kuras vēlaties eksportēt personas un ar tām saistītos kontus. Ņemiet vērā, ka tam jābūt unikālam, lai funkcija darbotos pareizi.
  • Personas tips: norādiet to personu tipu kodu, kas jāeksportē no Identity krātuves
  • Salīdzināšanas atribūts atsevišķam eksportam: „personne_uid“

Rezultāti un opcijas:

Katrai identitātei visi atribūti, kuriem ir vērtība, tiek automātiski eksportēti XML tagā, kura nosaukums ir atribūta kods. Eksportēto datu formāts ir rakstzīmju virkne.

Ja identitātei ir konts norādītajā krātuvē, tiek eksportēti papildu XML tagi:

  • HPPAccountLogin
  • HPPAccountPwd
  • HPPAccountState

Ja identitātei ir atļaujas norādītajā krātuvē, tiek eksportēti papildu XML tagi:

  • HPPAccessRight, kurā būs visas atļauju „Group“ un „Dynamic Group“ vērtības
  • Viens XML tags katram atšķirīgam kodam, kas definēts atļauju „Attribute“ vai „Dynamic Attribute“ kartējumā. Ja vairākas autorizācijas ir konfigurētas ar vienu un to pašu kartēšanas kodu, tiks eksportēts viens XML tags ar vairākām vērtībām.

Identity eksports: konti + autorizācijas

  • Objekta tips: atlasiet vērtību „ACCOUNT“
  • Krātuve: norādiet tās krātuves kodu, no kuras jāeksportē konti un autorizācijas. Ņemiet vērā: lai gan tehniski ir iespējams ievadīt vairākus krātuvju kodus, nodrošināšanas savienotāja pareizai darbībai obligāti jāievada tikai viens.

Rezultāti un opcijas: tiek eksportēti visi atlasītās krātuves konti.

Katram kontam tiek eksportēti šādi tagi:

  • ID = konta ID, kas jāizmanto atjauninājumiem un dzēšanai
  • Account_login = konta pieteikšanās vārds
  • password = konta parole, eksportēta šifrētā veidā
  • Account_provisioning = konta nodrošināšanas statuss:
    • 1: tikai teorētisks konts
    • 2: bāreņa konts
    • 3: teorētisks un nodrošināts konts
  • Account_state = teorētiskā konta statuss
    • -1: nav konta (eksportā neiespējama vērtība)
    • 0: tikai teorētisks konts
    • 1: aktīvs konts
    • 2: atspējots konts
  • Account_type = konta tipa ID
  • roles = ar kontu saistītās lomas
  • Atribūti un atļaujas tiek eksportēti tagos, kuru nosaukumus nosaka konfigurācija.

Identity eksports: lomas

  • Objekta tips: atlasiet vērtību „ROLE“
  • Krātuves: norādiet tās krātuves kodus, kuras esošās saistītās lomas jāeksportē. Nav obligāti.

Rezultāti un opcijas: tiek eksportētas visas esošās lomas. Ja ir norādīta viena vai vairākas krātuves, tiks eksportētas tikai ar šīm krātuvēm saistītās lomas.

Katrai lomai tiek eksportēti šādi tagi:

  • id = lomas ID
  • code = lomas kods
  • name = lomas nosaukums
  • description = lomas apraksts
  • repositories = ar lomu saistīto krātuvju kods
  • accountTypes = ar lomu saistīto kontu tipu kods

Identity eksports: autorizācijas

  • Objekta tips: atlasiet vērtību „RIGHT“
  • Krātuves: norādiet tās krātuves kodus, kuras esošās saistītās autorizācijas jāeksportē. Nav obligāti.

Rezultāti un opcijas: tiek eksportētas visas esošās autorizācijas. Ja ir norādīta viena vai vairākas konkrētas krātuves, tiks eksportētas tikai ar šīm krātuvēm saistītās autorizācijas.

Katrai autorizācijai tiek eksportēti šādi tagi:

  • Id = autorizācijas ID
  • code = autorizācijas kods
  • name = autorizācijas nosaukums
  • category = autorizācijas kategorijas kods
  • application = autorizācijas lietojumprogrammas kods
  • repository = autorizācijas krātuves kods
  • type = autorizācijas tips
    • 3 = group. Ņemiet vērā, ka šī autorizācijas tipa izmantošana kopš versijas 7.0 ir novecojusi. Ieteicams izmantot tipu „attribute“.
    • 6 = attribute
  • mode = autorizācijas režīms
    • 0 = statisks. Statiska vērtība, kas jānorāda tagā „value“
    • 1 = dinamisks: atribūta vērtība, kas norādīta tagā ar nosaukumu „template#[object_type_code]“
  • Atribūta nosaukums, ar kuru eksportē ar kontiem vai personām saistītās autorizācijas, tagā „mappingCode“

Identity eksports: identitātes + lomas

  • Objekta tips: atlasiet vērtību „PERSON_ROLES“
  • Krātuves: norādiet tās krātuves kodus, kuras esošās saistītās lomas jāeksportē.

Rezultāti un opcijas: tiek eksportētas visas saites identitāte-loma, kas saistītas ar atlasītajām krātuvēm.

Katrai saitei identitāte-loma tiek eksportēti šādi tagi:

  • person = identitātes UID
  • role = piešķiramās lomas kods
  • startdate = lomas sākuma datums
  • enddate = lomas beigu datums
  • id = saites identitāte-loma ID

Identity eksports: identitātes + lomas + autorizācijas

  • Objekta tips: atlasiet vērtību „PERSON_RIGHTS“
  • Krātuves: norādiet to krātuvju kodus, kurām vēlaties izveidot saites identitāte/loma-autorizācija.

Rezultāti un opcijas: tiek eksportētas visas saites identitāte/loma-autorizācija, kas saistītas ar atlasītajām krātuvēm.

Katrai saitei identitāte/loma-autorizācija tiek eksportēti šādi tagi:

  • person = identitātes UID
  • role = lomas kods
  • right = autorizācijas kods
  • startdate = autorizācijas sākuma datums
  • enddate = autorizācijas beigu datums
  • id = saites identitāte-loma-autorizācija ID