Skip to main content

​
Wat deze integratie bijdraagt

Netskope kan genormaliseerde activiteit op het gebied van web, cloud, authenticatie, gegevensbescherming en bedreigingen aanleveren. Beoordeelde voorbeelden zijn onder meer:
  • web.ai.visited — AI-website bezocht
  • data.bulk.uploaded — bulkupload van gegevens
  • geo.impossible — onmogelijke reis tussen aanmeldingen
De huidige koppeling maakt gebruik van REST API v2; voor bestaande klanten kan een verouderde REST-variant verschijnen. Zie hoe integratiegegevens Signalen worden.

​
Wat Living Security nodig heeft

Vereiste toegang tot endpoints: Vereiste rol: Tenant Admin of een equivalente rol met toegang tot Settings → Tools
Voor deze integratie is een v2 API-token vereist, geen v1-token. V1-tokens gebruiken authenticatie via een queryparameter en werken niet met het v2 API-endpoint.

​
Vereisten

  • U moet beschikken over Tenant Admin-toegang in Netskope om REST API-tokens te beheren.

​
Deel A — In Netskope

Uw Netskope-beheerder voert deze stappen uit.
1

Naar het beheer van REST API v2-tokens gaan

  1. Meld u aan bij uw Netskope-beheerconsole via https://<tenant>.goskope.com.
  2. Klik in het navigatiemenu links op Settings.
  3. Selecteer onder Tools de optie REST API v2.
2

Een nieuw token aanmaken

  1. Klik op New Token.
  2. Voer een beschrijvende naam in (bijv. Living Security Platform).
  3. Schakel onder endpointtoegang toegang in voor:
Verleen toegang tot beide endpoints. Ze voeden twee afzonderlijke stromen — alerts en events — en een token dat slechts tot één van beide is beperkt, maakt nog steeds succesvol verbinding. De stroom achter het ontbrekende endpoint levert dan niets op, zonder foutmelding die aangeeft waarom.
Deze twee zijn de enige endpoints die Living Security nodig heeft. Door niets daarbovenop toe te kennen, volgt u het principe van minimale rechten.
  1. Klik op Opslaan (of Generate Token).
3

Uw token kopiëren en opslaan

Kopieer het token direct en bewaar het veilig.
Netskope toont de tokenwaarde slechts één keer bij het aanmaken. Als u wegnavigeert zonder het te kopiëren, moet u het token verwijderen en een nieuw token aanmaken.
4

IP-allowlist configureren (indien van toepassing)

Als voor uw Netskope-tenant IP-allowlisting is ingeschakeld, moet u de egress-IP-bereiken van Living Security toevoegen.
  1. Ga in de Netskope-beheerconsole naar Settings → Administration → IP Allowlist.
  2. Als IP-allowlisting is ingeschakeld, voegt u elk egress-IP-adres van Living Security toe aan de lijst Custom IP.
Als IP-allowlisting is ingeschakeld, slaagt het verbindingsdialoogvenster, maar mislukt de gegevenssynchronisatie met 401 Unauthorized totdat de juiste IP-adressen zijn toegevoegd.
5

Uw tenant-subdomein bepalen

Uw tenant-subdomein is het voorvoegsel van de URL van uw Netskope-beheerconsole.Als de URL van uw console https://acme.goskope.com is, is uw subdomein acme.Voer uitsluitend het kale subdomein in — geen https://, geen .goskope.com, geen afsluitende schuine streep.
Het verbindingsdialoogvenster accepteert meerdere invoervormen (kaal subdomein, volledige hostnaam of volledige URL) en normaliseert deze automatisch. Het wordt echter aanbevolen om het kale subdomein in te voeren.

​
Deel B — In het Living Security Platform

De programma-eigenaar voert deze stap uit, of de systeembeheerder bij gedelegeerde installatie.
U bent nu verbonden met Netskope (v2 API).

​
Probleemoplossing

Veelvoorkomende oorzaken:
  1. Token ingetrokken of verlopen — genereer een nieuw token
  2. Gebruik van een v1-token — v1-tokens authenticeren via een queryparameter en werken niet met v2-endpoints. Genereer een nieuw v2-token via Settings → Tools → REST API v2
  3. IP-allowlist blokkeert verzoeken — als voor uw tenant IP-allowlisting is ingeschakeld, controleert u of alle vier de egress-IP-adressen van Living Security op de allowlist staan
Het token is aangemaakt zonder toegang tot /api/v2/events/data/alert of /api/v2/events/data/page. De endpointmachtigingen van een token kunnen na het aanmaken niet meer worden gewijzigd — maak een nieuw token aan met leestoegang tot beide en koppel opnieuw.
Het token mist een van de twee vereiste endpoints. Een token dat slechts tot /api/v2/events/data/alert of slechts tot /api/v2/events/data/page is beperkt, maakt nog steeds verbinding, en de stroom achter het ontbrekende endpoint blijft stilzwijgend leeg.Endpointmachtigingen kunnen na het aanmaken van een token niet meer worden gewijzigd — genereer een nieuw token met leestoegang tot beide en koppel vervolgens opnieuw.
Als IP-allowlisting is ingeschakeld, kunnen de egress-IP-adressen van Living Security zijn gewijzigd. Raadpleeg Egress-IP-adressen voor integraties configureren en werk de lijst Custom IP dienovereenkomstig bij.
V1- en v2-tokens gebruiken verschillende authenticatiemechanismen:
  • v1: queryparameter (token=...)
  • v2: header (Netskope-Api-Token: ...)
Living Security gebruikt v2-authenticatie. Genereer een nieuw token via Settings → Tools → REST API v2 (niet via de verouderde v1-tokenpagina).