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

# NINJIO-integraation käyttöönotto

> Yhdistä NINJIO Living Security Platformiin tuodaksesi työvoimasi tietoturvatietoisuuskoulutuksen tulokset ja tietojenkalastelusimulaatioiden 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="NINJIO" />

## Mitä tämä integraatio tuo mukanaan

NINJIO voi tuottaa työvoimaa, koulutusta ja tietojenkalastelusimulaatioita koskevia tuloksia. Tarkastettuja esimerkkejä ovat:

* `training.assigned` — hänelle on määritetty tietoturvakoulutusta
* `training.completed` — suorittaa tietoturvakoulutuksen
* `training.passed` — läpäisee tietoturvakoulutuksen arvioinnit
* `phishing.simulation.clicked` — napsautti simulaatiota ilmoittamatta siitä
* `phishing.simulation.reported` — ilmoittaa tietojenkalastelusimulaatioista

Nämä esimerkit osoittavat, millaista normalisoitua toimintaa Living Security voi hyödyntää. Katso, [miten integraatiotiedoista muodostuu signaaleja](/fi/signals/data-sources).

## Mitä Living Security tarvitsee

| Tunnistetieto | Kuvaus |
| - | - |
| **API-avain** | NINJIOn API-avain, jolla on lukuoikeus työntekijöiden, koulutuksen ja tietojenkalastelun käyttöpisteisiin. Living Security lähettää sen jokaisen pyynnön mukana. |

**Oikeudet:** NINJIO rajaa jokaisen API-avaimen oikeudet *käyttöpistekohtaisesti*, ja luku- ja kirjoitusoikeudet määritetään erikseen. Living Security tarvitsee **lukuoikeuden** kolmeen käyttöpisteeseen: työntekijät, koulutus ja tietojenkalastelu. Kirjoitusoikeutta ei tarvita, eikä sitä tule myöntää.

**Vaadittu rooli:** NINJIO-tilisi **järjestelmänvalvoja** (Administrator). Vain järjestelmänvalvojat pääsevät Integration-alueelle, jossa avaimet luodaan.

<Warning>
  **NINJIO näyttää uuden avaimen vain kerran, sen luontihetkellä.** Kopioi avain suoraan Living Security Platformiin tai salasanaholviin, ennen kuin siirryt pois sivulta. Avainta, jota et kopioinut, ei voi hakea uudelleen — sen tilalle on luotava uusi avain.
</Warning>

### Mitä Living Security hakee

| Tiedot | Lisätiedot |
| - | - |
| **Oppijat** | NINJIOn työntekijähakemisto: nimi, sähköpostiosoite, osasto, tehtävänimike, esihenkilö, maa, toimipiste ja aktiivinen-tila. |
| **Koulutus** | Kenelle kukin koulutus on määritetty ja kuka sen on suorittanut — mukana suorituspäivä, koepisteet ja sitoutumispisteet. |
| **Tietojenkalastelu** | Kuka on ollut vuorovaikutuksessa simuloidun tietojenkalasteluviestin kanssa ja kuka sen on ilmoittanut, sekä tapahtuma-aika. |

<Note>
  **Oppijoiden puhelinnumeroita ei tallenneta.** NINJIO palauttaa työntekijätietueessa puhelinnumeron. Living Security hylkää sen ennen minkään tiedon tallentamista, koska mikään Living Securityn ominaisuus ei käytä sitä.
</Note>

### Edellytykset

* NINJIO-tili, jolla on API-käyttöoikeus.
* Järjestelmänvalvojan käyttöoikeus osoitteeseen [admin.goninjio.com](https://admin.goninjio.com/).
* NINJIOssa olevien oppijoiden sähköpostiosoitteiden tulee vastata osoitteita, joita muut yhdistetyt järjestelmäsi käyttävät. Living Security yhdistää NINJIOn oppijan henkilöön sähköpostiosoitteen perusteella.

***

## Osa A — NINJIOssa

*NINJIO-järjestelmänvalvojasi suorittaa nämä vaiheet.*

<Steps>
  <Step title="Avaa Integration-alue">
    1. Kirjaudu sisään osoitteessa [admin.goninjio.com](https://admin.goninjio.com/) järjestelmänvalvojana.
    2. Valitse näytön oikeasta yläkulmasta **Integration**.
  </Step>

  <Step title="Luo API-avain">
    1. Valitse **New API Key**.
    2. Anna avaimelle nimi, jonka tunnistat myöhemmin — esimerkiksi `Living Security`.
    3. Myönnä **lukuoikeus** käyttöpisteisiin **employee**, **training** ja **phishing**.
    4. Jätä kirjoitusoikeus valitsematta. Living Security vain lukee tietoja NINJIOsta.
    5. Valitse **Generate Key**.

    <Warning>
      Kopioi avain nyt. NINJIO näyttää sen vain kerran eikä voi näyttää sitä uudelleen.
    </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="NINJIO">
    | Kenttä | Arvo |
    | - | - |
    | **API-avain** | Osassa A luomasi avain |
  </ConnectInPlatform>
</Steps>

NINJIO on nyt yhdistetty.

***

## Tietojen hakutiheys

| Tiedot | Aikataulu |
| - | - |
| Oppijat | Päivittäin |
| Koulutuksen tulokset | 6 tunnin välein |
| Tietojenkalastelun tulokset | 6 tunnin välein |

Ensimmäisen yhteyden yhteydessä Living Security hakee koulutussuoritukset viimeisten 12 kuukauden ajalta ja pysyy sen jälkeen ajan tasalla inkrementaalisesti. Tietojenkalastelusimulaatiot luetaan kukin kerran, ja niitä tarkistetaan uudelleen kahden viikon ajan niiden päättymisen jälkeen, jotta myöhäiset napsautukset ja ilmoitukset tallentuvat.

<Note>
  Suuren NINJIO-tilin ensimmäisen yhteyden yhteydessä kaikkien tietojen lukeminen voi vaatia useita ajastettuja ajoja. Jokainen ajo lukee niin paljon kuin pystyy, ja seuraava jatkaa siitä, mihin edellinen jäi, joten määrät kasvavat ensimmäisen tai kahden päivän aikana sen sijaan, että ne tulisivat näkyviin kerralla.
</Note>

***

## Vianmääritys

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API-avain on virheellinen tai puutteellinen. Yleisin syy on vain osittain kopioitu avain — NINJIO näyttää sen vain kerran, joten liitettäessä avain voi helposti katketa, eikä sitä voi jälkikäteen havaita. Luo NINJIOssa uusi avain ja muodosta yhteys uudelleen sen avulla.
  </Accordion>

  <Accordion title="403 Forbidden">
    Tämä **ei** ole tunnistetietoihin liittyvä ongelma. Avain todennettiin, mutta jollekin sen tarvitsemista käyttöpisteistä ei ollut myönnetty lukuoikeutta.

    Saman avaimen liittäminen uudelleen ei auta. Luo NINJIOssa avain, jolla on **lukuoikeus** kaikkiin kolmeen käyttöpisteeseen — employee, training ja phishing — ja muodosta yhteys uudelleen sillä.
  </Accordion>

  <Accordion title="Yhteys muodostettu, mutta koulutustietoja ei ole">
    Tarkista NINJIOsta, että vähintään yksi koulutuskampanja on **aktiivinen** ja että siihen on liitetty simulaatio. Kampanja, jossa ei ole simulaatiota, pysyy ei-aktiivisena eikä tuota mitään, joten haettavia tuloksia ei ole.

    Jos kampanjat ovat aktiivisia, varmista, että niiden oppijoiden NINJIO-tietueissa on sähköpostiosoitteet. Oppijaa, jolla ei ole sähköpostiosoitetta, ei voida yhdistää henkilöön, ja hänet ohitetaan.
  </Accordion>

  <Accordion title="Koulutus näkyy määritettynä mutta ei koskaan suoritettuna">
    Tämä on odotettu näkymä koulutukselle, jota oppija ei ole suorittanut loppuun. Living Security tallentaa määrityksen, kun NINJIO-simulaatio alkaa, ja tallentaa suorituksen erikseen, kun NINJIO ilmoittaa suorituspäivän.
  </Accordion>

  <Accordion title="Joitakin oppijoita puuttuu">
    Living Security yhdistää NINJIOn oppijan henkilöön **sähköpostiosoitteen** perusteella. Oppijaa, jonka NINJIO-sähköpostiosoite poikkeaa hakemistossasi olevasta osoitteesta — esimerkiksi henkilökohtainen osoite, vanha verkkotunnus tai kirjoitusvirhe — ei voida yhdistää.

    Korjaa osoite NINJIOssa, niin yhdistäminen onnistuu seuraavassa ajastetussa haussa.
  </Accordion>

  <Accordion title="Tietojenkalastelun tulokset puuttuvat vanhemmasta simulaatiosta">
    Living Security tarkistaa tietojenkalastelusimulaation uudelleen kahden viikon ajan sen päättymisen jälkeen ja lopettaa sen jälkeen. Tuloksia, jotka NINJIO tallentaa tämän ajan jälkeen, ei haeta. Ota yhteyttä tukeen, jos vanhempi simulaatio täytyy lukea uudelleen.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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