Skip to main content

​
Qué aporta esta integración

Netskope puede aportar actividad normalizada de web, nube, autenticación, protección de datos y amenazas. Entre los ejemplos revisados se incluyen:
  • web.ai.visited — sitio web de IA visitado
  • data.bulk.uploaded — carga masiva de datos
  • geo.impossible — viaje imposible entre inicios de sesión
La conexión actual utiliza la API REST v2; es posible que aparezca una variante REST heredada para los clientes existentes. Consulte cómo los datos de las integraciones se convierten en señales.

​
Qué necesita Living Security

Acceso a endpoints requerido: Rol requerido: Tenant Admin o equivalente con acceso a Configuración → Tools
Esta integración requiere un token de API v2, no un token v1. Los tokens v1 utilizan autenticación mediante parámetros de consulta y no funcionarán con el endpoint de la API v2.

​
Requisitos previos

  • Debe tener acceso de Tenant Admin en Netskope para gestionar los tokens de la API REST.

​
Parte A — En Netskope

Su administrador de Netskope completa estos pasos.
1

Acceda a la gestión de tokens de REST API v2

  1. Inicie sesión en su consola de administración de Netskope en https://<tenant>.goskope.com.
  2. En la navegación izquierda, haga clic en Configuración.
  3. En Tools, seleccione REST API v2.
2

Cree un nuevo token

  1. Haga clic en New Token.
  2. Introduzca un nombre descriptivo (p. ej., Living Security Platform).
  3. En el acceso a endpoints, habilite el acceso a:
Conceda acceso a ambos endpoints. Alimentan dos flujos independientes (alerts y events), y un token limitado a solo uno de ellos se conecta correctamente de todos modos. El flujo asociado al endpoint omitido no devuelve nada, sin ningún error que indique el motivo.
Estos dos son los únicos endpoints que requiere Living Security. No conceder nada más allá de ellos respeta el principio de mínimo privilegio.
  1. Haga clic en Guardar (o Generate Token).
3

Copie y guarde su token

Copie el token de inmediato y almacénelo de forma segura.
Netskope muestra el valor del token solo una vez, en el momento de su creación. Si abandona la página sin copiarlo, deberá eliminar el token y crear uno nuevo.
4

Configure la lista de IP permitidas (si procede)

Si su tenant de Netskope tiene habilitada la lista de IP permitidas, debe agregar los rangos de IP de salida de Living Security.
  1. En la consola de administración de Netskope, vaya a Configuración → Administración → IP Allowlist.
  2. Si la lista de IP permitidas está habilitada, agregue cada dirección IP de salida de Living Security a la lista Custom IP.
Si la lista de IP permitidas está habilitada, el cuadro de diálogo de conexión se completará correctamente, pero las sincronizaciones de datos fallarán con 401 Unauthorized hasta que se agreguen las IP correctas.
5

Identifique el subdominio de su tenant

El subdominio de su tenant es el prefijo de la URL de su consola de administración de Netskope.Si la URL de su consola es https://acme.goskope.com, su subdominio es acme.Introduzca únicamente el subdominio simple: sin https://, sin .goskope.com y sin barra final.
El cuadro de diálogo de conexión acepta varios formatos de entrada (subdominio simple, nombre de host completo o URL completa) y los normaliza automáticamente. No obstante, se recomienda introducir el subdominio simple.

​
Parte B — En Living Security Platform

El responsable del programa completa este paso, o el administrador del sistema si se utiliza la configuración delegada.
Ya está conectado a Netskope (v2 API).

​
Solución de problemas

Causas habituales:
  1. Token revocado o caducado: genere un nuevo token.
  2. Uso de un token v1: los tokens v1 se autentican mediante parámetros de consulta y no funcionan con los endpoints v2. Genere un nuevo token v2 desde Configuración → Tools → REST API v2.
  3. La lista de IP permitidas bloquea las solicitudes: si su tenant tiene habilitada la lista de IP permitidas, compruebe que las cuatro direcciones IP de salida de Living Security estén en la lista.
El token se creó sin acceso a /api/v2/events/data/alert o /api/v2/events/data/page. Los permisos de endpoints del token no se pueden modificar tras su creación: cree un nuevo token con acceso de lectura a ambos y vuelva a conectar.
Al token le falta uno de los dos endpoints requeridos. Un token limitado solo a /api/v2/events/data/alert o solo a /api/v2/events/data/page se conecta de todos modos, y el flujo asociado al endpoint omitido permanece vacío sin notificarlo.Los permisos de endpoints no se pueden modificar una vez creado el token: genere un nuevo token con acceso de lectura a ambos y, a continuación, vuelva a conectar.
Si la lista de IP permitidas está habilitada, es posible que las direcciones IP de salida de Living Security hayan cambiado. Consulte Configuración de las direcciones IP de salida de las integraciones y actualice la lista Custom IP para que coincida.
Los tokens v1 y v2 utilizan mecanismos de autenticación distintos:
  • v1: parámetro de consulta (token=...)
  • v2: encabezado (Netskope-Api-Token: ...)
Living Security utiliza la autenticación v2. Genere un nuevo token desde Configuración → Tools → REST API v2 (no desde la página heredada de tokens v1).