リリースノート
1.2.0 (Minimum required CE version 6.1.0)
Added
- Borderless WANテナントからネットワークイベント(フロー)とアラート(V2)をプルするサポートが追加されました。
- クライアントおよびゲートウェイエンティティのプルが追加されました。これらはNetskope Borderless WAN Risk Exchangeプラグインに配信されます。エンティティは、最後に変更された時間に基づいて増分的にプルされます。
1.1.0
Changed
- イベントエンドポイントのBorderless WAN APIを更新しました。
- Cloud Exchangeの互換性情報を更新しました。
1.0.0
Added
- 初回リリース。
- 監査、認証、クライアント、ゲートウェイ、およびシステムタイプのイベントを取得するためのサポートを追加しました。
本書では、Cloud ExchangeでNetskope Borderless WAN Tenant v1.2.0プラグインを構成する方法について説明します。このプラグインは、Cloud ExchangeでNetskope Borderless WANテナントを構成するために必要です。Netskope Borderless WANプラグインは、各モジュールに必要なデータを取得するためにテナントを使う。
前提条件
この設定を完了するには、以下が必要です。
- APIトークンを生成する権限を持つNetskope Borderless WANテナント。
- Netskope Borderless WANテナントホストへの接続。例えば、https://<tenant>.api.infiot.net です。
- Secrets Managerの構成については、Secrets Manager を参照してください。Azure Key VaultをSecrets Managerとして設定するには、Prerequisites for Azure Key Vault Secrets Manager を参照してください。
Netskope Borderless WAN Tenant Plugin Support
このプラグインは、Netskope Borderless WANプラグインで使うNetskope Borderless WANテナントからイベントとアラートをプルします。
| データ型 | サポート |
|---|---|
| イベントの種類 | はい(監査、認証、クライアント、ゲートウェイ、システム、ネットワークイベント) |
| アラートの種類 | はい(アラート(V2)) |
| ウェブテキサス | サポートされていません |
権限
認証トークンには、以下の権限が必要です。
[
{
"rap_resource": "*",
"rap_privs": [
"privAddressGroupCreate",
"privAddressGroupRead",
"privAddressGroupWrite",
"privAddressObjectCreate",
"privAddressObjectDelete",
"privAddressObjectRead",
"privAuditRecordRead",
"privCustomAppCreate",
"privCustomAppDelete",
"privCustomAppRead",
"privCustomAppWrite",
"privManagedDeviceRead",
"privMonitorAlertRead",
"privPolicyRead",
"privSiteRead",
"privTenantRead",
"privUserRead"
]
}
]
APIの詳細
使うAPI一覧
| APIエンドポイント | 方法 | 使うケース |
|---|---|---|
| /v2/auditevents | 得る | Borderless WANテナントからイベント(監査、認証、クライアント、ゲートウェイ、システム)を取得します。 |
| /v2/networkevents | 得る | Borderless WANテナントからネットワークイベント(フロー/トラフィックログ)を取得します。 |
| /v2/alerts | 得る | Borderless WANテナントからアラート(V2)を取得します。 |
イベントの取得
API Endpoint: <BASE URL>/v2/auditevents
Method: GET
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <API TOKEN> |
| ユーザーエージェント | netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0 |
Request Parameters
| 鍵 | Value |
|---|---|
| first | 100 |
| after | end_cursor(前回の応答からの終了カーソル) |
| filter | event_time>=’<START TIME>‘ AND event_time<‘<END TIME>‘ AND (type: <EVENT TYPE>) |
Sample API Response
{
"page_info": {
"end_cursor": "WyIyMDI1LTAxLTI5VDEyOjQzOjIyLjAzNVoiLCI2NzlhMjI2YTIyNmUyYTBmYzU2YzJjOGIiXQ",
"has_next": true,
"total_count": 4
},
"data": [
{
"id": "679a226a226e2a0fc56c2c8b",
"actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:token:6245b39c611790724910338f",
"target_nrn": "nrn:bwan:site:us:5dadf8a91602d141e060c93e:site:673757abb51faf57f043a36a",
"type": "AUDIT",
"subtype": "AUDIT_GATEWAY",
"activity": "SITE_UPDATED",
"note": "",
"event_time": "2025-01-29T12:43:22Z"
},
{
"id": "679a24c905aa7377e0924ab0",
"actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:user:656e127fd8a92afdc8447576",
"target_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:user:656e127fd8a92afdc8447576",
"type": "AUTHENTICATION",
"subtype": "AUTHENTICATION_USER",
"activity": "USER_LOGIN",
"note": "",
"event_time": "2025-01-29T12:53:29Z"
},
{
"id": "679a20d105aa7377e0924931",
"actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:token:675145c90f1ebb6e8c59983b",
"target_nrn": "nrn:bwan:site:us:5dadf8a91602d141e060c93e:site:675145b90f1ebb6e8c59982a",
"type": "CLIENT",
"subtype": "CLIENT_SYSTEM",
"activity": "SITE_CLIENT_DEVICE_ENROLL_STARTED",
"note": "",
"event_time": "2025-01-29T12:36:34Z"
},
{
"id": "679a259d05aa7377e0924afa",
"actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:token:67343709ca023562f3b8f02e",
"target_nrn": "nrn:bwan:site:us:5dadf8a91602d141e060c93e:site:6734367c1f66fecb2dff8554",
"type": "GATEWAY",
"subtype": "GATEWAY_UNDERLAY",
"activity": "SITE_LINK_UP",
"note": "wlp0s0",
"event_time": "2025-01-29T12:57:00Z"
},
{
"id": "679a25b439a4bd42a70bb934",
"actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:token:6245b39c611790724910338f",
"target_nrn": "nrn:bwan:tenant:us:5dadf8a91602d141e060c93e:tenant:5dadf8a91602d141e060c93e",
"type": "SYSTEM",
"subtype": "SYSTEM_SSE_TUNNEL",
"activity": "SITE_NS_TUNNEL_ERROR",
"note": "https://tunnel-test.goskope.com (accountId: 62b3a3e3b7f108a3b8b74815): get tunnels: status: 401 -> Unauthorized\naccountId: 62b3a3e3b7f108a3b8b74815",
"event_time": "2025-01-29T12:57:24Z"
}
]
}
ネットワークイベントの取得
API Endpoint: <BASE URL>/v2/networkevents
Method: GET
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <API TOKEN> |
| ユーザーエージェント | netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0 |
Request Parameters
| 鍵 | Value |
|---|---|
| first | 100 |
| after | end_cursor(前回の応答からの終了カーソル) |
| filter | ended_at>=’<START TIME>‘ AND ended_at<‘<END TIME>‘ |
Sample API Response
{
"page_info": {
"end_cursor": "WyIyMDI2LTEwLTIxVDEyOjE1OjE1Ljk4WiIsIjc5NjRkYzU2MmFiNDViNTQiXQ",
"has_next": true
},
"data": [
{
"id": "M2JlMDZjNzNmOGNlYjM1MXwyMDI2LTEwLTIxVDEyOjE1OjM2LjM2N1p8ODk2NzcxODkxMjQ5NDg1NzgyNw==",
"source_ip": "169.254.3.132",
"destination_ip": "169.254.3.167",
"source_port": 7777,
"destination_port": 7777,
"mac": "00:00:00:00:00:00",
"device_name": "169.254.3.132",
"application_id": "216",
"application_name": "User Datagram Protocol",
"site_id": "69dfd187fdab1797f44a3a92",
"in_interface_logical_name": "GE1",
"out_interface_logical_name": "GE1",
"started_at": "2026-10-09T14:17:03Z",
"ended_at": "1970-01-01T00:00:00Z",
"packets_sent": 50,
"packets_received": 0,
"bytes_sent": 1943,
"bytes_received": 0,
"duration_millis": 1029512888,
"protocol": "UDP",
"peer_type": "INFIOT",
"peer_role": "SPOKE",
"vpn_nat_source_ip": "0.0.0.0",
"vpn_nat_source_port": 0,
"vpn_nat_destination_ip": "0.0.0.0",
"segment_id": 0,
"latency_millis": 0,
"destination_country": "Reserved/Private",
"scheduler_queue": "HIGH",
"rx_loss_percent": 0,
"tx_loss_percent": 0,
"network_latency_millis": 0,
"jitter_millis": 0,
"peer_name": "mgmtgw",
"is_closed": false
},
{
"id": "Nzk2NGRjNTYyYWI0NWI1NHwyMDI2LTEwLTIxVDEyOjE1OjE1Ljk4WnwxMDg2OTkwMzY2MDUwNjA5NTcy",
"source_ip": "169.254.0.53",
"destination_ip": "169.254.2.251",
"source_port": 7777,
"destination_port": 7777,
"mac": "00:00:00:00:00:00",
"device_name": "169.254.0.53",
"application_id": "216",
"application_name": "User Datagram Protocol",
"site_id": "68107a34144df1459e958e47",
"in_interface_logical_name": "GE1",
"out_interface_logical_name": "GE2",
"started_at": "2026-10-19T03:30:28Z",
"ended_at": "1970-01-01T00:00:00Z",
"packets_sent": 245257,
"packets_received": 0,
"bytes_sent": 9509853,
"bytes_received": 0,
"duration_millis": 204287046,
"protocol": "UDP",
"peer_type": "INFIOT",
"peer_role": "SPOKE",
"vpn_nat_source_ip": "0.0.0.0",
"vpn_nat_source_port": 0,
"vpn_nat_destination_ip": "0.0.0.0",
"segment_id": 0,
"latency_millis": 0,
"destination_country": "Reserved/Private",
"scheduler_queue": "HIGH",
"rx_loss_percent": 0,
"tx_loss_percent": 0,
"network_latency_millis": 10,
"jitter_millis": 0,
"peer_name": "mp-vm-spoke",
"is_closed": false
}
]
}
アラート(V2)を取得します。
API Endpoint: <BASE URL>/v2/alerts
Method: GET
Request Headers
| 鍵 | Value |
|---|---|
| Authorization | Bearer <API TOKEN> |
| ユーザーエージェント | netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0 |
Request Parameters
| 鍵 | Value |
|---|---|
| first | 100 |
| after | end_cursor(前回の応答からの終了カーソル) |
| filter | (opened_at>=’<START TIME>‘ AND opened_at<‘<END TIME>‘) OR (closed_at>=’<START TIME>‘ AND closed_at<‘<END TIME>‘) |
Sample API Response
{
"page_info": {
"end_cursor": "WyI2YWM4MWIyZGEyMTk4M2E1YjVkN2M0ZWQiXQ",
"has_next": true,
"total_count": 972
},
"data": [
{
"id": "6ac81b2d1c9449a3ebdc193a",
"monitor_id": "6ac73666fa4016413e66fe7c",
"labels": {
"site_id": "6a7042ea0dfbcddb54899f92",
"site_name": "mgmtgw"
},
"state": "open",
"severity": "medium",
"opened_at": "2026-10-08T22:37:33Z"
},
{
"id": "6ac81b2da21983a5b5d7c4ed",
"monitor_id": "6ac7dac96ba9932eb61a8e11",
"labels": {
"site_name": "mgmtgw",
"site_id": "6a7042ea0dfbcddb54899f92"
},
"state": "closed",
"severity": "critical",
"opened_at": "2026-10-08T22:37:33Z",
"closed_at": "2026-10-09T11:03:49Z"
}
]
}
ユーザーエージェント
netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0
ワークフロー
- Netskope Borderless WANテナント用の認証トークンを生成します。
- Configure the Netskope Borderless WAN Tenant plugin.
- Validate the Netskope Borderless WAN Tenant plugin.
動画を見る
再生ボタンをクリックして動画をご覧ください。
認証トークンを生成する
-
Netskope Borderless WANテナントにログインします。

-
Settings > API Tokenに移動してNew Tokenをクリックしてください。

-
要件に従って、トークン名、有効期限、およびデスクリプションを入力します。
トークンの権限については、本書の「権限」を参照してください。
-
Saveをクリックして、生成されたトークンをコピーしてください。
生成されたトークンを使用して、Cloud ExchangeでNetskope Borderless WANテナントを構成します。
Configure the Netskope Borderless WAN Tenant Plugin
-
Cloud Exchange で、 Settings > Plugin Storeに移動します。Netskope Borderless WAN Tenant v1.2.0プラグインを検索して選択してください。

-
名前、完全なテナントベースURL(例:https://<tenant>.api.infiot.net)、そして前に生成した認証トークンを入力します。

-
Saveをクリックしてください。
Validate the Netskope Borderless WAN Tenant Plugin
Cloud Exchangeで設定されたBorderless WANテナントを検証するには、Settings > Tenantsに移動します。新しく設定されたテナントが設定済みテナントリストに表示されます。

Troubleshooting the Netskope Borderless WAN Tenant Plugin
テナントの設定中にエラーが発生しました
TENANT Netskope Borderless WAN Tenant [BWAN Tenant デモ]: Validation error occurred. Unable to establish connection with Netskope Borderless WAN プラットフォーム. Proxy server or Netskope Borderless WAN server is not reachable.が表示される場合
What to do: テナントのベースURLが正しく入力されていることを確認してください。形式については、「前提条件」を参照してください。
TENANT Netskope Borderless WAN Tenant [BWAN Tenant デモ]: Validation error occurred. Invalid Auth Token provided in the configuration parameters. Make sure that the Auth Token has all the required permissions and is not expired.が表示される場合
What to do:
- テナントの認証トークンが正しく入力されていることを確認します。
- 認証トークンに必要な権限があることを確認してください。認証トークンの生成を参照してください。

