Integraation käyttöönotto

Tämä ohje kattaa yleisen käyttöönottopolun kohdassa Asetukset → Integraatiot → Luettelo luetelluille integraatioille. Palveluntarjoajakohtaiset kentät, oikeudet ja todennusvaiheet löytyvät käyttöönotto-oppaasta, johon on linkki kyseisen palveluntarjoajan Luettelo-kortissa.

​

Edellytykset

Nämä roolit voivat olla saman henkilön hallussa. Henkilöllä, joka syöttää tunnistetiedot Living Securityssä, on oltava järjestelmänvalvojan rooli, joka sallii integraatioiden hallinnan. Älä kutsu lähdejärjestelmän järjestelmänvalvojaa Living Securityyn pelkästään sillä oletuksella, että kapeasti rajattu käyttöönottorooli on olemassa. Ennen aloittamista:

• Valitse Living Securityn organisaatio ja ympäristö, johon yhteys kuuluu.
• Avaa palveluntarjoajan Luettelo-opas ja kerää sen edellyttämät käyttöoikeuslaajuudet, uudelleenohjaus-URL-osoitteet ja sallittujen luettelon vaatimukset.
• Käytä organisaatiosi hyväksymää salaisuuksien jakamisprosessia, jos tunnistetiedot luo ja syöttää eri henkilöt.
• Älä koskaan lähetä salasanoja, asiakassalaisuuksia (client secret), yksityisiä avaimia tai pääsyavainten arvoja sähköpostitse tai tukipyynnössä.

​

1. Valmistele palveluntarjoajan tunnistetiedot

Avaa Asetukset → Integraatiot → Luettelo, etsi palveluntarjoaja ja lue sen käyttöönotto-opas ennen tunnistetietojen luomista. Palveluntarjoajan todennus voi perustua OAuth-suostumukseen, API-tunnukseen, asiakastunnukseen ja salaisuuteen (client ID ja secret), palvelutiliin tai muuhun palveluntarjoajan tukemaan menetelmään. Luo vain ne tunnistetiedot ja käyttöoikeuslaajuudet, jotka kyseisen palveluntarjoajan opas mainitsee.

​

2. Yhdistä palveluntarjoaja

Jos palveluntarjoaja hylkää todennuksen, keskeytä ja korjaa tunnistetiedot, vuokraaja (tenant), alue, uudelleenohjaus-URL tai lähdejärjestelmän oikeudet ennen jatkamista.

​

3. Ota tietovirrat käyttöön

Avaa yhteys kohdassa Asetukset → Integraatiot → yhdistetty. Living Security tunnistaa kyseiselle palveluntarjoajalle saatavilla olevat synkronointimallit ja listaa ne tietovirtoina.

1. Tarkista kunkin tietovirran nimi ja tarkoitus.
2. Ota käyttöön vain ne tietovirrat, joita ohjelmasi tarvitsee.
3. Jätä asiaankuulumattomat tietovirrat keskeytetyiksi.
4. Käytä toimintoa Synkronoi nyt, kun se on käytettävissä, pyytääksesi ensimmäistä ajoa.

Kaikki palveluntarjoajat eivät tarjoa samoja tietovirtoja tai aikataulun hallintaa. Noudata yhteydessä näkyviä hallintatoimintoja äläkä odota yleistä taajuuden, laajuuden, kenttien yhdistämisen, luonnoksen tai aktivoinnin ohjattua toimintoa.

​

4. Varmista ensimmäinen ajo

Pelkkä yhteyden todennus ei todista, että data liikkuu. Käyttöönoton yhteydessä Matkakartan tehtävät Vahvista identiteettitietojen virtaus ja Vahvista integraatiotietojen virtaus merkitään valmiiksi vastaanotetun datan perusteella. Älä korvaa näitä vahvistustuloksia tallennetulla yhteydellä.

​

Synkronoinnin tietosivu

Kohdasta Asetukset → Integraatiot → Synkronointi voit avata minkä tahansa synkronoinnin ja tarkastella sen asetuksia ja ajohistoriaa yhdessä paikassa. Tietosivulla näkyy: Käytä toimintoa Synkronoi nyt käynnistääksesi välittömän ajon, kun synkronointi on aktiivinen. Keskeytetyt synkronoinnit on jatkettava, ennen kuin uudet ajastetut tai manuaaliset ajot käynnistyvät. Voit avata synkronoinnin myös yhteyden tietosivulta, kun integraatio listaa aktiivisia tietovirtoja.

​

Yhteyden toiminnot

Yhteyden tietosivulla on kyseisen integraation tukemat toiminnot: Yhteyden poistaminen ei ole sama asia kuin sen kautta jo vastaanotetun datan poistaminen. Tarkista palveluntarjoajan opas tai ota yhteyttä tukeen, jos tietojen säilytyskäytäntö vaikuttaa päätökseesi.

​

Mukautetut push-lähteet

Käytä Custom Push Source -vaihtoehtoa (mukautettu push-lähde), kun järjestelmä lähettää dataa Living Securityyn sen sijaan, että dataa haettaisiin Luettelo-liittimen kautta.

1. Luo lähde Luettelon alalaidasta.
2. Avaa sen tietosivu mukautettujen push-lähteiden alueella.
3. Valitse kohdetietovirta.
4. Käytä toimintoa Lataa CSV manuaaliseen erään tai Lähetä API:n kautta automaattiseen lähettäjään.
5. Esikatsele tiedostoa tai hyötykuormaa ja tarkista lähteen ajohistoria lähetyksen jälkeen.

Täydellisen päätepisteen, todennuksen, hyötykuorman, uudelleenyrityksen ja varmennuksen määrittelyn löydät sivulta Custom Push Source API. Älä päättele näitä tietoja vanhemmasta Unify-integraatio-oppaasta. Lähteen tietosivun lataustoiminto hyväksyy lähde-CSV-tiedoston, jonka koko on enintään 100 MB. Ennen lataamista Kojelauta jakaa sen asiakaspuolella pyyntöihin, joista jokainen on enintään 10 MB ja 10 000 riviä. Tämä lähdekohtainen latausosio on erillinen yleisestä identiteetti- ja aktiviteettimallien Integraatiot → Lataa -sivusta.

​

Vianmääritys

Kun otat yhteyttä Living Securityn tukeen, liitä mukaan organisaatio, palveluntarjoaja, yhteyden nimi, tietovirta, viimeisimmän ajon aika ja näkyvä virhe. Älä liitä mukaan salaisuuksia.

​

Aiheeseen liittyvää