Generisk REST API anslutning
Lär dig hur du enkelt ansluter och interagerar med flera REST API :er med hjälp av en anpassningsbar och mångsidig generisk REST API koppling.
Generisk REST API anslutning
Lär dig hur du enkelt ansluter och interagerar med flera REST API :er med hjälp av en anpassningsbar och mångsidig generisk REST API koppling.
Generisk REST API anslutning
Generisk REST API kontakt är en del av Pro Engine Native Connectors och används i denna första version för att skriva data till kunders tredjepartslösningar som erbjuder REST API . Den kan användas för alla Matrix42 Core , Pro and IGA -lösningar som använder Connector Management (EPE).
2025.2-versionen introducerade denna nya generiska REST API anslutning med händelsebaserade uppgifter.
2025.3-versionen introducerade stöd för schemalagda uppgifter för denna generiska REST API anslutning.
Policy för rättvis användning
Anslutningen kan användas utan begränsningar under normala driftsförhållanden. Om användningen resulterar i en avsevärt ökad belastning som kräver ytterligare molnresurser (t.ex. minne eller processorkapacitet) kan ytterligare avgifter tillkomma.
Att använda den här anslutningen för att skapa, uppdatera eller ta bort användarkonton eller gruppobjekt kräver en aktiv IGA licens.
Generisk REST API anslutning kräver konfiguration enligt kundens användningsfall, och i princip har konfigurationen tre steg:
- Konfigurera anslutning – gör det möjligt för anslutningen att upprätta en anslutning till lösningen som erbjuder REST API
- Konfigurera händelseuppgift – används när data skrivs (händelsebaserade anrop från arbetsflödesorkestreringsnoden) till lösningen som erbjuder REST API
- Konfigurera arbetsflödesorkestreringsnoder för att använda händelsebaserade uppgifter
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 anslutning
I det här kapitlet beskrivs konfigurationsinstruktioner för hur connectorn ska kunna ansluta till REST API .
För att konfigurera provisionering behöver du åtkomst till plattformskonfigurationskonsolen.
1. Öppna administrationsområdet (en kugghjulssymbol).
2. Öppna vyn Kontakter.
3. Välj "Ny koppling"
4. Välj datakälltyp som Generic REST API
5. Ange ett namn för kontakten och lägg till anslutningsinställningar:
- Anslutningsnamn - ge din anslutning ett vänligt namn (namnet kan ändras i efterhand)
- Värd-URL - bas-URL för REST API . Detta kan användas som prefix för den slutliga URL:en som ska anropas.
- REST anslutningstyp - Generisk eller Google . För Google använd Google , och för alla andra typer av REST API :er använd Generell.
Välj rätt autentiseringsmetod baserat på det system du ansluter till
- Grundläggande autentisering - Grundläggande autentisering med användarnamn/lösenord som base64-kodad autentiseringsrubrik
- Bearer-token - Använder konstant autentiseringsrubrik för bärar-token
- Inaktiverad - För publika API :er utan autentisering (i 2025.3-versionen och senare)
- Autentiseringsrubrik - För konstant hemlig rubrik (i 2025.3-versionen och senare)
- Dynamisk token - För OAuth 2.0-klientuppgifter och liknande (i 2025.3-versionen och senare)
Ställ in korrekt paginering baserat på det tredjepartssystem du ansluter med den här kopplingen.
Generisk REST API anslutningssidning stöder 5 olika typer av sidning. Dessa används av schemalagda uppgifter:
- Inaktiverad – API stöder inte paginering och returnerar all data i ett enda svar.
- Start och offset – API :et använder start- och offsetparametrar. Öka start med offset för varje begäran tills all data har hämtats.
- Sidökning – API :et använder sidnumrering. Öka sidnumret med ett på varje begäran tills inga fler resultat returneras.
- Länktoken – Svaret innehåller en URL för nästa sida. Följ den URL:en tills ingen nästa länk visas.
- Länkattributtoken – Svaret innehåller en nästa-sida-token. Skicka den token som en frågeparameter i nästa begäran. Paginering Google -stil.
Uppfyll användarinformation för Web API
- Web API användare - välj rätt Web API användare som används när data skrivs från externa system till Matrix42 Core , Pro and IGA -lösningar
- Web API lösenord – lösenord för Web API användaren
7. Spara kontaktinformation
8. Lägg till ett externt REST API systems rot-https-certifikat som ska vara betrott av Connector Management (EPE). Detta kan endast göras med Matrix42 : Lägg till certifikat.
9. Matrix42 Core , Pro and IGA lösningar kan nu ansluta till externt REST API
- Nästa steg är att konfigurera en schemalagd uppgift för dataläsning eller händelseuppgift för dataskrivning och åtgärder mot REST API .
Allmän uid för schemalagda uppgifter
Allmän uid för schemalagda uppgifter
Hur man skapar en ny schemalagd uppgift för att importera data
För att konfigurera schemalagda provisioneringsuppgifter behöver du åtkomst till fliken Administration / Anslutningar.
1. Öppna administrationsområdet (en kugghjulssymbol).
2. Öppna vyn Kontakter .
3. Välj Anslutning för schemalagd uppgift och välj Ny uppgift
Obs! Om ingen koppling skapas måste du först välja Ny koppling och därefter Ny uppgift.
4. Fortsätt med anslutningsspecifika instruktioner: Inbyggda anslutningar
Ska jag använda stegvis, fullständig eller båda?
En schemalagd uppgift kan vara antingen stegvis eller av fullständig typ.
Importera inte behörigheter med AD och LDAP-stegsuppgifter
Den stegvisa uppgiften har problem med import av behörigheter. För närvarande rekommenderas det att inte importera gruppmedlemskap med stegvis schemalagd uppgift.
På Microsoft Active Directory och OpenLDAP -anslutningar, ta bort den här mappningen vid stegvisa uppgifter:
Inställning för schemalagda uppgifter:
Stegvis typ stöds endast för Microsoft Active Directory , LDAP- och Microsoft Graph API anslutningar (tidigare känt som Entra ID ).
Inkrementell typ innebär att Native Connectors (EPE) hämtar data från källsystemet med hjälp av ändrad tidsstämpelinformation, så att den endast hämtar data som ändras eller läggs till efter föregående körning av inkrementella uppgifter.
När en uppgift av stegvis typ körs för allra första gången gör den en fullständig hämtning (och markerar den aktuella tidsstämpeln till EPE-databasen). Därefter använder uppgiften den tidsstämpeln för att fråga datakällan om data som ändrats sedan den tidsstämpeln (och sedan uppdaterar EPE tidsstämpeln till EPE-databasen för nästa uppgiftskörning). Att rensa uppgiftscachen påverkar inte denna tidsstämpel, så en stegvis uppgift är alltid stegvis efter första körningen.
Fullständig typ stöds för alla kopplingar.
Fullständig import av typ hämtar alltid all data (den är konfigurerad att hämta) från källsystemet, vid varje körning.
Både fullständiga och stegvisa uppgifter använder även uppgiftscachen i EPE, vilket gör vissa importer snabbare och enklare för M42 -systemet.
Som standard rensas uppgiftscachen vid midnatt UTC-tid. När cachen rensas körs nästa import efter det utan cachning för att avgöra om hämtad data ska skickas till ESM. All hämtad data skickas till ESM. Därefter körs dock nästa uppgift tills nästa gång cachen rensas. EPE-cachen används för att avgöra om hämtad data behöver skickas till ESM eller inte.
Du kan konfigurera vid vilken tid på dagen aktivitetscachen töms genom att ändra den globala inställningen i EPE-datapumpkonfigurationen:
/opt/epe/datapump-itsm/config/ anpassade .egenskaper
vilket som standard är inställt på: clearCacheHours24HourFormat=0
Du kan också rensa cachen många gånger om dagen, men det måste övervägas noggrant, eftersom det påverkar den totala prestandan eftersom EPE kommer att driva ändringar i ESM, som förmodligen redan finns där, exempel (lägg inte till mellanslag i attributvärde): clearCacheHours24HourFormat=6,12
Efter att du har ändrat det här värdet, starta om EPE datapump-behållaren för att använda ändringen.
Rekommendationer:
Har alltid som standard schemalagd uppgift av typen Fullständig.
Om du vill hämta ändringar i data som redan hämtats av en fullständig uppgift, oftare än du kan köra en fullständig uppgift, lägg även till en stegvis uppgift. Vanligtvis behövs inte en stegvis uppgift.
Rekommenderad schemaläggningssekvens
Rekommenderad schemaläggningssekvens beror på hur mycket data som läses från kundens system/katalog till Matrix42 Core , Pro eller IGA lösningen och importeras stegvis eller fullständigt.
Exempel för schemaläggning,
| Totalt antal användare | Totalt antal grupper | Full lastsekvens | Stegvis belastningssekvens |
| < 500 | < 1000 | Var 30:e minut om dellast inte används Fyra (4) gånger per dag vid dellast |
Var 10:e minut |
| < 2000 | < 2000 | Var 60:e minut, om dellast inte används Fyra (4) gånger per dag vid dellast |
Var 15:e minut |
| < 5000 | < 3000 | Var fjärde (4:e) timme, om dellast inte används Två gånger om dagen vid dellast |
Var 15:e minut |
| < 10 000 | < 5000 | Maximal import två gånger per dag, oavsett om dellast används eller inte | Var 30:e minut |
| < 50 000 | < 7000 | Maximal import en gång per dag, oavsett om dellast används eller inte | Var 60:e minut |
| Över 50 000 | Över 7000 | Det kan finnas behov av ytterligare en EPE-arbetare, vänligen kontakta Pro . | Separat utvärderad |
Observera att om flera uppgifter körs samtidigt kan ni behöva fler EPE-arbetare. Uppgifterna bör schemaläggas vid olika tidpunkter och kan slutföras enligt tabellen ovan. Om det däremot körs fler än 6 uppgifter samtidigt bör antalet epe-arbetare ökas. Det är bäst att om möjligt inte schemalägga uppgifter så att de körs samtidigt.
Rekommendationer relaterade till prestanda
Om mängden data som ska importeras överstiger 10 000, tänk på följande:
Justera loggnivån för ESM och DATAPUMP till ERROR-nivå för att minska mängden loggning under körning av uppgiften.
Se till att så få automatiseringar som möjligt startar omedelbart för importerade datakort (lyssnare, hanterare, arbetsflöden), eftersom dessa gör att ESM tar längre tid att hantera nya datakort.
Ange status för borttagna konton och rättigheter som borttagna/inaktiverade
Med den här funktionen kan du markera konto- och rättighetsstatus till t.ex. Borttagen eller Inaktiverad, när kontot eller rättigheten tas bort från källsystemet. Från och med version 2025.3 kan du även ange status för generiska objekt (inte bara för konton/identiteter och rättighetar/grupper).
För version 2025.3 och senare
I version 2025.3 har dessa inställningar flyttats från egenskapsfiler till Task UI. Du kan nu också ställa in dessa inställningar för generiska objekt, vilket inte har varit möjligt före denna version.
Det finns separat konfiguration för varje schemalagd uppgift och för alla mappningstyper. Här är ett exempel på denna konfiguration för uppgiften:
För version 2025.2 och äldre
Den här funktionen är tillgänglig för schemalagda uppgifter av typen "fullständig".
Inställningarna finns i datapump dockers konfigurationsfil. För att ändra dessa parametervärden måste du ställa in dem i filen /opt/epe/datapump-itsm/config/custom.properties .
Konfiguration
För att aktivera inaktiveringsfunktionen bör datapump-konfigurationen ha dessa parametrar inställda på sant:
disable.unknown. esm .users=true
disable.unknown. esm .groups=true
Dessa två parametrar är som standard falska i versionerna 2024.2 och 2025.1. I version 2025.2 och senare är de sanna som standard.
Här är dessa parametrar:
personTemplateStatusCodeAttributeKey=accountStatus
personTemplateStatusAttributeDisabledValueKey=Deleted
groupTemplateStatusCodeAttributeKey=status
groupTemplateStatusAttributeDisabledValueKey=5 - Removed
De två första attributen ska peka på attributet DatacardHiddenState i användarmallen och ange vilket värde som ska skickas dit när användaren tas bort.
Som standard är dess accountStatus och värde 5 - Removed på IGA Account .
Allt detta måste matcha attributkonfigurationen:
Samma sak gäller för de kommande två parametrarna, men det är för grupper.
Om du behöver ändra dessa parametrar i egenskapsfilen, gör ändringar i Datapump-containern till filen: /opt/ epe /datapump-itsm/config/custom.properties. Dessa ändringar kommer sedan att finnas kvar efter omstart av containern och kopieras vid omstart till /opt/ epe /datapump-itsm/config/application.properties .
Beskrivning
Uppgifter sparar sina __taskid__ som visas som Task Id mapping i användargränssnittet till datakorten. Det används sedan för att avgöra om datakortet lades till av denna uppgift. Om det finns flera uppgifter med olika uppsättningar användare.
Det här fältet användes tidigare som datasource-id, men sedan vi bytte till modellen där kopplingen kan ha flera uppgifter kan dess identifierare inte längre användas, det är därför fältet har ändrat syfte till task-id istället.
Om vi tar användare som exempel, när en uppgift körs blir ESM ombedd att ange en lista över användare som har dess uppgifts-ID i mappningsfältet Task Id mapping och inte har ett personTemplateStatusAttributeDisabledValueKey -värde i personTemplateStatusCodeAttributeKey
Detta resultat jämförs sedan med vad uppgiften hämtade, och datakorten för användare som inte hämtades får sitt personTemplateStatus attribut inställt på värdet som anges i konfigurationen - 5 - Removed som standard.
Exempelloggen nedan visar den beskrivna processen och informerar om att en användare har tagits bort.
Samma sak gäller för grupper, men groupTemplateStatus -attribut används istället.
Anteckningar
- Funktionen fungerar endast med schemalagda uppgifter för fullständig hämtning.
- Inget stöd för generiska mallar ännu, endast identitet och åtkomst
- Vid migrering från tidigare versioner där datasourceid fortfarande användes måste den köras minst en gång för att först ange sina task-id:n i datakorten.
- EPE identifierar inaktiverade användare eller grupper som de som har tagits bort från AD . För närvarande stöder vi inte statusar relaterade till om enheten är aktiv eller inte.
- EPE aktiverar inte användare igen på egen hand.
- Om fler än en uppgift hämtar samma användare eller grupper kan den skriva över uppgifts-ID:t i datakortet beroende på vilken uppgift som kördes senast. Det tyder på att många fullständiga uppgifter inte hämtar samma användare eller grupp.
- Gör alltid ändringar i konfigurationsfilen av anpassade .properties, ändra inte bara application.properties eftersom dessa ändringar går förlorade vid omstart av containern om du inte har gjort samma ändringar av custom.properties.
Konfigurera schemalagd uppgift för att läsa data
Version 2025.3 har lagt till stöd för att läsa data med schemalagda uppgifter.
Generisk REST API anslutning används för att läsa data från tredjepartslösningar som exponerar REST API genom att skapa schemalagda provisioneringsuppgifter.
Hur man skapar en ny uppgift för schemalagd Pro
För att konfigurera schemalagda provisioneringsuppgifter behöver du åtkomst till plattformskonfigurationskonsolen.
Obs! Om ingen koppling skapas måste du först skapa en "ny koppling" och därefter kan du skapa nya uppgifter.
1. Öppna konfigurationsvyn för plattformen (en kugghjulssymbol).
2. Öppna vyn Kontakter.
3. Välj den anslutning som den schemalagda 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 Matrix42 Core , Pro and IGA -lösningen.
Rekommenderad schemaläggningssekvens beror på hur mycket data som läses från kundens katalog till Matrix42 Core , Pro and IGA lösningen och är importerad med delvis eller fullständig belastning.
Exempel på schemaläggning för läsning av data.
| Totalt antal användare | Totalt antal grupper | Full lastsekvens | Delvis lastsekvens |
| < 500 | < 1000 | Var 30:e minut om dellast inte används Fyra (4) gånger per dag vid dellast |
Var 10:e minut |
| < 2000 | < 2000 | Var 60:e minut, om dellast inte används Fyra (4) gånger per dag vid dellast |
Var 15:e minut |
| < 5000 | < 3000 | Var fjärde (4) timme, om dellast inte används Två gånger om dagen vid dellast |
Var 15:e minut |
| < 10 000 | < 5000 | Maximal import två gånger per dag, oavsett om dellast används eller inte | Var 30:e minut |
| < 50 000 | < 7000 | Maximal import en gång per dag, oavsett om dellast används eller inte | Var 60:e minut |
| Över 50 000 | Över 7000 | Det kan finnas behov av ytterligare en EPE-arbetare, vänligen kontakta Pro . | Separat utvärderad |
5. Fyll i uppgiftsuppgifterna
- Fyll i ett unikt uppgiftsnamn för den schemalagda uppgiften
- Uppgiftsanvändningen indikerar att det är uppgiften som används för att läsa data, skriva data eller för autentisering. Observera att om händelsetypen ändras i efterhand kan det störa arbetsflöden eller integrationer.
- Mappningstypen beror på vilken typ av information som läses från katalogen, endast Generic stöds för Generic REST API anslutning.
- Generisk (en mall) - används när generisk information läses från katalogen
6. Fyll i uppgiftsparametrar
- Fråga - faktisk API URL-slutpunkt som ska anropas
- Delfrågor – valfritt. Kan användas om det finns behov av att hämta data relaterad till frågan från en annan API slutpunkt.
- Frågerubriker – Anpassade rubriker läggs till i den slutliga frågan under dataextrahering.
Anslutningshantering (EPE) lägger till dessa rubriker automatiskt, så det finns inget behov av att lägga till dessa explicit:
“Content-Type”, “…”
"Authorization", “…” - Värdemarkör – kan vara tom. Värdet beror på JSON-datastrukturen som returneras av Query API . Om till exempel all data finns inuti resultset-json-objektet, sätt denna värdemarkör till resultset.
- Felmarkör – kan vara tom. Värdet beror på JSON-felmeddelandets struktur som returneras av Query API . Om till exempel hela felmeddelandet finns inuti fel-json-objektet, sätt denna värdemarkör till fel.
- Säkerhetströskel för API anrop - säkerhetströskel för att förhindra oändliga loopar. Ställ in detta till 2 gånger större än de nuvarande anrop som behövs för att den här uppgiften ska hämta all data. Om du hämtar all din data med den här uppgiften, t.ex. om 50 paginerade anrop behövs, sätt detta värde till 100.
- Unikt attribut - ange ett unikt attributnamn (skiftlägeskänsligt) från JSON-resultatmängden. Vanligtvis ID, id eller g uid etc. Varje rad måste ha ett unikt värde i detta attribut. Du måste också lägga till detta attribut i mappningstabellen i slutet av uppgiftskonfigurationen. Obs! Schemalagda uppgifter kan inte hämta data som inte innehåller detta unika attribut för varje objekt.
7. Fyll i felinformation
Valfria inställningar för felhantering. Om en schemalagd uppgift misslyckas kan ett datakort skapas till ESM 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. Välj texttypsattribut.
8. Lägg till generiska mappningar
I mappningsavsnittet konfigurerar du vilket attribut från JSON-meddelandet som ska läsas till vilket attribut på Matrix42 Core , Pro and IGA -datakortet.
- Målmall – Välj en mall för att definiera attributmappningar
- Målmapp – Välj en mapp från en lista med mappar. Listan begränsas för att matcha kompatibilitet med vald mall.
- Mappning av datakälltyp – valfritt. Om den är inställd skriver den kopplingstyp till det attributet.
- Mappning av uppgifts-ID – Uppgifts-ID-numret skrivs till det här attributet.
- Ange värde för datakort för objekt som raderats från källsystemet - Den här funktionen aktiveras genom att markera kryssrutan. När ett objekt som tidigare lästes från ett tredjepartssystem till en lösning raderas från tredjepartssystemet, meddelar den här schemalagda uppgiften att det har raderats och markerar det valda attributet med önskat värde. Detta kan till exempel användas för att ställa in Statusattributet till Borttaget (som visas i skärmdumpen nedan).
- Attributmappningar
- Externt attribut - vilket attribut från tredjepartssystemets API läses från JSON-kroppen
- Lokalt attribut - till vilket attribut i Matrix42 Core , Pro and IGA -attributet mappas
- Det är möjligt att ange ytterligare attribut till attributmappningar genom att välja Nytt attribut.
9 Spara provisioneringsuppgiften från knappen Spara.
Om vissa obligatoriska attribut saknas visas spara-knappen i grått och den visar vad som saknas i inställningarna.
10. Du har nu konfigurerat schemalagd kopplingsuppgift för generisk REST API läsning
- Du kan nu vänta tills uppgiften har startats baserat på schemaläggning eller
- Kör uppgiften manuellt – genom att klicka på knappen ”Kör uppgift” högst upp i uppgiftsredigeringsfönstret konfigureras uppgiften så att den schemaläggs att starta omedelbart. Vanligtvis för testkörningar eller om du inte vill ändra schemainställningarna, men vill köra uppgiften nu.
Exempel på startmeddelande för manuell körning av uppgift:
Om uppgiften körs manuellt ( kör uppgift ) eller enligt schemaläggning kan uppgiftens status granskas från hanteringskolumnen i listan över schemalagda uppgifter genom att klicka på knappen "Visa historik" .
Konfigurera händelsebaserad uppgift
Händelseuppgift används när data skrivs (eller andra händelsebaserade REST API anrop görs från Workflow) mot kunders lösningar som erbjuder generiskt REST API . Dessa funktioner för anslutningshantering är tillgängliga för alla Matrix42 Core , Pro and IGA -lösningar.
Exempel på användning av händelsebaserade uppgifter:
- Lägg till konto
- Uppdatera personen
- Aktivera konto
- Skapa ärende
- Inaktiv enhet
All konfiguration relaterad till anslutningshantering och händelsebaserade provisioneringsuppgifter konfigureras i Matrix42 Core , Pro eller IGA -anslutningsvyn.
1. Öppna konfigurationsvyn Matrix42 Core , Pro eller IGA (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 uppgiftsinställningar
- 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 [Mallnamn]:[Aktivitet] IGA -tjänstförfrågan: Lägg till konto
- 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 beror på vilken typ av information som läses från katalogen. Val av identitetsmappningar visas baserat på den här inställningen.
- Generisk (en mall) – används när generisk information läses från katalogen. Detta kan vara vilken typ av data som helst.
Varning om att ändra uppgiftsanvändning eller mappningstyp när händelseuppgift används:
6. Fyll i uppgiftsparametrar
- Fråga - API-slutpunkt som denna uppgift kommer att anropa. Detta kan lämnas tomt och anges i Workflow-orkestreringsnoden. Du kan ange fullständig slutpunktsadress som: https://apiurl.com/endpointtocall eller bara slutet av URL:en. Om du bara anger slutet av URL:en, till exempel endpointtocall , kommer den slutliga URL:en att sammanfogas med hjälp av alla dessa: connector host url + task query + orchestration node url.
- Frågerubriker – Anpassade rubriker har lagts till i den slutliga frågan till REST API . Se dokumentationen för mål-/källsystem API et vilka rubriker som krävs.
- Datumattributformatering – används för att formatera datum vid provisionering av datumattribut till målsystemet. Du kan välja format från listan eller lägga till ditt eget anpassade format. Fältet till höger visar exempel på formaterat datum.
- Attributformatering för DateTime – används för att formatera datum och tider vid provisionering av datetime-attribut till målsystemet. Du kan välja format från listan eller lägga till ditt eget anpassade format. Fältet till höger visar ett exempel på formaterad datum och tid.
7. Definiera generiska mappningar
- Målmall – Välj en mall för att definiera attributmappningar
- Målmapp – Välj en mapp från en lista med mappar. Listan begränsas för att matcha kompatibilitet med vald mall.
- Attributmappningar ( Notera! I de flesta fall finns det inget behov av att ställa in dessa. Data som används i händelseuppgiften konfigureras på noden Workflow Orchestration.
- Efecte-mallattribut - till vilket attributet i Efecte-katalogen är mappat.
- Katalogattribut - vilket attribut från katalogen mappas till Efecte
- Lägg till nytt attribut – Det är möjligt att ange ytterligare attribut genom att välja knappen Nytt attribut.
8. Spara uppgift
Spara provisioneringsuppgiften med knappen "spara"
Om någon obligatorisk information saknas kan du inte spara uppgiften och spara-knappen visar den information som saknas.
9. Konfigurera arbetsflödet för att använda den här händelsebaserade uppgiften med Orchestration-noden
Nästa steg är att konfigurera arbetsflödet för att använda den här händelsebaserade uppgiften.
Från arbetsflödesmotorn i plattformen är det möjligt att utföra provisioneringsaktiviteter mot kundkatalogtjänster. 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 (du kan uppdatera arbetsflödesreferenser med knappen ”Visa arbetsflödesreferenser”):
Konfigurera nodaktiviteter för arbetsflödesorkestrering
Generiskt REST anrop
Lägg till Orchestration-noden i ditt arbetsflöde och konfigurera följande saker.
Namn - ange beskrivande namn
Beskrivning - ange beskrivande beskrivning
Orkestrera - välj Pro
Datakälla - välj Generic REST API
Aktivitet - välj Generiskt REST anrop
Mål - välj din händelsebaserade uppgift (du kan använda samma uppgift för många orkestreringsnoder)
Åtgärd - välj åtgärd baserat på REST API du anropar (se API dokumentationen för korrekt åtgärd). Åtgärder som stöds är: POST, PUT, PATCH, DELETE och GET
REST URL - API-slutpunkten som du anropar. Detta kan vara hela URL:en eller suffixet till URL:en. Om du använder suffix kommer den faktiska URL:en som ska anropas att sammanfogas med hjälp av alla dessa: connector host url + task query + orchestration node url. Du kan använda mallattributvariabler på samma sätt som i e-postnoden, med hjälp av dollarsyntax som: $attribute_code$ och $reference:attribute_code$.
Obs! Om du har mellanslag eller $-tecken i din webbadress, kom ihåg att URL-koda dem. Så $ är %24 mellanslag är %20
Rest Body - json-kropp för API-anrop. Kan vara tom om API et du anropar inte behöver body. Se body-information från API dokumentationen. Du kan använda mallattributvariabler på samma sätt som i e-postnoden, med hjälp av dollarsyntax som: $attribute_code$ och $reference:attribute_code$.
Till exempel i den här kroppen har vi två variabler: $firstname$ och $lastname$
{"namn": {
"givetName": "$förnamn$",
"familyName": "$lastname$"}}
Om du behöver skapa en komplicerad json-body för API anrop kan du först konstruera den fullständiga json-filen till ett datacard-attribut. Och sedan bara ha den attributkoden i body-filen, så här: $generated_json_body_attributecode$
Hur man genererar JSON-kropp i kod
How to generate JSON in workflow
Use json library to read value from JSON
This example is for example for OnPremisesExtensionAttributes, but this same approach can be used for all kinds of JSON messages for Microsoft Graph API and REST API's.
To read 1 specific value from JSON which looks like this:
{ "extensionAttribute1": "test data1", "extensionAttribute2": null, "extensionAttribute3": null, "extensionAttribute4": "EXT", "extensionAttribute5": null, "extensionAttribute6": null, "extensionAttribute7": null, "extensionAttribute8": null, "extensionAttribute9": "HR functions", "extensionAttribute10": "100", "extensionAttribute11": null, "extensionAttribute12": null, "extensionAttribute13": null, "extensionAttribute14": "test5", "extensionAttribute15": "M365_E5" }
You can do it easily with following code on workflow script.
Example (example uses two esm attributes: onPremisesExtensionAttributes and extensionAttribute14code):
import json
if onPremisesExtensionAttributes:
_data = this.get("onPremisesExtensionAttributes")
_obj = json.loads(_data)
_value = _obj["extensionAttribute14"]
this.set("extensionAttribute14code",_value)Remember to always test, that code selects correct data from JSON for your use-case, and if not, do needed adjustments to it.
Rest Response Attribute - resultatmängden i json-filen för API anropet kommer att skrivas till detta attribut. Inte alla API :er returnerar någon response-json. Se detaljer i API dokumentationen.
How to read value from JSON in workflow
Use json library to read value from JSON
This example is for example for OnPremisesExtensionAttributes, but this same approach can be used for all kinds of JSON messages for Microsoft Graph API and REST API's.
To read 1 specific value from JSON which looks like this:
{ "extensionAttribute1": "test data1", "extensionAttribute2": null, "extensionAttribute3": null, "extensionAttribute4": "EXT", "extensionAttribute5": null, "extensionAttribute6": null, "extensionAttribute7": null, "extensionAttribute8": null, "extensionAttribute9": "HR functions", "extensionAttribute10": "100", "extensionAttribute11": null, "extensionAttribute12": null, "extensionAttribute13": null, "extensionAttribute14": "test5", "extensionAttribute15": "M365_E5" }
You can do it easily with following code on workflow script.
Example (example uses two esm attributes: onPremisesExtensionAttributes and extensionAttribute14code):
import json
if onPremisesExtensionAttributes:
_data = this.get("onPremisesExtensionAttributes")
_obj = json.loads(_data)
_value = _obj["extensionAttribute14"]
this.set("extensionAttribute14code",_value)Remember to always test, that code selects correct data from JSON for your use-case, and if not, do needed adjustments to it.
Undantag vid Pro – Om det uppstår ett problem med REST API anropet skrivs ett fel till det här attributet.
Undantagshantering:
- 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.
- Resultatet för en nod kommer att vara i tillståndet "Slutförd" om REST API http-svarskod är 200 eller över och under 400.
- Detaljer om lyckade/misslyckade REST API anrop finns i loggarna.
Felsök
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
Begränsningar för händelsebaserade uppgifter
- E-postmeddelanden stöds inte
- Bilagor 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)
- E-postmeddelanden stöds inte
- Bilagor stöds inte