リリースノート
1.2.0 (Requires minimum Cloud Exchange version 6.1.0 and minimum Netskope BWAN Tenant version 1.2.0)
Added
- 新しいイベントタイプ:ネットワークイベントおよびアラートタイプ:アラート(V2)のサポートを追加しました。
1.1.0
Changed
- イベントエンドポイント向けにBorderless WAN APIを更新しました。
1.0.0
Added
- 初回リリース。
本書では、Netskope Cloud ExchangeプラットフォームのログシッパーモジュールでNetskope Borderless WAN v1.2.0プラグインを設定する方法を説明します。このプラグインは、Netskope Borderless WANテナントのMonitor > Events(監視 > イベント)ページからイベント(監査、認証、クライアント、ゲートウェイ、システム)を、Monitor > Flows(監視 > フロー)ページからネットワークイベント(フロー/トラフィックログ)を、Monitor > Alerts(V2)(監視 > アラート(V2))ページからアラートを取得するために使用されます。
前提条件
この設定を完了するには、以下が必要です。
- Borderless WANテナント(または、本番環境と開発/テスト環境など、複数のテナント)。
- TenantプラグインとLog Shipperプラグインがすでに構成されているNetskope Cloud Exchangeテナント。
- サードパーティプラグイン(Syslogなど)が既に構成されています。
- プラグインの設定には、Netskope Borderless WAN Tenantプラグインのバージョン1.2.0以上が必要です。
- Borderless WANテナントホストへの接続性。
例:https://<tenant>.api.infiot.net - Secrets Managerの構成については、Secrets Managerを参照してください。Azure Key Vault Secrets Managerをセットアップするには、Azure Key Vault Secrets Managerの前提条件を参照してください。
Netskope Borderless WANプラグインのサポート
このプラグインは、Netskope Borderless WANテナントの「モニター」>「イベント」ページからイベント(監査、認証、クライアント、ゲートウェイ、システム)、「モニター」>「フロー」ページからネットワークイベント(フロー/トラフィックログ)、「モニター」>「アラート(V2)」ページからアラートをフェッチするために使用されます。
| データ型 | サポート |
|---|---|
| アラートサポート | はい(アラート(V2)) |
| イベントサポート | はい(監査、認証、クライアント、ゲートウェイ、システム、ネットワークイベント) |
| WebTxサポート | サポートされていません |
| CEログ | サポートされていません |
権限
認証トークンには、以下の権限が必要です。
[
{
"rap_resource": "",
"rap_privs": [
"privAuditRecordRead",
"privMonitorAlertRead",
"privTenantRead"
]
}
]
APIの詳細
使うAPI一覧
| APIエンドポイント | 方法 | 使うケース |
|---|---|---|
| /v2/auditevents | 得る | Borderless WANテナントからイベント(監査、認証、クライアント、ゲートウェイ、システム)を取得します。 |
| /v2/networkevents | 得る | Borderless WAN テナントからネットワークイベント(フロー/トラフィックログ)をフェッチします。 |
| /v2/alerts | 得る | Borderless WANテナントからアラート(V2)を取得します。 |
ソースプラグインに対するすべてのAPI呼び出しはテナントプラグインから行われるため、ユーザーエージェントはテナントプラグインのものになることに注意してください。
イベントの取得
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>)例えば、 event_time>='2025-01-29T12:20:42.124910Z' AND event_time<'2025-01-29T12:58:01.122000Z' AND (type: AUDIT OR type:AUTHENTICATION OR type:CLIENT OR type:GATEWAY OR type:SYSTEM) |
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"
}
]
}
パフォーマンスマトリックス
このパフォーマンス測定は、以下のVM仕様でCloud Exchangeのラージスタックにおいて実施されました。
| デスクリプション | Specifications |
|---|---|
| スタックの詳細 | サイズ:大 RAM:32 GB CPU:16コア |
| ボーダーレスWANから取得したイベント | 約8万EPM |
ユーザーエージェント
netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0
ソースプラグインに対するすべてのAPI呼び出しは、ボーダーレスWANテナントプラグインから行われるため、ユーザーエージェントはテナントプラグインのものになります。
ワークフロー
- Borderless WANテナントで認証トークンを生成します。
- Log Shipper 用の Borderless WAN プラグインを設定します。
- ビジネスルールを設定します。
- ログ配信を設定します。
- ボーダーレスWANプラグインを検証します。
再生ボタンをクリックして動画をご覧ください。
Borderless WANテナントで認証トークンを生成する
-
Netskope Borderless WANテナントにログインします。

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

-
要件に応じて Token Name、Expiration、および Description を入力してください。アクセス権限については、権限を参照してください。
-
Saveをクリックして、生成されたトークンをコピーしてください。
生成されたトークンは、Cloud Exchangeで Netskope Borderless WAN テナントを構成するときに使用します。
Log ShipperプラグインのNetskope Borderless WANを構成します。
-
Cloud Exchangeで、Settings > Plugin Store に移動します。CLS カテゴリの下で、Netskope Borderless WAN v1.2.0 (CLS) プラグインを検索して選択します。

-
プラグインの設定名を入力し、設定済みのBorderless WANテナントを選択します。
- Configuration Name: プラグイン構成名。
- Tenant: Tenant to pull alerts from. Select your Borderless WAN tenant.

-
Next をクリックし、構成パラメータを入力します。
- Event Types: 選択したタイプのイベントがフェッチされます。少なくとも1つのイベントタイプを選択する必要があります。
- Initial Range for Events (in hours): 初期実行時にイベントデータを取得する時間数。値は0から8760の間である必要があります。
- Alert Types: 選択したタイプのアラートがフェッチされます。少なくとも1つのアラートタイプを選択する必要があります。
- Initial Range for Alerts (in days): 初期実行でアラートデータを取得する日数。値は0から365の間である必要があります。

-
Saveをクリックしてください。プラグインの設定は、ログシッパーの「プラグイン」ページで確認できます。

ボーダーレスWANプラグインのログシッパービジネスルールを設定する
-
Log ShipperでBusiness Rulesに移動します。
-
デフォルトでは、すべての警告とイベントをフィルタリングするビジネスルールがあります。特定の種類の警告またはイベントをフィルタリングする場合は、Create New Ruleをクリックし、ルール名とフィルタを追加して新しいビジネスルールを設定します。
If you want to only filter the Borderless WAN events and alerts, create a new rule and select the Borderless WAN types from the following options: bwan_audit, bwan_authentication, bwan_system, bwan_gateway, bwan_client, bwan_network_event, and bwan_alert_v2.

-
Saveをクリックしてください。
Borderless WANプラグインのログ配信を設定する
-
Log ShipperでLog Deliveryに移動し、 Add Log Delivery Configurationをクリックします。
-
Select 送信元構成(Borderless WANプラグイン構成)、送信先構成(Syslogなど、要件に応じて)、ビジネスルールを選択し、Save をクリックします。

-
ログ配信設定を追加すると、データはBorderless WANテナントからプル、変換され、送信先プラットフォームに取り込まれ始めます。

ボーダーレスWANプラグインを検証する
プルを検証する
Cloud ExchangeでLoggingに移動し、取得したログを検索します。







Borderless WANテナントでイベントとアラートを検証します。
-
ボーダーレスWANテナントにログインしてください。
-
Monitor > Eventsに移動します。このプラグインは、このページから監査、認証、クライアント、ゲートウェイ、およびシステムイベントをプルします。


-
Monitor > Flows に移動します。プラグインはこのページからネットワークイベントをプルします。

-
Monitor > Alerts(V2)に移動します。プラグインはこのページからアラートを取得します。

ボーダーレスWANプラグインのトラブルシューティング
プラグインが有効になっているのにイベントがプルされない
What to do: 同じ期間のイベントとアラートがBorderless WANテナントに存在することを確認します。手順については、「Borderless WAN Tenantでイベントとアラートを検証する」を参照してください。
既知の行動
-
ログにこのエラーが表示されることがあります:
2025年2月5日 午後12時06分59秒 – error Netskopeでユーザー エージェントを使用して分析を共有中にエラーが発生しました What to do: NetskopeテナントではなくBorderless WAN テナントを使用しているため、Netskopeのユーザーエージェントを認識できず、このエラーログが表示されます。
制限
Borderless WAN APIの制限:BWAN APIから返されるデータに矛盾があることが確認されており、プラットフォームに表示されるイベント数と、CEから受信および送信されるイベント数に不一致が生じる可能性があります。これは、BWAN API が現在 遅延イベント の問題に直面しているためです。

