Skip to main content

​
Ce que cette intégration apporte

Netskope peut fournir des données normalisées sur l’activité Web, infonuagique, d’authentification, de protection des données et de menaces. Voici quelques exemples examinés :
  • web.ai.visited — Visite d’un site Web d’IA
  • data.bulk.uploaded — Téléversement massif de données
  • geo.impossible — Déplacement impossible entre deux connexions
La connexion actuelle utilise l’API REST v2; une variante REST héritée peut apparaître pour les clients existants. Consultez la façon dont les données d’intégration deviennent des signaux.

​
Ce dont Living Security a besoin

Accès requis aux points de terminaison : Rôle requis : Tenant Admin ou un rôle équivalent ayant accès à Settings → Tools
Cette intégration nécessite un jeton d’API v2, et non un jeton v1. Les jetons v1 utilisent l’authentification par paramètre de requête et ne fonctionneront pas avec le point de terminaison de l’API v2.

​
Prérequis

  • Vous devez disposer d’un accès Tenant Admin dans Netskope pour gérer les jetons d’API REST.

​
Partie A — Dans Netskope

L’administrateur Netskope de votre organisation effectue ces étapes.
1

Accéder à la gestion des jetons d'API REST v2

  1. Connectez-vous à votre console d’administration Netskope à l’adresse https://<tenant>.goskope.com.
  2. Dans le menu de navigation de gauche, cliquez sur Settings.
  3. Sous Tools, sélectionnez REST API v2.
2

Créer un jeton

  1. Cliquez sur New Token.
  2. Saisissez un nom descriptif (p. ex., Living Security Platform).
  3. Sous l’accès aux points de terminaison, activez l’accès à :
Accordez l’accès aux deux points de terminaison. Ils alimentent deux flux distincts — alerts et events — et un jeton limité à un seul d’entre eux se connecte tout de même avec succès. Le flux associé au point de terminaison manquant ne renvoie alors aucune donnée, sans aucune erreur pour vous en indiquer la raison.
Ces deux points de terminaison sont les seuls dont Living Security a besoin. Ne rien accorder de plus respecte le principe du moindre privilège.
  1. Cliquez sur Save (ou sur Generate Token).
3

Copier et conserver votre jeton

Copiez le jeton immédiatement et conservez-le en lieu sûr.
Netskope affiche la valeur du jeton une seule fois, lors de sa création. Si vous quittez la page sans la copier, vous devrez supprimer le jeton et en créer un nouveau.
4

Configurer la liste d'adresses IP autorisées (le cas échéant)

Si la liste d’adresses IP autorisées est activée sur votre locataire Netskope, vous devez ajouter les plages d’adresses IP de sortie de Living Security.
  1. Dans la console d’administration Netskope, accédez à Settings → Administration → IP Allowlist.
  2. Si la liste d’adresses IP autorisées est activée, ajoutez chaque adresse IP de sortie de Living Security à la liste Custom IP.
Si la liste d’adresses IP autorisées est activée, la boîte de dialogue de connexion réussira, mais les synchronisations de données échoueront avec l’erreur 401 Unauthorized tant que les bonnes adresses IP n’auront pas été ajoutées.
5

Repérer le sous-domaine de votre locataire

Le sous-domaine de votre locataire est le préfixe de l’URL de votre console d’administration Netskope.Si l’URL de votre console est https://acme.goskope.com, votre sous-domaine est acme.Saisissez uniquement le sous-domaine seul — sans https://, sans .goskope.com et sans barre oblique finale.
La boîte de dialogue de connexion accepte plusieurs formats de saisie (sous-domaine seul, nom d’hôte complet ou URL complète) et les normalise automatiquement. Il est toutefois recommandé de saisir uniquement le sous-domaine.

​
Partie B — Dans Living Security Platform

Le responsable du programme effectue cette étape, ou l’administrateur système si la configuration déléguée est utilisée.
Vous êtes maintenant connecté à Netskope (API v2).

​
Dépannage

Causes courantes :
  1. Jeton révoqué ou expiré — générez un nouveau jeton
  2. Utilisation d’un jeton v1 — les jetons v1 s’authentifient par paramètre de requête et ne fonctionnent pas avec les points de terminaison v2. Générez un nouveau jeton v2 à partir de Settings → Tools → REST API v2
  3. Requêtes bloquées par la liste d’adresses IP autorisées — si la liste d’adresses IP autorisées est activée sur votre locataire, vérifiez que les quatre adresses IP de sortie de Living Security figurent dans la liste
Le jeton a été créé sans accès à /api/v2/events/data/alert ou à /api/v2/events/data/page. Les autorisations des points de terminaison d’un jeton ne peuvent pas être modifiées après sa création — créez un nouveau jeton avec un accès en lecture aux deux, puis reconnectez-vous.
Il manque l’un des deux points de terminaison requis au jeton. Un jeton limité à /api/v2/events/data/alert seulement ou à /api/v2/events/data/page seulement se connecte tout de même, et le flux associé au point de terminaison manquant reste vide sans avertissement.Les autorisations des points de terminaison ne peuvent pas être modifiées après la création d’un jeton — générez un nouveau jeton avec un accès en lecture aux deux, puis reconnectez-vous.
Si la liste d’adresses IP autorisées est activée, les adresses IP de sortie de Living Security ont peut-être changé. Consultez Configuration des adresses IP de sortie des intégrations et mettez à jour la liste Custom IP en conséquence.
Les jetons v1 et v2 utilisent des mécanismes d’authentification différents :
  • v1 : paramètre de requête (token=...)
  • v2 : en-tête (Netskope-Api-Token: ...)
Living Security utilise l’authentification v2. Générez un nouveau jeton à partir de Settings → Tools → REST API v2 (et non de la page des jetons v1 héritée).