Use the Netskope DSPM API

Overview

Grâce aux API ouvertes de Netskope One DSPM, vous pouvez créer des intégrations qui exploitent l'intelligence de Netskope One DSPM afin d'enrichir davantage votre écosystème d'applications de données &. Voici quelques exemples concrets :

• Acquisition de données Tags à partir de vos systèmes de catalogues de données externes
• Contrôler la classification des champs de votre ensemble de données
• Exportez les informations de Netskope One DSPM pour obtenir des résultats dans d'autres plateformes telles que les SIEM, les SOAR et les systèmes de billetterie.

Cet article vous expliquera comment accéder à notre documentation destinée aux développeurs et comment exécuter les méthodes API disponibles.

Toutes les routes API Netskope One DSPM disponibles sont décrites dans la documentation Netskope One DSPM l'interface utilisateur Netskope , accessible sur votre console Netskope en naviguant vers Settings > Tools > REST API v2.

Essai des méthodes

Notre documentation permet d'essayer les différentes méthodes directement dans l'interface utilisateur de Swagger.  Pour activer cette fonctionnalité :

1. Cliquez sur le Authorize button.
2. Le site Available authorizations modal s'affiche.
3. Sur le site Value field, collez un jeton Netskope Rest API valide.
4. Cliquez sur Authorize button, puis cliquez sur Close button.

Vous pouvez maintenant essayer des méthodes individuelles :

1. Cliquez sur la méthode individuelle que vous souhaitez exécuter.
2. La section de la méthode individuelle se développe.
3. À côté du Parameters header, cliquez sur le Try it out button.
4. Si nécessaire, renseignez les paramètres requis (y compris en modifiant les exemples de corps de requête).
   un.  Plusieurs filtres peuvent être appliqués par champ. Vous trouverez ci-dessous quelques exemples de syntaxe spécifique que vous pouvez utiliser pour GET /api/v2/dspm/classificationmanagement/columns
   i. Get all columns classified as Name or Email address: classification eq 1 or classification eq 2
   ii. Get all high-sensitivity columns that are not reviewed: sensitivity_level_id eq 3 and reviewed eq false
5. Cliquez sur le Execute button.
6. Le site Responses section est maintenant affiché.
7. Consultez le site Responses section pour connaître la réponse du système à votre demande.

Exemples d'autres syntaxes de filtre prises en charge :

Scenario	Filter Syntax
Commence par	startswith(location.column, 'FIRST') startswith(location.column, 'first')
Contient (spécifique au cas)	substringof('firstn', location.column) substringof('FIRSTN', location.column)
Contient (insensible à la casse)	substringof(tolower('FiRsTn'), location.column) substringof(tolower('FiRsTn'), tolower(location.column)) substringof('firstn', tolower(location.column)) substringof(tolower('firstn'), tolower(location.column))
Pas d'égalité	account_id ne 1234567890

API ouverte et étiquettes de données

Vous pouvez utiliser les API ouvertes de Netskope DSPMpour créer des intégrations et ingérer des étiquettes de données à partir de systèmes de catalogues de données externes.

Pour des informations sur la manière dont les données Tags sont créés, gérés et affichés dans l’interface utilisateur Netskope DSPM , voir Gérer DSPM données Tags.

Toutes les étiquettes de données ont une couleur qui leur est attribuée afin de les distinguer dans l'interface utilisateur de Netskope DSPM. Lorsque vous définissez des balises via l'API, vous devez utiliser les codes de couleur hexagonaux pris en charge pour garantir un rendu correct de l'interface utilisateur.