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

# Netskope-integraation käyttöönotto

> Yhdistä Netskope Living Securityyn verkko-, pilvi-, todennus-, tietosuoja- ja uhkatoiminnan seurantaa varten.

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

## Mitä tämä integraatio tuo mukanaan

Netskope voi tuottaa normalisoitua verkko-, pilvi-, todennus-, tietosuoja- ja uhkatoimintaa. Tarkastettuja esimerkkejä ovat:

* `web.ai.visited` — tekoälysivustolla vierailu
* `data.bulk.uploaded` — massatietojen lataus
* `geo.impossible` — mahdoton matka kirjautumisten välillä

Nykyinen yhteys käyttää REST API v2 -rajapintaa; olemassa oleville asiakkaille voi näkyä vanhempi REST-variantti. Katso [miten integraatiotiedoista muodostuu signaaleja](/fi/signals/data-sources).

## Mitä Living Security tarvitsee

| Tunnistetieto | Kuvaus |
| - | - |
| **API-tunnus** | Netskopen hallintakonsolista luotu REST API v2 -tunnus |
| **Vuokraajan aliverkkotunnus** | Netskope-vuokraajasi aliverkkotunnus (esim. `acme` osoitteesta `acme.goskope.com`) |

**Vaadittu päätepisteiden käyttöoikeus:**

| Päätepiste | Tarkoitus |
| - | - |
| `/api/v2/events/data/alert` | Uhkahälytykset, käytäntörikkomukset, DLP-tapahtumat, haittaohjelmahavainnot |
| `/api/v2/events/data/page` | Verkkotoiminta — selailu, sallitut ja estetyt sivustot, pilvisovellusten käyttö |

**Vaadittu rooli:** **Tenant Admin** tai vastaava rooli, jolla on pääsy kohtaan **Asetukset → Tools**

<Note>
  Tämä integraatio edellyttää **v2 API -tunnusta**, ei v1-tunnusta. V1-tunnukset käyttävät kyselyparametriin perustuvaa todennusta eivätkä toimi v2 API -päätepisteen kanssa.
</Note>

### Edellytykset

* Sinulla on oltava Netskopessa **Tenant Admin** -käyttöoikeus REST API -tunnusten hallintaan.

***

## Osa A — Netskopessa

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

<Steps>
  <Step title="Siirry REST API v2 -tunnusten hallintaan">
    1. Kirjaudu Netskopen hallintakonsoliin osoitteessa `https://<tenant>.goskope.com`.
    2. Napsauta vasemmassa navigointivalikossa kohtaa **Asetukset**.
    3. Valitse kohdasta **Tools** vaihtoehto **REST API v2**.
  </Step>

  <Step title="Luo uusi tunnus">
    1. Napsauta **New Token**.
    2. Anna kuvaava nimi (esim. `Living Security Platform`).
    3. Ota päätepisteiden käyttöoikeuksista käyttöön seuraavat:

    | Päätepiste | Vaadittu käyttöoikeus |
    | - | - |
    | `/api/v2/events/data/alert` | Luku |
    | `/api/v2/events/data/page` | Luku |

    <Warning>
      Myönnä käyttöoikeus **molempiin** päätepisteisiin. Ne syöttävät kahta erillistä virtaa — `alerts` ja
      `events` — ja vain toiseen niistä rajattu tunnus muodostaa silti yhteyden onnistuneesti.
      Puuttuvan päätepisteen takana oleva virta ei tällöin palauta mitään, eikä mikään virheilmoitus
      kerro syytä.
    </Warning>

    <Note>
      Nämä kaksi ovat ainoat päätepisteet, joita Living Security vaatii. Kun et myönnä mitään niiden lisäksi,
      noudatat vähimpien oikeuksien periaatetta.
    </Note>

    4. Napsauta **Tallenna** (tai **Generate Token**).
  </Step>

  <Step title="Kopioi ja tallenna tunnus">
    **Kopioi tunnus heti** ja säilytä se turvallisesti.

    <Warning>
      Netskope näyttää tunnuksen arvon **vain kerran** luomisen yhteydessä. Jos poistut näkymästä kopioimatta sitä, sinun on poistettava tunnus ja luotava uusi.
    </Warning>
  </Step>

  <Step title="Määritä IP-sallittujen luettelo (tarvittaessa)">
    Jos Netskope-vuokraajassasi on käytössä IP-osoitteiden sallittujen luettelo, sinun on lisättävä Living Securityn lähtevän liikenteen IP-alueet.

    1. Siirry Netskopen hallintakonsolissa kohtaan **Asetukset → Administration → IP Allowlist**.
    2. Jos IP-sallittujen luettelo on käytössä, lisää jokainen [Living Securityn lähtevän liikenteen IP-osoite](/fi/integrations/managing/egress-ip-addresses) **Custom IP** -luetteloon.

    <EgressIpSafelist system="Netskope" />

    <Warning>
      Jos IP-sallittujen luettelo on käytössä, yhteysikkuna onnistuu, mutta tietojen synkronoinnit epäonnistuvat virheeseen `401 Unauthorized`, kunnes oikeat IP-osoitteet on lisätty.
    </Warning>
  </Step>

  <Step title="Selvitä vuokraajasi aliverkkotunnus">
    Vuokraajasi aliverkkotunnus on Netskopen hallintakonsolin URL-osoitteen etuliite.

    Jos konsolisi URL-osoite on `https://acme.goskope.com`, aliverkkotunnuksesi on `acme`.

    Anna vain pelkkä aliverkkotunnus — ei `https://`, ei `.goskope.com`, ei loppukauttaviivaa.

    <Note>
      Yhteysikkuna hyväksyy useita syöttömuotoja (pelkkä aliverkkotunnus, täydellinen isäntänimi tai täydellinen URL-osoite) ja normalisoi ne automaattisesti. Pelkän aliverkkotunnuksen syöttämistä kuitenkin suositellaan.
    </Note>
  </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="Netskope (v2 API)">
    | Kenttä | Arvo |
    | - | - |
    | **API-avain** | Osan A vaiheessa 3 saatu tunnus |
    | **Vuokraajan aliverkkotunnus** | Osan A vaiheessa 5 selvitetty aliverkkotunnus (esim. `acme`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/netskope-v2-api/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=89b64e78a14c51a0977c3a2a28418988" alt="Living Securityn yhteysikkuna Netskope v2 API -integraatiolle" style={{maxWidth: "450px"}} width="576" height="356" data-path="integrations/images/netskope-v2-api/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

Netskope (v2 API) on nyt yhdistetty.

***

## Vianmääritys

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Yleisiä syitä:

    1. **Tunnus on peruutettu tai vanhentunut** — luo uusi tunnus
    2. **Käytössä on v1-tunnus** — v1-tunnukset todentavat kyselyparametrin avulla eivätkä toimi v2-päätepisteiden kanssa. Luo uusi v2-tunnus kohdassa **Asetukset → Tools → REST API v2**
    3. **IP-sallittujen luettelo estää pyynnöt** — jos vuokraajassasi on käytössä IP-sallittujen luettelo, varmista, että kaikki neljä [Living Securityn lähtevän liikenteen IP-osoitetta](/fi/integrations/managing/egress-ip-addresses) ovat sallittujen luettelossa
  </Accordion>

  <Accordion title="403 Forbidden">
    Tunnus luotiin ilman käyttöoikeutta päätepisteeseen `/api/v2/events/data/alert` tai `/api/v2/events/data/page`. Tunnuksen päätepisteiden käyttöoikeuksia ei voi muuttaa luomisen jälkeen — luo uusi tunnus, jolla on lukuoikeus molempiin, ja muodosta yhteys uudelleen.
  </Accordion>

  <Accordion title="Hälytykset saapuvat, mutta verkkotoiminta puuttuu (tai päinvastoin)">
    Tunnuksesta puuttuu toinen kahdesta vaaditusta päätepisteestä. Vain päätepisteeseen
    `/api/v2/events/data/alert` tai vain päätepisteeseen `/api/v2/events/data/page` rajattu tunnus muodostaa silti yhteyden,
    ja puuttuvan päätepisteen takana oleva virta pysyy hiljaisesti tyhjänä.

    Päätepisteiden käyttöoikeuksia ei voi muuttaa tunnuksen luomisen jälkeen — luo uusi
    tunnus, jolla on lukuoikeus molempiin, ja muodosta yhteys uudelleen.
  </Accordion>

  <Accordion title="Synkronoinnit toimivat, mutta epäonnistuvat nyt virheeseen 401">
    Jos IP-sallittujen luettelo on käytössä, Living Securityn lähtevän liikenteen IP-osoitteet ovat voineet muuttua. Tarkista sivu [Integraatioiden lähtevän liikenteen IP-osoitteiden määrittäminen](/fi/integrations/managing/egress-ip-addresses) ja päivitä **Custom IP** -luettelo vastaamaan niitä.
  </Accordion>

  <Accordion title="V1-tunnuksen käyttö v2-tunnuksen sijaan">
    V1- ja v2-tunnukset käyttävät eri todennusmekanismeja:

    * **v1**: kyselyparametri (`token=...`)
    * **v2**: otsake (`Netskope-Api-Token: ...`)

    Living Security käyttää v2-todennusta. Luo uusi tunnus kohdassa **Asetukset → Tools → REST API v2** (ei vanhan v1-tunnuksen sivulla).
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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