Netskope
このガイドでは、Netskope を Google Security Operations(Google SecOps)と統合する方法について説明します。
ユースケース
Netskope を Google SecOps と統合すると、次のユースケースを解決できます。
フィッシング URL の調査とブロック: フィッシング URL アラートを受信すると、Google SecOps 機能を使用して Netskope クラウド セキュリティ プラットフォームにクエリを実行し、URL の評価と分類に関する情報を取得します。URL が悪意のあるものと確認された場合、Netskope は組織のネットワーク全体で URL を自動的にブロックできます。
マルウェアの分析と封じ込め: Google SecOps の機能を使用して、マルウェア サンプルを Netskope に送信し、動的分析を行います。分析結果に基づいて、Netskope はポリシーを適用して、感染したデバイスを隔離したり、悪意のあるコマンド&コントロール サーバーとの通信をブロックしたりできます。
不正使用されたアカウントの修復: Google SecOps の機能を使用して、不審なログイン試行やアクティビティを特定し、パスワードの再設定、多要素認証のチャレンジ、アカウントの強制停止などのアクションを適用します。
脆弱性スキャンとパッチ適用: Google SecOps の機能を使用して、クラウド アプリケーションで検出された脆弱性に関するアラートを受信します。
インシデント対応の自動化: Google SecOps の機能を使用して、ユーザー アクティビティ、ネットワーク トラフィック、データアクセス ログなど、インシデントに関するコンテキスト情報を収集し、影響を受けるシステムの隔離、悪意のあるトラフィックのブロック、関連するステークホルダーへの通知など、インシデント対応タスクを自動化します。
脅威インテリジェンスの拡充: Google SecOps の機能を使用して Netskope 脅威インテリジェンス フィードと統合し、セキュリティ通知をコンテキスト情報で拡充します。
始める前に
Google SecOps で Netskope 統合を構成する前に、Netskope テナントから特定の認証情報を取得する必要があります。この統合では、アクションで使用する API バージョンに応じて、2 つの認証方法がサポートされています。
Netskope プラットフォームでこれらの設定を見つける方法については、Netskope Knowledge Portal をご覧ください。
REST API V1(レガシー)
このメソッドは、V1 API を使用するアクションに必要です。このメソッドを使用するには、API トークン(API キーとも呼ばれます)を取得する必要があります。トークンの生成手順については、Netskope の REST API v1 の概要をご覧ください。
REST API V2(OAuth 2.0)
このメソッドは、V2 API(List Alerts、List Events、Add Entities To URL List、Deploy URL List Changes)のみを使用するアクションと、Use V2 API パラメータが選択されているアクションに必要です。
V2 API を使用して認証するには、Netskope テナントから次の認証情報を取得する必要があります ([Settings] > [Tools] > [REST API v2] で構成するか、RBAC v3 を使用するテナントの場合は [Settings] > [Administration] > [Administrators & Roles] のサービス アカウントから取得します)。
- クライアント ID: 新しい OAuth 2.0 クライアントまたはサービス アカウントを作成するときに生成されます。
- クライアント シークレット: クライアント ID とともに生成されます。
OAuth 2.0 クライアントの設定とロールの割り当ての手順については、Netskope の REST API V2 の概要と管理者 RBAC V3 のドキュメントをご覧ください。
必要な REST API V2 エンドポイントとスコープ
Netskope で OAuth 2.0 クライアントまたは RBAC v3 サービス アカウントのロールを構成する場合は、実行するアクションに必要な最小限のスコープ(権限)を付与します。
| アクション | 必須の REST API V2 エンドポイント | 必要なスコープ(権限) |
|---|---|---|
| Ping(V2 API を使用する場合) List Alerts |
/api/v2/events/data/alert |
Read |
| イベントを一覧表示する |
このアクションで |
Read |
クライアントを一覧表示する(Use V2 API が有効な場合) |
/api/v2/events/datasearch/clientstatus |
Read |
隔離されたファイルを一覧表示する(Use V2 API が有効になっている場合) |
/api/v2/casbapi/incidents/quarantine |
Read |
ファイルをダウンロード(Use V2 API が有効になっている場合) |
|
Read |
ファイルを許可(Use V2 API が有効になっている場合) |
/api/v2/casbapi/incidents/quarantine/{file_id}/restore |
Read+Write |
ファイルをブロック(Use V2 API が有効な場合) |
/api/v2/casbapi/incidents/quarantine/{file_id}/block |
Read+Write |
| URL リストにエンティティを追加する |
|
Read+Write |
| URL リストの変更をデプロイする | /api/v2/policy/urllist/deploy |
Read+Write |
ネットワーク設定
統合の掲載ネットワークの設定を構成するには、次の表をご覧ください。
| 関数 | デフォルト ポート | 方向 | プロトコル |
|---|---|---|---|
| API | 443 | 送信 | HTTPS |
Netskope を Google SecOps と統合する
Netskope の統合には、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Api Root |
必須。 Netskope インスタンスの API ルート。 |
Api Key |
省略可。 V1 API を使用したアクションに対する認証に使用される、Netskope コンソールから取得した API トークン値。 |
Client ID |
省略可。 V2 API(OAuth 2.0)認証に使用されるクライアント ID。 このパラメータは、V2 API を使用するアクションに必須です。 |
Client Secret |
省略可。 V2 API(OAuth 2.0)認証に使用されるクライアント シークレット。 このパラメータは、V2 API を使用するアクションに必要です。 |
Verify SSL |
省略可。 選択すると、統合は Netskope サーバーに接続するときに SSL 証明書を検証します。 |
Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。
必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。
操作
アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。
URL リストにエンティティを追加する
[Add Entities To URL List] アクションを使用して、新しい URL、ドメイン、IP アドレスを既存の Netskope URL リストに追加します。
このアクションは、次の Google SecOps エンティティに対して実行されます。
DomainIP AddressURLアクションへの入力
Netskope アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
URL List Name |
必須。 更新する既存の Netskope URL リストの名前( |
Entries |
省略可。 リストに追加する URL、ドメイン、IP アドレスのカンマ区切りのリスト。 このアクションにより、ケースに添付された |
Deploy URL List Changes |
省略可。 選択すると、このアクションにより、テナント内のすべての URL リスト(更新中のリストだけでなく)で保留中のすべての変更がグローバルにデプロイされます。 |
アクションの出力
Netskope アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Netskope アクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"added_entities": [
"https://aistudio.google.com/prompts",
"https://docs.google.com/"
],
"failed_entities": [
"not_real_url",
10500
],
"url_list_name": "Allowed URL List",
"modify_by": "SOAR_API2",
"modify_time": "2026-02-26T15:28:07.000Z",
"pending": 1
}
出力メッセージ
Netskope アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action. Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Netskope アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ファイルを許可
[Allow File] アクションを使用して、隔離されたファイルを許可します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
ファイルの許可アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
File ID |
必須
許可するファイルの ID。 |
Quarantine Profile ID |
省略可
ファイルに関連付けられている検疫プロファイルの ID。 |
Use V2 API |
省略可
選択すると、アクションは V1 ではなく Netskope V2 API エンドポイントを使用します。 これには、有効な V2 API 認証情報が必要です。 このパラメータには OAuth 2.0 のサポートが必要です。統合設定で有効な |
アクションの出力
[Allow File] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| スクリプトの結果 | 利用可能 |
スクリプトの結果
次の表に、[ファイルを許可] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ファイルをブロック
検疫されたファイルをブロックするには、[Block File] アクションを使用します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
Block File アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
File ID |
必須
Netskope でブロックするファイルの ID。 |
Quarantine Profile ID |
省略可
ファイルに関連付けられている検疫プロファイルの ID。 |
Use V2 API |
省略可
選択すると、アクションは V1 ではなく Netskope V2 API エンドポイントを使用します。 これには、有効な V2 API 認証情報が必要です。 このパラメータには OAuth 2.0 のサポートが必要です。統合設定で有効な |
アクションの出力
Block File アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| スクリプトの結果 | 利用可能 |
スクリプトの結果
次の表に、Block File アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
URL リストの変更をデプロイする
[URL リストの変更をデプロイ] アクションを使用して、保留中の構成をアクティブな Policy Engine に push します。これにより、ステージングされた更新が URL リストに適用され、適用されます。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
なし
アクションの出力
Deploy URL List Changes アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Deploy URL List Changes アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action. Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Deploy URL List Changes] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ファイルをダウンロード
[Download File] アクションを使用して、隔離されたファイルをダウンロードします。
このアクションは、Google SecOps IP Address エンティティに対して実行されます。
アクションへの入力
Download File アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
File ID |
必須
検疫からダウンロードするファイルの ID。 |
Quarantine Profile ID |
省略可
ファイルに関連付けられている検疫プロファイルの ID。 |
Use V2 API |
省略可
選択すると、アクションは V1 ではなく Netskope V2 API エンドポイントを使用します。 これには、有効な V2 API 認証情報が必要です。 このパラメータを有効にすると、次の要件と変更が導入されます。
|
アクションの出力
Download File アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| スクリプトの結果 | 利用可能 |
スクリプトの結果
次の表に、ファイルのダウンロード アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
アラートを一覧表示する
アラートを一覧表示するには、[List Alerts] アクションを使用します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
List Alerts アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Query |
Optional アラート データベース内のクラウド アプリケーション イベントをフィルタするクエリ。 |
Type |
Optional フィルタするアラートの種類。 値は次のいずれかになります。
|
Time Period |
Optional アラートを検索する現在より前の期間(ミリ秒単位)。 指定できる値は |
Start Time |
Optional 指定された Unix エポック時間より後のタイムスタンプを持つアラートをフィルタする開始時刻。 このパラメータは、 |
End Time |
Optional 指定された Unix エポック時間より前のタイムスタンプを持つアラートをフィルタする終了時間。 このパラメータは、 |
Is Acknowledged |
Optional 選択すると、統合は確認済みのアラートをフィルタします。 デフォルトでは選択されていません。 |
Limit |
Optional 返される結果の数。 デフォルト値は |
アクションの出力
List Alerts アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、List Alerts アクションの使用時に受信した JSON 結果の出力を示しています。
[
{
"dstip": "192.0.2.1",
"app": "Amazon Web Services",
"profile_id": "ID",
"device": "iPad",
"shared_credential_user": "example@example.com",
"app_session_id": 2961859388,
"dst_location": "Ashburn",
"dst_region": "Virginia",
"policy": "Copy prohibited",
"page_id": 380765822,
"object_type": "File",
"dst_latitude": 39.0481,
"timestamp": 1548603047,
"src_region": "California",
"from_user": "user@example.com",
"src_location": "San Luis Obispo",
"traffic_type": "CloudApp",
"appcategory": "IaaS/PaaS",
"src_latitude": 35.2635,
"count": 2,
"type": "anomaly",
"risk_level_id": 2,
"activity": "Upload",
"userip": "203.0.113.1",
"src_longitude": -120.6509,
"browser": "Safari",
"alert_type": "anomaly",
"event_type": "user_shared_credentials",
"_insertion_epoch_timestamp": 1548601562,
"site": "Amazon Web Services",
"id": 3561,
"category": "IaaS/PaaS",
"orig_ty": "nspolicy",
"dst_country": "US",
"src_zipcode": "93401",
"cci": 94,
"ur_normalized": "user@example.com",
"object": "quarterly_report.pdf",
"organization_unit": "",
"acked": "false",
"dst_longitude": -77.4728,
"alert": "yes",
"user": "user@example.com",
"userkey": "user@example.com",
"srcip": "7198.51.100.1",
"org": "example.com",
"src_country": "US",
"bin_timestamp": 1548633600,
"dst_zipcode": "20149",
"url": "http://aws.amazon.com/",
"sv": "unknown",
"ccl": "excellent",
"alert_name": "user_shared_credentials",
"risk_level": "high",
"_mladc": ["ur"],
"threshold_time": 86400,
"_id": "cadee4a8488b3e139b084134",
"os": "iOS 6"
}
]
スクリプトの結果
次の表に、List Alerts アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
alerts |
ALERT_LIST |
クライアントを一覧表示する
クライアントを一覧表示するアクションを使用して、クライアントを一覧表示します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
List Clients アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Query |
省略可
データベースから取得したクライアントをフィルタします。 |
Limit |
省略可
アクションによって返されるクライアントの数を制限します。 デフォルト値は |
Use V2 API |
省略可
選択すると、アクションは V1 ではなく Netskope V2 API エンドポイントを使用します。 これには、有効な V2 API 認証情報が必要です。 このパラメータには OAuth 2.0 のサポートが必要です。統合設定で有効な |
アクションの出力
List Clients アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、List Clients アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"client_install_time": 1532040251,
"users":
[
{
"heartbeat_status_since": 1532040385,
"user_added_time": 1532040167,
"last_event":
{
"status": "Enabled",
"timestamp": 1548578307,
"event": "Tunnel Up",
"actor": "System"
},
"device_classification_status": "Not Configured",
"username": "user@example.com",
"user_source": "Manual",
"userkey": "K00fuSXl8yMIqgdg",
"_id": "ID",
"heartbeat_status": "Active"
}],
"last_event":
{
"status": "Enabled",
"timestamp": 1548578307,
"event": "Tunnel Up",
"actor": "System"
},
"host_info":
{
"device_model": "VMware Virtual Platform",
"os": "Windows",
"hostname": "HOSTNAME",
"device_make": "VMware, Inc.",
"os_version": "10.0"
},
"client_version": "1.1.1.1",
"_id": "ID",
"device_id": "DEVICE_ID"
}
]
スクリプトの結果
次の表に、List Clients アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
clients |
CLIENT_LIST |
イベントのリストを取得する
List Events アクションを使用して、イベントを一覧表示します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
List Events アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Query |
Optional イベント データベース内のクラウド アプリケーション イベントをフィルタするクエリ。 |
Type |
Optional フィルタするアラートの種類。 値は次のいずれかになります。
|
Time Period |
Optional イベントを検索する、現在より前の期間(ミリ秒単位)。 有効な値は |
Start Time |
Optional 指定された Unix エポック時間より大きいタイムスタンプを持つイベントをフィルタする開始時間。 このパラメータは、 |
End Time |
Optional 指定された Unix エポック時間より小さいタイムスタンプを持つイベントをフィルタする終了時間。 このパラメータは、 |
Limit |
Optional 返される結果の数。 デフォルト値は |
アクションの出力
List Events アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、List Events アクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"dstip": "192.0.2.64",
"browser_session_id": 1066949788113471080,
"srcip": "198.51.100.36",
"app_session_id": 4502249472406092569,
"os_version": "WindowsServer2016",
"dst_region": "Virginia",
"numbytes": 37480,
"req_cnt": 18,
"server_bytes": 8994,
"page_id": 0,
"page_duration": 867,
"page_endtime": 1548577530,
"dst_latitude": 39.0481,
"timestamp": 1548576663,
"src_region": "Oregon",
"src_location": "Boardman",
"ur_normalized": "user@example.com",
"appcategory": "",
"src_latitude": 45.8491,
"count": 1,
"bypass_traffic": "no",
"type": "page",
"userip": "203.0.113.253",
"src_longitude": -119.7143,
"page": "WebBackground",
"browser": "",
"domain": "WebBackground",
"dst_location": "Ashburn",
"_insertion_epoch_timestamp": 1548577621,
"site": "WebBackground",
"access_method": "Client",
"browser_version": "",
"category": "",
"client_bytes": 28486,
"user_generated": "no",
"hostname": "IP-C0A84AC",
"dst_country": "US",
"resp_cnt": 18,
"src_zipcode": "97818",
"traffic_type": "Web",
"http_transaction_count": 18,
"organization_unit": "example.com/Users",
"page_starttime": 1548576663,
"dst_longitude": -77.4728,
"user": "user@example.com",
"userkey": "user@example.com",
"device": "WindowsDevice",
"src_country": "US",
"dst_zipcode": "20149",
"url": "WebBackground",
"sv": "",
"ccl": "unknown",
"useragent": "RestSharp/192.0.2.0",
"_id": "ID",
"os": "WindowsServer2016"
}
]
スクリプトの結果
次の表に、List Events アクションを使用した場合のスクリプト結果出力の値を示します。
| スクリプトの結果名 | 値 |
|---|---|
events |
EVENT_LIST |
隔離されたファイルを一覧表示する
[List Quarantined Files] アクションを使用して、隔離されたファイルを一覧表示します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
List Quarantined Files アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Start Time |
省略可
このパラメータの値より大きいタイムスタンプを持つイベントを制限する開始時刻(Unix 形式)。 |
End Time |
省略可
Unix 形式のこのパラメータの値より小さいタイムスタンプを持つイベントを制限する終了時刻。 |
Use V2 API |
省略可
選択すると、アクションは V1 ではなく Netskope V2 API エンドポイントを使用します。 これには、有効な V2 API 認証情報が必要です。 このパラメータには OAuth 2.0 のサポートが必要です。統合設定で有効な |
アクションの出力
[List Quarantined Files] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| スクリプトの結果 | 利用可能 |
スクリプトの結果
次の表に、List Quarantined Files アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
files |
FILE_LIST |
Ping
Ping アクションを使用して、Netskope への接続をテストします。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
なし
アクションの出力
Ping アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| スクリプトの結果 | 利用可能 |
スクリプトの結果
次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。