> ## 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.

# Adaptive Security -integraation käyttöönotto

> Yhdistä Adaptive Security Living Security Platformiin, jotta voit tuoda työvoimasi tietojenkalastelu-, smishing- ja vishing-simulaatioiden tulokset sekä tietoturvatietoisuuskoulutuksen tulokset.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Aiheeseen liittyvät resurssit</h2>
    <ul>
      <li>
        <a href="/fi/signals/data-sources">Lue, miten integraatioiden data muuttuu Human Risk Management -signaaleiksi</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Tutustu Living Securityn integraatioihin</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Avaa Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Pyydä Living Securityn demo</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Syötä tunnistetiedot Living Security Platformissa">
    <p>
      Tämän vaiheen suorittaa henkilö, jolla on Living Securityn käyttöoikeus – ohjelman omistaja tai
      järjestelmänvalvoja, jos hänet on kutsuttu (delegoitu käyttöönotto).
    </p>
    <ol>
      <li>
        Siirry kohtaan <strong>Asetukset → Integraatiot → Luettelo</strong>, etsi{' '}
        <strong>{tile}</strong>-kortti ja valitse <strong>Liitä</strong>.
      </li>
      <li>
        Täytä alla olevat kentät ja valitse sitten <strong>Liitä</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Tämä opas on tarkoitettu {system}-järjestelmänne ylläpitäjälle.</strong> Se käsittelee API-tunnistetietojen luomista {system}-järjestelmässä, mikä edellyttää ylläpitäjän käyttöoikeuksia {system}-järjestelmään – ei Living Security Platformiin.
    </p>
    <p>
      Jos olette Living Securityn <strong>ohjelman omistaja</strong> ettekä ylläpidä {system}-järjestelmää,
      lähettäkää tämä sivu sille, joka sitä ylläpitää. Kyseinen henkilö suorittaa osan A ja luovuttaa tunnistetiedot teille
      (tai syöttää ne suoraan, jos olette kutsuneet hänet alustalle).
      {recommendDelegated && <>
          {' '}Koska asetusten yhteydessä syntyy arkaluonteista avainaineistoa, suosittelemme
          {' '}<strong>delegoitua käyttöönottoa</strong>, jotta salaisuutta ei koskaan lähetetä takaisin teille.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Adaptive Security" />

## Mitä tämä integraatio tuo järjestelmään

Adaptive Security voi tuottaa tietoja työvoimasta, koulutuksesta ja monikanavaisten simulaatioiden tuloksista. Tarkastettuja esimerkkejä ovat:

* `phishing.simulation.clicked` — napsautti simuloitua sähköpostiviestiä ilmoittamatta siitä
* `phishing.simulation.credential.submitted` — syötti tunnistetietoja simuloidulla kirjautumissivulla
* `phishing.simulation.attachment.opened` — avasi simuloidun sähköpostiviestin liitteen
* `phishing.simulation.reported` — ilmoitti simuloidusta sähköpostiviestistä
* `smishing.simulation.replied` — vastasi simuloituun tekstiviestiin
* `vishing.simulation.succeeded` — toimi simuloidun puhelinsoittajan ohjeiden mukaan
* `training.assigned` — sai tietoturvakoulutuksen määrättäväkseen
* `training.completed` — suoritti tietoturvakoulutuksen
* `training.past.due` — ylitti koulutuksen määräajan

Nämä esimerkit havainnollistavat normalisoidun toiminnan tyyppejä, joita Living Security voi hyödyntää. Katso [miten integraatiotiedoista muodostuu signaaleja](/fi/signals/data-sources).

<Note>
  **Adaptive simuloi kolmella kanavalla, ja Living Security pisteyttää jokaisen erikseen.**
  Sähköpostitulokset pisteytetään tietojenkalasteluna (phishing), tekstiviestitulokset smishingnä ja puhelutulokset vishingänä. Simuloidun sähköpostiviestin napsauttanutta ja simuloituun tekstiviestiin vastannutta henkilöä ei mitata samana käyttäytymisenä, koska kummankin tekemä arvio on erilainen.
</Note>

## Mitä Living Security tarvitsee

| Tunnistetieto | Kuvaus |
| - | - |
| **API-tunnus** | Adaptive Securityn API-tunnus. Living Security lähettää sen jokaisessa pyynnössä bearer-tunnuksena. |

**Vaadittu rooli:** Adaptive Security -tilisi järjestelmänvalvoja, jolla on pääsy kohtaan **Asetukset → API**. Adaptive hallitsee API-käyttöä roolipohjaisilla oikeuksilla, joten tunnuksen on kuuluttava roolille, joka voi lukea käyttäjiä, tietojenkalastelua ja koulutusta.

**Pääsy:** Vain luku. Living Security vain lukee tietoja Adaptive Securitystä, eikä se koskaan luo, muuta tai poista mitään tililläsi.

### Mitä Living Security hakee

| Tiedot | Lisätiedot |
| - | - |
| **Ihmiset** | Adaptive-käyttäjähakemistosi: nimi, sähköpostiosoite, osasto, tehtävänimike, esihenkilön nimi ja sähköpostiosoite, sijainti, divisioona, työsuhteen tila ja aloituspäivä. |
| **Sähköpostisimulaatiot** | Henkilöä ja simulaatiota kohden: milloin viesti toimitettiin, avattiin, napsautettiin, siihen vastattiin, sen liite avattiin, sen QR-koodi skannattiin, tunnistetiedot syötettiin tai siitä ilmoitettiin. |
| **Tekstiviestisimulaatiot** | Henkilöä ja simulaatiota kohden: toimitettu, avattu, napsautettu, vastattu, tunnistetiedot syötetty tai ilmoitettu. |
| **Puhelusimulaatiot** | Henkilöä ja simulaatiota kohden: toimitettu houkutus, soitettu numero, toimiko henkilö soittajan ohjeiden mukaan ja ilmoittiko hän asiasta. |
| **Koulutus** | Henkilöä ja kampanjaa kohden: milloin hänet ilmoitettiin kampanjaan, mikä oli määräaika, milloin hän aloitti, milloin hän suoritti kampanjan ja hyväksyikö hän kampanjan käytännön. |

<Note>
  **Puhelinnumeroita ei tallenneta.** Adaptive palauttaa käyttäjätietueessaan toimisto- ja matkapuhelinnumerot. Living Security hylkää molemmat ennen minkään tallentamista, koska mikään Living Securityn ominaisuus ei käytä niitä.
</Note>

<Note>
  **Adaptiven oma riskipisteytys tallennetaan, mutta sitä ei koskaan käytetä pisteytyksessä.** Adaptive laskee jokaiselle henkilölle `current_risk_score`. Living Security säilyttää sen, jotta voit verrata järjestelmiä rinnakkain, mutta Ihmisriskiindeksi lasketaan aina havaitusta käyttäytymisestä Living Securityn omalla julkaistulla mallilla — ei koskaan toisen toimittajan yhdistelmäpisteytyksestä.
</Note>

### Edellytykset

* Adaptive Security -tili, jossa API on otettu käyttöön.
* Järjestelmänvalvojan käyttöoikeus osoitteeseen [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* Adaptivessa olevat käyttäjien sähköpostiosoitteet, jotka vastaavat muiden yhdistettyjen järjestelmiesi käyttämiä osoitteita. Living Security yhdistää Adaptive-käyttäjän henkilöön sähköpostiosoitteen perusteella.

***

## Osa A — Adaptive Securityssä

*Adaptive Security -järjestelmänvalvojasi suorittaa nämä vaiheet.*

<Steps>
  <Step title="Avaa API-asetukset">
    1. Kirjaudu sisään osoitteessa [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) järjestelmänvalvojana.
    2. Siirry kohtaan **Asetukset → API**.
  </Step>

  <Step title="Luo API-tunnus">
    1. Luo uusi API-tunnus.
    2. Anna sille nimi, jonka tunnistat myöhemmin — esimerkiksi `Living Security`.
    3. Varmista, että tunnuksen rooli voi lukea käyttäjiä, tietojenkalastelukampanjoita ja koulutuskampanjoita.
    4. Kopioi tunnus.

    <Warning>
      Kopioi tunnus, ennen kuin poistut sivulta. Jos Adaptive-tilisi asettaa tunnukselle vanhenemispäivän, merkitse päivämäärä muistiin — Living Security ei voi hakea tietoja tunnuksen vanhennuttua, ja yhteys on päivitettävä uudella tunnuksella.
    </Warning>
  </Step>
</Steps>

***

## Osa B — Living Security Platformissa

*Ohjelman omistaja suorittaa tämän vaiheen, tai järjestelmänvalvoja, jos käytössä on delegoitu käyttöönotto.*

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Kenttä | Arvo |
    | - | - |
    | **API-tunnus** | Osassa A luomasi tunnus |
  </ConnectInPlatform>
</Steps>

Yhteys Adaptive Securityyn on nyt muodostettu.

***

## Tietojen hakutiheys

| Tiedot | Aikataulu |
| - | - |
| Ihmiset | 6 tunnin välein |
| Simulaatioiden tulokset (sähköposti, tekstiviesti, puhelu) | 6 tunnin välein |
| Koulutuksen tulokset | 6 tunnin välein |

Adaptiven raportointirajapinta ei tarjoa ”mikä on muuttunut sen jälkeen” -suodatinta, joten Living Security lukee jokaisen simulaatio- ja koulutuskampanjan niin kauan kuin se tuottaa vielä tuloksia, ja lopettaa sen lukemisen, kun kampanja on ollut suljettuna kaksi viikkoa. Myöhäiset napsautukset ja myöhäiset ilmoitukset siis tallentuvat edelleen, eikä päättyneitä kampanjoita lueta uudelleen loputtomiin.

<Note>
  Ensimmäinen yhteys laajaan Adaptive-tiliin voi vaatia useita ajoitettuja ajokertoja, ennen kuin kaikki tiedot on luettu. Jokainen ajo lukee niin paljon kuin pystyy, ja seuraava jatkaa siitä, mihin edellinen pysähtyi, joten määrät kasvavat ensimmäisen tai toisen päivän aikana sen sijaan, että ne ilmestyisivät kerralla.
</Note>

***

## Vianmääritys

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API-tunnus on virheellinen, vanhentunut tai peruutettu. Adaptive palauttaa tässä virheessä tyhjän vastauksen rungon, joten lisätietoja ei ole luettavissa. Luo uusi tunnus kohdassa **Asetukset → API** ja muodosta yhteys uudelleen sillä. Osittain kopioitu tunnus aiheuttaa saman virheen, ja se on yleisin syy.
  </Accordion>

  <Accordion title="403 Forbidden">
    Tunnus todennettiin, mutta sen rooli ei voi lukea pyydettyjä tietoja. Saman tunnuksen liittäminen uudelleen ei auta. Varmista Adaptivessa, että tunnuksen roolilla on lukuoikeus käyttäjiin, tietojenkalasteluun ja koulutukseen, tai luo tunnus roolille, jolla se on.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive rajoitti yhteyden pyyntönopeutta. Living Security pysäyttää kyseisen ajon ja jatkaa samasta kohdasta seuraavalla ajoitetulla ajolla, joten tietoja ei katoa — määrät vain kasvavat hitaammin. Jos tilanne jatkuu usean päivän ajan, ota yhteyttä Adaptive Securityn tukeen ja kysy tilillesi sovellettavasta pyyntörajasta.
  </Accordion>

  <Accordion title="Ihmiset näkyvät, mutta simulaatioiden tuloksia ei ole">
    Tarkista, että odottamasi kampanjat on todella ajettu. Adaptive raportoi ilmoittautumiset vain lähetetyistä simulaatioista, joten kampanja, jonka tila on edelleen **Luonnos** tai **Aikataulutettu**, ei tuota mitään ennen kuin se lähetetään. Living Security jättää nämä tarkoituksella lukematta, jotta pyyntökiintiö kuluu kampanjoihin, joilla on todellisia tuloksia.
  </Accordion>

  <Accordion title="Puhelu- tai tekstiviestisimulaatiot puuttuvat">
    Living Security määrittää kunkin tuloksen kanavan siihen liitetyn skenaarion perusteella. Jos skenaario poistettiin Adaptivessa simulaation ajon jälkeen, sen tulokset tallennetaan sähköpostikanavalle, koska kanavaa ei enää voi lukea. Tämän voi välttää säilyttämällä käytöstä poistetut skenaariot Adaptivessa poistamisen sijaan.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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