Skip to main content

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

​
Mitä Living Security tarvitsee

Vaadittu päätepisteiden käyttöoikeus: Vaadittu rooli: Tenant Admin tai vastaava rooli, jolla on pääsy kohtaan Asetukset → Tools
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.

​
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.
1

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

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:
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ä.
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.
  1. Napsauta Tallenna (tai Generate Token).
3

Kopioi ja tallenna tunnus

Kopioi tunnus heti ja säilytä se turvallisesti.
Netskope näyttää tunnuksen arvon vain kerran luomisen yhteydessä. Jos poistut näkymästä kopioimatta sitä, sinun on poistettava tunnus ja luotava uusi.
4

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 Custom IP -luetteloon.
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.
5

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

​
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.
Netskope (v2 API) on nyt yhdistetty.

​
Vianmääritys

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 ovat sallittujen luettelossa
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.
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.
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 ja päivitä Custom IP -luettelo vastaamaan niitä.
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).