Skip to main content

​
Was diese Integration beiträgt

Netskope kann normalisierte Aktivitäten aus den Bereichen Web, Cloud, Authentifizierung, Datenschutz und Bedrohungen beisteuern. Geprüfte Beispiele sind:
  • web.ai.visited — KI-Website besucht
  • data.bulk.uploaded — Massen-Datenupload
  • geo.impossible — unmögliche Reise zwischen Anmeldungen
Die aktuelle Verbindung verwendet REST API v2; für Bestandskunden kann eine ältere REST-Variante angezeigt werden. Weitere Informationen finden Sie unter Wie Integrationsdaten zu Signalen werden.

​
Was Living Security benötigt

Erforderlicher Endpunktzugriff: Erforderliche Rolle: Tenant Admin oder eine gleichwertige Rolle mit Zugriff auf Einstellungen → Tools
Diese Integration erfordert einen v2-API-Token, keinen v1-Token. V1-Token verwenden die Authentifizierung per Abfrageparameter und funktionieren nicht mit dem v2-API-Endpunkt.

​
Voraussetzungen

  • Sie benötigen Tenant Admin-Zugriff in Netskope, um REST-API-Token zu verwalten.

​
Teil A — In Netskope

Ihr Netskope-Administrator führt diese Schritte durch.
1

Zur Verwaltung der REST-API-v2-Token navigieren

  1. Melden Sie sich unter https://<tenant>.goskope.com bei Ihrer Netskope-Admin-Konsole an.
  2. Klicken Sie in der linken Navigation auf Einstellungen.
  3. Wählen Sie unter Tools die Option REST API v2 aus.
2

Neuen Token erstellen

  1. Klicken Sie auf New Token.
  2. Geben Sie einen aussagekräftigen Namen ein (z. B. Living Security Platform).
  3. Aktivieren Sie unter dem Endpunktzugriff den Zugriff auf:
Gewähren Sie Zugriff auf beide Endpunkte. Sie speisen zwei getrennte Datenströme — alerts und events — und ein Token, der nur auf einen davon beschränkt ist, lässt sich dennoch erfolgreich verbinden. Der Datenstrom hinter dem fehlenden Endpunkt liefert dann keine Daten, ohne dass ein Fehler den Grund anzeigt.
Diese beiden Endpunkte sind die einzigen, die Living Security benötigt. Wenn Sie keine weiteren Berechtigungen vergeben, entspricht dies dem Prinzip der geringsten Rechte.
  1. Klicken Sie auf Speichern (oder Generate Token).
3

Token kopieren und speichern

Kopieren Sie den Token sofort und bewahren Sie ihn sicher auf.
Netskope zeigt den Token-Wert nur einmal bei der Erstellung an. Wenn Sie die Seite verlassen, ohne ihn zu kopieren, müssen Sie den Token löschen und einen neuen erstellen.
4

IP-Zulassungsliste konfigurieren (falls zutreffend)

Wenn für Ihren Netskope-Tenant eine IP-Zulassungsliste aktiviert ist, müssen Sie die ausgehenden IP-Bereiche von Living Security hinzufügen.
  1. Wechseln Sie in der Netskope-Admin-Konsole zu Einstellungen → Administration → IP Allowlist.
  2. Wenn die IP-Zulassungsliste aktiviert ist, fügen Sie jede ausgehende IP-Adresse von Living Security zur Liste Custom IP hinzu.
Wenn die IP-Zulassungsliste aktiviert ist, wird der Verbindungsdialog erfolgreich abgeschlossen, Datensynchronisierungen schlagen jedoch mit 401 Unauthorized fehl, bis die korrekten IP-Adressen hinzugefügt wurden.
5

Tenant-Subdomain ermitteln

Ihre Tenant-Subdomain ist das Präfix der URL Ihrer Netskope-Admin-Konsole.Wenn die URL Ihrer Konsole https://acme.goskope.com lautet, ist Ihre Subdomain acme.Geben Sie ausschließlich die reine Subdomain ein — kein https://, kein .goskope.com, keinen abschließenden Schrägstrich.
Der Verbindungsdialog akzeptiert mehrere Eingabeformen (reine Subdomain, vollständiger Hostname oder vollständige URL) und normalisiert sie automatisch. Es wird jedoch empfohlen, die reine Subdomain einzugeben.

​
Teil B — In der Living Security Platform

Der Programmverantwortliche führt diesen Schritt durch, bei delegierter Einrichtung der Systemadministrator.
Sie sind nun mit Netskope (v2 API) verbunden.

​
Fehlerbehebung

Häufige Ursachen:
  1. Token widerrufen oder abgelaufen — generieren Sie einen neuen Token
  2. Verwendung eines v1-Tokens — V1-Token authentifizieren sich per Abfrageparameter und funktionieren nicht mit v2-Endpunkten. Generieren Sie einen neuen v2-Token unter Einstellungen → Tools → REST API v2
  3. IP-Zulassungsliste blockiert Anfragen — Wenn für Ihren Tenant eine IP-Zulassungsliste aktiviert ist, stellen Sie sicher, dass alle vier ausgehenden IP-Adressen von Living Security in der Zulassungsliste enthalten sind
Der Token wurde ohne Zugriff auf /api/v2/events/data/alert oder /api/v2/events/data/page erstellt. Die Endpunktberechtigungen eines Tokens können nach der Erstellung nicht geändert werden — erstellen Sie einen neuen Token mit Lesezugriff auf beide Endpunkte und stellen Sie die Verbindung erneut her.
Dem Token fehlt einer der beiden erforderlichen Endpunkte. Ein Token, der nur auf /api/v2/events/data/alert oder nur auf /api/v2/events/data/page beschränkt ist, lässt sich dennoch verbinden, und der Datenstrom hinter dem fehlenden Endpunkt bleibt unbemerkt leer.Endpunktberechtigungen können nach der Erstellung eines Tokens nicht geändert werden — generieren Sie einen neuen Token mit Lesezugriff auf beide Endpunkte und stellen Sie dann die Verbindung erneut her.
Wenn die IP-Zulassungsliste aktiviert ist, haben sich möglicherweise die ausgehenden IP-Adressen von Living Security geändert. Lesen Sie Ausgehende IP-Adressen für Integrationen konfigurieren und aktualisieren Sie die Liste Custom IP entsprechend.
V1- und v2-Token verwenden unterschiedliche Authentifizierungsmechanismen:
  • v1: Abfrageparameter (token=...)
  • v2: Header (Netskope-Api-Token: ...)
Living Security verwendet die v2-Authentifizierung. Generieren Sie einen neuen Token unter Einstellungen → Tools → REST API v2 (nicht auf der Seite für ältere v1-Token).