Netskope
Intégrez Netskope pour récupérer les appareils enrôlés avec le Netskope Client et les utilisateurs de votre tenant
Le connecteur Netskope récupère dans OverView les appareils enrôlés avec le Netskope Client ainsi que les utilisateurs de votre tenant Netskope, via l'API REST v2 de Netskope.
Objectif
Le connecteur Netskope récupère les informations suivantes :
- Appareils enrôlés avec le Netskope Client (nom d'hôte, adresses MAC, système d'exploitation, fabricant, modèle et numéro de série, version et statut du client, classification de l'appareil)
- Utilisateurs associés à chaque appareil
- Utilisateurs provisionnés dans le tenant
Prérequis
- Un compte Tenant Admin sur la console Netskope : c'est le seul rôle prédéfini autorisé à créer des rôles et des service accounts.
- Si le tenant restreint l'accès à l'API par une liste d'IP autorisées, les adresses sources d'OverView doivent y être ajoutées. Contactez le support OverSOC pour les obtenir.
Informations à fournir dans OverView
| Champ | Description |
|---|---|
| Tenant URL* | L'URL avec laquelle vous ouvrez la console Netskope, sans slash final (ex. : https://example.goskope.com ou https://example.eu.goskope.com) |
| API Token* | Token REST API v2 du service account créé ci-dessous |
Procédure
Créer un rôle en lecture seule
Le rôle attribué au service account définit les endpoints API que son token peut appeler.
- Connectez-vous à la console Netskope et allez dans Settings > Administration > Administrators & Roles.
- Dans l'onglet Roles, cliquez sur New.
- Saisissez un Role Name (ex. :
OverView Connector). - Positionnez la permission des deux domaines fonctionnels ci-dessous sur View, et laissez tous les autres sur None :
- Access Control > NS Client > Devices
- End User Provisioning > Users & Groups
- Cliquez sur Save.
Créer un service account et son token
- Dans l'onglet Administrators, cliquez sur Service Account.
- Saisissez un Service Account Name (ex. :
overview-connector) et sélectionnez le rôle créé ci-dessus. - Dans la section REST API Token, définissez l'expiration du token. Le connecteur cesse de fonctionner à son expiration : renouvelez-le avant cette date.
- Cliquez sur Create.
- Copiez le token immédiatement : il n'est affiché qu'une seule fois.
Sur un tenant pas encore migré vers RBAC V3, la page Settings > Tools > REST API v2 propose encore New Token. Saisissez un nom et une expiration, puis cliquez sur Add Endpoint et ajoutez les endpoints listés dans Permissions requises avec le privilège Read.
Configurer le connecteur dans OverView
- Dans OverView, allez dans Data Sources Settings > Sources.
- Sélectionnez Netskope et cliquez sur Configure.
- Renseignez le Tenant URL et l'API Token, puis cliquez sur Save Configuration.
Permissions requises
Le niveau View accorde les opérations de lecture des endpoints ci-dessous, ce qui est tout ce que le connecteur utilise : il ne crée, ne modifie et ne supprime rien dans Netskope. L'icône d'information à côté de chaque permission dans l'éditeur de rôle liste les endpoints qu'elle couvre.
| Données récupérées | Endpoint | Permission |
|---|---|---|
| Appareils | GET /api/v2/events/datasearch/clientstatus | Access Control > NS Client > Devices |
| Utilisateurs | GET /api/v2/scim/Users | End User Provisioning > Users & Groups |