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

> SSE-Warnungen, Web-/SaaS-/ZTNA-/Netzwerkereignisse, Benutzer und Netskope-Client-Geräte aus Netskope erfassen

> [!NOTE]
>
> Netskope befindet sich derzeit in der **Beta-Phase**

Wirespeed verbindet sich mit Ihrem Netskope-Security-Cloud-Mandanten über ein REST-API-**v2**-Token. Es handelt sich um das SSE/SASE-Produkt (`*.goskope.com`), nicht um Device Intelligence.

## Voraussetzungen

* Ein Hostname des Netskope-Mandanten (zum Beispiel `company.goskope.com` oder `company.eu.goskope.com`)
* Ein REST-API-v2-Token eines **Service Account**, dessen Rolle **View** für folgende Bereiche hat:
  * **Skope IT → Alerts**
  * **Skope IT → Application Events**
  * **Skope IT → Network Events**
  * **Skope IT → Page Events** (HTTP-Verbindungs- bzw. Seitenereignisse)
  * **Administration → Users & Groups**
  * **Settings → Security Cloud Platform → Devices** (Gerätestatus des Netskope Client; optional)
* Wenn der Mandant eine IP-Zulassungsliste verwendet (**Settings → Administration → IP Allowlist**), fügen Sie die ausgehenden IP-Adressen von Wirespeed zur benutzerdefinierten Liste hinzu

## REST-API-v2-Token erstellen

1. Melden Sie sich beim Netskope-Mandanten an
2. Öffnen Sie **Settings → Administration → Administrators & Roles → Roles** und erstellen Sie eine Rolle mit **View** für die oben aufgeführten Funktionsbereiche. Setzen Sie alle anderen Berechtigungen auf **None**
3. Öffnen Sie die Registerkarte **Administrators**, klicken Sie auf **Service Account**, weisen Sie diese Rolle zu und generieren Sie ein REST-API-Token
4. Kopieren Sie das Token, sobald es angezeigt wird. Es wird nicht erneut angezeigt

Bei älteren Mandanten, die noch über **Settings → Tools → REST API v2 → New Token** verfügen, erstellen Sie dort ein Token und fügen **Read** für Folgendes hinzu:

* `/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` (optional, für die Gerätesynchronisierung)

anstatt eine Service-Account-Rolle zu verwenden.

## Integration in Wirespeed hinzufügen

1. Navigieren Sie in Wirespeed zu **Integrationen** > [**Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse) > **Netskope**
2. Geben Sie den **Mandanten-Hostnamen** ein (zum Beispiel `company.eu.goskope.com`). Eine vollständige Mandanten-URL funktioniert ebenfalls
3. Fügen Sie das REST-API-v2-Token ein
4. Senden Sie die Integration ab

## Was Wirespeed erfasst

| Quelle | Netskope-API | Zweck |
| - | - | - |
| Warnungen | `GET /api/v2/events/dataexport/events/alert` | Detektionen (Malware, DLP, Richtlinien, Malsite, Anomalien und verwandte Warnungstypen) |
| Anwendungsereignisse | `GET /api/v2/events/dataexport/events/application` | SaaS-/CASB-Aktivitätsprotokolle |
| Seitenereignisse | `GET /api/v2/events/dataexport/events/page` | Webproxy-/HTTP-Verbindungsprotokolle |
| Netzwerkereignisse | `GET /api/v2/events/dataexport/events/network` | Netzwerk-/Firewall-artige Protokolle |
| Benutzer | `GET /api/v2/scim/Users` | Verzeichnissynchronisierung |
| Geräte | `GET /api/v2/events/datasearch/clientstatus` | Endpunktinventar: Netskope-Client-Geräte mit Hostname, Betriebssystem, Zeitpunkt der letzten Aktivität und Benutzer (tägliche Synchronisierung; **Endgerätedaten aktualisieren** auf einem Gerät ruft dessen aktuellen Status bei Bedarf ab) |

> [!NOTE]
>
> Für Ereignisprotokolle lädt die erste Synchronisierung rückwirkend etwa **24 Stunden** nach und setzt danach dort fort, wo der vorherige Abruf aufgehört hat. Die Gerätesynchronisierung liest bei jedem Lauf den Clientstatus der letzten **30 Tage**.

> [!NOTE]
>
> Die Gerätesynchronisierung ist optional. Wenn das Token `/api/v2/events/datasearch/clientstatus` nicht lesen kann, funktionieren alle anderen Quellen weiter und die Integration zeigt eine Warnung **Gerätestatus** an. Wirespeed prüft den Zugriff alle paar Stunden erneut, sodass Geräte nach dem Erteilen der Berechtigung ohne erneute Verbindung synchronisiert werden.


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