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

# Abnormal Security -integraation käyttöönotto

> Yhdistä Abnormal Security tuodaksesi sähköpostiuhkia ja tietojenkalastelukampanjoita koskevia tietoja.

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="Abnormal Security" />

## Mitä tämä integraatio tuo mukanaan

Abnormal Security voi tuottaa normalisoitua tietoa sähköpostiuhkista, toimituksesta, estämisestä ja työntekijöiden tekemistä ilmoituksista. Tarkastettuja esimerkkejä ovat:

* `phishing.real.blocked` — todellinen tietojenkalastelu, joka estettiin ennen toimitusta
* `phishing.real.delivered` — todellinen tietojenkalastelu, joka toimitettiin saapuneisiin
* `phishing.real.reported` — ilmoittaa todellisista tietojenkalasteluviesteistä

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

## Mitä Living Security tarvitsee

| Tunnistetieto | Kuvaus |
| - | - |
| **API-avain** | Abnormal Portalissa luotu REST API -haltijatunniste (bearer token) |
| **Alueellinen API-isäntä** | Abnormal Security -ympäristösi isäntänimi |

**Käyttöoikeusalueet:** Custom Access, jossa **Lue** -oikeus kohteisiin `Abuse Campaigns (AI Security Mailbox)` ja `Threats`

**Vaadittu rooli:** **Security Admin** tai **Super Admin** Abnormal Securityssä

### Edellytykset

* API-tunnisteiden luominen ja hallinta edellyttää **Security Admin**- tai **Super Admin** -oikeuksia Abnormal Securityssä.

***

## Osa A — Abnormal Securityssä

*Abnormal Securityn ylläpitäjä suorittaa nämä vaiheet.*

<Steps>
  <Step title="Siirry API-tunnisteiden hallintaan">
    1. Kirjaudu sisään Abnormal Security -portaaliin.
    2. Napsauta vasemmassa navigointivalikossa kohtaa **Asetukset** ja valitse sitten **Integraatiot**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/settings-integrations.webp?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=7f5d7a616acdcf72a9048f16c6706b5e" alt="Abnormal Securityn Asetukset-valikko, jossa näkyy Integraatiot-vaihtoehto" width="1999" height="1680" data-path="integrations/images/abnormal-security/settings-integrations.webp" />

    3. Vieritä alas Integraatiot-sivun alaosassa olevaan **API Token Management** -osioon.
    4. Napsauta **+ Create New Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/api-token-management.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=13cfdfb7ced9b3f3fca67c781ee7e844" alt="API Token Management -osio ja Create New Token -painike" width="1239" height="1151" data-path="integrations/images/abnormal-security/api-token-management.avif" />
  </Step>

  <Step title="Valitse integraatiotyyppi">
    Valitse integraatiotyypiksi **REST API** ja napsauta sitten **Seuraava**.
  </Step>

  <Step title="Valitse tunnisteen laajuus">
    Valitse tunnisteen laajuus ja napsauta sitten **Seuraava**:

    * **Asiakas (kaikki nykyiset ja tulevat tenantit)** — Käytä tätä, jos Abnormal-tilisi hallinnoi useita tenanteja. Tämä tunniste kattaa automaattisesti kaikki nykyiset ja tulevat tenantit.
    * **Tenant (yksi tenant)** — Käytä tätä, jos haluat rajata tunnisteen yhteen tiettyyn tenanttiin.

    Useimmille organisaatioille, joilla on yksi Abnormal-tenant, kumpi tahansa vaihtoehto toimii. Jos olet epävarma, valitse **Asiakas**.
  </Step>

  <Step title="Myönnä vaadittavat käyttöoikeudet">
    Valitse **Custom Access** ja ota käyttöön **Lue** molemmille päätepisteryhmille:

    | Päätepisteryhmä | Vaadittu käyttöoikeustaso |
    | - | - |
    | **Abuse Campaigns (AI Security Mailbox)** | Lue |
    | **Threats** | Lue |

    Napsauta sitten **Seuraava**.

    <Note>
      **Lue**-oikeus palauttaa uhka- ja kampanjatietoja, jotka eivät ole arkaluonteisia. **Read Sensitive** paljastaa lisäksi henkilötietoja, liitteitä ja työntekijätietoja. **Kirjoita** lähettää korjaustoimia. Myönnä vain **Lue**-oikeus, ellei käyttötapauksesi nimenomaisesti edellytä enempää.
    </Note>
  </Step>

  <Step title="Määritä tunnisteen tiedot ja IP-sallittujen luettelo">
    Täytä seuraavat kentät:

    * **Token Name** — Kuvaava nimi (esim. `Living Security Platform`)
    * **Kuvaus** — Valinnainen lisätieto (esim. `Read access for Living Security HRM platform`)
    * **Token Expiry** — Valitse **90**, **180** tai **365 päivää** vaihtokäytäntösi mukaan. Aseta kalenterimuistutus tunnisteen vaihtamisesta ennen sen vanhenemista.
    * **IP Safelist** — Syötä Living Securityn lähtevän liikenteen IP-alueet yksi kerrallaan. Napsauta jokaisen jälkeen **Lisää**.

    <EgressIpSafelist system="Abnormal Security" />

    <Warning>
      **IP-sallittujen luettelo on pakollinen.** Abnormal Security hylkää kaikki API-pyynnöt osoitteista, jotka eivät ole sallittujen luettelossa. Yhteyden muodostusikkuna onnistuu, mutta tietojen synkronoinnit epäonnistuvat virheeseen `401 Unauthorized`, kunnes oikeat IP-osoitteet on lisätty sallittujen luetteloon.
    </Warning>

    Napsauta sitten **Seuraava**.
  </Step>

  <Step title="Tarkista ja luo tunniste">
    Tarkista tunnisteen määritysten yhteenveto ja napsauta sitten **Create Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/review-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=6935f488f5778fcea3f6907629aa1316" alt="Tunnisteen määritysten tarkistusnäkymä" style={{maxWidth: "550px"}} width="1910" height="726" data-path="integrations/images/abnormal-security/review-token.avif" />
  </Step>

  <Step title="Kopioi ja tallenna tunniste">
    **Kopioi tunniste heti** ja tallenna se turvalliseen paikkaan (esim. salasanaholviin tai salaisuuksien hallintaan). Napsauta sitten **Valmis**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/copy-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=fa752c333af664ad5b3ed037dbb67143" alt="Tunnisteen kopiointi-ikkuna, jossa näkyy luotu tunniste" style={{maxWidth: "550px"}} width="1999" height="329" data-path="integrations/images/abnormal-security/copy-token.avif" />

    <Warning>
      Abnormal Portal näyttää tunnisteen arvon **vain kerran**. Jos poistut näkymästä kopioimatta sitä, sinun on luotava uusi tunniste ja mitätöitävä vanha.
    </Warning>
  </Step>

  <Step title="Selvitä alueellinen API-isäntä">
    Määritä Abnormal Security -ympäristösi oikea API-isäntä:

    | Ympäristö | Alueellinen API-isäntä |
    | - | - |
    | Oletus (US commercial) | `api.abnormalplatform.com` |
    | EU | `eu.rest.abnormalsecurity.com` |
    | FedRAMP | `rest.abnormalsecurity.us` |

    Syötä **vain isäntänimi** — ilman `https://`-etuliitettä ja ilman loppukauttaviivaa.

    Jos et ole varma, mitä ympäristöä organisaatiosi käyttää, tarkista Abnormal-portaalin URL-osoite tai ota yhteyttä Abnormal Securityn tiliryhmään.
  </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="Abnormal Security">
    | Kenttä | Arvo |
    | - | - |
    | **API-avain** | Osan A vaiheessa 7 kopioitu tunniste |
    | **Alueellinen API-isäntä** | Osan A vaiheessa 8 selvitetty isäntä (US-oletus: `api.abnormalplatform.com`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/abnormal-security/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=46afa66685c5f59483324c863fd4fa86" alt="Living Securityn yhteyden muodostusikkuna Abnormal Securitylle" style={{maxWidth: "450px"}} width="576" height="638" data-path="integrations/images/abnormal-security/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

Olet nyt yhdistänyt Abnormal Securityn.

***

## Vianmääritys

<AccordionGroup>
  <Accordion title="403 Forbidden — Sinulla ei ole oikeutta suorittaa tätä toimintoa">
    Tunnisteesta puuttuu toinen tai molemmat vaadituista käyttöoikeuksista (**Abuse Campaigns** tai **Threats**). Integraatiotyyppiä, laajuutta ja käyttöoikeustasoa ei voi muuttaa tunnisteen luomisen jälkeen — sinun on luotava uusi tunniste oikeilla asetuksilla ja mitätöitävä vanha.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Joko tunniste on virheellinen tai vanhentunut, tai pyynnön IP-osoite ei ole sallittujen luettelossa. Tarkista seuraavat:

    1. Tunnistetta ei ole mitätöity eikä se ole vanhentunut
    2. Kaikki neljä [Living Securityn lähtevän liikenteen IP-osoitetta](/fi/integrations/managing/egress-ip-addresses) ovat sallittujen luettelossa

    Jos synkronoinnit toimivat aiemmin mutta epäonnistuvat nyt virheeseen `401`, lähtevän liikenteen IP-osoitteet ovat saattaneet muuttua — tarkista [integraatioiden lähtevän liikenteen IP-osoitteiden määritys](/fi/integrations/managing/egress-ip-addresses) ja varmista, että sallittujen luettelo vastaa niitä.
  </Accordion>

  <Accordion title="Vanhan tunnisteen vanheneminen (30. huhtikuuta 2027)">
    Jos organisaatiossasi on API-tunnisteita, jotka on luotu ennen itsepalvelutyyppisen Token Management -toiminnon käyttöönottoa, ne näkyvät kojelaudassa merkinnällä **Legacy**. Vanhat tunnisteet toimivat edelleen, mutta niitä ei voi vaihtaa — vain niiden IP-sallittujen luetteloa voi päivittää. Kaikki vanhat tunnisteet vanhenevat automaattisesti **30. huhtikuuta 2027**. Suunnittele vanhojen tunnisteiden korvaaminen uusilla ennen tätä päivämäärää.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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