Skip to main content

​
Hvad denne integration bidrager med

Netskope kan bidrage med normaliseret aktivitet inden for web, cloud, godkendelse, databeskyttelse og trusler. Gennemgåede eksempler omfatter:
  • web.ai.visited — besøg på AI-websted
  • data.bulk.uploaded — masseupload af data
  • geo.impossible — umulig rejse mellem logins
Den nuværende forbindelse bruger REST API v2; en ældre REST-variant kan forekomme for eksisterende kunder. Se hvordan integrationsdata bliver til signaler.

​
Hvad Living Security har brug for

Påkrævet endpoint-adgang: Påkrævet rolle: Tenant Admin eller tilsvarende med adgang til Indstillinger → Tools
Denne integration kræver et v2 API-token, ikke et v1-token. V1-tokens bruger godkendelse via forespørgselsparameter og fungerer ikke med v2 API-endpointet.

​
Forudsætninger

  • Du skal have Tenant Admin-adgang i Netskope for at administrere REST API-tokens.

​
Del A — I Netskope

Din Netskope-administrator udfører disse trin.
1

Gå til administration af REST API v2-tokens

  1. Log ind på din Netskope-administrationskonsol på https://<tenant>.goskope.com.
  2. Klik på Indstillinger i venstre navigation.
  3. Vælg REST API v2 under Tools.
2

Opret et nyt token

  1. Klik på New Token.
  2. Angiv et beskrivende navn (f.eks. Living Security Platform).
  3. Under endpoint-adgang skal du aktivere adgang til:
Giv adgang til begge endpoints. De forsyner to separate datastrømme — alerts og events — og et token, der kun er begrænset til den ene, kan stadig oprette forbindelse. Datastrømmen bag det manglende endpoint returnerer derefter ingenting, uden at nogen fejl angiver årsagen.
Disse to er de eneste endpoints, som Living Security kræver. Hvis du ikke giver adgang til mere end dem, følger du princippet om mindste privilegium.
  1. Klik på Gem (eller Generate Token).
3

Kopiér og gem dit token

Kopiér tokenet med det samme, og opbevar det sikkert.
Netskope viser tokenets værdi kun én gang ved oprettelsen. Hvis du forlader siden uden at kopiere det, skal du slette tokenet og oprette et nyt.
4

Konfigurer IP-tilladelsesliste (hvis relevant)

Hvis din Netskope-tenant har IP-tilladelsesliste aktiveret, skal du tilføje Living Securitys udgående IP-intervaller.
  1. Gå til Indstillinger → Administration → IP Allowlist i Netskope-administrationskonsollen.
  2. Hvis IP-tilladelsesliste er aktiveret, skal du tilføje hver udgående IP-adresse fra Living Security til listen Custom IP.
Hvis IP-tilladelsesliste er aktiveret, lykkes forbindelsesdialogen, men datasynkroniseringer mislykkes med 401 Unauthorized, indtil de korrekte IP-adresser er tilføjet.
5

Find dit tenant-underdomæne

Dit tenant-underdomæne er præfikset i URL’en til din Netskope-administrationskonsol.Hvis din konsol-URL er https://acme.goskope.com, er dit underdomæne acme.Angiv kun det rene underdomæne — ingen https://, ingen .goskope.com, ingen afsluttende skråstreg.
Forbindelsesdialogen accepterer flere inputformer (rent underdomæne, fuldt værtsnavn eller fuld URL) og normaliserer dem automatisk. Det anbefales dog at angive det rene underdomæne.

​
Del B — I Living Security Platform

Programejeren udfører dette trin, eller systemadministratoren, hvis der bruges delegeret opsætning.
Du er nu forbundet til Netskope (v2 API).

​
Fejlfinding

Almindelige årsager:
  1. Token tilbagekaldt eller udløbet — generer et nyt token
  2. Brug af et v1-token — v1-tokens godkendes via forespørgselsparameter og fungerer ikke med v2-endpoints. Generer et nyt v2-token fra Indstillinger → Tools → REST API v2
  3. IP-tilladelsesliste blokerer forespørgsler — hvis din tenant har IP-tilladelsesliste aktiveret, skal du kontrollere, at alle fire udgående IP-adresser fra Living Security står på tilladelseslisten
Tokenet blev oprettet uden adgang til /api/v2/events/data/alert eller /api/v2/events/data/page. Et tokens endpoint-tilladelser kan ikke ændres efter oprettelsen — opret et nyt token med læseadgang til begge, og opret forbindelsen igen.
Tokenet mangler et af de to påkrævede endpoints. Et token, der kun er begrænset til /api/v2/events/data/alert eller kun /api/v2/events/data/page, kan stadig oprette forbindelse, og datastrømmen bag det manglende endpoint forbliver stille tom.Endpoint-tilladelser kan ikke ændres, efter et token er oprettet — generer et nyt token med læseadgang til begge, og opret derefter forbindelsen igen.
Hvis IP-tilladelsesliste er aktiveret, kan Living Securitys udgående IP-adresser have ændret sig. Se Konfiguration af udgående IP-adresser for integrationer, og opdater listen Custom IP, så den matcher.
V1- og v2-tokens bruger forskellige godkendelsesmekanismer:
  • v1: Forespørgselsparameter (token=...)
  • v2: Header (Netskope-Api-Token: ...)
Living Security bruger v2-godkendelse. Generer et nyt token fra Indstillinger → Tools → REST API v2 (ikke den ældre v1-tokenside).