Ga naar inhoud

Exportregels aanmaken/wijzigen

Een exportregel heeft tot doel om, op basis van een repository, de te exporteren objecten en hun locatie te bepalen. Bij een repository van het type directory moeten bijvoorbeeld de te exporteren objecten en de OU's waarin wordt gezocht, worden bepaald.

Elke export genereert een gegevensbestand in XML-formaat.

Er zijn twee mogelijke exportmodi, die naargelang het gebruiksscenario worden gekozen:

  • Volledig: alle objecten die aan de exportregels voldoen, worden naar het uitvoerbestand geëxporteerd. Het uitvoerbestand is in XML-formaat.
  • Afzonderlijk: export van één enkel object, gefilterd op de waarde van een attribuut.

Welke exportregels moeten worden geconfigureerd, verschilt per type repository.

Een repository van het type directory exporteren (LDAP, AD, AD/LDS, OpenLDAP enzovoort)

  • Objecttype: geef het type van het te exporteren object op (voorbeeld: user, classes enzovoort).
  • Zoekfilter: optioneel veld om filters toe te passen op de te exporteren objecten (voorbeeld: ”employeeID” niet leeg).
  • Afzonderlijk filter: attribuut waarmee een object wordt gefilterd door de waarde ervan vast te leggen.
  • Attributen: lijst van de attributen van de te exporteren objecten.
  • OU's: geef de OU's op waarin de objecten worden geëxporteerd.
  • Groepsfilters: lijst van de groepen die bij verwijderacties moeten worden beheerd of uitgesloten:
    • Als de optie ”Remove the groups instead of keeping them” niet is aangevinkt: de lijst van groepen geeft aan welke niet mogen worden verwijderd.
    • Als de optie ”Remove the groups instead of keeping them” is aangevinkt: de lijst van groepen geeft aan welke mogen worden verwijderd.

Resultaten en opties:

Elk attribuut wordt geëxporteerd in een XML-tag waarvan de naam de naam van het attribuut van de directory is. Het standaardformaat van de geëxporteerde gegevens is een tekenreeks.

Voor elk attribuut kan een ander type worden opgegeven, met de volgende keuzes:

  • Binary
  • Date
  • Date_Filetime

Om het exportformaat te wijzigen, selecteer het gewenste attribuut en klik op de knop ”Modify”.

Een repository van het type plat bestand exporteren (CSV)

  • Attributen: lijst van de kolommen waaruit het platte bestand bestaat (het bestand wordt bij het aanmaken van de repository bepaald).
    • Klik op ”Add” om een vermelding toe te voegen.
    • Selecteer een attribuut om het te wijzigen of te verwijderen.
    • Als het CSV-bestand kolomkoppen heeft, kunt u op de knop ”Get Column Name” klikken om de kolomnamen automatisch over te nemen.
  • Vergelijkingsattribuut voor een gefilterde zoekopdracht: kolom waarmee één enkel object kan worden geëxporteerd door de waarde ervan vast te leggen.

Resultaten en opties:

Elk attribuut wordt geëxporteerd in een XML-tag waarvan de naam die van het opgegeven attribuut is. Het standaardformaat van de geëxporteerde gegevens is een tekenreeks.

Voor elk attribuut kan een ander type worden opgegeven, met de volgende keuzes:

  • Binary
  • Date
  • Date_Filetime

Om het exportformaat te wijzigen, selecteer het gewenste attribuut en klik op de knop ”Modify”.

Een repository van het type database exporteren (SQL Server, Oracle enzovoort)

  • Objecttype: indicatieve waarde, zonder gevolg voor de configuratie
  • SQL-query: query waarmee alle gewenste gegevens worden opgehaald
  • Afzonderlijk filter: query waarin een filter is opgegeven om slechts één resultaat terug te geven
  • Attributen: kader dat is bedoeld om SQL-query's toe te voegen waarmee aanvullende gegevens worden geëxporteerd. Elke query kan slechts één attribuut exporteren, maar dat attribuut kan meerwaardig zijn (query's die meerdere regels teruggeven)
  • Optie meerregelig: optie die moet worden aangevinkt wanneer een van de geëxporteerde attributen van de hoofdquery meerwaardig is. De naam van dit attribuut moet in het veld ”Multiline Matching Attribute” worden opgegeven. In de hoofdquery kan er slechts één meerwaardig attribuut zijn.

Belangrijke opmerking: als deze optie is aangevinkt, moet in de query beslist een ”order by” worden uitgevoerd om te sorteren op het attribuut dat in het veld ”Multiline Matching Attribute” is opgegeven.

Resultaten en opties:

Elke in de query bepaalde kolom wordt geëxporteerd in een XML-tag waarvan de naam die van de opgegeven kolom is. Het formaat van de geëxporteerde gegevens is een tekenreeks.

Een repository van het type API exporteren (protocol REST – SIM)

  • Objecttype: klik op de knop ”Get Object Type List” om de lijst op te halen van de objecten die de repository van de applicatie beschikbaar stelt voor export.
  • Mappingattribuut: klik op de knop ”Get Attributes List” om de lijst van de beschikbare attributen op te halen. De lijst van attributen hangt af van het geselecteerde objecttype.
  • Klik op de knop ”Set” om de bijwerkingen te bevestigen.

Resultaten en opties:

Elk attribuut dat is bepaald in het objecttype dat de API teruggeeft, wordt geëxporteerd in een XML-tag. Het formaat van de geëxporteerde gegevens is een tekenreeks.

Een XML-repository exporteren

Om een XML-repository te exporteren, moet een XSLT-actie worden uitgevoerd.

XML-bestanden kunnen verschillende structuren hebben; daarom moet een transformatiebestand worden gemaakt om het om te zetten naar een XML-formaat dat verenigbaar is met de provisioningengine SIP.

Identity-export: identiteiten

  • Objecttype: voer de waarde ”USERS” in
  • Persoonstype: geef de code op van de persoonstypen die uit de Identity-repository moeten worden geëxporteerd
  • Vergelijkingsattribuut voor de afzonderlijke export: ”personne_uid”

Resultaten en opties:

Voor elke identiteit worden alle attributen die een waarde hebben automatisch geëxporteerd naar een XML-tag waarvan de naam de code van het attribuut is. Het formaat van de geëxporteerde gegevens is een tekenreeks.

Identity-export: enumeraties

  • Objecttype: voer de waarde ”ENUMERATIONS” in
  • Codelijst: code van de enumeraties die uit de Identity-repository moeten worden geëxporteerd; er kunnen meerdere enumeraties tegelijk worden geëxporteerd.

Voor enumeraties wordt geen afzonderlijke export ondersteund.

Resultaten en opties:

Voor elke enumeratie worden de volgende tags geëxporteerd:

  • Type = code van het attribuut (of code van het enumeratietype) dat de lijst van waarden bevat
  • Code = code van een waarde van de enumeratie
  • Name = label dat aan de code is gekoppeld
  • Description = beschrijving van de waarde van de enumeratie. Deze gegevens zijn optioneel en worden alleen geëxporteerd als ze niet leeg zijn.

Het formaat van de geëxporteerde gegevens is een tekenreeks.

Identity-export: mappingtabellen

  • Objecttype: voer de waarde ”MATCHINGTABLE” in
  • Codelijst: code van de mappingtabellen die uit de Identity-repository moeten worden geëxporteerd; er kunnen meerdere mappingtabellen tegelijk worden geëxporteerd.

Voor mappingtabellen wordt geen afzonderlijke export ondersteund.

Resultaten en opties:

Voor elke mappingtabel worden de volgende tags geëxporteerd:

  • Type = code van het type mappingtabel
  • Key = sleutel van de mappingtabel
  • Value = waarde of waarden die aan de sleutel zijn gekoppeld. De waarde kan meerwaardig zijn.
  • Description = beschrijving van de waarde van de mappingtabel. Deze gegevens zijn optioneel en worden alleen geëxporteerd als ze niet leeg zijn.

Het formaat van de geëxporteerde gegevens is een tekenreeks.

Identity-export: toewijzingen (resources)

  • Objecttype: voer de waarde ”OBJECTS” in
  • Codelijst: geef de code op van de types toewijzingen (resources) die uit de Identity-repository moeten worden geëxporteerd
  • Optie om de structuren te exporteren die een koppeling met de toewijzing hebben
  • Optie om de identiteiten te exporteren die een koppeling met de toewijzing hebben
  • Vergelijkingsattribuut voor de afzonderlijke export: ”object_instance_code”

Resultaten en opties:

Voor elke toewijzing (resource) worden alle attributen die een waarde hebben automatisch geëxporteerd naar een XML-tag waarvan de naam de code van het attribuut is. Het formaat van de geëxporteerde gegevens is een tekenreeks.

Identity-export: provisioningstatussen

  • Objecttype: voer de waarde ”STATUS” in
  • Repository: code van de repository waaruit u de personen en hun bijbehorende accounts wilt exporteren. Let erop dat die code uniek moet zijn om correct te werken.
  • Vergelijkingsattribuut voor de afzonderlijke export: ”Account.login”

Resultaten en opties:

Voor elk account van de repository worden de volgende tags geëxporteerd:

  • Account.Id: id van het account
  • Account.login: login van het account. Wordt voor de vergelijking gebruikt
  • Account.state: provisioningstatus van het account (0: niet geprovisioneerd, 1: geprovisioneerd)
  • Person.Id: identificatie van de hoofdpersoon
  • Person.uniqueId: UID van de hoofdpersoon
  • Voor elke autorisatie die aan het account is gekoppeld:
    • [code_mapping_right]#right.id: informatietag waarmee de lijst van identificaties van de autorisaties wordt opgehaald die de mappingcode hebben die in het eerste deel van de tag is opgegeven. Meerdere waarden zijn mogelijk.
    • [code_mapping_right]#[right.id]: één tag van dit type per autorisatie die de mappingcode heeft die in het eerste deel van de tag is opgegeven. Bevat de waarde van de autorisatie
    • [code_mapping_right]: informatietag waarmee de lijst van autorisatiewaarden wordt opgehaald die de mappingcode hebben die in het eerste deel van de tag is opgegeven. Meerdere waarden zijn mogelijk.
    • [code_mapping_right]#state: lijst van de provisioningstatussen van elke autorisatie die de mappingcode heeft die in het eerste deel van de tag is opgegeven.

Het formaat van de geëxporteerde gegevens is een tekenreeks.

Identity-export: structuren

  • Objecttype: voer de waarde ”STRUCTURES” in
  • Codelijst: geef de code op van de structuurtypen die uit de Identity-repository moeten worden geëxporteerd
  • Vergelijkingsattribuut voor de afzonderlijke export: ”structure_code”

Resultaten en opties:

Voor elke structuur worden alle attributen die een waarde hebben automatisch geëxporteerd naar een XML-tag waarvan de naam de code van het attribuut is. Het formaat van de geëxporteerde gegevens is een tekenreeks.

Identity-export: identiteiten + autorisaties

  • Objecttype: voer de waarde ”USERS+ACCESS” in
  • Repository: code van de repository waaruit u de personen en hun bijbehorende accounts wilt exporteren. Let erop dat die code uniek moet zijn om correct te werken.
  • Persoonstype: geef de code op van de persoonstypen die uit de Identity-repository moeten worden geëxporteerd
  • Vergelijkingsattribuut voor de afzonderlijke export: ”personne_uid”

Resultaten en opties:

Voor elke identiteit worden alle attributen die een waarde hebben automatisch geëxporteerd naar een XML-tag waarvan de naam de code van het attribuut is. Het formaat van de geëxporteerde gegevens is een tekenreeks.

Als de identiteit een account heeft in de opgegeven repository, worden er extra XML-tags geëxporteerd:

  • HPPAccountLogin
  • HPPAccountPwd
  • HPPAccountState

Als de identiteit autorisaties heeft op de opgegeven repository, worden er extra XML-tags geëxporteerd:

  • HPPAccessRight, dat alle waarden van de autorisaties ”Group” en ”Dynamic Group” bevat
  • Eén XML-tag per verschillende code die in de mapping van de autorisaties ”Attribute” of ”Dynamic Attribute” is bepaald. Als meerdere autorisaties met dezelfde mappingcode zijn geconfigureerd, wordt één enkele XML-tag geëxporteerd met daarin meerdere waarden.

Identity-export: accounts + autorisaties

  • Objecttype: selecteer de waarde ”ACCOUNT”
  • Repository: geef de code op van de repository waaruit de accounts en de autorisaties moeten worden geëxporteerd. Let erop dat het technisch weliswaar mogelijk is meerdere repositorycodes op te geven, maar dat er beslist slechts één moet worden opgegeven om de provisioningconnector correct te laten werken.

Resultaten en opties: alle accounts van de geselecteerde repository worden geëxporteerd.

Voor elk account worden de volgende tags geëxporteerd:

  • ID = identificatie van het account, te gebruiken voor bijwerkingen en verwijderingen
  • Account_login = login van het account
  • password = wachtwoord van het account, versleuteld geëxporteerd
  • Account_provisioning = provisioningstatus van het account:
    • 1: uitsluitend theoretisch account
    • 2: verweesd account
    • 3: theoretisch en geprovisioneerd account
  • Account_state = status van het theoretische account
    • -1: geen account (waarde die bij een export niet mogelijk is)
    • 0: uitsluitend theoretisch account
    • 1: actief account
    • 2: uitgeschakeld account
  • Account_type = identificatie van het accounttype
  • roles = rollen die aan het account zijn gekoppeld
  • De attributen en de autorisaties worden geëxporteerd in tags waarvan de naam uit de configuratie voortkomt.

Identity-export: rollen

  • Objecttype: selecteer de waarde ”ROLE”
  • Repositories: geef de codes op van de repository waarvan de bestaande gerelateerde rollen moeten worden geëxporteerd. Optioneel.

Resultaten en opties: alle bestaande rollen worden geëxporteerd. Als een of meer repositories worden opgegeven, worden alleen de rollen geëxporteerd die met die repositories verband houden.

Voor elke rol worden de volgende tags geëxporteerd:

  • id = identificatie van de rol
  • code = code van de rol
  • name = naam van de rol
  • description = beschrijving van de rol
  • repositories = code van de repositories die aan de rol zijn gekoppeld
  • accountTypes = code van de accounttypen die aan de rol zijn gekoppeld

Identity-export: autorisaties

  • Objecttype: selecteer de waarde ”RIGHT”
  • Repositories: geef de codes op van de repository waarvan de bestaande gerelateerde autorisaties moeten worden geëxporteerd. Optioneel.

Resultaten en opties: alle bestaande autorisaties worden geëxporteerd. Als een of meer specifieke repositories worden opgegeven, worden alleen de autorisaties geëxporteerd die met die repositories verband houden.

Voor elke autorisatie worden de volgende tags geëxporteerd:

  • Id = identificatie van de autorisatie
  • code = code van de autorisatie
  • name = naam van de autorisatie
  • category = code van de categorie van de autorisatie
  • application = code van de applicatie van de autorisatie
  • repository = code van de repository van de autorisatie
  • type = type van de autorisatie
    • 3 = group. Let erop dat het gebruik van dit type autorisatie vanaf versie 7.0 is uitgefaseerd. Geef de voorkeur aan het type ”attribute”.
    • 6 = attribute
  • mode = modus van de autorisatie
    • 0 = statisch. Statische waarde die in de tag ”value” moet worden opgegeven
    • 1 = dynamisch: waarde van een attribuut dat is opgegeven in de tag met de naam ”template#[object_type_code]”
  • De naam van het attribuut waarmee de aan de accounts of aan de personen gekoppelde autorisaties worden geëxporteerd, in de tag ”mappingCode”

Identity-export: identiteiten + rollen

  • Objecttype: selecteer de waarde ”PERSON_ROLES”
  • Repositories: geef de codes op van de repository waarvan de bestaande gerelateerde rollen moeten worden geëxporteerd.

Resultaten en opties: alle koppelingen identiteit-rol die met de geselecteerde repositories verband houden, worden geëxporteerd.

Voor elke koppeling identiteit-rol worden de volgende tags geëxporteerd:

  • person = UID van de identiteit
  • role = code van de toe te kennen rol
  • startdate = begindatum van de rol
  • enddate = einddatum van de rol
  • id = identificatie van de koppeling identiteit-rol

Identity-export: identiteiten + rollen + autorisaties

  • Objecttype: selecteer de waarde ”PERSON_RIGHTS”
  • Repositories: geef de repositorycodes op waarvoor u de koppelingen identiteit/rol-autorisatie wilt aanmaken.

Resultaten en opties: alle koppelingen identiteit/rol-autorisatie die met de geselecteerde repositories verband houden, worden geëxporteerd.

Voor elke koppeling identiteit/rol-autorisatie worden de volgende tags geëxporteerd:

  • person = UID van de identiteit
  • role = code van de rol
  • right = code van de autorisatie
  • startdate = begindatum van de autorisatie
  • enddate = einddatum van de autorisatie
  • id = id van de koppeling identiteit-rol-autorisatie