> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Netskope

> Ingestar alertas SSE, eventos web/SaaS/ZTNA/de red, usuarios y dispositivos Netskope Client desde Netskope

> [!NOTE]
>
> Netskope está actualmente en **beta**

Wirespeed se conecta a su inquilino de Netskope Security Cloud con un token REST API **v2**. Se trata del producto SSE/SASE (`*.goskope.com`), no de Device Intelligence.

## Requisitos previos

* Un nombre de host de inquilino de Netskope (por ejemplo, `company.goskope.com` o `company.eu.goskope.com`)
* Un token REST API v2 de una **Service Account** cuyo rol tenga **View** en:
  * **Skope IT → Alerts**
  * **Skope IT → Application Events**
  * **Skope IT → Network Events**
  * **Skope IT → Page Events** (eventos de conexión HTTP / de página)
  * **Administration → Users & Groups**
  * **Settings → Security Cloud Platform → Devices** (estado de dispositivos Netskope Client; opcional)
* Si el inquilino usa una lista de permitidos de IP (**Settings → Administration → IP Allowlist**), añada las IP de salida de Wirespeed a la lista personalizada

## Crear un token REST API v2

1. Inicie sesión en el inquilino de Netskope
2. Abra **Settings → Administration → Administrators & Roles → Roles** y cree un rol con **View** en las áreas funcionales indicadas arriba. Establezca el resto de permisos en **None**
3. Abra la pestaña **Administrators**, haga clic en **Service Account**, asigne ese rol y genere un token REST API
4. Copie el token cuando se muestre. No se vuelve a mostrar

En inquilinos antiguos que aún tienen **Settings → Tools → REST API v2 → New Token**, cree un token allí y añada **Read** en:

* `/api/v2/events/dataexport/events/alert`
* `/api/v2/events/dataexport/events/application`
* `/api/v2/events/dataexport/events/page`
* `/api/v2/events/dataexport/events/network`
* `/api/v2/scim/Users`
* `/api/v2/events/datasearch/clientstatus` (opcional, para la sincronización de dispositivos)

en lugar de usar un rol de Service Account.

## Añadir la integración en Wirespeed

1. En Wirespeed, vaya a **Integraciones** > [**Añadir integración**](https://app.wirespeed.co/settings/integrations?tab=browse) > **Netskope**
2. Introduzca el **Tenant Hostname** (por ejemplo, `company.eu.goskope.com`). También funciona una URL completa del inquilino
3. Pegue el token REST API v2
4. Envíe la integración

## Qué ingesta Wirespeed

| Origen | API de Netskope | Finalidad |
| - | - | - |
| Alertas | `GET /api/v2/events/dataexport/events/alert` | Detecciones (malware, DLP, política, malsite, anomalía y tipos de alerta relacionados) |
| Eventos de aplicación | `GET /api/v2/events/dataexport/events/application` | Registros de actividad SaaS / CASB |
| Eventos de página | `GET /api/v2/events/dataexport/events/page` | Registros de proxy web / de conexión HTTP |
| Eventos de red | `GET /api/v2/events/dataexport/events/network` | Registros de red / de estilo firewall |
| Usuarios | `GET /api/v2/scim/Users` | Sincronización de directorio |
| Dispositivos | `GET /api/v2/events/datasearch/clientstatus` | Inventario de puntos de conexión: dispositivos Netskope Client con nombre de host, SO, hora de última visualización y usuario (sincronizados diariamente; **Actualizar datos del punto de conexión** en un dispositivo obtiene su estado más reciente bajo demanda) |

> [!NOTE]
>
> Para los registros de eventos, la primera sincronización recupera datos de aproximadamente las últimas **24 horas** y, a continuación, continúa desde donde quedó la extracción anterior. La sincronización de dispositivos lee los últimos **30 días** de estado del cliente en cada ejecución.

> [!NOTE]
>
> La sincronización de dispositivos es opcional. Si el token no puede leer `/api/v2/events/datasearch/clientstatus`, el resto de orígenes sigue funcionando y la integración muestra una advertencia de **Device Status**. Wirespeed vuelve a comprobar el acceso cada pocas horas, de modo que los dispositivos empiezan a sincronizarse tras conceder el permiso sin necesidad de volver a conectar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.