Skip to main content

​
Què aporta aquesta integració

Netskope pot aportar activitat normalitzada web, al núvol, d’autenticació, de protecció de dades i d’amenaces. Alguns exemples revisats:
  • web.ai.visited — lloc web d’IA visitat
  • data.bulk.uploaded — càrrega massiva de dades
  • geo.impossible — viatge impossible entre inicis de sessió
La connexió actual utilitza REST API v2; és possible que als clients existents els aparegui una variant REST heretada. Consulteu com es converteixen les dades de la integració en signals.

​
Què necessita Living Security

Accés als endpoints necessari: Rol necessari: Tenant Admin o un rol equivalent amb accés a Settings → Tools
Aquesta integració requereix un token de l’API v2, no un token v1. Els tokens v1 utilitzen l’autenticació mitjançant paràmetre de consulta i no funcionaran amb l’endpoint de l’API v2.

​
Requisits previs

  • Heu de tenir accés de Tenant Admin a Netskope per gestionar els tokens de REST API.

​
Part A — A Netskope

L’administrador de Netskope fa aquests passos.
1

Aneu a la gestió de tokens de REST API v2

  1. Inicieu la sessió a la consola d’administració de Netskope a https://<tenant>.goskope.com.
  2. Al menú de navegació de l’esquerra, feu clic a Settings.
  3. A Tools, seleccioneu REST API v2.
2

Creeu un token nou

  1. Feu clic a New Token.
  2. Introduïu un nom descriptiu (p. ex., Living Security Platform).
  3. A l’accés als endpoints, activeu l’accés a:
Concediu accés a tots dos endpoints. Alimenten dos fluxos diferents (alerts i events) i un token limitat a només un d’ells es connecta igualment sense problemes. El flux associat a l’endpoint que falta no retorna res, sense cap error que n’indiqui el motiu.
Aquests dos són els únics endpoints que necessita Living Security. No concedir res més que aquests segueix el principi de mínim privilegi.
  1. Feu clic a Save (o Generate Token).
3

Copieu i deseu el token

Copieu el token immediatament i deseu-lo en un lloc segur.
Netskope mostra el valor del token només una vegada, en el moment de crear-lo. Si abandoneu la pàgina sense copiar-lo, haureu d’eliminar el token i crear-ne un de nou.
4

Configureu la llista d'IP permeses (si escau)

Si el vostre tenant de Netskope té activada la llista d’IP permeses, heu d’afegir els intervals d’IP de sortida de Living Security.
  1. A la consola d’administració de Netskope, aneu a Settings → Administration → IP Allowlist.
  2. Si la llista d’IP permeses està activada, afegiu cada adreça IP de sortida de Living Security a la llista Custom IP.
Si la llista d’IP permeses està activada, el diàleg de connexió s’completarà correctament, però les sincronitzacions de dades fallaran amb 401 Unauthorized fins que s’hi afegeixin les IP correctes.
5

Identifiqueu el subdomini del tenant

El subdomini del vostre tenant és el prefix de l’URL de la consola d’administració de Netskope.Si l’URL de la consola és https://acme.goskope.com, el vostre subdomini és acme.Introduïu només el subdomini sense res més: sense https://, sense .goskope.com i sense barra final.
El diàleg de connexió accepta diversos formats d’entrada (subdomini sol, nom d’amfitrió complet o URL completa) i els normalitza automàticament. No obstant això, es recomana introduir només el subdomini.

​
Part B — A Living Security Platform

El responsable del programa fa aquest pas, o l’administrador del sistema si s’utilitza la configuració delegada.
Ara ja esteu connectat a Netskope (v2 API).

​
Resolució de problemes

Causes habituals:
  1. Token revocat o caducat — genereu un token nou
  2. Ús d’un token v1 — els tokens v1 s’autentiquen mitjançant un paràmetre de consulta i no funcionen amb els endpoints v2. Genereu un token v2 nou des de Settings → Tools → REST API v2
  3. La llista d’IP permeses bloqueja les sol·licituds — si el vostre tenant té activada la llista d’IP permeses, comproveu que les quatre adreces IP de sortida de Living Security són a la llista
El token es va crear sense accés a /api/v2/events/data/alert o /api/v2/events/data/page. Els permisos dels endpoints del token no es poden modificar després de crear-lo: creeu un token nou amb accés de lectura a tots dos i torneu-vos a connectar.
Al token li falta un dels dos endpoints necessaris. Un token limitat només a /api/v2/events/data/alert o només a /api/v2/events/data/page es connecta igualment, i el flux associat a l’endpoint que falta queda buit sense cap avís.Els permisos dels endpoints no es poden modificar després de crear un token: genereu un token nou amb accés de lectura a tots dos i torneu-vos a connectar.
Si la llista d’IP permeses està activada, és possible que les adreces IP de sortida de Living Security hagin canviat. Consulteu Configuració de les adreces IP de sortida de les integracions i actualitzeu la llista Custom IP perquè hi coincideixi.
Els tokens v1 i v2 utilitzen mecanismes d’autenticació diferents:
  • v1: paràmetre de consulta (token=...)
  • v2: capçalera (Netskope-Api-Token: ...)
Living Security utilitza l’autenticació v2. Genereu un token nou des de Settings → Tools → REST API v2 (no des de la pàgina heretada de tokens v1).