> ## 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

> Ingérez les alertes SSE, les événements web/SaaS/ZTNA/réseau, les utilisateurs et les appareils Netskope Client de Netskope

> [!NOTE]
>
> Netskope est actuellement en **bêta**

Wirespeed se connecte à votre locataire Netskope Security Cloud à l’aide d’un jeton REST API **v2**. Il s’agit du produit SSE/SASE (`*.goskope.com`), et non de Device Intelligence.

## Prérequis

* Le nom d’hôte d’un locataire Netskope (par exemple `company.goskope.com` ou `company.eu.goskope.com`)
* Un jeton REST API v2 issu d’un **Service Account** dont le rôle dispose de **View** sur :
  * **Skope IT → Alerts**
  * **Skope IT → Application Events**
  * **Skope IT → Network Events**
  * **Skope IT → Page Events** (connexions HTTP / événements de page)
  * **Administration → Users & Groups**
  * **Settings → Security Cloud Platform → Devices** (état des appareils Netskope Client ; facultatif)
* Si le locataire utilise une liste d’adresses IP autorisées (**Settings → Administration → IP Allowlist**), ajoutez les adresses IP sortantes de Wirespeed à la liste personnalisée

## Créer un jeton REST API v2

1. Connectez-vous au locataire Netskope
2. Ouvrez **Settings → Administration → Administrators & Roles → Roles** et créez un rôle disposant de **View** sur les domaines fonctionnels listés ci-dessus. Définissez toutes les autres autorisations sur **None**
3. Ouvrez l’onglet **Administrators**, cliquez sur **Service Account**, attribuez ce rôle et générez un jeton REST API
4. Copiez le jeton lorsqu’il s’affiche. Il ne sera plus affiché ensuite

Sur les locataires plus anciens qui disposent encore de **Settings → Tools → REST API v2 → New Token**, créez-y un jeton et ajoutez **Read** sur :

* `/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` (facultatif, pour la synchronisation des appareils)

au lieu d’utiliser un rôle de Service Account.

## Ajouter l’intégration dans Wirespeed

1. Dans Wirespeed, accédez à **Intégrations** > [**Ajouter une intégration**](https://app.wirespeed.co/settings/integrations?tab=browse) > **Netskope**
2. Saisissez le **Nom d’hôte du locataire** (par exemple `company.eu.goskope.com`). Une URL complète du locataire fonctionne également
3. Collez le jeton REST API v2
4. Validez l’intégration

## Données ingérées par Wirespeed

| Source | API Netskope | Objectif |
| - | - | - |
| Alertes | `GET /api/v2/events/dataexport/events/alert` | Détections (logiciels malveillants, DLP, stratégies, sites malveillants, anomalies et types d’alertes associés) |
| Événements d’application | `GET /api/v2/events/dataexport/events/application` | Journaux d’activité SaaS / CASB |
| Événements de page | `GET /api/v2/events/dataexport/events/page` | Journaux de proxy web / de connexions HTTP |
| Événements réseau | `GET /api/v2/events/dataexport/events/network` | Journaux réseau / de type pare-feu |
| Utilisateurs | `GET /api/v2/scim/Users` | Synchronisation de l’annuaire |
| Appareils | `GET /api/v2/events/datasearch/clientstatus` | Inventaire des terminaux : appareils Netskope Client avec nom d’hôte, système d’exploitation, date de dernière activité et utilisateur (synchronisation quotidienne ; **Actualiser les données du terminal** sur un appareil récupère son dernier état à la demande) |

> [!NOTE]
>
> Pour les journaux d’événements, la première synchronisation récupère environ **24 heures** d’historique, puis reprend là où la récupération précédente s’est arrêtée. La synchronisation des appareils lit les **30 derniers jours** d’état des clients à chaque exécution.

> [!NOTE]
>
> La synchronisation des appareils est facultative. Si le jeton ne peut pas lire `/api/v2/events/datasearch/clientstatus`, toutes les autres sources continuent de fonctionner et l’intégration affiche un avertissement **État des appareils**. Wirespeed revérifie l’accès toutes les quelques heures : les appareils commencent à se synchroniser dès que vous accordez l’autorisation, sans reconnexion.


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