Overview
Netskope One DSPMのオープンAPIを使用することで、Netskope One DSPMのインテリジェンスを活用した統合を構築し、データアプリケーションとエコシステムをさらに強化することができます。具体的な例としては、以下のようなものがあります。
- 外部データ カタログ システムからのデータ タグの取り込み
- データセットフィールドの分類を制御する
- Netskope One DSPMの知見をエクスポートして、SIEM、SOAR、チケットシステムなどの他のプラットフォームで成果を向上させましょう。
この記事では、開発者向けドキュメントへのアクセス方法と、利用可能なAPIメソッドの実行方法について説明します。
利用可能なすべてのNetskope One DSPM API ルートは、マスターNetskope UI ドキュメントに記載されています。 Netskope OneドキュメントDSPM 、 NetskopeコンソールでSettings > Tools > REST API v2に移動することでアクセスできます。
方法を試してみる
弊社のドキュメントでは、Swagger UI内で様々な方法を直接試す方法をサポートしています。この機能を有効にするには：
- Authorize buttonをクリックしてください。
- Available authorizations modalが表示されます。
- Value fieldには、有効な Netskope REST API トークンを貼り付けてください。
- Authorize buttonをクリックしてから、 Close buttonをクリックしてください。
◇次の方法で個別の方法を試すことができます。
- 実行したいメソッドを個別にクリックしてください。
- 個々のメソッドのセクションが展開されます。
- Parameters headerの横にあるTry it out buttonをクリックしてください。
- 必要に応じて、必須パラメータを入力してください（リクエストボディの例を編集する場合も含む）。
a.1つのフィールドにつき、複数のフィルターを適用できます。以下は、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 - Execute buttonをクリックしてください。
- Responses sectionには◇が表示されます。
- リクエストに対するシステムの応答については、 Responses sectionを確認してください。
その他のサポートされているフィルタ構文の例：
| Scenario | Filter Syntax |
|---|---|
| から始まる | startswith(location.column, 'FIRST')startswith(location.column, 'first') |
| （ケース固有）を含む | substringof('firstn', location.column)substringof('FIRSTN', location.column) |
| を含む (ケース非依存) | substringof(tolower('FiRsTn'), location.column)substringof(tolower('FiRsTn'), tolower(location.column))substringof('firstn', tolower(location.column))substringof(tolower('firstn'), tolower(location.column)) |
| 等しくない | account_id ne 1234567890 |
オープンAPIとデータタグ
Netskope DSPMの Open API を使用して、統合を構築し、外部データ カタログ システムからデータ タグを取り込むことができます。
データタグの作成、管理、 Netskope DSPM ユーザーインターフェースでの表示方法については、「 データタグ DSPM 管理」を参照してください。
すべてのデータタグには、Netskope DSPMのユーザーインターフェース内で区別できるように、それぞれ固有の色が割り当てられています。API を介してタグを定義する場合は、 適切な UI レンダリングを保証するために、サポートされている 16 進数カラーコードを指定する必要があります。
