Skip to main content

​
Ce que cette intégration apporte

Netskope peut fournir une activité normalisée relative au web, au cloud, à l’authentification, à la protection des données et aux menaces. Voici des exemples examinés :
  • web.ai.visited — site web d’IA consulté
  • data.bulk.uploaded — téléversement massif de données
  • geo.impossible — déplacement impossible entre des connexions
La connexion actuelle utilise l’API REST v2 ; une variante REST héritée peut apparaître pour les clients existants. Consultez comment les données d’intégration deviennent des signaux.

​
Ce dont Living Security a besoin

Accès aux endpoints requis : Rôle requis : Tenant Admin ou un rôle équivalent disposant d’un accès à Paramètres → Tools
Cette intégration nécessite un jeton d’API v2, et non un jeton v1. Les jetons v1 utilisent une authentification par paramètre de requête et ne fonctionneront pas avec l’endpoint 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

Votre administrateur Netskope réalise 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 la navigation de gauche, cliquez sur Paramètres.
  3. Sous Tools, sélectionnez REST API v2.
2

Créer un nouveau jeton

  1. Cliquez sur New Token.
  2. Saisissez un nom descriptif (par exemple, Living Security Platform).
  3. Sous l’accès aux endpoints, activez l’accès à :
Accordez l’accès aux deux endpoints. 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é à l’endpoint manquant ne renvoie alors aucune donnée, sans aucune erreur pour en indiquer la raison.
Ces deux endpoints sont les seuls que Living Security requiert. Ne rien accorder au-delà respecte le principe du moindre privilège.
  1. Cliquez sur Sauvegarder (ou Generate Token).
3

Copier et conserver votre jeton

Copiez immédiatement le jeton 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 l’avoir copiée, vous devrez supprimer le jeton et en créer un nouveau.
4

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

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

Identifier le sous-domaine de votre tenant

Le sous-domaine de votre tenant correspond au 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, 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 le sous-domaine seul.

​
Partie B — Dans la Living Security Platform

Le responsable du programme réalise cette étape, ou l’administrateur système en cas de configuration déléguée.
Vous êtes maintenant connecté à Netskope (v2 API).

​
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 fonctionneront pas avec les endpoints v2. Générez un nouveau jeton v2 depuis Paramètres → Tools → REST API v2
  3. Liste d’autorisation d’adresses IP bloquant les requêtes — si la liste d’autorisation d’adresses IP est activée sur votre tenant, vérifiez que les quatre adresses IP de sortie de Living Security figurent dans cette liste
Le jeton a été créé sans accès à /api/v2/events/data/alert ou à /api/v2/events/data/page. Les autorisations d’endpoints d’un jeton ne peuvent pas être modifiées après sa création — créez un nouveau jeton disposant d’un accès en lecture aux deux, puis reconnectez-vous.
Il manque l’un des deux endpoints requis au jeton. Un jeton limité à /api/v2/events/data/alert uniquement ou à /api/v2/events/data/page uniquement se connecte tout de même, et le flux associé à l’endpoint manquant reste vide sans aucun message d’erreur.Les autorisations d’endpoints ne peuvent pas être modifiées après la création d’un jeton — générez un nouveau jeton disposant d’un accès en lecture aux deux, puis reconnectez-vous.
Si la liste d’autorisation d’adresses IP 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 depuis Paramètres → Tools → REST API v2 (et non depuis la page des jetons v1 héritée).