> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integraation käyttöönotto

> Valmistele palveluntarjoajan tunnistetiedot, yhdistä tuettu järjestelmä, ota sen tietovirrat käyttöön ja varmista ensimmäisen synkronoinnin onnistuminen.

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

| Rooli | Vastuu |
| - | - |
| [**Ohjelman omistaja**](/fi/reference/glossary#ohjelman-omistaja) | Valitsee lähteen, yhdistää sen Living Securityssä, ottaa tietovirrat käyttöön ja varmistaa lopputuloksen |
| [**Järjestelmänvalvoja**](/fi/reference/glossary#j%C3%A4rjestelm%C3%A4nvalvoja) | Luo tai hyväksyy tunnistetiedot ja käyttöoikeuslaajuudet lähdejärjestelmässä |

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.

<Warning>
  Älä kopioi oikeuksia toiselta palveluntarjoajalta äläkä myönnä laajoja
  kirjoitusoikeuksia varmuuden vuoksi. Puuttuvat oikeudet aiheuttavat yleensä
  selkeän 401- tai 403-virheen, joka voidaan korjata; liialliset oikeudet
  aiheuttavat tarpeetonta riskiä.
</Warning>

## 2. Yhdistä palveluntarjoaja

<Steps>
  <Step title="Avaa Luettelo">
    Siirry kohtaan **Asetukset → Integraatiot → Luettelo** ja valitse palveluntarjoaja.
  </Step>

  <Step title="Aloita yhdistäminen">
    Valitse **Liitä**. Suorita OAuth-kulku loppuun tai syötä yhteysikkunassa
    pyydetyt kentät. Palveluntarjoajan opas kertoo, mistä kukin arvo saadaan.
  </Step>

  <Step title="Viimeistele todennus">
    Hyväksy palveluntarjoajan suostumusnäkymä, jos se on käytössä. Kun todennus onnistuu, Living Security avaa uuden yhteyden tai listaa sen kohdassa **yhdistetty**.
  </Step>
</Steps>

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.

<Steps>
  <Step title="Tarkista yhteyden tila">
    Varmista, että yhteys on kunnossa eikä pyydä uudelleenvaltuutusta.
  </Step>

  <Step title="Tarkista tietovirran tila">
    Varmista, että tarvittava tietovirta on käytössä eikä keskeytetty.
  </Step>

  <Step title="Tarkista viimeisin ajo">
    Avaa tietovirta, yhteyden synkronointilinkki tai **Asetukset** → **Integraatiot** → **Synkronointi**. Odota onnistunutta päätilaa ja tarkista palveluntarjoajan virheet ja tietueiden määrät, kun ne ovat saatavilla.
  </Step>

  <Step title="Vahvista jatkokäsitelty data">
    Avaa asiaankuuluva Living Securityn näkymä. Identiteettidatan pitäisi tuottaa odotetut henkilöt ja identiteetit kohtaan Työvoima; tietoturvalähteiden data pitäisi näkyä kyseisen palveluntarjoajan dokumentoimassa ominaisuudessa.
  </Step>
</Steps>

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:

| Osio | Sisältö |
| - | - |
| **Otsikko** | Synkronoinnin nimi, tilamerkki ja integraation palveluntarjoaja |
| **Tilastot** | Malli, viimeisin synkronointi, suoritetut ajot ja tietueiden kokonaismäärä |
| **Ajohistoria** | Viimeaikaiset ajot tiloineen, ajoituksineen ja tietueiden määrineen |
| **Toiminnot** | **Päivitä**, **Tauko** / **Jatka** ja **Synkronoi nyt** |

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:

| Toiminto | Vaikutus |
| - | - |
| **Synkronoi nyt** | Pyytää välitöntä ajoa valitulle tietovirralle |
| **Keskeytä tietovirta** | Pysäyttää kyseisen tietovirran uudet ajot ja säilyttää yhteyden |
| **Keskeytä yhteys** | Pysäyttää tuetun yhteystoiminnan poistamatta määrityksiä |
| **Jatka** | Käynnistää keskeytetyn tietovirran tai yhteyden uudelleen |
| **Valtuuta uudelleen** | Toistaa todennuksen tunnistetietojen tai suostumuksen muututtua |
| **Poista** | Poistaa yhteyden määritykset vahvistuksen jälkeen |

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](/fi/integrations/custom-push-source). Ä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

| Oire | Tarkistettavaa |
| - | - |
| `401 Unauthorized` | Tunnistetietojen arvo, voimassaolo, peruutus, palveluntarjoajan vuokraaja (tenant) ja uudelleenvaltuutuksen tila |
| `403 Forbidden` | Palveluntarjoajan edellyttämä rooli, käyttöoikeuslaajuudet, ylläpitäjän suostumus ja lähdejärjestelmän käyttökäytäntö |
| Yhteys epäonnistuu heti | Uudelleenohjaus-URL, alue, lähde-URL sekä verkon tai IP-osoitteiden sallittujen luettelon vaatimukset |
| Yhteys on kunnossa, mutta ajoja ei tapahdu | Tarvittava tietovirta on käytössä ja palveluntarjoaja tarjoaa kyseisen tietovirran |
| Onnistunut ajo ei palauta tietueita | Lähdetili näkee odotetun joukon ja palveluntarjoajan puolen suodattimet ovat oikein |
| Data näkyy väärän henkilön kohdalla | Identiteettiattribuutit ja aliakset ovat yhdenmukaisia kaikissa yhdistetyissä lähteissä |
| Data ei enää päivity | Tietovirta tai yhteys on keskeytetty, tunnistetiedot ovat vanhentuneet tai viimeisin ajo epäonnistui |

Kun otat yhteyttä [Living Securityn tukeen](mailto:support@livingsecurity.com), liitä mukaan organisaatio, palveluntarjoaja, yhteyden nimi, tietovirta, viimeisimmän ajon aika ja näkyvä virhe. Älä liitä mukaan salaisuuksia.

## Aiheeseen liittyvää

<CardGroup cols={2}>
  <Card title="Integraatioiden yleiskatsaus" icon="grid-2" href="/fi/integrations/overview">
    Viitetiedot kohteista yhdistetty, Luettelo, Synkronointi, Toiminnot ja Lataa.
  </Card>

  <Card title="Datan yhdistäminen" icon="arrows-left-right" href="/fi/integrations/managing/data-mapping">
    Tutustu tuettuihin attribuutteihin ja yhdistämisiin, missä ne ovat saatavilla.
  </Card>

  <Card title="Integraation elinkaari" icon="route" href="/fi/integrations/managing/lifecycle">
    Hallitse olemassa olevaa integraatiota uudelleenvaltuutuksesta poistamiseen.
  </Card>

  <Card title="Ylläpitäjän käyttöönotto" icon="circle-check" href="/fi/getting-started/onboarding">
    Suorita identiteetti- ja tietoturvadatan vahvistustehtävät.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.