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 .

General info

Generic Python Script connector comes with couple out-of-the box Python scripts. You should not modify those. Instead, if you need to make modifications to those, copy-paste those to new name and then do your modifications to newly named python script file. And as last step, modify your connector to use that script.

Work order:

1. Create your custom scheduled or task-based script
2. Take it into use to connector from Connectors UI

Scheduled scripts

How to take your custom python script into use for scheduled tasks, guidance for 1 host and 1 worker environment:

Note! Do not change "default" .py files which came with environment installation.

Copy your customly named (in this example mypythonscript.py) python script to these folders from HOST (remember to use correct tenant_name in path):

cp mypythonscript.py /var/lib/efecteone/tenant_files/{tenant_name}/epe-master/files/custom-provisioning-scripts/only_scheduled

cp mypythonscript.py /var/lib/efecteone/tenant_files/{tenant_name}/epe-worker-1/files/custom-provisioning-scripts

cp mypythonscript.py /var/lib/efecteone/tenant_files/{tenant_name}/epe-master/files/custom-provisioning-scripts

Change your custom python script file permission to 755 on all those above locations where you copied your script(in this example mypythonscript.py) (remember to use correct tenant_name in path):

chmod 755 /var/lib/efecteone/tenant_files/{tenant_name}/epe-master/files/custom-provisioning-scripts/only_scheduled/mypythonscript.py

chmod 755 /var/lib/efecteone/tenant_files/{tenant_name}/epe-worker-1/files/custom-provisioning-scripts/mypythonscript.py

chmod 755 /var/lib/efecteone/tenant_files/{tenant_name}/epe-master/files/custom-provisioning-scripts/mypythonscript.py

If you have more hosts, repeat on every host.

If you have more workers, repeat to every worker(check that worker folder name is correct).

Event-based scripts

How to take your custom python script into use for event-based tasks, guidance for 1 host environment:

Note! Do not change "default" .py files which came with environment installation.

Copy your customly named (in this example mypythonscript.py) python script to these folders from HOST (remember to use correct tenant_name in path):

cp mypythonscript.py /var/lib/efecteone/tenant_files/{tenant_name}/epe-master/files/custom-provisioning-scripts/only_event

cp mypythonscript.py /var/lib/efecteone/tenant_files/{tenant_name}/epe-master/files/custom-provisioning-scripts

Change your custom python script file permission to 755 on all those above locations where you copied your script(in this example mypythonscript.py) (remember to use correct tenant_name in path):

chmod 755 /var/lib/efecteone/tenant_files/{tenant_name}/epe-master/files/custom-provisioning-scripts/only_event/mypythonscript.py

chmod 755 /var/lib/efecteone/tenant_files/{tenant_name}/epe-master/files/custom-provisioning-scripts/mypythonscript.py

If you have more hosts, repeat on every host.

#!/usr/bin/python3

import json
import sys
import logging

def main():
    # Configure logging, change log file name
    logging.basicConfig(filename='python_event_task_abc.log', level=logging.INFO, format='%(asctime)s - %(message)s')
    
    # Read inputs from stdin
    lines = sys.stdin.read().splitlines()

    if len(lines) != 2:
        print("Error: Expected exactly two lines of input.")
        raise Exception("Expected exactly two lines of input.")

    # Parse the first line, this contains connector variables
    try:
        connector_parameters = json.loads(lines[0])
        host = connector_parameters.get('host', None)
        password = connector_parameters.get('password', None)
        logging.info(f"Connector parameters, Host={host}")
        # read custom connector parameters here
    except json.JSONDecodeError:
        raise Exception("Connector parameters is not a valid JSON string.") 

    # Parse the second line, this contains mappings data from template datacard
    try:
        task_mappings = json.loads(lines[1])
        logging.info(f"Task mappings JSON: {task_mappings}")
        #read task mappings data here

        # Implement your logic here

        
    except json.JSONDecodeError as e:
        raise Exception("Task mappings is not a valid JSON string.") from e
        # Exceptions raised are controlling workflow orchestration node flow, on exception it goes to Exception path, otherwise it goes to Completed path. Exception raised can be seen on Provisioning exception attribute value.
    except Exception as e:
        raise Exception("An unexpected error occurred") from e

if __name__ == "__main__":
    main()

Take customly named script into use to connector

How to take your customly named Python script into use, by selecting it from Connectors UI. Select your script from connectors Provisioning script -dropdown: