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

# KnowBe4-integraation käyttöönotto

> Yhdistä KnowBe4 Living Security Platformiin tuodaksesi käyttäjät, koulutusilmoittautumiset ja tietojenkalastelun tietoturvatestien 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 EgressIpSafelist = ({system}) => <Note>
    <strong>Lisää kaikki neljä Living Securityn synkronoinnin lähtevän liikenteen IP-osoitetta</strong> sallittujen luetteloon kohteessa{' '}
    {system}. Syötä kukin yksittäisenä isäntänä ja lisää perään <code>/32</code>, jos {system} edellyttää CIDR-merkintää:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Liikenne voi lähteä mistä tahansa näistä neljästä osoitteesta, joten vain osan lisääminen sallittujen luetteloon aiheuttaa ajoittaisia
    synkronointivirheitä. Nämä neljä osoitetta ovat samat kaikilla Living Securityn alueilla. Katso{' '}
    <a href="/fi/integrations/managing/egress-ip-addresses">
      Integraatioiden lähtevän liikenteen IP-osoitteiden määrittäminen
    </a>{' '}
    täydellistä luetteloa, muutoskäytäntöä ja vianmääritystä varten.
  </Note>;

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="KnowBe4" />

## Mitä tämä integraatio tuo mukanaan

KnowBe4 voi tuottaa työvoimaan, koulutukseen ja tietojenkalastelusimulaatioihin liittyviä tuloksia. Tarkastettuja esimerkkejä ovat:

* `training.completed` — suorittaa tietoturvakoulutuksen
* `training.past.due` — koulutus on myöhässä
* `phishing.simulation.clicked` — klikkasi simulaatiota ilmoittamatta siitä

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

## Mitä Living Security tarvitsee

| Tunnistetieto | Kuvaus |
| - | - |
| **API-avain** | Reporting API -haltijatunnus (bearer token), joka luodaan kohdassa **Account Settings → API**. Lähetetään jokaisessa pyynnössä otsakkeessa `Authorization: Bearer`. |
| **Reporting API server region** | Alue, jolle KnowBe4-tilisi on provisioitu, valittuna luettelosta (US, EU, Canada, UK, Germany). |

**Oikeusalueet (scopes):** Määritettäviä ei ole — KnowBe4 Reporting API -tunnukset ovat suunnittelultaan vain luku -tyyppisiä, eikä niille määritetä oikeusalueita. Tunnus antaa lukuoikeuden käyttäjiin, koulutusilmoittautumisiin ja tietojenkalastelun tietoturvatestien tuloksiin, eli juuri niihin tietoihin, joita synkronointi lukee.

**Vaadittu rooli:** **Account Admin** KnowBe4:ssä (vain tilin ylläpitäjät voivat käyttää kohtaa **Account Settings → API**)

### Edellytykset

* Sinun on oltava kirjautuneena KnowBe4-konsoliin **Account Admin** -roolilla. Vain tilin ylläpitäjät voivat käyttää kohtaa **Account Settings → API**, jossa Reporting API otetaan käyttöön ja tunnukset luodaan.

***

## Osa A — KnowBe4:ssä

*KnowBe4-ylläpitäjäsi suorittaa nämä vaiheet.*

<Steps>
  <Step title="Ota Reporting API käyttöön ja luo tunnus">
    1. Kirjaudu KnowBe4-konsoliin.
    2. Napsauta tilisi nimeä oikeassa yläkulmassa ja valitse **Account Settings**.
    3. Valitse vasemmasta siirtymisvalikosta **API**.
    4. Ota **Reporting API** käyttöön, jos se ei ole jo käytössä, ja luo sitten uusi API-tunnus.

    Anna tunnukselle kuvaava käyttötarkoitus (esim. `Living Security Platform`), jos konsoli sitä pyytää.

    <Warning>
      KnowBe4 näyttää API-tunnuksen arvon **vain kerran**, kun se luodaan. Kopioi se heti ja tallenna turvalliseen paikkaan (esim. salasanaholviin tai salaisuuksien hallintaan). Jos poistut sivulta kopioimatta tunnusta, sinun on luotava uusi tunnus.
    </Warning>

    <Note>
      Reporting API on vain luku -tyyppinen. Se tarjoaa käyttäjät, koulutusilmoittautumiset ja tietojenkalastelun tietoturvatestien tulokset — eli tiedot, jotka Living Security ottaa vastaan pisteytystä ja raportointia varten. Kirjoitusoikeutta ei tarvita.
    </Note>
  </Step>

  <Step title="Lisää Living Securityn egress-IP-osoitteet Allowed IP Addresses -luetteloon">
    KnowBe4:ssä Reporting API -käyttö voidaan rajata tiettyihin lähde-IP-osoitteisiin. Tämä asetus sijaitsee samassa paikassa kuin tunnus:

    1. Siirry KnowBe4-konsolissa kohtaan **Account Settings → API → Allowed IP Addresses**.
    2. Lisää jokainen [Living Securityn egress-IP-osoite](/fi/integrations/managing/egress-ip-addresses) sallittujen luetteloon. Samat neljä osoitetta koskevat kaikkia alueita.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Jos Allowed IP Addresses -luettelo on määritetty, sitä valvotaan verkkokerroksella.** Yhteysikkuna onnistuu todennuksessa, mutta datasynkronoinnit epäonnistuvat (estyvät verkkokerroksella ja näkyvät tyypillisesti muodossa `403`), kunnes Living Securityn egress-IP-osoitteet on lisätty sallittujen luetteloon. Jos lisäät luetteloon minkä tahansa osoitteen, sinun on lisättävä myös Living Securityn osoitealueet, muuten pyyntömme hylätään, vaikka tunnuksesi on kelvollinen.
    </Warning>

    <Note>
      Living Securityn egress-IP-osoitteet voivat muuttua infrastruktuuripäivitysten yhteydessä, vaikka tällaiset muutokset ovat harvinaisia. Jos datasynkronoinnit alkavat epäonnistua aiemman toimivuuden jälkeen, tarkista [Integraation egress-IP-osoitteiden määrittäminen](/fi/integrations/managing/egress-ip-addresses) ja varmista, että Allowed IP Addresses -luettelo vastaa niitä.
    </Note>
  </Step>

  <Step title="Selvitä KnowBe4-palvelinalueesi">
    KnowBe4 tarjoaa Reporting API:n aluekohtaisesta isännästä. Valitset alueen yhteysikkunassa etkä kirjoita isäntänimeä itse:

    | Alue | Reporting API -isäntä |
    | - | - |
    | Yhdysvallat | `us.api.knowbe4.com` |
    | Eurooppa | `eu.api.knowbe4.com` |
    | Kanada | `ca.api.knowbe4.com` |
    | Iso-Britannia | `uk.api.knowbe4.com` |
    | Saksa | `de.api.knowbe4.com` |

    Jos et ole varma, mitä aluetta tilisi käyttää, tarkista KnowBe4-konsolisi URL-osoitteen verkkotunnus tai ota yhteyttä KnowBe4-ylläpitäjääsi.

    <Note>
      Nämä viisi aluetta ovat ne, joihin Living Security voi muodostaa yhteyden. Jos KnowBe4-tilisi on toisella palvelimella (esimerkiksi Yhdysvaltain hallinnon instanssissa), ota yhteyttä Living Securityn tukeen ennen yhteyden muodostamisen aloittamista.
    </Note>
  </Step>
</Steps>

***

## Osa B — Living Security Platformissa

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Kenttä | Arvo |
    | - | - |
    | **API-avain** | Osan A vaiheessa 1 luotu Reporting API -tunnus |
    | **Reporting API server region** | Osan A vaiheessa 3 selvitetty alue (esim. Yhdysvallat) |
  </ConnectInPlatform>
</Steps>

Yhteys KnowBe4:ään on nyt muodostettu.

***

## Vianmääritys

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API-tunnus on virheellinen tai vanhentunut. Varmista, että tunnus on oikea eikä sitä ole luotu uudelleen kohdassa **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    Joko tunnuksella ei ole Reporting API -käyttöoikeutta, tai pyynnön IP-osoite ei ole Allowed IP Addresses -luettelossa. Varmista, että Reporting API on otettu käyttöön ja että kaikki neljä [Living Securityn egress-IP-osoitetta](/fi/integrations/managing/egress-ip-addresses) ovat sallittujen luettelossa.
  </Accordion>

  <Accordion title="Tyhjät tulokset (200 OK, mutta ei dataa)">
    Reporting API:lla ei välttämättä ole vielä palautettavaa dataa, tai tunnuksen tilillä ei ole näkyvyyttä käyttäjiin ja kampanjoihin, joita Living Security ottaa vastaan. Varmista, että tunnuksen on luonut Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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