Netskope Cloud ExchangeはREST APIを提供しており、ほぼすべてのGUIコマンドをプログラムから実行できるようにしています。ただし、各 REST API 呼び出しには有効なクレデンシャルが必要です。 APIアクセス権限を与えられたユーザーは、クライアントIDとクライアントシークレットを作成できるようになります。注：これは、Netskopeテナントとの通信に使用するAPIトークンとは異なります。 Netskopeテナントとの通信に使用するAPIトークンとは異なります。
Settings > UsersにアクセスしてAPI Tokensタブをクリックすると、API トークンを作成できます。
- Create new tokenクリックすると、UIでユーザーが持っている認証レベルと同じ認証レベルで新しいトークンを作成するためのフォームが開きます。新しいAPIトークンを作成できます。
- ユーザーはデスク リプションとトークンの有効期限を入力できます。
- クライアントシークレットをコピーできます コピーボタンをクリックすると、クライアントIDとクライアントシークレットがCloud Exchange APIにアクセスできるようになります。
トークンが作成されたら、それらをコピーして「テナントの設定」ページに戻ります。 Cloud ExchangeにNetskopeテナントを追加するには v1 トークンが必要ですが、v2 エンドポイントが利用可能な場合は使用されないことに注意してください。
トグル ボタンUse Iterator Endpointを有効にすると、イテレータ API エンドポイントを使用できます。 トグルボタンは、v2トークンが提供されている場合にのみアクセスできます。Iterator API エンドポイントを選択した場合、すべての脅威 IoC、アラート、およびイベントが Iterator API エンドポイントによって取得されます。 v2 API トークンの生成中に、上記の API エンドポイントへのアクセスを提供する必要があります。
SwaggerでAPIドキュメントを表示するには、左側のナビゲーションの下部にあるHelpクリックし、 API docsを選択します。
 |
エンドポイント情報を表示するには、キャレットアイコンをクリックしてください。
 |
REST API スコープ
Cloud Exchangeプラットフォームの REST API スコープについては、次のセクションで説明します。
重要
バージョン6.0.0以降Netskope Cloud Exchangeロールを持つRBAC v3トークン。 RBAC v3トークンを生成するには、ここに記載されている手順を参照してください。
5.1.1および5.1.2REST API
v1 REST API スコープ
| Netskope Endpoints | 特権レベル | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | リスク交換（CREv2） |
|---|---|---|---|---|---|
| /api/v1/updateFileHashList | 読む + 書く (v1 デフォルト) | Netskopeテナントにハッシュを共有するために使います。 | |||
| /api/v1/app _インスタンス | 読む + 書く (v1 デフォルト) | アプリインスタンスをNetskopeテナントに共有するために使います。 | |||
| /api/v1/app _インスタンス | 読む + 書く (v1 デフォルト) | v1 トークンを使用したテナント構成中に v1 トークンを検証するために必要なエンドポイントです。 | |||
v2 REST API スコープ
| Netskope Endpoints | 特権レベル | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | リスク交換（CREv2） |
|---|---|---|---|---|---|
| /api/v2/events/dataexport/ イベント/アラート | Read | これは必須のエンドポイントであり、テナント構成中に v2 トークンを検証するために使用されます。 | |||
| /api/v2/events/dataexport/ イベント/アプリケーション | Read | アプリケーション イベントのプルと取り込みに費やします。 | APPLICATIONエンティティのアプリケーションをプル、抽出、保存します。 | ||
| /api/v2/events/dataexport/ イベント/監査 | Read | 監査イベントのプルと取り込みに費やします。 | |||
| /api/v2/events/dataexport/ イベント/エンドポイント | Read | エンドポイントデータを取得して取り込むのに使います。 | エンドポイントデータを取得して保存するのに使います。 | ||
| /api/v2/events/dataexport/ イベント/インシデント | Read | インシデント イベントを取得して取り込むために使用します。 | インシデント データを取得して保存するのに使います。 | ||
| /api/v2/events/dataexport/ イベント/インフラストラクチャ | Read | インフラストラクチャ イベントをプルするために使用します。 | |||
| /api/v2/events/dataexport/ イベント/ネットワーク | Read | ネットワーク イベントをプルするために使います。 | |||
| /api/v2/events/dataexport/ イベント/ページ | Read | ページイベントをプルするために使います。 | |||
| /api/v2/events/dataexport/ アラート/uba | Read | UBA アラートのプルと取り込みに費やします。 | UBA アラートを取得して保存するのに時間がかかります。 | USERエンティティのUBAアラートからユーザー情報を取得します。 | |
| /api/v2/events/dataexport/ アラート/セキュリティ評価 | Read | セキュリティ評価アラートを取得して取り込むのに時間がかかります。 | セキュリティ評価アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/隔離 | Read | 隔離アラートを取得して取り込むのに時間がかかります。 | 隔離アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/修復 | Read | 修復アラートを取得して取り込むのに時間がかかります。 | 修復アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/ポリシー | Read | ポリシー アラートを取得して取り込むのに時間がかかります。 | ポリシー アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/マルウェア | Read | マルウェアアラートを取得して取り込むのに費やします。 | マルウェアアラートを取得して保存するのに費やします。 | マルウェアアラートからハッシュを取得して抽出するのに時間がかかります。 | |
| /api/v2/events/dataexport/ アラート/悪質サイト | Read | マルサイトアラートを取得して取り込むのに費やします。 | Malsite アラートを取得して保存するのに時間がかかります。 | マルウェアサイト警告から悪意のあるURLを抽出します。 | |
| /api/v2/events/dataexport/ アラート/侵害された認証情報 | Read | 侵害されたクレデンシャル アラートをプルして取り込むのに費やします。 | 侵害されたクレデンシャル アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/ctep (または ips) | Read | ctep/ips/c2 アラートのプルと取り込みに費やします。 | CTEP/IPS/C2アラートを取得して保存します。 | ||
| /api/v2/events/dataexport/ アラート/DLP | Read | DLP アラートのプルと取り込みに費やします。 | DLP アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/ウォッチリスト | Read | ウォッチリストのアラートを取得して取り込むのに時間がかかります。 | ウォッチリストのアラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/token/ トランザクションイベント | Read | Netskope WebTx 構成のサブスクリプション キーとサブスクリプション パスを取得するために使用し、WebTx データを取得するために認証を行うために使用します。 | |||
| /api/v2/events/metrics/ トランザクションイベント | Read | 使う WebTx 設定用のバックログメッセージ数を引き出します。 | |||
| /api/v2/incidents/update | 読む＋書く | 使う インシデントをテナントに更新 Netskope 。 | |||
| /api/v2/ポリシー/urllist | 読む＋書く | NetskopeテナントのURLリストにURL、ドメイン、IPアドレスを共有する。 | |||
| /api/v2/policy/urllist/ デプロイ | 読む＋書く | 共有される変更をデプロイするのに使う /api/v2/ポリシー/urllist エンドポイントを使う。 | |||
| /api/v2/incidents/uba/ ゲトゥチ | 読む＋書く | 使う to get for user entity のスコア。 | |||
| /api/v2/incidents/user/ uciimpact | 読む＋書く | 使う to ingent はユーザーからテナントへの UCI スコア Netskope 影響します。 | |||
| /api/v2/services/cci/ アプリ | Read | 使う アプリ名、CCI、CCL、カテゴリ名、組織など関連するアプリケーションの詳細CCI取得できます。 | |||
| /api/v2/services/cci/ ドメイン | Read | アプリケーションのドメインの詳細を取得するのに時間がかかります。 | |||
| /api/v2/services/cci/ tags | Read | アプリケーションのタグの詳細を取得するのに時間がかかります。 | |||
| /api/v2/infrastructure/ 出版社 | 読む＋書く | 使う 利用可能な出版社のリストを入手したい。 | 使う 利用可能な出版社のリストを入手したい。 | ||
| /api/v2/steering/apps/ プライベート | 読む＋書く | プライベートアプリとその詳細を共有するために使います。 | プライベートアプリとその詳細を共有するために使います。 | ||
| /api/v2/scim/Users | 読む＋書く | SCIM ユーザーを獲得するために使います。 | |||
| /api/v2/scim/Groups | 読む＋書く | 使う SCIMグループを取得し、グループからユーザーの変更・追加・削除。 | |||
| /api/v2/events/dataexport/ アラート/デバイス | Read | デバイスアラートを取得するのに時間がかかります。 (Cloud Exchange v5.1.0 以上のバージョンが必要)Netskopeテナントプラグインv1.2.0およびCLSプラグインv2.1.0） | 使う デバイスアラートを取得・保存するために。 (必要条件:Cloud Exchange v5.1.0、Netskope Tenantプラグイン v1.2.0およびCTO プラグイン v2.1.0) | ||
| /api/v2/events/dataexport/ アラート/コンテンツ | Read | コンテンツアラートを取得するのに時間がかかります。 (Cloud Exchange v5.1.0 以上のバージョンが必要)Netskopeテナントプラグインv1.2.0およびCLSプラグインv2.1.0） | 使う コンテンツアラートをプルして保存するために。 (必要条件:Cloud Exchange v5.1.0、Netskope Tenantプラグイン v1.2.0およびCTO プラグイン v2.1.0) | ||
| /api/v2/events/dataexport/ イテレータ | 読む＋書く | ステータスの確認/データの取得/クライアント ステータス イテレータの削除を行います。 (Cloud Exchange v5.1.1 以上のバージョンが必須)Netskope Tenantプラグインv1.4.0およびCLSプラグインv2.2.0） | |||
| /api/v2/incidents/dlpincidents | Read | 使う dlp_incident_id ごとにインシデント・フォレンジクスを抽出する。 (最低限のCloud Exchange v5.1.2、Netskope Tenant プラグイン v1.5.0 および CLS プラグイン v2.3.0) | 使う dlp_incident_idあたりインシデント・フォレンジクスを取得・保存すること。 (最低限のCloud Exchange v5.1.2、Netskope Tenantプラグイン v1.5.0およびCTOプラグイン v2.3.0) | ||
| /api/v2/incidents/users/uci/reset | 読む＋書く | 使う ユーザーがテナント Netskope UCIスコアをリセットするために。 | |||
| /api/v2/nsiq/retrohunt/ioc/getinfo | 読む＋書く | IOCのレトロハント情報を一括で取得するために使います。 | |||
| /api/v2/nsiq/retrohunt/ioc/report | Read | 使う to get the retrohunt レポート of inジデントの指標。 | |||
| /api/v2/nsiq/retrohunt/ioc/info | Read | インジデントの指標のレトロハント情報を取得するために使います。 | |||
5.1.0 REST API
v1 REST API スコープ
| Netskope Endpoints | 特権レベル | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | リスク交換（CREv2） |
|---|---|---|---|---|---|
| /api/v1/updateFileHashList | 読む + 書く (v1 デフォルト) | Netskopeテナントにハッシュを共有するために使います。 | |||
| /api/v1/app _インスタンス | 読む + 書く (v1 デフォルト) | アプリインスタンスをNetskopeテナントに共有するために使います。 | |||
| /api/v1/app _インスタンス | 読む + 書く (v1 デフォルト) | v1 トークンを使用したテナント構成中に v1 トークンを検証するために必要なエンドポイントです。 | |||
v2 REST API スコープ
| Netskope Endpoints | 特権レベル | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | リスク交換（CREv2） |
|---|---|---|---|---|---|
| /api/v2/events/dataexport/ イベント/アラート | Read | これは必須のエンドポイントであり、テナント構成中に v2 トークンを検証するために使用されます。 | |||
| /api/v2/events/dataexport/ イベント/アプリケーション | Read | アプリケーション イベントのプルと取り込みに費やします。 | APPLICATIONエンティティのアプリケーションをプル、抽出、保存します。 | ||
| /api/v2/events/dataexport/ イベント/監査 | Read | 監査イベントのプルと取り込みに費やします。 | |||
| /api/v2/events/dataexport/ イベント/エンドポイント | Read | エンドポイントデータを取得して取り込むのに使います。 | エンドポイントデータを取得して保存するのに使います。 | ||
| /api/v2/events/dataexport/ イベント/インシデント | Read | インシデント イベントを取得して取り込むために使用します。 | インシデント データを取得して保存するのに使います。 | ||
| /api/v2/events/dataexport/ イベント/インフラストラクチャ | Read | インフラストラクチャ イベントをプルするのに使う | |||
| /api/v2/events/dataexport/ イベント/ネットワーク | Read | ネットワークイベントをプルするのに使う | |||
| /api/v2/events/dataexport/ イベント/ページ | Read | ページイベントをプルするのに使う | |||
| /api/v2/events/dataexport/ アラート/uba | Read | UBA アラートのプルと取り込みに費やす | UBA アラートを取得して保存するのに時間がかかります。 | USERエンティティのUBAアラートからユーザー情報を取得します。 | |
| /api/v2/events/dataexport/ アラート/セキュリティ評価 | Read | セキュリティ評価アラートを取得して取り込むのに費やす | セキュリティ評価アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/隔離 | Read | 隔離アラートの取得と取り込みに時間を費やす | 隔離アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/修復 | Read | 修復アラートのプルと取り込みに時間を費やす | 修復アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/ポリシー | Read | ポリシーアラートを取得して取り込むのに時間を費やす | ポリシー アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/マルウェア | Read | マルウェアアラートのプルと取り込みに費やす | マルウェアアラートを取得して保存するのに費やします。 | マルウェアアラートからハッシュを取得して抽出するのに時間がかかります。 | |
| /api/v2/events/dataexport/ アラート/悪質サイト | Read | マルサイトアラートのプルと取り込みに費やす | Malsite アラートを取得して保存するのに時間がかかります。 | マルウェアサイト警告から悪意のあるURLを抽出します。 | |
| /api/v2/events/dataexport/ アラート/侵害された認証情報 | Read | 侵害されたクレデンシャル アラートをプルして取り込むのに使う | 侵害されたクレデンシャル アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/ctep (または ips) | Read | ctep/ips/c2 アラートのプルと取り込みに費やす | CTEP/IPS/C2アラートを取得して保存します。 | ||
| /api/v2/events/dataexport/ アラート/DLP | Read | DLP アラートのプルと取り込みに費やす | DLP アラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/dataexport/ アラート/ウォッチリスト | Read | ウォッチリストのアラートを取得して取り込むのに時間がかかる | ウォッチリストのアラートを取得して保存するのに時間がかかります。 | ||
| /api/v2/events/token/ トランザクションイベント | Read | Netskope WebTx 構成のサブスクリプション キーとサブスクリプション パスを取得するために使用し、WebTx データを取得するために認証を行うために使用します。 | |||
| /api/v2/events/metrics/ トランザクションイベント | Read | 使う WebTx 設定用のバックログメッセージ数を引き出します。 | |||
| /api/v2/incidents/update | 読む＋書く | 使う インシデントをテナントに更新 Netskope 。 | |||
| /api/v2/ポリシー/urllist | 読む＋書く | NetskopeテナントのURLリストにURL、ドメイン、IPアドレスを共有する。 | |||
| /api/v2/policy/urllist/ デプロイ | 読む＋書く | 共有される変更をデプロイするのに使う /api/v2/ポリシー/urllist エンドポイントを使う。 | |||
| /api/v2/incidents/uba/ ゲトゥチ | 読む＋書く | 使う to get for user entity のスコア。 | |||
| /api/v2/incidents/user/ uciimpact | 読む＋書く | 使う to inest to influence for user(ユーザー)からテナントへのUCIスコア Netskope 影響 | |||
| /api/v2/services/cci/ アプリ | Read | 使う アプリ名、CCI、CCL、カテゴリ名、組織など関連するアプリケーションの詳細CCI取得できます。 | |||
| /api/v2/services/cci/ ドメイン | Read | アプリケーションのドメインの詳細を取得するのに時間がかかります。 | |||
| /api/v2/services/cci/ tags | Read | アプリケーションのタグの詳細を取得するのに時間がかかります。 | |||
| /api/v2/infrastructure/ 出版社 | 読む＋書く | 使う 利用可能な出版社のリストを入手したい。 | 使う 利用可能な出版社のリストを入手したい。 | ||
| /api/v2/steering/apps/ プライベート | 読む＋書く | 使う プライベートアプリとその詳細を共有するために | プライベートアプリとその詳細を共有するために使います。 | ||
| /api/v2/scim/Users | 読む＋書く | SCIM ユーザーを獲得するために使います。 | |||
| /api/v2/scim/Groups | 読む＋書く | 使う SCIMグループを取得し、グループからユーザーの変更・追加・削除。 | |||
5.0.1 REST API（非推奨）
v1 REST API スコープ
| Netskopeエンドポイントの権限 | 特権レベル | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | ユーザーリスク交換（URE） | アプリリスクエクスチェンジ（ARE） |
|---|---|---|---|---|---|---|
| /api/v1/updateFileHashList | 読む + 書く (v1 デフォルト) | x |
v2 REST API スコープ
| Netskopeエンドポイントの権限 | 特権レベル | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | ユーザーリスク交換（URE） | アプリリスクエクスチェンジ（ARE） |
|---|---|---|---|---|---|---|
| /api/v2/events/dataexport/events/alert | Read | |||||
| /api/v2/events/dataexport/events/application | Read | x | x | |||
| /api/v2/events/dataexport/events/audit | Read | x | ||||
| /api/v2/events/dataexport/events/connection | 調査対象外 | |||||
| /api/v2/events/dataexport/events/incident | Read | x | ||||
| /api/v2/events/dataexport/events/infrastructure | Read | x | ||||
| /api/v2/events/dataexport/events/network | Read | x | ||||
| /api/v2/events/dataexport/events/page | Read | x | ||||
| /api/v2/events/dataexport/alerts/uba | Read | x | x | x | ||
| /api/v2/events/dataexport/alerts/securityassessment | Read | x | x | |||
| /api/v2/events/dataexport/alerts/quarantine | Read | x | x | |||
| /api/v2/events/dataexport/alerts/remediation | Read | x | x | |||
| /api/v2/events/dataexport/alerts/policy | Read | x | x | |||
| /api/v2/events/dataexport/alerts/マルウェア | Read | x | x | x | ||
| /api/v2/events/dataexport/alerts/malsite | Read | x | x | x | ||
| /api/v2/events/dataexport/alerts/compromisedcredential | Read | x | x | |||
| /api/v2/events/dataexport/alerts/ctep （またはips） | Read | x | x | |||
| /api/v2/events/dataexport/alerts/dlp | Read | x | x | |||
| /api/v2/events/dataexport/alerts/watchlist | Read | x | x | |||
| /api/v2/policy/urllist/file | 読む＋書く | |||||
| /api/v2/ポリシー/urllist | 読む＋書く | x | ||||
| /api/v2/ポリシー/urllist/deploy | 読む＋書く | x | ||||
| /api/v2/incidents/uba/getuci | 読む＋書く | x | ||||
| /api/v2/ubadatasvc/user/uci | 読む＋書く | x | ||||
| /api/v2/services/cci/app | Read | x | ||||
| /api/v2/services/cci/domain | Read | x | ||||
| /api/v2/services/cci/tags | Read | x | ||||
| /api/v2/infrastructure/publishers | 読む＋書く | x | ||||
| /api/v2/steering/apps/private/tags | 読む＋書く | x | ||||
| /api/v2/steering/apps/private | 読む＋書く | x |
5.0.0REST API（非推奨）
v1 REST API スコープ
| Netskopeエンドポイントの権限 | 特権レベル | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | ユーザーリスク交換（URE） | アプリリスクエクスチェンジ（ARE） |
|---|---|---|---|---|---|---|
| /api/v1/updateFileHashList | 読む + 書く (v1 デフォルト) | x |
v2 REST API スコープ
| Netskopeエンドポイントの権限 | 特権レベル | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | ユーザーリスク交換（URE） | アプリリスクエクスチェンジ（ARE） |
|---|---|---|---|---|---|---|
| /api/v2/events/dataexport/events/alert | Read | |||||
| /api/v2/events/dataexport/events/application | Read | x | x | |||
| /api/v2/events/dataexport/events/audit | Read | x | ||||
| /api/v2/events/dataexport/events/connection | 調査対象外 | |||||
| /api/v2/events/dataexport/events/incident | Read | x | ||||
| /api/v2/events/dataexport/events/infrastructure | Read | x | ||||
| /api/v2/events/dataexport/events/network | Read | x | ||||
| /api/v2/events/dataexport/events/page | Read | x | ||||
| /api/v2/events/dataexport/alerts/uba | Read | x | x | x | ||
| /api/v2/events/dataexport/alerts/securityassessment | Read | x | x | |||
| /api/v2/events/dataexport/alerts/quarantine | Read | x | x | |||
| /api/v2/events/dataexport/alerts/remediation | Read | x | x | |||
| /api/v2/events/dataexport/alerts/policy | Read | x | x | |||
| /api/v2/events/dataexport/alerts/マルウェア | Read | x | x | x | ||
| /api/v2/events/dataexport/alerts/malsite | Read | x | x | x | ||
| /api/v2/events/dataexport/alerts/compromisedcredential | Read | x | x | |||
| /api/v2/events/dataexport/alerts/ctep （またはips） | Read | x | x | |||
| /api/v2/events/dataexport/alerts/dlp | Read | x | x | |||
| /api/v2/events/dataexport/alerts/watchlist | Read | x | x | |||
| /api/v2/policy/urllist/file | 読む＋書く | |||||
| /api/v2/ポリシー/urllist | 読む＋書く | x | ||||
| /api/v2/ポリシー/urllist/deploy | 読む＋書く | x | ||||
| /api/v2/incidents/uba/getuci | 読む＋書く | x | ||||
| /api/v2/ubadatasvc/user/uci | 読む＋書く | x | ||||
| /api/v2/services/cci/app | Read | x | ||||
| /api/v2/services/cci/domain | Read | x | ||||
| /api/v2/services/cci/tags | Read | x |
4.2.0 REST API（非推奨）
データエクスポートエラーコード
| Error Codes | ユーザーによる操作が必要です | デスクリプション |
|---|---|---|
| 403 | はい | API V2トークンが有効なエンドポイントに関連付けられており、有効期限が切れていないことを確認してください。これらのガイドラインに従ってトークンの問題を解決した後でのみ、再試行によって問題が解決されます。 |
| 409 | いいえ | 同時実行競合が発生しており、現時点ではリクエストを処理できません。
DataExport API V2のエンドポイントは、同じイテレータインデックスを使用して同じイベントタイプを同時にダウンロードすることをサポートしていません。クライアントは、イベントを取得するロジックがシングルスレッドであることを検証する必要があります。 |
| 429 | いいえ | 同一テナントから同一エンドポイントへのアクセス要求が多すぎます。
クライアントは、429 エラーを回避するためにレート制限を遵守することが求められ、レスポンス ヘッダーの一部として、ratelimit-reset ヘッダーにリセット時刻が含まれます。クライアントは、429 エラーを回避するためにスリープ/待機 (ratelimit-reset) する必要があります。 現在のレート制限は、エンドポイントあたり毎秒4リクエストです。 |
| 5XX | はい | Netskopeで何らかの理由で一時的なサーバー障害が発生しています。
Netskopeサーバーから5xxエラーを受信した場合、ユーザーは次の呼び出しを行う前に5秒間待機することをお勧めします。 |
v1 REST API スコープ
| Endpoint | Privilege | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | ユーザーリスク交換（URE） | アプリリスクエクスチェンジ（ARE） | 注記 |
|---|---|---|---|---|---|---|---|
| トークンが生成され、有効期限が切れていません | （全て） | x | ファイルハッシュの共有に必要 |
v2 REST API スコープ
注記
CE 4.2.0 以降では、 Netskopeテナントを設定するときに、 Cloud Exchangeで構成したアラートとイベントに対してdataexportエンドポイント アクセス許可を使用する必要があります。
| Endpoint | Privilege | ログシッパー（CLS） | チケットオーケストレーター（CTO） | 脅威交換（CTE） | ユーザーリスク交換（URE） | アプリリスクエクスチェンジ（ARE） | 注記 |
|---|---|---|---|---|---|---|---|
| /api/v2/events/data/alert | Read | ||||||
| /api/v2/events/data/application | Read | ||||||
| /api/v2/events/data/audit | Read | ||||||
| /api/v2/events/data/infrastructure | Read | ||||||
| /api/v2/events/data/network | Read | ||||||
| /api/v2/events/data/page | Read | ||||||
| /api/v2/events/dataexport/events/alert | Read | x | x | x | x | x | APIトークンの検証が必要です |
| /api/v2/events/dataexport/events/application | Read | x | x | ||||
| /api/v2/events/dataexport/events/audit | Read | x | |||||
| /api/v2/events/dataexport/events/connection | Read | ||||||
| /api/v2/events/dataexport/events/incident | Read | x | |||||
| /api/v2/events/dataexport/events/infrastructure | Read | x | |||||
| /api/v2/events/dataexport/events/network | Read | x | |||||
| /api/v2/events/dataexport/events/page | Read | x | |||||
| /api/v2/events/dataexport/alerts/uba | Read | x | x | ||||
| /api/v2/events/dataexport/alerts/securityassessment | Read | x | x | ||||
| /api/v2/events/dataexport/alerts/quarantine | Read | x | x | x | |||
| /api/v2/events/dataexport/alerts/remediation | Read | x | x | ||||
| /api/v2/events/dataexport/alerts/policy | Read | x | x | ||||
| /api/v2/events/dataexport/alerts/マルウェア | Read | x | x | x | |||
| /api/v2/events/dataexport/alerts/malsite | Read | x | x | x | |||
| /api/v2/events/dataexport/alerts/compromisedcredential | Read | x | x | ||||
| /api/v2/events/dataexport/alerts/ctep （またはips） | Read | x | x | ||||
| /api/v2/events/dataexport/alerts/dlp | Read | x | x | ||||
| /api/v2/events/dataexport/alerts/watchlist | Read | x | x | ||||
| /api/v2/policy/urllist/file | 読む＋書く | ||||||
| /api/v2/ポリシー/urllist | 読む＋書く | x | |||||
| /api/v2/ポリシー/urllist/deploy | 読む＋書く | x | |||||
| /api/v2/incidents/uba/getuci | 読む＋書く | x | |||||
| /api/v2/ubadatasvc/user/uci | 読む＋書く | x | |||||
| /api/v2/services/cci/app | Read | x | |||||
| /api/v2/services/cci/domain | Read | x | |||||
| /api/v2/services/cci/tags | Read | x |
x: Required API scopes for the corresponding CE module.