Liittimet - yleiset toiminnot

Tässä artikkelissa kuvataan natiivien liittimien (Native Connectors) hallinnan yleiset toiminnot ratkaisussa. Kaikkia natiiveja liittimiä hallitaan samasta liittimien hallinnan käyttöliittymästä.

Huomaa, että jokaiselle liittimelle on omat erilliset kuvaukset, joissa liitinkohtaiset toiminnot ja konfigurointiohjeet on kuvattu yksityiskohtaisesti.

Päästäkseen liittimien hallintaan käyttäjällä täytyy olla admin-tason oikeudet asiakkaan Platform-konfiguraatioon. Kun oikeudet on myönnetty oikein, connector-välilehti tulee näkyviin ja käyttäjä voi hallita liittimiä.

Vasen valikko

Liittimien hallinta on jaettu neljään välilehteen:

• Overview - natiivien liittimien luomiseen ja päivittämiseen. Admin-käyttäjä näkee niiden tilan, tyypin ja kuinka monta ajastettua tai tapahtumapohjaista tehtävää niihin on liitetty.
• Authentication - todennustehtävien luomiseen ja päivittämiseen. Todennuksen provisiointitehtävää tarvitaan, jotta Secure Access pystyy määrittämään, mitkä asiakkaan loppukäyttäjät pääsevät Matrix42 Core, Pro and IGA -kirjautumissivulle.
• Logs - Native Connectors- ja Secure Access -lokien lataamiseen käyttöliittymästä.
• Settings - Native Connectorsin ja Secure Accessin yleiset asetukset, mukaan lukien lokitukseen ja valvontaan käytettävä ympäristötyyppi.

Connectors overview -välilehti

Overview-sivulta käyttäjä näkee helposti ja nopeasti kaikkien liittimien tilan.

Yläpalkki:

• Native Connectorsin (EPE) tila
  • Vihreä teksti tarkoittaa, että Native Connectors on online-tilassa. Kaikki tarvittavat palvelut ovat käynnissä.
  • Punainen teksti tarkoittaa, että Native Connectorsissa on ongelma, eivätkä kaikki palvelut ole käynnissä.
• Secure Accessin (ESA) tila
  • Vihreä teksti tarkoittaa, että Secure Access on online-tilassa. Kaikki tarvittavat palvelut ovat käynnissä.
  • Punainen teksti tarkoittaa, että Secure Accessissa on ongelma, eivätkä kaikki palvelut ole käynnissä.
• Native Connectorsin versionumero näytetään oikeassa yläkulmassa
  

Yläpalkki listanäkymälle:

• New connector - avaa uuden ikkunan uuden liittimen lisäämistä ja konfigurointia varten
• Remove connector(s) - työnkulkuviittaukset lasketaan, ja poistoa varten avautuu vahvistusikkuna (huomaa, että viittausten laskenta voi kestää useita sekunteja)
• Export - Admin voi viedä yhden tai useamman liittimen (ja tehtävät) ympäristöstä. Käytetään yleensä liittimien (ja tehtävien) viemiseen testistä tuotantoon. Native Connectorsin salaiset tiedot on suojattu salasanalla.
• Import - Admin voi tuoda yhden tai useamman liittimen (ja tehtävät) ympäristöön. Käytetään yleensä liittimien (ja tehtävien) tuomiseen testistä tuotantoon.
  • Admin ei voi tuoda vanhasta EPE-käyttöliittymästä (vanhempi kuin 2024.1) uuteen. Lähde- ja kohdeympäristöjen täytyy olla samaa versiota.
  • Tuonti epäonnistuu, jos konfiguraatio (mallit, attribuutit) ei ole sama - esimerkiksi jos jokin attribuutti puuttuu
  • Jos tuot jotain, jolla on samat liitintiedot, se yhdistetään olemassa olevan liittimen alle
• Refresh - Admin voi päivittää liittimien näkymän napsauttamalla painiketta.

Overview-listanäkymä,

• Select connector(s) - Valitse yksi liitin napsauttamalla valintaruutua liittimen rivin edessä, tai napsauttamalla valintaruutua otsikkorivillä valitset kaikki liittimet
• Id - Automaattisesti luotu liittimen yksilöllinen tunniste. Ei voi muokata tai muuttaa.
• Status - ilmaisee ajastetun tehtävän tilan
  • Vihreä valintamerkki - Tehtävä on suoritettu ilman virheitä
  • Punainen rasti - Tehtävä on suoritettu, mutta siinä on ollut virheitä
  • Harmaa kello - Tehtävää ei ole vielä suoritettu, odottaa ajastusta
  • Oranssi - yhdessä tehtävistä on ongelma
  • Ei arvoa - Ajastuspohjainen tehtävä puuttuu
• Name - Liittimen asetuksiin lisätty liittimen nimi. Yksilöllinen nimi liittimelle, joka sisältää yhden tietolähteen konfiguraation
• Type - ilmaisee kohde-/lähdejärjestelmän
• Scheduled - kertoo, kuinka monta ajastettua tehtävää on konfiguroitu
• Event - kertoo, kuinka monta tapahtumapohjaista tehtävää on konfiguroitu
• Manage
  • Kynäkuvake - avaa liittimen asetukset (myös liittimen rivin kaksoisnapsautus avaa asetukset)
  • Paperikuvake - kopioi liittimen
  • Stop - työnkulkuviittaukset lasketaan, ja poistoa varten avautuu vahvistusikkuna
• Search - Käyttäjä voi hakea liitintä syöttämällä hakusanan vastaavaan kenttään. Id-, Status-, Name-, Type-, Scheduled- ja Event-kentistä voi hakea.

Ajastetun tehtävän tiedot (napsauta liittimen edessä olevaa nuolta)

Kun napsautat liittimen rivin alussa olevaa nuolta, kaikki siihen liittyvät ajastetut ja tapahtumapohjaiset tehtävät näytetään

Yläpalkki ajastetuille tehtäville

• New task - avaa konfigurointisivun uudelle tehtävälle
• Remove task(s) - poistaa valitut tehtävät järjestelmästä, eikä niitä voi enää palauttaa.
• Refresh - päivittää ajastuspohjaisten tehtävien näkymän
• Search - käyttäjä voi hakea tehtävää syöttämällä hakusanan vastaavaan Id-, name-, enabled- tai extract/load status -kenttään.

Ajastettujen tehtävien listanäkymä

• Select task(s) - Valitse listanäkymästä poistettava tehtävä valintamerkillä.
• Id - Tehtävän yksilöllinen tunniste. Luodaan automaattisesti, eikä sitä voi muuttaa.
• Name - Tehtävän asetuksiin lisätty tehtävän nimi, tehtävän yksilöllinen nimi.
• Enabled - Näyttää, onko tehtävä ajastettu vai ei
  • Vihreä valintamerkki - Tehtävä on ajastettu
  • Punainen rasti - Tehtävää ei ole ajastettu
• Extract status - Näyttää datan poiminnan tilan kohdehakemistosta/-järjestelmästä
  • Vihreä valintamerkki - data on poimittu onnistuneesti
  • Punainen rasti - data poimittiin virheellisesti, tai poiminta epäonnistui
  • Kello - Tehtävä odottaa suoritusta
• Load status - Näyttää datan viennin tilan json-tiedostosta asiakkaan ratkaisuun
  • Vihreä valintamerkki - data on tuotu onnistuneesti asiakkaan ratkaisuun
  • Punainen rasti - data tuotiin virheellisesti, tai tuonti epäonnistui
• Manage
  • Kynäkuvake - avaa tehtävän asetukset omassa ikkunassaan (myös tehtävärivin kaksoisnapsautus avaa tehtävän asetukset)
  • Paperikuvake - kopioi tehtävän
  • Kellokuvake - avaa tehtävän historianäkymän
  • Stop - poistaa tehtävän, poistoa varten avautuu vahvistusikkuna

Ajastetun tehtävän historianäkymä

Napsauttamalla kellokuvaketta ajastetun tehtävän rivillä, ajastuksen historia näytetään.

Yläpalkki historianäkymälle

• Refresh - päivittää ajastetun tehtävän tilan. Tämä ei vaikuta tehtävään, se vain päivittää käyttöliittymän näyttämään uusimmat tiedot tehtävän ajosta.

Ajastetun tehtävän historian listanäkymä

• Rivin väri ilmaisee tilan
  • Vihreä - tehtävä suoritettiin onnistuneesti
  • Punainen - suorituksen aikana tapahtui virhe
• Execution ID - ajastetun tehtävärivin yksilöllinen tunniste
• Extract planned time - milloin seuraava poiminta hakemistosta/sovelluksesta on ajastettu tapahtuvaksi
• Extract complete time - milloin poiminta valmistui
• Extract status - hakemistosta/sovelluksesta tapahtuvan datan hakemisen tila
• Load start time - milloin seuraava vienti asiakkaan ratkaisuun on ajastettu tapahtuvaksi
• Load complete time - milloin vienti valmistui
• Load status - tiedon asiakkaan ratkaisuun viemisen tila

Ajastetun tehtävän tilan listanäkymä

• Actual start time - todellisen aloituksen aikaleima
• Users file - JSON-tiedosto, joka sisältää hakemistosta/sovelluksesta luetut käyttäjätiedot
• Group file - JSON-tiedosto, joka sisältää hakemistosta/sovelluksesta luetut ryhmätiedot
• Generic file - JSON-tiedosto, joka sisältää hakemistosta/sovelluksesta luetut yleiset tiedot
• Extract info - yksityiskohtaiset tiedot tiedon lukemisesta hakemistosta/sovelluksesta
• Load info - yksityiskohtaiset tiedot tiedon viemisestä asiakkaan Matrix42 Core, Pro and IGA -ratkaisuun

Ajastetun tehtävän muokkausikkuna

Ajastetun tehtävän konfiguraation voi avata napsauttamalla kynäkuvaketta tai kaksoisnapsauttamalla tehtävärivi.

Vasen valikko ja attribuutit vaihtelevat valittujen vaihtoehtojen mukaan, joten tarkemmat ohjeet tehtävien muokkaamiseen löytyvät liittimen kuvauksesta, mutta kaikille ajastetuille tehtäville yhteiset toiminnot on kuvattu alla.

Tehtävän tallentaminen

Jos tehtävästä puuttuu pakollisia tietoja, hiiren viemisellä tallennuspainikkeen päälle näet, mitkä attribuutit ovat vielä tyhjiä.

Yläpalkki ajastetun tehtävän muokkaukselle

• Run task manually - admin voi ajaa tehtävän manuaalisesti määritetyn ajastuksen ulkopuolella
• Stop task - admin voi pysäyttää parhaillaan käynnissä olevan ajastuspohjaisen tehtävän. Tehtävä pysäytetään, ja tila muuttuu pysäytetyksi. Se odottaa tässä tilassa seuraavaan ajastukseen asti.
• Clear data cache - Seuraavan Users- ja Groups-provisioinnin data-välimuisti tyhjennetään. Tämä tarkoittaa, että seuraava ajo suoritetaan kuten ensimmäinen ajo.
  • Oletuksena tyhjennämme välimuistin joka päivä klo 00:00 UTC
  • Jos haluat tyhjentää välimuistin eri aikaan, se täytyy määrittää eri arvolla host-koneen 'custom.properties'-tiedostossa.
  • EPE:n välimuisti tyhjenee myös, kun EPE käynnistetään uudelleen, koko ympäristö käynnistetään uudelleen, tai EPE:n mappauksia on muutettu
    

Tapahtumapohjaisen tehtävän tiedot

Kun napsautat liittimen rivin alussa olevaa nuolta, kaikki siihen liittyvät ajastetut ja tapahtumapohjaiset tehtävät näytetään

Yläpalkki tapahtumapohjaisille tehtäville

• New task - avaa konfigurointisivun uudelle tapahtumapohjaiselle tehtävälle
• Remove task(s) - poistaa valitut tehtävät, poistoa varten avautuu vahvistusikkuna
• Refresh - päivittää tapahtumapohjaisten tehtävien näkymän
• Show workflow references - laskee tehtävään liittyvät työnkulkusuhteet ja tilat. Tämä on erittäin hyödyllinen, jos et tiedä, mistä työnkuluista tapahtumapohjaisia tehtäviä käytetään.

Tapahtumapohjaisten tehtävien listanäkymä

• Select task(s) - Valitse listanäkymästä poistettava tehtävä valintamerkillä.
• Id - Tehtävän yksilöllinen tunniste. Luodaan automaattisesti, eikä sitä voi muuttaa.
• Name - Tehtävän asetuksiin lisätty tehtävän nimi, tehtävän yksilöllinen nimi.
• Workflow relations
  • Kysymysmerkki näyttää ponnahdusikkunan, jossa on yksityiskohtaiset tiedot viittauksesta
• Workflow status
  • Not used - Ei suhteita työnkulkuun
  • In use - Työnkulku(ja) liitetty tehtävään, tehtävää ei voi poistaa
• Manage
  • Kynäkuvake - avaa tehtävän asetukset omassa ikkunassaan
  • Paperikuvake - kopioi tehtävän
  • Stop-kuvake - poistaa tehtävän, poistoa varten avautuu vahvistusikkuna

Tapahtumapohjaisen tehtävän muokkausikkuna

Tapahtumapohjaisen tehtävän konfiguraation voi avata napsauttamalla kynäkuvaketta tai kaksoisnapsauttamalla tehtävärivi.

Vasen valikko ja attribuutit vaihtelevat valittujen vaihtoehtojen mukaan, joten tarkemmat ohjeet tehtävien muokkaamiseen löytyvät liittimen kuvauksesta, mutta kaikille tapahtumapohjaisille tehtäville yhteiset toiminnot on kuvattu alla.

Tapahtumapohjaisen tehtävän muokkausikkuna

• Task usage, editable? - tämä näkyy muokattaessa olemassa olevaa tehtävää, ja tehtävän käyttötyypin muuttaminen rikkoo työnkulkuja
• Mappings type, editable? - tämä näkyy muokattaessa olemassa olevaa tehtävää, ja mappaustyypin muuttaminen rikkoo työnkulkuja

Tehtävän tallentaminen

Jos tehtävästä puuttuu pakollisia tietoja, hiiren viemisellä tallennuspainikkeen päälle näet, mitkä attribuutit ovat vielä tyhjiä.

Authentication-välilehti

Matrix42 Core, Pro and IGA -ratkaisujen todennus konfiguroidaan authentication-välilehdeltä. Huomaa, että vain osa liittimistä (hakemistoliittimet) tukee todennusta, joten todennustehtäviä ei voi luoda kaikille käytettävissä oleville liittimille.

Yläpalkki todennukselle

• New connector - avaa uuden ikkunan uuden liittimen konfigurointia varten (huomaa, että kaikki liittimet eivät tue todennusta)
• Remove connector(s) - poistaa valitut tehtävät, poistoa varten avautuu vahvistusikkuna
• Export - käyttäjä voi viedä yhden tai useamman tehtävän ympäristöstä. Käytetään yleensä tehtävien viemiseen testistä tuotantoon. EPE-liittimet on suojattu salasanalla.
  • Huomaa, että todennustehtävien Realm ei viedy tuonnin mukana, se täytyy asettaa manuaalisesti tuonnin jälkeen
• Import - käyttäjä voi tuoda yhden tai useamman tehtävän ympäristöön. Käytetään yleensä tehtävien tuomiseen testistä tuotantoon.
• Refresh - päivittää todennustehtävien näkymän

Authentication overview -listanäkymä

• Select connector(s) - Valitse yksi liitin napsauttamalla valintaruutua liittimen rivin edessä, tai napsauttamalla valintaruutua otsikkorivillä valitset kaikki liittimet
• Id - Automaattisesti luotu liittimen yksilöllinen tunniste. Ei voi muokata tai muuttaa.
• Name - Liittimen asetuksiin lisätty liittimen nimi. Yksilöllinen nimi liittimelle, joka sisältää yhden tietolähteen konfiguraation
• Type - ilmaisee kohde-/lähdejärjestelmän
• Count - kertoo, kuinka monta todennustehtävää on konfiguroitu
• Manage
  • Kynäkuvake - avaa todennustehtävän asetukset omassa ikkunassaan
  • Paperikuvake - kopioi tehtävän
  • Stop-kuvake - poistaa valitun tehtävän

Todennustehtävän tiedot

Kun napsautat liittimen rivin alussa olevaa nuolta, kaikki siihen liittyvät ajastetut ja tapahtumapohjaiset tehtävät näytetään

Yläpalkki todennuksen yleiskatsaukselle

• Create new task - avaa konfigurointisivun uudelle todennustehtävälle
• Remove task(s) - poistaa valitut tehtävät, poistoa varten avautuu vahvistusikkuna
• Refresh - päivittää todennustehtävien näkymän

Authentication overview -listanäkymä,

• Select task(s) - Valitse listanäkymästä poistettava tehtävä valintamerkillä.
• Id - Tehtävän yksilöllinen tunniste. Luodaan automaattisesti, eikä sitä voi muuttaa.
• Name - Tehtävän asetuksiin lisätty tehtävän nimi, tehtävän yksilöllinen nimi.
• Manage
  • Kynäkuvake - avaa tehtävän asetukset omassa ikkunassaan (myös tehtävärivin kaksoisnapsautus avaa asetusikkunan)
  • Paperikuvake - kopioi tehtävän
  • Stop-kuvake - poistaa tehtävän, poistoa varten avautuu vahvistusikkuna

Logs-välilehti

Logs-välilehdeltä ladataan Native Connector- ja Secure Access -lokit käyttöliittymästä yksityiskohtaista vianmääritystä varten.

• epe-master-lokit - sisältää Native Connectorsiin liittyviä varoitus-, debug- ja virhetason viestejä sekä tietoa siitä, kauanko tehtävän toiminnot ovat kestäneet.
• epe-worker-ad-lokit - sisältää Active Directory -liittimen poimintatilan tiedot (mitä Native Connectors lataa asiakkaan Matrix42 Core, Pro and IGA -ratkaisuun). Jos valinta on tyhjä, se tarkoittaa, ettei hakemisto ole käytössä tässä ympäristössä.
• epe-worker-azure -lokit - sisältää Entra ID:n poimintatilan tiedot (mitä Native Connectors lataa asiakkaan Matrix42 Core, Pro and IGA -ratkaisuun). Jos valinta on tyhjä, se tarkoittaa, ettei hakemisto ole käytössä tässä ympäristössä.
• epe-worker-ldap-lokit - sisältää LDAP:n poimintatilan tiedot (mitä Native Connectors lataa asiakkaan Matrix42 Core, Pro and IGA -ratkaisuun). Jos valinta on tyhjä, se tarkoittaa, ettei hakemisto ole käytössä tässä ympäristössä.
• epe-launcher-lokit - sisältää tietoa EPE:n käynnistyksistä
• datapump-itsm-lokit - Sisältää tietoa datan viennistä asiakkaan Matrix42 Core, Pro and IGA -ratkaisuun.
• esa-lokit - Sisältää tietoa Secure Access -todennuksesta.

Settings-välilehti

Settings-välilehteä käytetään liittimiä sisältävien ympäristöjen valvontaan.

• Environment type - on pakollinen valita, ja tietoa käytetään esimerkiksi hälytyksen kriittisyyden määrittämiseen.
  • Test - valitse tämä, kun ympäristöäsi käytetään testiympäristönä
  • Prod - valitse tämä, kun ympäristöäsi käytetään tuotantoympäristönä
  • Demo - valitse tämä, kun ympäristöäsi käytetään demo- tai koulutusympäristönä
  • Dev - valitse tämä, kun ympäristöäsi käytetään kehitysympäristönä

Mitä valvomme?

• Virheet ajastuspohjaisessa provisioinnissa (datan poiminta, datan vienti ESM:ään, vanhentuneet sertifikaatit, virheelliset salasanat, virheellinen hakuperusta/-suodatin, virheelliset mappaukset jne.)
• Virheet tapahtumapohjaisessa provisioinnissa (kirjoitus AD:hen/Azureen epäonnistuu jne.)
• Tapahtumapohjainen provisiointi - mitä liittimiä käytetään datan kirjoittamiseen sovelluksiin/hakemistoihin.
• ESA: yli kymmenen epäonnistunutta kirjautumisyritystä yhdelle käyttäjälle viimeisen 3 päivän aikana
• Environment type - on pakollinen valita, ja tietoa käytetään esimerkiksi hälytyksen kriittisyyden määrittämiseen.

Datamigraatiot

Älä napsauta ”Migrate attribute mappings” tai ”Migrate workflows”, ellei Matrix42 ole erikseen pyytänyt sitä.