M42 CoreProIGA kontakt
Hur man integrerar Matrix42 Core , Pro eller IGA lösningen med en annan instans av Matrix42 Core , Pro eller IGA -lösningen
M42 CoreProIGA kontakt
Hur man integrerar Matrix42 Core , Pro eller IGA lösningen med en annan instans av Matrix42 Core , Pro eller IGA -lösningen
M42 CoreProIGA kontakt
M42 CoreProIGA Connector (tidigare Efecte Connector / Efecte ESM-connector) är en del av Connector Management Native Connectors och används för att läsa/skriva datakort till en annan Matrix42 Core , Pro eller IGA lösning. Den kan användas för alla Matrix42 Core , Pro eller IGA -lösningar som använder Pro Engine.
M42 CoreProIGA -kontakten kräver konfiguration enligt kundens användningsfall, och i princip har konfigurationen tre (3) steg:
- Konfigurera kontakt – gör det möjligt för kontakten att upprätta anslutning till mållösningen Matrix42 Core Pro IGA
- Konfigurera schemalagd uppgift – används när data läses från mållösningen Matrix42 Core Pro IGA
- Konfigurera händelseuppgift – används när data skrivs till mållösningen Matrix42 Core Pro IGA
- Även arbetsflödesorkestreringsnoder måste konfigureras (skapa/uppdatera/ta bort datakort)
Viktigt att veta!
Med M42 CoreProIGA kontakten måste du vara extra uppmärksam så att du inte skapar en oändlig loop mellan två Matrix42 Core Pro IGA lösningar. Detta kan hända när data skrivs till en annan Matrix42 Core Pro IGA lösning och arbetsflödesorkestreringsnoden inte är konfigurerad för en av de fördröjande aktiviteterna:
Timer
Godkännande
Väntevillkor
Manuell uppgift (om noden inte markeras direkt som klar när den återställs)
Instruktioner för 2024.2 och senare versioner
Allmänna funktioner
Kontakter - allmänna funktioner
Kontakter - allmänna funktioner
I den här artikeln beskrivs allmänna funktioner för att hantera nativa kopplingar i lösningen. Alla nativa kopplingar hanteras från samma gränssnitt för kopplingshantering.
Observera att det finns separata beskrivningar för varje kontakt, där kontaktspecifika funktioner och konfigurationsinstruktioner beskrivs i detalj.
För att kunna komma åt hantering av anslutningar måste användaren ha administratörsbehörighet till kundens plattformskonfiguration. När åtkomst beviljas korrekt visas fliken för anslutningar och användaren kan hantera anslutningar.
Vänstermeny
Hantering av kopplingar är indelat i fyra flikar:
- Översikt – för att skapa och uppdatera Native Connectors. Administratörsanvändaren kan se sin status, typ och hur många schemalagda uppgifter eller händelseuppgifter som är kopplade till dem.
- Autentisering – för att skapa och uppdatera autentiseringsuppgifter. Pro tillhandahållandeuppgift för autentisering behövs för att Secure Access ska kunna definiera vilka kunders slutanvändare som har åtkomst till Matrix42 Core , Pro and IGA inloggningssidorna.
- Loggar – för att ladda ner Native Connector- och Secure Access loggar från användargränssnittet.
- Inställningar – allmänna inställningar för Native Connectors och Secure Access , inklusive miljötyp för loggning och övervakning.
Fliken Översikt över kontakter
Från översiktssidan kan användaren enkelt och snabbt se status för alla kopplingar.
Övre fältet:
- Status för inbyggda kopplingar (EPE)
- Grön text indikerar att Native Connectors är online. Alla nödvändiga tjänster är igång.
- Röd text indikerar att det är ett problem med Native Connectors, att alla tjänster inte körs.
- Status för Secure Access ( ESA )
- Grön text indikerar att Secure Access är online. Alla nödvändiga tjänster är igång.
- Röd text indikerar att det är ett problem med Secure Access , att alla tjänster inte körs.
- Versionsnumret för Native Connectors visas i det övre högra hörnet
Övre fältet för listvy:
- Ny koppling – öppnar ett nytt fönster för att lägga till och konfigurera en ny koppling
- Ta bort koppling(ar) – arbetsflödesreferenser beräknas och ett popup-fönster visas för att bekräfta borttagningen (observera att beräkningen av referenser kan ta flera sekunder)
- Exportera – Administratören kan exportera en eller flera kopplingar (och uppgifter) från miljön. Används vanligtvis för att exportera kopplingar och kopplingar (och uppgifter) från test till produkt. Hemlig information om inbyggda kopplingar är lösenordsskyddad.
- Importera – Administratören kan importera en eller flera kopplingar (och uppgifter) till miljön. Används vanligtvis för att importera kopplingar (och uppgifter) från test till prod.
- Administratören kan inte importera från det gamla EPE-gränssnittet (äldre än 2024.1) till det nya. Käll- och målmiljöer måste ha samma version.
- Importen misslyckas om konfigurationen (mallar, attribut) inte är densamma - till exempel när något attribut saknas.
- Om du importerar något med samma kopplingsdetaljer kommer det att slås samman under befintlig koppling
- Uppdatera – Administratören kan uppdatera kopplingsvyn genom att klicka på knappen .
Listvy för översikt,
- Välj kontakt(er) - Välj en kontakt genom att klicka på kryssrutan framför kontaktraden eller genom att klicka på kryssrutan i rubrikraden markeras alla kontakter.
- Id - Automatiskt genererat unikt ID för kopplingen. Kan inte redigeras eller ändras.
- Status - indikerar status för schemalagd uppgift
-
Grön bockmarkering - Uppgiften utförs utan fel
-
Röda korset - Uppgiften är utförd, men det har uppstått fel
-
Grå klocka - Uppgiften är inte utförd än, väntar på schemaläggning -
Orange - en av uppgifterna har ett problem
- Inget värde - Schemalagd uppgift saknas
-
- Namn - Anslutningsnamn tillagt i anslutningsinställningar. Unikt namn på anslutningskonfigurationen för en datakälla.
- Typ - indikerar mål-/källsystem
- Schemalagd – informerar hur många schemalagda uppgifter som är konfigurerade
- Händelse - informerar hur många händelseuppgifter som är konfigurerade
- Hantera
- Pennikon – öppnar kopplingsinställningar (dubbelklicka på kopplingsraden, även inställningarna öppnas)
- Pappersikon – kopierar kopplingen
- Stopp - arbetsflödesreferenser beräknas och ett popup-fönster visas för att bekräfta borttagningen.
- Sök – Användaren kan söka efter kopplingar genom att ange söktermen i motsvarande fält. Fälten Id, Status, Namn, Typ, Schemalagd och Händelse kan sökas.
Information om schemalagda uppgifter (klicka på pilen framför kopplingen)
När du klickar på pilen i början av kopplingsraden visas alla relaterade schemalagda uppgifter och händelseuppgifter.
Övre fältet för schemalagda uppgifter
- Ny uppgift – öppnar konfigurationssidan för ny uppgift
- Ta bort uppgift(er) – tar bort den/de valda uppgiften/uppgiftarna från systemet och de kan inte längre återställas.
- Uppdatera - uppdatera vyn över schemalagda uppgifter
- Sök – användaren kan söka efter uppgiften genom att ange söktermen i motsvarande fält för Id, namn, aktiverad, extraktions-/laddningsstatus.
Listvy för schemalagda uppgifter
- Välj uppgift(er) – Markera den uppgift som ska tas bort från listvyn genom att markera.
- Id - Unikt ID för uppgiften. Genereras automatiskt och kan inte ändras.
- Namn - Uppgiftsnamn som läggs till i uppgiftsinställningarna, unikt namn för uppgiften.
- Aktiverad - Visar om uppgiften är schemalagd eller inte
-
Grön bockmarkering – Uppgiften är schemalagd
-
Röda korset - Uppgiften är inte schemalagd
-
- Extraheringsstatus – Visar status för dataextrahering från målkatalogen/systemet
- Grön bockmarkering - data har extraherats
- Röda korset - data extraheras med fel eller extraheringen misslyckades
-
Klocka - Uppgiften väntar på körning
-
- Laddningsstatus - Visar status för dataexport från json-fil till kundens lösning
- Grön bockmarkering - data har importerats till kundens lösning
-
Rött kors - data importeras med fel eller importen misslyckades
-
- Hantera
- Pennikon – öppnar aktivitetsinställningar i ett eget fönster (dubbelklick på aktivitetsraden öppnar även aktivitetsinställningar)
- Pappersikon - kopierar uppgiften
- Klockikon – öppnar vyn för uppgiftshistorik
- Stopp - ta bort uppgift, popup-fönster öppnas för att bekräfta borttagningen
Vy över schemalagd uppgiftshistorik
Genom att klicka på klockikonen i raden för schemalagda uppgifter visas historiken för schemaläggningen.
Övre fältet för visningshistorik
- Uppdatera – uppdaterar statusen för schemalagda uppgifter. Detta påverkar inte uppgiften, det uppdaterar bara användargränssnittet för att visa den senaste informationen om den körda uppgiften.
Listvy för historik över schemalagda uppgifter
- Radens färg anger status
- Grön - uppgiften har utförts
- Röd - fel uppstod under körning
-
- Körnings-ID - unikt ID för den schemalagda uppgiftsraden
- Planerad extraktionstid - när nästa extraktion från katalogen/applikationen är schemalagd att ske
- Utdragets slutförande tid - när utdraget slutfördes
- Extraheringsstatus - status för att hämta data från katalogen/applikationen
- Starttid för laddning – när nästa laddning till kundens lösning är schemalagd
- Lastningstid - när lastningen var klar
- Laddningsstatus - status för laddning av information till kundens lösning
Listvy för status för schemalagd uppgift
- Faktisk starttid - tidsstämpel för faktisk start
- Användarfil - JSON-fil som innehåller användarinformation läst från katalogen/applikationen
- Gruppfil - JSON-fil som innehåller gruppinformation läst från katalogen/applikationen
- Generisk fil - JSON-fil som innehåller generisk information läst från katalogen/applikationen
- Extrahera information - detaljerad information om att läsa information från katalogen/applikationen
- Ladda information - detaljerad information om hur informationen laddas till kundernas Matrix42 Core , Pro and IGA -lösningar
Redigera fönster för schemalagd uppgift
Konfigurationen för schemalagd uppgift kan öppnas genom att klicka på pennikonen eller dubbelklicka på uppgiftsraden.
Vänstermeny och attribut varierar beroende på valda alternativ och därför kan mer detaljerade instruktioner för att redigera uppgifter hittas i kopplingens beskrivning, men det finns gemensamma funktioner för alla schemalagda uppgifter som beskrivs nedan.
Sparar uppgiften
Om obligatorisk information saknas i uppgiften, kommer muspekaren över spara-knappen att visa vilka attribut som fortfarande är tomma.
Övre fältet för att redigera schemalagd uppgift
- Kör uppgift manuellt – administratören kan köra uppgiften manuellt utanför den definierade schemaläggningen
- Stoppa uppgift – administratören kan stoppa en schemalagd uppgift som för närvarande körs. Uppgiften stoppas och statusen ändras till stoppad. Den väntar i detta tillstånd tills nästa tidpunkt inträffar.
- Rensa datacachen – Datacachen för nästa provisionering av användare och grupper kommer att rensas. Det betyder att nästa körning körs som förstagångskörning.
- Som standard rensar vi cachen varje dag klockan 00:00 UTC
- Om du vill rensa cachen vid en annan tidpunkt måste du ange ett annat värde i värdfilen 'custom.properties'.
- EPE-cachen rensas också när EPE startas om, hela miljön startas om och EPE-mappningar har ändrats.
Information om händelseuppgift
När du klickar på pilen i början av kopplingsraden visas alla relaterade schemalagda uppgifter och händelseuppgifter.
Översta fältet för händelseuppgifter
- Ny uppgift – öppnar konfigurationssidan för ny händelseuppgift
- Ta bort uppgift(er) - tar bort markerade uppgifter, ett popup-fönster visas för att bekräfta borttagningen.
- Uppdatera - uppdaterar vyn för händelseuppgifter
- Visa arbetsflödesreferenser – beräknar arbetsflödesrelationer och statusar för uppgifter. Detta är mycket användbart om du inte vet från vilka arbetsflöden händelsebaserade uppgifter används.
Listvy för händelseuppgifter
- Välj uppgift(er) – Markera den uppgift som ska tas bort från listvyn genom att markera.
- Id - Unikt ID för uppgiften. Genereras automatiskt och kan inte ändras.
- Namn - Uppgiftsnamn som läggs till i uppgiftsinställningarna, unikt namn för uppgiften.
- Arbetsflödesrelationer
- Frågetecknet visar ett popup-fönster med detaljerad information om referensen
- Arbetsflödesstatus
- Används inte - Inga relationer till arbetsflödet
- Används - Arbetsflöde(n) kopplade till uppgift, uppgiften kan inte tas bort
- Hantera
- Pennikon - öppnar aktivitetsinställningar i eget fönster
- Pappersikon - kopierar uppgiften
- Stoppikon – tar bort uppgiften, ett popup-fönster visas för att bekräfta borttagningen
Redigera fönster för händelseuppgift
Konfigurationen för händelseuppgiften kan öppnas genom att klicka på pennikonen eller dubbelklicka på uppgiftsraden.
Vänstermeny och attribut varierar beroende på valda alternativ och därför kan mer detaljerade instruktioner för redigering av uppgifter hittas i kopplingbeskrivningen, men det finns gemensamma funktioner för alla händelseuppgifter som beskrivs nedan.
Redigera händelseuppgiftsfönstret
- Uppgiftsanvändning, redigerbar? – detta visas när du redigerar en befintlig uppgift och ändrar uppgiftsanvändningstypen kommer att avbryta arbetsflöden
- Mappningstyp, redigerbar? - detta visas när du redigerar en befintlig uppgift och ändring av mappningstypen kommer att avbryta arbetsflöden.
Sparar uppgiften
Om obligatorisk information saknas i uppgiften, kommer muspekaren över spara-knappen att visa vilka attribut som fortfarande är tomma.
Fliken Autentisering
Autentisering för Matrix42 Core , Pro and IGA -lösningar konfigureras från fliken autentisering. Observera att endast vissa av kopplingarna (katalogkopplingar) stöder autentisering, så det är inte möjligt att skapa autentiseringsuppgifter för alla tillgängliga kopplingar.
Övre fältet för autentisering
- Ny koppling – öppnar ett nytt fönster för att konfigurera den nya kopplingen (observera att inte alla kopplingar stöder autentisering)
- Ta bort koppling(ar) – tar bort markerade uppgifter, ett popup-fönster visas för att bekräfta borttagningen.
- Exportera - användaren kan exportera en eller flera uppgifter från miljön. Används vanligtvis för att exportera uppgifter från test till prod. EPE-kontakter är lösenordsskyddade.
- Observera att Realm för autentiseringsuppgifter inte exporteras, du måste ställa in det manuellt efter importen.
- Importera - användaren kan importera en eller flera uppgifter till miljön. Används vanligtvis för att importera uppgifter från test till prod.
- Uppdatera - uppdaterar vyn för autentiseringsuppgifter
Listvy för autentiseringsöversikt
- Välj kontakt(er) - Välj en kontakt genom att klicka på kryssrutan framför kontaktraden eller genom att klicka på kryssrutan i rubrikraden markeras alla kontakter.
- Id - Automatiskt genererat unikt ID för kopplingen. Kan inte redigeras eller ändras.
- Namn - Anslutningsnamn tillagt i anslutningsinställningar. Unikt namn på anslutningskonfigurationen för en datakälla.
- Typ - indikerar mål-/källsystem
- Antal – anger hur många autentiseringsuppgifter som är konfigurerade
- Hantera
- Pennikon - öppnar inställningen för autentiseringsuppgift i ett eget fönster
- Pappersikon - kopierar uppgiften
- Stoppikon – tar bort vald uppgift
Information om autentiseringsuppgift
När du klickar på pilen i början av kopplingsraden visas alla relaterade schemalagda uppgifter och händelseuppgifter.
Översta fältet för autentiseringsöversikt
- Skapa ny uppgift – öppnar konfigurationssidan för ny autentiseringsuppgift
- Ta bort uppgift(er) - tar bort markerade uppgifter, ett popup-fönster visas för att bekräfta borttagningen.
- Uppdatera - uppdaterar vyn för autentiseringsuppgifter
Listvy för autentiseringsöversikt,
- Välj uppgift(er) – Markera den uppgift som ska tas bort från listvyn genom att markera.
- Id - Unikt ID för uppgiften. Genereras automatiskt och kan inte ändras.
- Namn - Uppgiftsnamn som läggs till i uppgiftsinställningarna, unikt namn för uppgiften.
- Hantera
- Pennikon – öppnar aktivitetsinställningar i ett eget fönster (dubbelklicka på aktivitetsraden, öppnar även inställningsfönstret)
- Pappersikon - kopierar uppgiften
- Stoppikon – tar bort uppgiften, ett popup-fönster visas för att bekräfta borttagningen
Fliken Loggar
Fliken Loggar är för att ladda ner loggar för Native Connector och Secure Access från användargränssnittet för detaljerad felsökning.
- epe-master- loggar - innehåller varnings-, felsöknings- och felnivåmeddelanden om Native Connectors och information om hur länge uppgiftsåtgärder har vidtagits.
- epe-worker-ad -loggar - innehåller extraheringsdata för Active Directory anslutningen (vad Native Connector laddar till kundernas Matrix42 Core , Pro and IGA lösningar). Om valet är tomt betyder det att katalogen inte används i den här miljön.
- epe-worker-azure -loggar – innehåller extraheringsdatastatus för Entra ID (vad Native Connector laddar till kundernas Matrix42 Core , Pro and IGA lösningar). Om valet är tomt betyder det att katalogen inte används i den här miljön.
- epe-worker-ldap- loggar - innehåller extraheringsdata för LDAP (vad Native Connector laddar till kundernas Matrix42 Core , Pro and IGA lösningar). Om valet är tomt betyder det att katalogen inte används i den här miljön.
- epe-launcher- loggar - innehåller information om EPE-uppskjutningar
- datapump-itsm l ogs - Innehåller information om dataexport till kunders Matrix42 Core , Pro and IGA lösningar.
- esa -loggar – Innehåller information om Secure Access åtkomstautentisering.
Inställningsfliken
Inställningsflikar används för att övervaka miljöer med kopplingar.
- Miljötyp - är obligatorisk att vara vald och information används till exempel för att definiera varningar kritiskt.
- Test – välj detta när din miljö används som testmiljö
- Pro d – välj detta när din miljö används som produktionsmiljö
- Demo – välj detta när din miljö används som demo- eller utbildningsmiljö
- Utvecklare – välj detta när din miljö används som utvecklingsmiljö
Vad övervakar vi?
- Fel i schemalagd provisionering (extrahering av data, export av data till ESM, föråldrade certifikat, felaktiga lösenord, felaktig sökbas/filter, felaktiga mappningar etc.)
- Fel i händelsebaserad provisionering (misslyckades med att skriva till AD / Azure , etc.)
- Händelsebaserad provisionering – vilka kopplingar används för att skriva data till program/kataloger.
- ESA fler än tio misslyckade inloggningsförsök till en användare under de senaste 3 dagarna
- Miljötyp - är obligatorisk att vara vald och information används till exempel för att definiera varningar kritiskt.
Datamigreringar
Klicka inte på ”Migrera attributmappningar” eller ”Migrera arbetsflöden” om du inte begär det av Matrix42 .
Konfigurera Efecte-anslutning
I det här kapitlet beskrivs konfigurationsinstruktioner för hur Efecte-anslutningen ska kunna anslutas till en annan Efecte-lösning.
Kontrollera med hjälp av bilden hur två Efecte-lösningar heter, så att det blir lättare att följa instruktionerna.
För att få åtkomst till kopplingshantering måste användaren ha behörighet till Efecte Platform-konfigurationen.
1. Öppna administrationsområdet för Efecte (en kugghjulssymbol).
2. Öppna kopplingsvyn.
3. Välj ny kontakt
4. Välj datakälltyp som ska vara Efecte
5. Fyll i information relaterad till Efecte 1 -lösningen
- Anslutningsnamn - ge din anslutning ett vänligt namn (namnet kan ändras i efterhand)
- Värd-URL - värdadressen som kommer att användas för att ansluta till Efecte-lösningen
- Användarnamn - Efecte 1-lösningens webb- API användarnamn
- Lösenord - Efecte 1-lösning Web API användares lösenord
6. Fyll i information relaterad till Efecte 2- lösningen
- Web API användare - Efecte 2-lösningens webb API användarnamn
- Lista över alla lokala Efecte-användare
- Lösenord för webb API – Efecte 2-lösningar Lösenord för webb- API användare
7. Spara kontaktinformation.
7. När du har sparat kontaktinformationen kan du trycka på knappen Testa anslutning och testa om kontakten kan ansluta till mållösningen från Efecte.
9. Om du redigerar befintliga kopplingsdetaljer, kom ihåg att spara dina ändringar och testa anslutningen efter det.
Allmän uid för schemalagda uppgifter
General g uid ance for scheduled tasks
How to Create New Scheduled Task to import data
For configuring scheduled-based provisioning task, you will need access to Administration / Connectors tab.
1. Open the Administration area (a cogwheel symbol).
2. Open Connectors view.
3. Choose Connector for Scheduled-based task and select New Task
Note! If connector is not created, you have to choose first New connector and after that New task.
4. Continue with connector specific instructions: Native Connectors
Should I use Incremental, Full or Both?
Scheduled task can be either Incremental or Full -type.
Do not import permissions with AD and LDAP incremental task
Incremental task has issue with permissions importing. At the moment it is recommended not to import group memberships with incremental scheduled task.
On Microsoft Active Directory and OpenLDAP connectors, remove this mapping on incremental task:
Setting on Scheduled tasks:
Incremental type is supported only for Microsoft Active Directory, LDAP and Microsoft Graph API (formerly known as Entra ID) Connectors.
Incremental type means, that Native Connectors (EPE) fetches data from source system, using changed timestamp information, so it fetches only data which is changed or added after previous incremental task run.
When Incremental type task is run for very first time, it does a full fetch (and it marks the current timestamp to EPE database), thereafter, task uses that timestamp to ask the data source for data that changed since that timestamp (and then EPE updates the timestamp to EPE database for next task run). Clearing task cache doesn't affect this timestamp, so Incremental task is always incremental after first run.
Full type is supported for all Connectors.
Full type import fetches always all data (it's configured to fetch) from source system, on every run.
Both Full and Incremental type tasks use also Task cache in EPE, which makes certain imports faster and lighter for M42 system.
By default that task cache is cleared ad midnight UTC time. When cache is cleared, next import after that is run without caching used to reason if data fetched should be pushed to ESM, all fetched data is pushed to ESM. But after that, next task runs until next time cache is cleared, are using EPE cache to determine if fetched data needs to be pushed to ESM or not.
You can configure at what time of day task cache is emptied, by changing global setting in EPE datapump configuration:
/opt/epe/datapump-itsm/config/custom.properties
which is by default set to: clearCacheHours24HourFormat=0
You can also clear cache many times a day, but that needs to be thinked carefully, as it has impact on overall performance as EPE will push changes to ESM, that probably are already there, example(do not add spaces to attribute value): clearCacheHours24HourFormat=6,12
After changing this value, reboot EPE datapump container to take change into use.
Recommendations:
Have always by default Full type scheduled task.
If you want to fetch changes to data fetched already by full task, more frequently than you can run full task, add also incremental task. Usually incremental task is not needed.
Recommended Scheduling Sequence
Recommended scheduling sequence, depends how much data is read from Customers system/directory to the Matrix42 Core, Pro or IGA solution and is import Incremental or Full.
Examples for scheduling,
| Total amount of users | Total amount of groups | Full load sequence | Incremental load sequence |
| < 500 | < 1000 |
Every 30 minutes if partial load is not used Four (4) times a day if partial load is used |
Every 10 minutes |
| < 2000 | < 2000 |
Every 60 minutes, if partial load is not used Four (4) times a day if partial load is used |
Every 15 minutes |
| < 5000 | < 3000 |
Every four (4) hours, if partial load is not used Twice a day if partial load is used |
Every 15 minutes |
| < 10 000 | < 5000 | Maximum imports twice a day, no matter if partial load is or is not used | Every 30 minutes |
| < 50 000 | < 7000 | Maximum import once a day, no matter if partial load is or is not used | Every 60 minutes |
| Over 50 000 | Over 7000 | There might be a need for another EPE-worker, please contact Product Owner | Separately evaluated |
Please note that if there are several tasks running at the same time you may need more EPE-workers. The tasks should be scheduled at different times and can be completed according to the table above. However, if there are more than 6 tasks running at the same time, the number of epeworkers should be increased. It's best practice not to schedule tasks to run at same time, if possible.
Recommendations related to performance
If the amount fo data to be imported is over 10000 concider these things:
Adjust log level of ESM and DATAPUMP to ERROR-level, to lowe the amount of logging during task run
Have as few as possible automations starting immediately for imported datacards (listeners, handlers, workflows), as those make ESM to take longer time handling new datacards.
Set removed accounts and entitlements status removed/disabled
With this functionality, you can mark account and entitlement status to e.g. Deleted or Disabled, when account or entitlement is removed from source system. Starting from version 2025.3 you can also set status to generic objects (not only to accounts/identities and entitlements/groups).
For version 2025.3 and newer
In version 2025.3 these settings are moved from properties files to Task UI. Also you can now set these settings for Generic objects, which have not been possible before this version.
There is separate configuration for each scheduled task, and for all mapping types. Here is example of this config on task:
For version 2025.2 and older
This functionality is available for “full” type scheduled tasks.
Settings are on datapump dockers configuration file. To change those parameter values, you need to set those in /opt/epe/datapump-itsm/config/custom.properties file.
Configuration
To enable disabling functionality, datapump config should have these parameters set to true:
disable.unknown.esm.users=truedisable.unknown.esm.groups=true
Those 2 parameters are false by default in 2024.2 and 2025.1 versions. In 2025.2 and newer version those are true by default.
Next are these parameters:
personTemplateStatusCodeAttributeKey=accountStatuspersonTemplateStatusAttributeDisabledValueKey=DeletedgroupTemplateStatusCodeAttributeKey=statusgroupTemplateStatusAttributeDisabledValueKey=5 - Removed
First two attributes should point to the DatacardHiddenState attribute in the User template, and tell which value should be send there when the user is deleted.
By default its accountStatus and Value 5 - Removed on IGA Account template.
All these needs to match with the attribute configuration:
Same thing applies for the next two paramaters, but its for Groups.'
If you need to change those parameters in properties file, do changes in Datapump container to file: /opt/epe/datapump-itsm/config/custom.properties and those changes will then survive over container reboot and will be copied on reboot to /opt/epe/datapump-itsm/config/application.properties.
Description
Tasks save their __taskid__ shown as Task Id mapping in the UI to the datacards, its then used to determine if the datacard was added by this task. In case there are multiple tasks with different sets of users.
This field was previously used as datasourceid, but since we moved to the model where connector can have multiple tasks its identifier cannot be used anymore, thats why the field was repurposed as taskid instead.
Taking users as an example, when task runs ESM is asked for the list of users that have its taskid in Task Id mapping field, and doesn't have a personTemplateStatusAttributeDisabledValueKey value in the personTemplateStatusCodeAttributeKey
This result is then compared to what the task fetched, and the datacards of users that were not fetched have their personTemplateStatusattribute set to value specified in the config - 5 - Removedby default.
Example log below shows described process and informs that one user was removed.
Same thing applies to groups but groupTemplateStatusattributes are used instead.
Notes
- Feature works only with full fetch scheduled tasks..
- No support for generic templates yet, only identity and access
- When migrating from the previous versions where datasourceid was still used it needs to run at least once to set its taskid’s in the datacards first.
- EPE identifies Disabled users or groups as the ones that were removed from the AD, at the present we do not support statuses related to the entity beign active or not.
- EPE does not enable users back on its own.
- If more than one tasks fetches the same users or groups it may overwrite the taskid in the datacard depending on which task ran last. It is suggested that many full type tasks are not fetching same user or group.
- Always do configuration file changes to custom.properties, do not change only application.properties as those changes are lost on container reboot if you have not done same changes to custom.properties.
Konfigurera schemalagd uppgift för att läsa data
I det här kapitlet finns konfigurationsinstruktioner när datakort endast läses från Efectes källlösning.
Lägg märke till hur två Efecte-lösningar heter, så att det blir lättare att följa instruktionerna.
För att konfigurera schemabaserade uppgifter behöver du åtkomst till Efecte Platform-konfigurationskonsolen.
Obs! Om ingen koppling skapas måste du först skapa en "ny koppling" och därefter kan du skapa nya uppgifter.
1. Öppna administrationsområdet för Efecte (en kugghjulssymbol).
2. Öppna kopplingsvyn.
3. Välj den anslutning som den schemabaserade uppgiften är konfigurerad för
4. Välj ny uppgift under rätt koppling
5. Definiera schemaläggning för uppgiften (om och hur schemalagda uppgifter ska köras regelbundet). Välj schemaläggningssekvens, som beror på hur mycket data som läses till Efecte-lösningen.
6. Fyll i uppgiftsuppgifter
- Fyll i ett unikt uppgiftsnamn för den schemalagda uppgiften. Observera att namnet inte kan ändras i efterhand.
- Uppgiftsanvändning indikerade att det är uppgiften som används för att läsa data eller skriva data.
- Observera att om händelsetypen ändras i efterhand kan det avbryta arbetsflödena.
- Mappningstypen är alltid Generisk
- Filtreringsfråga – detta är valfritt och du kan använda filter för att endast läsa specifika datakort från Efecte-källlösningen. Om värdet lämnas tomt läses alla datakort relaterade till mallen från Efecte-källlösningen. EQL syntax används, till exempel:
- VÄLJ entitet FRÅN entitet DÄR entitet.template.code = 'system' OCH entitet.deleted = 0 OCH $access_rights_group$ inte är null
- EQL dokumentation: https://docs.efecte.com/webapi-esm/efecte-query-language-description-esm
- Mallkod - Mallkod för Efecte-lösning (vilka datakort läses från källlösningen för Efecte)
- Mappkod - Efecte-lösningens mappkod (där datakort förvaras)
- Tips! Du kan använda lyssnare för att flytta datakort till en annan mapp
7. Fyll i felinformation
Valfria inställningar för felhantering. Om en schemalagd uppgift misslyckas kan ett datakort skapas till Efecte-lösningen (inte till källan för Efecte-lösningen) som visar felet. Om felinställningar har definierats behöver administratören inte manuellt kontrollera statusen för schemalagda uppgifter.
- Felmall – Välj en mall för datakort som skapas vid fel under etableringen (anslutning till datakällor, timeouts etc.)
- Felmapp – Välj mapp där feldatakortet lagras.
- Felattribut – Välj ett attribut där i felmallen felinformationen ska lagras.
8. Mappningar för generisk mall
Generiska data läses till valfri mall som användaren önskar och det är obligatoriskt att ange målmapp, datakälla-ID och unika värden som används för att identifiera data mellan två Efecte-lösningar.
- Målmall – välj Efecte-lösningsmallen dit data läses från Efecte-källlösningen.
- Målmapp – välj Efecte-lösningsmappen (listan är begränsad för att matcha kompatibilitet med vald mall) dit data läses från Efecte-källlösningen.
- Attributmappningar
- På vänster sida: attributet source Efecte-lösning
- Datakällans ID (Datasourceid) är namnet på kopplingens uppgift, vilket i vissa fall är användbart för att visas i datakort
- Efecte ID unikt attribut i datakort, vanligtvis med hjälp av IDgenerator-hanteraren
- På höger sida: Attributet Efecte-lösning
- På vänster sida: attributet source Efecte-lösning
- Det är möjligt att ställa in ytterligare attribut, som läses från Efectes källlösning, genom att välja knappen nytt attribut.
11. Spara provisioneringsuppgiften från spara-knappen. Om vissa obligatoriska attribut saknas visas spara-knappen i grått och den visar vad som saknas i inställningarna.
12. Du har nu konfigurerat schemabaserade kopplingsuppgifter för Efecte-kopplingen för att läsa datakort från Efecte-källlösningen.
- Du kan nu vänta tills uppgiften har startats baserat på schemaläggning eller
- Kör uppgiften manuellt – genom att klicka på knappen konfigureras uppgiften för att schemaläggas att starta omedelbart. Vanligtvis för testkörningar eller om du inte vill ändra schemainställningarna, men vill köra uppgiften nu.
Konfigurera händelseuppgift för att skriva data
All konfiguration relaterad till Efecte Provisioning Engine och händelsebaserade provisioneringsuppgifter konfigureras i Efecte Service Management-plattformen.
Lägg märke till hur två Efecte-lösningar heter, så att det blir lättare att följa instruktionerna.
1. Öppna konfigurationsvyn för Efecte-plattformen (en kugghjulssymbol).
2. Öppna kopplingsvyn
3. Välj kopplingen som ska använda händelseuppgiften
4. Välj "ny uppgift" under rätt anslutning
5. Fyll i uppgiftsuppgifter
- Uppgiftsnamn - Ange ett namn för uppgiften, det kommer att visas i kopplingsvyn.
- Det är god praxis att namnge en uppgift på ett sätt som beskriver dess syfte, till exempel
- Uppgiftsanvändningen indikerade att det är den uppgift som används för att läsa data eller skriva data. Kan ändras i efterhand, men det rekommenderas inte om händelseuppgiften används. Det kommer att störa arbetsflöden.
- Mappningstypen är alltid en generisk mall
6. Lägg till detaljer för målmall för Efecte-lösning
- Du behöver inte fylla i filterfrågan, den används bara för schemalagda uppgifter.
- Mallkod - källkod för Efecte-lösningsmall där data skapas eller tas bort
- Mappkod - källkod för Efecte-lösningens mappkod där data skapas eller tas bort
- Tips! Du kan använda lyssnare för att flytta datakort till olika mappar
8. Definiera generiska mappningar
- Målmall - Välj en mall från källlösningen för Efecte där information läses från mållösningen för Efecte
- Målmapp – Välj en mapp från Efectes källlösning (listan är begränsad för att matcha kompatibilitet med vald mall) där data läses.
- Attributmappningar
- På vänster sida: attribut för mållösningen Efecte
- Datakällans ID (Datasourceid) är namnet på kopplingens uppgift, vilket i vissa fall är användbart för att visas i datakort
- Efecte ID unikt attribut i datakort, vanligtvis med hjälp av IDgenerator-hanteraren
- På höger sida: Attributet Efecte-lösning
- På vänster sida: attribut för mållösningen Efecte
- Det är möjligt att ange ytterligare attribut, som läses från mållösningen för Efecte, genom att välja knappen nytt attribut.
9. Spara provisioneringsuppgiften med knappen "spara". Om obligatorisk information saknas kan du inte spara uppgiften och knappen "spara" visar information som saknas.
10. Nästa steg är att konfigurera arbetsflödet för att använda denna händelsebaserade uppgift. Från arbetsflödesmotorn i Efecte-plattformen är det möjligt att köra provisioneringsaktiviteter mot en annan Efecte-lösning. Det betyder att vilken som helst av de tillgängliga orkestreringsnodernas aktiviteter kan köras när som helst i arbetsflödet.
Arbetsflödesreferenser visas på översiktssidan för kopplingar,
Konfigurera dubbelriktad kontakt
I fall där dubbelriktad kontakt krävs måste du vara extra noggrann så att du inte skapar en loop mellan två Efecte-lösningar.
När man konfigurerar en dubbelriktad kontakt krävs det att både schemalagda och händelsebaserade uppgifter konfigureras i båda Efecte-lösningarna.
Lägg märke till hur två Efecte-lösningar heter, så att det blir lättare att följa instruktionerna.
Det finns flera olika scenarier för hur en dubbelriktad kontakt kan konfigureras, men här har vi listat vanliga scenarier och exempel på hur konfigurationen bör göras.
Scenario 1
Efecte 1 skapar ett ärende till Efecte 2, baserat på ärendetyp och Efecte 2 skickar tillbaka ärendet baserat på status.
Konfiguration i Efecte 1.
- Skapa en händelsebaserad uppgift enligt instruktionerna ovan för en händelsebaserad uppgift.
- Konfigurera ditt arbetsflöde enligt instruktionerna nedan för arbetsflödesaktiviteter
- Skapa ett villkor för Efecte 1-arbetsflödet för att kontrollera om ärendet ska skickas till Efecte 2.
Till exempel, här är ett arbetsflöde i Efecte 1 som skickar ett ärende till Efecte 2 när ärendetypen är incident.
- Skapa ett villkor för Efecte 1-arbetsflödet för att kontrollera om ärendet ska skickas till Efecte 2.
- Skapa schemabaserad uppgift enligt beskrivningen i instruktionerna ovan för schemabaserad uppgift
- Lägg till filter för uppgiften som kontrollerar statusen för ärendet i Efecte 2. I det här fallet måste ärendet lösas i Efecte 2 innan det läses till Efecte 1.
- Lägg till filter för uppgiften som kontrollerar statusen för ärendet i Efecte 2. I det här fallet måste ärendet lösas i Efecte 2 innan det läses till Efecte 1.
Konfiguration i Efecte 2.
- Skapa en Web API användare för Efecte1 Efecte-anslutningen och skicka inloggningsuppgifterna till Efecte 1-administratören.
- WebApi-användaren måste ha behörighet att läsa incidentdatakort med statusen Löst
- Ange attributkoder för händelsen som läses från Efecte 2 till Efecte 1
Scenario 2
Efecte 1 skapar ett ärende till Efecte 2 och uppdaterar befintligt ärende i Efecte 2 med ändrad information (beskrivningsfältet har uppdaterats)
Konfiguration i Efecte 1.
- Skapa en händelsebaserad uppgift enligt instruktionerna ovan för en händelsebaserad uppgift.
- Konfigurera ditt arbetsflöde enligt instruktionerna nedan för arbetsflödesaktiviteter
- Det måste finnas villkor i arbetsflödet när ett ärende ska skapas från Effekt 1 till Effekt 2.
- Det måste finnas en provisioneringsnod med åtgärden Skapa datakort. Till exempel
Konfiguration i Efecte 2.
- Skapa en Web API användare för Efecte 1 EFfecte-anslutningen och skicka inloggningsuppgifterna till Efecte 1-administratören.
- WebApi-användaren måste ha behörighet att läsa incidentdatakort
- Ange attributkoder för händelsen som läses från Effekt 1 till Effekt 2
- Skapa en schemabaserad uppgift enligt instruktionerna ovan för en schemabaserad uppgift.
- Lägg till filter för uppgiften som kontrollerar statusen för ärendet i Efecte 1. I det här fallet får ärendet inte lösas i Efecte 1 innan det läses till Efecte 2.
- Lägg till filter för uppgiften som kontrollerar statusen för ärendet i Efecte 1. I det här fallet får ärendet inte lösas i Efecte 1 innan det läses till Efecte 2.
Scenario 3.
Efecte 1 läser alla applikationsdatakort från Efecte 2, data ändras i Efecte 1 och uppdateras tillbaka till Efecte 2.
Konfiguration i Efecte 1.
- Skapa en schemabaserad uppgift enligt instruktionerna ovan för en schemabaserad uppgift. Till exempel
- Skapa en händelsebaserad uppgift enligt instruktionerna ovan för en händelsebaserad uppgift.
- Konfigurera ditt arbetsflöde enligt instruktionerna nedan för arbetsflödesaktiviteter
Konfiguration i Efecte 2.
- Skapa en Web API användare för Efecte 1 Efecte-anslutningen och skicka inloggningsuppgifterna till Efecte 1-administratören.
- WebApi-användaren måste ha behörighet att läsa programdatakort
- Ange attributkoder för applikationsmallen som läses från Efecte 2 till Efecte 1
Scenario 4.
Efecte 1 skapar en manuell begäran om åtkomsträttigheter som en biljett till Efecte 2, baserat på statusändringen skickas den tillbaka till Efecte 1.
Konfiguration i Efecte 1.
- Skapa en händelsebaserad uppgift enligt instruktionerna ovan för en händelsebaserad uppgift.
- Konfigurera ditt arbetsflöde enligt instruktionerna nedan för arbetsflödesaktiviteter
- Skapa ett villkor för Efecte 1-arbetsflödet för att kontrollera om ärendet ska skickas till Efecte 2.
Till exempel: arbetsflödet i Efecte 1 skickar en begäran om åtkomsträttigheter till Efecte 2 som ett ärende när provisioneringstypen är manuell.
- Skapa ett villkor för Efecte 1-arbetsflödet för att kontrollera om ärendet ska skickas till Efecte 2.
Konfiguration i Efecte 2.
- Skapa en Web API användare för Efecte 1 Efecte-anslutningen och skicka inloggningsuppgifterna till Efecte 1-administratören.
- WebApi-användaren måste ha behörighet att redigera statusattributet i datakort för åtkomsträttighetsbegäran
- Ange statusattributkoden för mallen för åtkomsträttighetsbegäran och dess värden.
- Skapa en händelsebaserad uppgift enligt instruktionerna ovan för en händelsebaserad uppgift.
- Konfigurera ditt arbetsflöde enligt instruktionerna nedan för arbetsflödesaktiviteter
- Lägg till villkor i arbetsflödet när Efecte-anslutningen ska ändra statusändringen till Efecte 1. Till exempel när statusen är 07 - Löst
Instruktioner för 2024.1 och äldre versioner
Konfigurera schemalagd uppgift
För att konfigurera schemabaserade provisioneringsuppgifter behöver du åtkomst till Efecte Platform-konfigurationskonsolen.
1. Öppna området Efecte-administration (en kugghjulssymbol).
2. Öppna IGA vyn
3. Välj Lägg till en ny uppgift för schemalagd Pro
4. Välj Efecte ESM från listan Lägg till en ny uppgift
5. Fyll i ett unikt namn för provisioneringsuppgiften
6. Välj Web API användare (lista över alla lokala Efecte-användare) och skriv in lösenordet
7. Välj en felmall för datakortet som skapas i händelse av fel under provisioneringen (anslutning till datakällor, timeouts etc.)
8. Välj schemaläggningssekvens, vilken beror på hur mycket data som läses till kundernas Efecte-lösning
9. Fyll i avsnittet Pro , där informationen för anslutningen anges.
10. Fyll i avsnittet Efecte ESM-mallmappning
- Kodnamn för fjärr-ESM-mall – Mallkod för fjärr-ESM
- Kodnamn för fjärr-ESM-mapp - Mappkod för fjärr-ESM
- Mappningar till vänster är för Remote-attribut och höger sida för den lokala ESM-instansen
- datasourceid och efecte_id är obligatoriska mappningar
- datasource-id ska vara ett strängattribut. Anslutningsenhetens namn visas i måldatakortets Datasource-ID när data importeras till Efecte.
- efecte_id måste vara ett unikt attribut för mallen, vanligtvis använder den idgenerator-hanteraren
14. Spara provisioneringsuppgiften från den översta fältet
15. Du har nu konfigurerat schemabaserad provisioneringsuppgift och du kan
- Testanslutning
- Kör uppgiften manuellt
16. Om uppgiften körs manuellt (kör uppgiften manuellt) eller om den körs enligt schemaläggning kan uppgiftens status granskas under fliken Extrahera/Läs in status.
Konfigurera händelsebaserad uppgift
All konfiguration relaterad till Efecte Provisioning Engine och händelsebaserade provisioneringsuppgifter konfigureras i Efecte Service Management-plattformen.
1. Öppna området Efecte-administration (en kugghjulssymbol).
2. Öppna IGA vyn
3. Välj Lägg till en ny uppgift för schemalagd Pro
4. Välj Efecte ESM från listan Lägg till en ny uppgift
5. Fyll i ett unikt namn för provisioneringsuppgiften
6. Fyll i avsnittet Pro där informationen för anslutningen anges. Obs! Filterfrågor behöver inga värden, de används bara för de schemalagda uppgifterna.
7. Fyll i avsnittet Efecte ESM-mallmappning
- Kodnamn för fjärr-ESM-mall – Mallkod för fjärr-ESM
- Kodnamn för fjärr-ESM-mapp - Mappkod för fjärr-ESM
- Mappningar till vänster är för Remote-attribut och höger sida för den lokala ESM-instansen
- datasourceid och efecte_id är obligatoriska mappningar
- datasource-id ska vara ett strängattribut. Anslutningsenhetens namn visas i måldatakortets Datasource-ID när data importeras till Efecte.
- efecte_id måste vara ett unikt attribut för mallen, vanligtvis använder den idgenerator-hanteraren
8. Spara provisioneringsuppgiften från den översta fältet
9. Du har nu konfigurerat händelsebaserad provisionering och du kan testa anslutningen.
10. Nästa steg är att konfigurera arbetsflödet för att använda denna händelsebaserade uppgift. Från arbetsflödesmotorn i Efecte Service Management-plattformen är det möjligt att köra provisioneringsaktiviteter mot Efecte ESM. Det betyder att vilken som helst av de tillgängliga aktiviteterna kan köras när som helst i arbetsflödet.
Arbetsflödesaktiviteter (orkestreringsnoder)
Skapa datakort
I illustrationen ovan fylls Efecte ESM-mallmappningarna i från Pro . Administratörer väljer rätt Efecte ESM-"mål" och kan se identitetsmappningarna som är konfigurerade för den valda uppgiften. I den här orkestreringsvyn får administratörer inte ändra några mappningar, de presenteras endast som ett visuellt hjälpmedel. Om några ändringar av mappningarna behövs måste dessa behov utföras i konfigurationsvyn Pro .
"Mål" visar alla anslutningsuppgifter som är konfigurerade för Efecte ESM och uppgiftsmappningar refererar till samma mall där själva arbetsflödet finns.
Undantag Pro etablering är en valfri egenskap på den här arbetsflödesnoden. Administratörer kan konfigurera den här egenskapen där undantag kan skrivas om några undantag finns under etableringsåtgärderna.
Ta bort datakort
Administratörer väljer rätt Efecte ESM-"Mål". I den här orkestreringsvyn får administratörer inte ändra några mappningar eller villkor. Om några ändringar behövs måste dessa utföras i konfigurationsvyn för Pro .
"Mål" visar alla anslutningsuppgifter som är konfigurerade för Efecte ESM och uppgiftsmappningar refererar till samma mall där själva arbetsflödet finns.
Undantag Pro etablering är en valfri egenskap på den här arbetsflödesnoden. Administratörer kan konfigurera den här egenskapen där undantag kan skrivas om några undantag finns under etableringsåtgärderna.
Felsökning
I det här kapitlet beskrivs felsökningsalternativ,
- Om felmall används, kontrollera korrekt datakort
- Kontrollera historiken för schemalagda uppgifter från kopplingshanteringen
- Kontrollera Efecte Provisioning Engine loggar
Begränsningar
Dessa begränsningar gäller när käll- och målsystemet har samma attributtyp. Vissa av dessa kan fungera om du ändrar attributtypen på ett annat system till String.
Begränsningar för händelsebaserade uppgifter
- E-postmeddelanden stöds inte
- Bilagor, vilket innebär att externa referenser (FileUpload-hanterare) inte stöds.
- Datumattribut stöds inte
- DateTime-attribut stöds inte
- Arbetslogghanteraren stöds inte
Begränsningar för schemalagda uppgifter
- Datumtypattribut (du måste mappa dessa till strängtypattributet)
- Attribut av typen DateTime (du måste mappa dessa till strängtypattributet)
- Arbetslogghanteraren stöds inte