> Source: https://docs.cyberelements.io/identity/7.0/et/UserDocumentation/AutomaticProvisioningConnectorsManagement/CreateModifyExportRules/

# Ekspordireeglite loomine/muutmine

Ekspordireegli eesmärk on määratleda hoidla põhjal eksporditavad objektid ja nende asukohad. Näiteks kataloogitüüpi hoidla puhul tuleb määratleda eksporditavad objektid ja OU-d, milles otsing tehakse.

Iga eksport loob XML-vormingus andmefaili.

Ekspordirežiime on kaks ja neid saab valida kasutusjuhu järgi:

- Täielik: kõik ekspordireeglitele vastavad objektid eksporditakse väljundfaili. Väljundfail on XML-vormingus.
- Üksik: ühe objekti eksport, mis on filtreeritud atribuudi väärtuse järgi.

Konfigureeritavad ekspordireeglid erinevad olenevalt hoidla tüübist.

## Kataloogitüüpi hoidla eksportimine (LDAP, AD, AD/LDS, OpenLDAP jne)

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

- Objekti tüüp: määrake eksporditava objekti tüüp (nt user, classes jne).
- Otsingufilter: valikuline väli eksporditavatele objektidele filtrite rakendamiseks (nt „employeeID“ pole tühi).
- Üksikfilter: atribuut, mis võimaldab objekti filtreerida selle väärtuse määramise kaudu.
- Atribuudid: eksporditavate objektide atribuutide loend.
- OU-d: määrake OU-d, kuhu objektid eksporditakse.
- Rühmafiltrid: kustutamistoimingutes hallatavate või välistatavate rühmade loend:
    - Kui suvand „Remove the groups instead of keeping them“ pole märgitud: rühmade loend näitab neid, mida ei tohi kustutada.
    - Kui suvand „Remove the groups instead of keeping them“ on märgitud: rühmade loend näitab neid, mida võib kustutada.

**Tulemused ja suvandid:**

Iga atribuut eksporditakse XML-märgendis, mille nimeks on kataloogi atribuudi nimi. Eksporditud andmete vaikevorming on märgistring.

Iga atribuudi jaoks saab määrata erineva tüübi järgmistest valikutest:

- Binary
- Date
- Date_Filetime

Ekspordivormingu muutmiseks valige soovitud atribuut ja klõpsake nuppu „Modify“.

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

## Lamefaili hoidla eksportimine (CSV)

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

- Atribuudid: lamefaili moodustavate veergude loend (fail määratletakse hoidla loomisel).
    - Kirje lisamiseks klõpsake „Add“.
    - Valige atribuut selle muutmiseks või kustutamiseks.
    - Kui CSV-failis on veerupäised, saate veergude nimede automaatseks toomiseks klõpsata nuppu „Get Column Name“.
- Võrdlusatribuut filtreeritud otsinguks: veerg, mis võimaldab eksportida üksiku objekti selle väärtuse määramise kaudu.

**Tulemused ja suvandid:**

Iga atribuut eksporditakse XML-märgendis, mille nimeks on määratud atribuudi nimi. Eksporditud andmete vaikevorming on märgistring.

Iga atribuudi jaoks saab määrata erineva tüübi järgmistest valikutest:

- Binary
- Date
- Date_Filetime

Ekspordivormingu muutmiseks valige soovitud atribuut ja klõpsake nuppu „Modify“.

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

## Andmebaasitüüpi hoidla eksportimine (SQL Server, Oracle jne)

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

- Objekti tüüp: informatiivne väärtus, ei mõjuta konfiguratsiooni
- SQL-päring: päring, mis ekstraktib kogu soovitud teabe
- Üksikfilter: päring, milles on määratud filter, et tagastada ainult üks tulemus
- Atribuudid: raam SQL-päringute lisamiseks lisateabe eksportimiseks. Iga päring saab eksportida ainult ühe atribuudi, kuid see võib olla mitmeväärtuseline (mitu rida tagastavad päringud)
- Mitmerealine suvand: suvand, mis tuleb märkida, kui mõni põhipäringu eksporditavatest atribuutidest on mitmeväärtuseline. Selle atribuudi nimi tuleb märkida väljale „Multiline Matching Attribute“. Põhipäringus saab olla ainult üks mitmeväärtuseline atribuut.

**Oluline märkus:** kui see suvand on märgitud, tuleb päringus kindlasti teha „order by“, et sortida väljale „Multiline Matching Attribute“ sisestatud atribuudi järgi.

**Tulemused ja suvandid:**

Iga päringus määratletud veerg eksporditakse XML-märgendis, mille nimeks on määratud veeru nimi. Eksporditud andmete vorming on märgistring.

## API-tüüpi hoidla eksportimine (REST – SIM-protokoll)

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

- Objekti tüüp: klõpsake nuppu „Get Object Type List“, et tuua rakenduse hoidlast ekspordiks saadaolevate objektide loend.
- Vastendusatribuut: klõpsake nuppu „Get Attributes List“, et tuua saadaolevate atribuutide loend. Atribuutide loend sõltub valitud objekti tüübist.
- Muudatuste kinnitamiseks klõpsake nuppu „Set“.

**Tulemused ja suvandid:**

Iga API tagastatud objektitüübis määratletud atribuut eksporditakse XML-märgendis. Eksporditud andmete vorming on märgistring.

## XML-hoidla eksportimine

XML-hoidla eksportimiseks tuleb teha XSLT-toiming.

XML-failidel võivad olla erinevad struktuurid, seega tuleb luua teisendusfail, et teisendada see SIP-i ettevalmistusmootoriga ühilduvasse XML-vormingusse.

## Identity eksport: identiteedid

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

- Objekti tüüp: sisestage väärtus „USERS“
- Isikutüüp: määrake Identity hoidlast eksporditavate isikutüüpide kood
- Võrdlusatribuut üksikekspordiks: „personne_uid“

**Tulemused ja suvandid:**

Iga identiteedi puhul eksporditakse kõik väärtusega atribuudid automaatselt XML-märgendisse, mille nimeks on atribuudi kood. Eksporditud andmete vorming on märgistring.

## Identity eksport: loetelud

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

- Objekti tüüp: sisestage väärtus „ENUMERATIONS“
- Koodide loend: Identity hoidlast eksporditavate loetelude kood; korraga saab eksportida mitu loetelu.

Loetelude puhul üksikeksporte ei hallata.

**Tulemused ja suvandid:**

Iga loetelu kohta eksporditakse järgmised märgendid:

- Type = atribuudi kood (või loetelutüübi kood), mis sisaldab väärtuste loendit
- Code = loetelu väärtuse kood
- Name = koodiga seotud nimetus
- Description = loetelu väärtuse kirjeldus. See teave on valikuline ja eksporditakse ainult siis, kui see pole tühi.

Eksporditud andmete vorming on märgistring.

## Identity eksport: vastavustabelid

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

- Objekti tüüp: sisestage väärtus „MATCHINGTABLE“
- Koodide loend: Identity hoidlast eksporditavate vastavustabelite kood; korraga saab eksportida mitu vastavustabelit.

Vastavustabelite puhul üksikeksporte ei hallata.

**Tulemused ja suvandid:**

Iga vastavustabeli kohta eksporditakse järgmised märgendid:

- Type = vastavustabeli tüübi kood
- Key = vastavustabeli võti
- Value = võtmega seotud väärtus(ed). Väärtus võib olla mitmeväärtuseline.
- Description = vastavustabeli väärtuse kirjeldus. See teave on valikuline ja eksporditakse ainult siis, kui see pole tühi.

Eksporditud andmete vorming on märgistring.

## Identity eksport: eraldised (ressursid)

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

- Objekti tüüp: sisestage väärtus „OBJECTS“
- Koodide loend: määrake Identity hoidlast eksporditavate eraldisetüüpide (ressursside) kood
- Suvand eraldisega seotud struktuuride eksportimiseks
- Suvand eraldisega seotud identiteetide eksportimiseks
- Võrdlusatribuut üksikekspordiks: „object_instance_code“

**Tulemused ja suvandid:**

Iga eraldise (ressursi) puhul eksporditakse kõik väärtusega atribuudid automaatselt XML-märgendisse, mille nimeks on atribuudi kood. Eksporditud andmete vorming on märgistring.

## Identity eksport: ettevalmistusolekud

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

- Objekti tüüp: sisestage väärtus „STATUS“
- Hoidla: selle hoidla kood, kust soovite eksportida isikud ja nendega seotud kontod. Pange tähele, et see peab õigeks toimimiseks olema kordumatu.
- Võrdlusatribuut üksikekspordiks: „Account.login“

**Tulemused ja suvandid:**

Iga hoidla konto kohta eksporditakse järgmised märgendid:

- Account.Id: konto ID
- Account.login: konto kasutajanimi. Kasutatakse võrdlemiseks
- Account.state: konto ettevalmistusolek (0: ette valmistamata, 1: ette valmistatud)
- Person.Id: peamise isiku ID
- Person.uniqueId: peamise isiku UID
- Iga kontoga seotud autoriseerimise kohta:
    - [code_mapping_right]#right.id: teabemärgend, millega tuuakse nende õiguste ID-de loend, millel on märgendi esimeses osas näidatud vastenduskoodi väärtus. Võimalikud on mitu väärtust.
    - [code_mapping_right]#[right.id]: seda tüüpi märgend iga autoriseerimise kohta, millel on märgendi esimeses osas näidatud vastenduskoodi väärtus. Sisaldab autoriseerimise väärtust
    - [code_mapping_right]: teabemärgend, millega tuuakse nende autoriseerimisväärtuste loend, millel on märgendi esimeses osas näidatud vastenduskoodi väärtus. Võimalikud on mitu väärtust.
    - [code_mapping_right]#state: ettevalmistusolekute loend iga autoriseerimise kohta, millel on märgendi esimeses osas näidatud vastenduskoodi väärtus.

Eksporditud andmete vorming on märgistring.

## Identity eksport: struktuurid

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

- Objekti tüüp: sisestage väärtus „STRUCTURES“
- Koodide loend: määrake Identity hoidlast eksporditavate struktuuritüüpide kood
- Võrdlusatribuut üksikekspordiks: „structure_code“

**Tulemused ja suvandid:**

Iga struktuuri puhul eksporditakse kõik väärtusega atribuudid automaatselt XML-märgendisse, mille nimeks on atribuudi kood. Eksporditud andmete vorming on märgistring.

## Identity eksport: identiteedid + autoriseerimised

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

- Objekti tüüp: sisestage väärtus „USERS+ACCESS“
- Hoidla: selle hoidla kood, kust soovite eksportida isikud ja nendega seotud kontod. Pange tähele, et see peab õigeks toimimiseks olema kordumatu.
- Isikutüüp: määrake Identity hoidlast eksporditavate isikutüüpide kood
- Võrdlusatribuut üksikekspordiks: „personne_uid“

**Tulemused ja suvandid:**

Iga identiteedi puhul eksporditakse kõik väärtusega atribuudid automaatselt XML-märgendisse, mille nimeks on atribuudi kood. Eksporditud andmete vorming on märgistring.

Kui identiteedil on määratud hoidlas konto, eksporditakse täiendavad XML-märgendid:

- HPPAccountLogin
- HPPAccountPwd
- HPPAccountState

Kui identiteedil on määratud hoidlas load, eksporditakse täiendavad XML-märgendid:

- HPPAccessRight, mis sisaldab kõiki lubade „Group“ ja „Dynamic Group“ väärtusi
- Üks XML-märgend iga erineva koodi kohta, mis on määratletud lubade „Attribute“ või „Dynamic Attribute“ vastenduses. Kui mitu autoriseerimist on konfigureeritud sama vastenduskoodiga, eksporditakse üks XML-märgend, mis sisaldab mitut väärtust.

## Identity eksport: kontod + autoriseerimised

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

- Objekti tüüp: valige väärtus „ACCOUNT“
- Hoidla: määrake selle hoidla kood, kust kontod ja autoriseerimised eksporditakse. Pange tähele, et kuigi tehniliselt on võimalik sisestada mitu hoidla koodi, tuleb ettevalmistuskonnektori õigeks toimimiseks kindlasti sisestada ainult üks.

**Tulemused ja suvandid:** eksporditakse kõik valitud hoidla kontod.

Iga konto kohta eksporditakse järgmised märgendid:

- ID = konto ID, kasutatakse värskendamisel ja kustutamisel
- Account_login = konto kasutajanimi
- password = konto parool, eksporditakse krüptitud kujul
- Account_provisioning = konto ettevalmistusolek:
    - 1: ainult teoreetiline konto
    - 2: orbkonto
    - 3: teoreetiline ja ette valmistatud konto
- Account_state = teoreetilise konto olek
    - -1: konto puudub (väärtus pole ekspordis võimalik)
    - 0: ainult teoreetiline konto
    - 1: aktiivne konto
    - 2: välja lülitatud konto
- Account_type = kontotüübi ID
- roles = kontoga seotud rollid
- Atribuudid ja load eksporditakse märgenditesse, mille nimed tulenevad konfiguratsioonist.

## Identity eksport: rollid

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

- Objekti tüüp: valige väärtus „ROLE“
- Hoidlad: määrake selle hoidla koodid, mille olemasolevad seotud rollid eksporditakse. Valikuline.

**Tulemused ja suvandid:** eksporditakse kõik olemasolevad rollid. Kui on määratud üks või mitu hoidlat, eksporditakse ainult nende hoidlatega seotud rollid.

Iga rolli kohta eksporditakse järgmised märgendid:

- id = rolli ID
- code = rolli kood
- name = rolli nimi
- description = rolli kirjeldus
- repositories = rolliga seotud hoidlate kood
- accountTypes = rolliga seotud kontotüüpide kood

## Identity eksport: autoriseerimised

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

- Objekti tüüp: valige väärtus „RIGHT“
- Hoidlad: määrake selle hoidla koodid, mille olemasolevad seotud autoriseerimised tuleb eksportida. Valikuline.

**Tulemused ja suvandid:** eksporditakse kõik olemasolevad autoriseerimised. Kui on määratud üks või mitu kindlat hoidlat, eksporditakse ainult nende hoidlatega seotud autoriseerimised.

Iga autoriseerimise kohta eksporditakse järgmised märgendid:

- Id = autoriseerimise ID
- code = autoriseerimiskood
- name = autoriseerimise nimi
- category = autoriseerimise kategooria kood
- application = autoriseerimise rakenduse kood
- repository = autoriseerimise hoidla kood
- type = autoriseerimise tüüp
    - 3 = group. Pange tähele, et seda tüüpi autoriseerimise kasutamine on alates versioonist 7.0 iganenud. Eelistage tüüpi „attribute“.
    - 6 = attribute
- mode = autoriseerimise režiim
    - 0 = staatiline. Staatiline väärtus, mis tuleb määrata märgendis „value“
    - 1 = dünaamiline: atribuudi väärtus, mis on määratud märgendis nimega „template#[object_type_code]“
- Märgendis „mappingCode“: kontode või isikutega seotud autoriseerimiste eksportimiseks kasutatava atribuudi nimi

## Identity eksport: identiteedid + rollid

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

- Objekti tüüp: valige väärtus „PERSON_ROLES“
- Hoidlad: määrake selle hoidla koodid, mille olemasolevad seotud rollid eksporditakse.

**Tulemused ja suvandid:** eksporditakse kõik valitud hoidlatega seotud identiteedi-rolli seosed.

Iga identiteedi-rolli seose kohta eksporditakse järgmised märgendid:

- person = identiteedi UID
- role = määratava rolli kood
- startdate = rolli alguskuupäev
- enddate = rolli lõppkuupäev
- id = identiteedi-rolli seose id

## Identity eksport: identiteedid + rollid + autoriseerimised

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

- Objekti tüüp: valige väärtus „PERSON_RIGHTS“
- Hoidlad: määrake hoidlakoodid, mille jaoks soovite luua identiteedi/rolli-autoriseerimise seoseid.

**Tulemused ja suvandid:** eksporditakse kõik valitud hoidlatega seotud identiteedi/rolli-autoriseerimise seosed.

Iga identiteedi/rolli-autoriseerimise seose kohta eksporditakse järgmised märgendid:

- person = identiteedi UID
- role = rolli kood
- right = autoriseerimiskood
- startdate = autoriseerimise alguskuupäev
- enddate = autoriseerimise lõppkuupäev
- id = identiteedi-rolli-autoriseerimise seose id
