Release Notes
1.2.0 (Minimum required CE version 6.1.0)
Added
- Added support for pulling Network Events (Flows) and Alerts (V2) from the Borderless WAN tenant.
- Added the pull of the Clients and Gateways entities, which are delivered to the Netskope Borderless WAN Risk Exchange plugin. The entities are pulled incrementally, based on their last modified time.
1.1.0
Changed
- Updated the Borderless WAN API for the events endpoint.
- Updated the Cloud Exchange compatibility information.
1.0.0
Added
- Initial release.
- Added support for pulling events of types Audit, Authentication, Client, Gateway, and System.
This document explains how to configure the Netskope Borderless WAN Tenant v1.2.0 plugin in Cloud Exchange. This plugin is required to configure a Netskope Borderless WAN tenant in Cloud Exchange. The Netskope Borderless WAN plugins use the tenant to fetch the required data for each module.
Prerequisites
To complete this configuration, you need:
- A Netskope Borderless WAN tenant with permission to generate an API token.
- Connectivity to the Netskope Borderless WAN tenant host, for example https://<tenant>.api.infiot.net.
- For Secrets Manager configuration, refer to Secrets Manager. To set up Azure Key Vault as the Secrets Manager, refer to Prerequisites for Azure Key Vault Secrets Manager.
Netskope Borderless WAN Tenant Plugin Support
This plugin pulls events and alerts from the Netskope Borderless WAN tenant for use by the Netskope Borderless WAN plugins.
| Data Type | Support |
|---|---|
| Event Types | Yes (Audit, Authentication, Client, Gateway, System, Network Events) |
| Alert Types | Yes (Alerts (V2)) |
| WebTx | Not Supported |
Permissions
You need to have these permissions in the Auth Token:
[
{
"rap_resource": "*",
"rap_privs": [
"privAddressGroupCreate",
"privAddressGroupRead",
"privAddressGroupWrite",
"privAddressObjectCreate",
"privAddressObjectDelete",
"privAddressObjectRead",
"privAuditRecordRead",
"privCustomAppCreate",
"privCustomAppDelete",
"privCustomAppRead",
"privCustomAppWrite",
"privManagedDeviceRead",
"privMonitorAlertRead",
"privPolicyRead",
"privSiteRead",
"privTenantRead",
"privUserRead"
]
}
]
API Details
List of APIs Used
| API Endpoint | Method | Use Case |
|---|---|---|
| /v2/auditevents | GET | Fetch Events (Audit, Authentication, Client, Gateway, System) from the Borderless WAN tenant. |
| /v2/networkevents | GET | Fetch Network Events (Flow/Traffic logs) from the Borderless WAN tenant. |
| /v2/alerts | GET | Fetch Alerts (V2) from the Borderless WAN tenant. |
Fetch Events
API Endpoint: <BASE URL>/v2/auditevents
Method: GET
Request Headers
| Key | Value |
|---|---|
| Authorization | Bearer <API TOKEN> |
| User-Agent | netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0 |
Request Parameters
| Key | Value |
|---|---|
| first | 100 |
| after | end_cursor (end cursor from previous response) |
| 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"
}
]
}
Fetch Network Events
API Endpoint: <BASE URL>/v2/networkevents
Method: GET
Request Headers
| Key | Value |
|---|---|
| Authorization | Bearer <API TOKEN> |
| User-Agent | netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0 |
Request Parameters
| Key | Value |
|---|---|
| first | 100 |
| after | end_cursor (end cursor from previous response) |
| 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
}
]
}
Fetch Alerts (V2)
API Endpoint: <BASE URL>/v2/alerts
Method: GET
Request Headers
| Key | Value |
|---|---|
| Authorization | Bearer <API TOKEN> |
| User-Agent | netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0 |
Request Parameters
| Key | Value |
|---|---|
| first | 100 |
| after | end_cursor (end cursor from previous response) |
| 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"
}
]
}
User Agent
netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0
Workflow
- Generate an Auth Token for your Netskope Borderless WAN tenant.
- Configure the Netskope Borderless WAN Tenant plugin.
- Validate the Netskope Borderless WAN Tenant plugin.
Watch a Video
Click play to watch a video.
Generate an Auth Token
-
Log in to your Netskope Borderless WAN tenant.

-
Go to Settings > API Token and click New Token.

-
Enter the Token Name, Expiration, and Description per your requirements.
For the token permissions, refer to Permissions in this guide.
-
Click Save and copy the generated token.
You use the generated token to configure the Netskope Borderless WAN tenant in Cloud Exchange.
Configure the Netskope Borderless WAN Tenant Plugin
-
In Cloud Exchange, go to Settings > Plugin Store. Search for and select the Netskope Borderless WAN Tenant v1.2.0 plugin.

-
Enter a Name, the full tenant Base URL (for example, https://<tenant>.api.infiot.net), and the Auth Token you generated previously.

-
Click Save.
Validate the Netskope Borderless WAN Tenant Plugin
To verify the configured Borderless WAN tenant in Cloud Exchange, go to Settings > Tenants. The newly configured tenant appears in the Configured Tenants list.

Troubleshooting the Netskope Borderless WAN Tenant Plugin
Receiving an error while configuring the tenant
If you see TENANT Netskope Borderless WAN Tenant [BWAN Tenant Demo]: Validation error occurred. Unable to establish connection with Netskope Borderless WAN platform. Proxy server or Netskope Borderless WAN server is not reachable.
What to do: Verify that the Base URL of your tenant is entered correctly. For the format, refer to Prerequisites.
If you see TENANT Netskope Borderless WAN Tenant [BWAN Tenant Demo]: 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:
- Verify that the Auth Token of your tenant is entered correctly.
- Verify that the Auth Token has the necessary permissions. Refer to Generate an Auth Token.

