Overview
DLP On Demand — Public Cloudは、クラウドホスト型のスケーラブルなマルチテナントDLP検査をREST APIとして提供し、お客様側での展開や保守は不要です。
リージョンの可用性
お客様のテナントは、単一の特定のAWSリージョンに対してプロビジョニングされます。APIエンドポイントとすべてのトラフィックは、割り当てられたリージョンをターゲットにする必要があります。別のリージョンのエンドポイントに送信されたリクエストは機能しません。
テナントがどのリージョンに割り当てられているか不明な場合は、Netskopeの担当者にお問い合わせください。ホームMP（管理プレーン）がAWSリージョンにどのようにマッピングされるかについては、パブリッククラウドリージョンのマッピングを参照してください。
前提条件
開始する前に、以下を確認してください：
- 貴組織は、DLP On Demand — Public Cloudのエンタイトルメントに必要なライセンスを保有しています。
- DLP On Demand — Public Cloud がテナントで有効になりました。Netskopeはプロビジョニングの一環としてこれを有効にします。有効になっているか不明な場合は、Netskope担当者にお問い合わせください。
- テナントに割り当てられたAWSリージョンとホスト名を確認してください（上記の「リージョンの可用性」を参照）。
- Netskopeテナントにおいて、ロール、サービスアカウント、APIキーを作成するのに十分な管理者権限を持つアカウントが必要です。
APIキーの取得
DLP On Demand — Public Cloudへの認証には、Netskope WebUIから自身で生成したAPIキーを使用します。個別のトークン交換ステップはありません。生成したキーは、すべてのAPI呼び出しでベアラートークンとして直接使用されます。
ステップ1：ロールを作成するか、定義済みのロールを使う
- 定義済みのロールを使用する場合は、このステップをスキップしてください。
- カスタムロールを作成するには、Settings > Administration > Administrators & Roles > Roles に移動します。
- 新しいカスタムロールを作成します。
- ロールにDLP On Demand権限を付与します。
ステップ2：サービスアカウントの作成
- Settings > Administration > Administrators & Roles > Administratorsへ移動してください。
- Service Accountをクリックしてください。
- ステップ1で作成したロールを割り当てるか、定義済みのロール DLPoD Admin を使用してください。
ステップ3：APIキーの生成
- サービスアカウントのダイアログを開いたまま、Generate token now with expiryを選択します。
- Create をクリックします。キーを安全にコピーして保管してください。パスワードと同様に扱ってください。このページを離れると、再度表示することはできません。
APIリファレンス
DLPoD Public API の swagger ドキュメントは、WebUI の Settings > Tools > DLPoD REST API v1 で確認できます。完全なAPIリファレンス（エンドポイント、リクエスト/レスポンススキーマ、例）はNetskope WebUI内に直接記載されており、ここには複製されていません。任意のプログラミング言語を使用してクライアントを生成します。
APIの使用方法
- ベースURL:
https://.aws- .dlp.goskope.com - ショートネームはテナント名です。例えば、テナントが
acme.goskope.comの場合、ショートネームはacmeとなります。 - AWSリージョンコードはホームMPのマッピングから取得されます。パブリッククラウドリージョンのマッピングを参照してください。
- ショートネームはテナント名です。例えば、テナントが
- API キーをベアラートークンとして送信します：
Authorization: Bearer <API_KEY> - 有効なトークンまたは一般的な接続性をテストするには、
/inspections/jobs/pendingに対して GET 呼び出しを実行します。
例：
curl https://acme.aws-usw2.dlp.goskope.com/inspections/jobs/pending
有効なレスポンスは、保留中のジョブがある場合でも 200 を返します。