Skip to main content

​
Hva denne integrasjonen bidrar med

Netskope kan bidra med normalisert aktivitet knyttet til web, sky, autentisering, databeskyttelse og trusler. Gjennomgåtte eksempler omfatter:
  • web.ai.visited — besøk på AI-nettsted
  • data.bulk.uploaded — masseopplasting av data
  • geo.impossible — umulig reiseforflytning mellom pålogginger
Den gjeldende tilkoblingen bruker REST API v2. En eldre REST-variant kan vises for eksisterende kunder. Se hvordan integrasjonsdata blir til signaler.

​
Hva Living Security trenger

Nødvendig endepunkttilgang: Nødvendig rolle: Tenant Admin eller tilsvarende med tilgang til Settings → Tools
Denne integrasjonen krever et v2 API-token, ikke et v1-token. V1-token bruker autentisering med spørringsparameter og fungerer ikke med v2 API-endepunktet.

​
Forutsetninger

  • Du må ha Tenant Admin-tilgang i Netskope for å kunne administrere REST API-token.

​
Del A — I Netskope

Netskope-administratoren din utfører disse trinnene.
1

Gå til administrasjon av REST API v2-token

  1. Logg på administrasjonskonsollen i Netskope på https://<tenant>.goskope.com.
  2. Klikk på Settings i venstre navigasjonsfelt.
  3. Velg REST API v2 under Tools.
2

Opprett et nytt token

  1. Klikk på New Token.
  2. Skriv inn et beskrivende navn (f.eks. Living Security Platform).
  3. Under endepunkttilgang aktiverer du tilgang til:
Gi tilgang til begge endepunktene. De mater to separate strømmer — alerts og events — og et token som er begrenset til bare ett av dem, kobler likevel til uten problemer. Strømmen bak det manglende endepunktet returnerer da ingenting, uten noen feilmelding som forklarer hvorfor.
Disse to er de eneste endepunktene Living Security krever. Å gi tilgang til ingenting utover disse følger prinsippet om minste privilegium.
  1. Klikk på Save (eller Generate Token).
3

Kopier og lagre tokenet

Kopier tokenet umiddelbart og oppbevar det sikkert.
Netskope viser tokenverdien bare én gang ved opprettelsen. Hvis du forlater siden uten å kopiere den, må du slette tokenet og opprette et nytt.
4

Konfigurer IP-tillatelsesliste (hvis aktuelt)

Hvis Netskope-tenanten din har IP-tillatelsesliste aktivert, må du legge til Living Securitys IP-områder for utgående trafikk.
  1. I administrasjonskonsollen i Netskope går du til Settings → Administration → IP Allowlist.
  2. Hvis IP-tillatelsesliste er aktivert, legger du til hver utgående IP-adresse for Living Security i listen Custom IP.
Hvis IP-tillatelsesliste er aktivert, vil tilkoblingsdialogen lykkes, men datasynkroniseringer vil mislykkes med 401 Unauthorized helt til de riktige IP-adressene er lagt til.
5

Finn tenant-underdomenet ditt

Tenant-underdomenet er prefikset i URL-en til administrasjonskonsollen i Netskope.Hvis konsoll-URL-en din er https://acme.goskope.com, er underdomenet ditt acme.Skriv bare inn selve underdomenet — ingen https://, ingen .goskope.com, ingen avsluttende skråstrek.
Tilkoblingsdialogen godtar flere inndataformer (bare underdomene, fullt vertsnavn eller full URL) og normaliserer dem automatisk. Det anbefales likevel å skrive inn bare underdomenet.

​
Del B — I Living Security Platform

Programansvarlig utfører dette trinnet, eller systemadministratoren hvis delegert oppsett brukes.
Du er nå koblet til Netskope (v2 API).

​
Feilsøking

Vanlige årsaker:
  1. Tokenet er tilbakekalt eller utløpt — generer et nytt token
  2. Bruk av et v1-token — v1-token autentiserer via spørringsparameter og fungerer ikke med v2-endepunkter. Generer et nytt v2-token fra Settings → Tools → REST API v2
  3. IP-tillatelseslisten blokkerer forespørsler — hvis tenanten din har IP-tillatelsesliste aktivert, kontroller at alle fire utgående IP-adresser for Living Security står på tillatelseslisten
Tokenet ble opprettet uten tilgang til /api/v2/events/data/alert eller /api/v2/events/data/page. Endepunkttillatelser for et token kan ikke endres etter opprettelsen — opprett et nytt token med lesetilgang til begge, og koble til på nytt.
Tokenet mangler ett av de to nødvendige endepunktene. Et token som er begrenset til bare /api/v2/events/data/alert eller bare /api/v2/events/data/page, kobler likevel til, og strømmen bak det manglende endepunktet forblir stille tom.Endepunkttillatelser kan ikke endres etter at et token er opprettet — generer et nytt token med lesetilgang til begge, og koble deretter til på nytt.
Hvis IP-tillatelsesliste er aktivert, kan Living Securitys utgående IP-adresser ha endret seg. Se Konfigurere utgående IP-adresser for integrasjoner og oppdater listen Custom IP deretter.
V1- og v2-token bruker ulike autentiseringsmekanismer:
  • v1: Spørringsparameter (token=...)
  • v2: Header (Netskope-Api-Token: ...)
Living Security bruker v2-autentisering. Generer et nytt token fra Settings → Tools → REST API v2 (ikke siden for det eldre v1-tokenet).