Netskope Borderless WAN Tenant Plugin - Netskope Technical Documentation

Notes de mise à jour

1.2.0 (Minimum required CE version 6.1.0)

Added

Ajout de la prise en charge de la récupération des événements réseau (flux) et des alertes (V2) à partir du locataire Borderless WAN.
Ajout de la récupération des entités Clients et Passerelles, qui sont livrées au plugin Netskope Borderless WAN Risk Exchange. Les entités sont récupérées de manière incrémentielle, en fonction de leur dernière modification.

1.1.0

Changed

Mise à jour de l’API Borderless WAN pour le point de terminaison des événements.
Mise à jour des informations de compatibilité Cloud Exchange.

1.0.0

Added

Initial release.
Ajout de la prise en charge de la récupération des types d’événements Audit, Authentification, Client, Gateway et Système.

Ce document explique comment configurer le plug-in Netskope Borderless WAN Tenant v1.2.0 dans Cloud Exchange. Ce plug-in est nécessaire pour configurer un locataire Netskope Borderless WAN dans Cloud Exchange. Les plug-ins Netskope Borderless WAN utilisent le locataire pour récupérer les données nécessaires à chaque module.

Conditions préalables

Pour compléter cette configuration, vous avez besoin de :

Un locataire Netskope Borderless WAN avec l'autorisation de générer un jeton API.
Connectivité à l’hôte de tenant Netskope Borderless WAN, par exemple https://<tenant>.api.infiot.net.
Pour la configuration de Secrets Manager, reportez-vous à Secrets Manager. Pour configurer Azure Key Vault en tant que Secrets Manager, reportez-vous aux Prérequis pour Azure Key Vault Secrets Manager.

Netskope Borderless WAN Tenant Plugin Support

Ce plugin extrait les événements et les alertes du tenant Netskope Borderless WAN pour une utilisation par les plugins Netskope Borderless WAN.

Type de données	Support
Types d'événements	Oui (audit, authentification, client, passerelle, système, événements réseau)
Types d'alerte	Oui (Alertes (V2))
WebTx	Non pris en charge

Permissions

Vous devez disposer de ces autorisations dans le jeton d'authentification :

[
  {
    "rap_resource": "*",
    "rap_privs": [
      "privAddressGroupCreate",
      "privAddressGroupRead",
      "privAddressGroupWrite",
      "privAddressObjectCreate",
      "privAddressObjectDelete",
      "privAddressObjectRead",
      "privAuditRecordRead",
      "privCustomAppCreate",
      "privCustomAppDelete",
      "privCustomAppRead",
      "privCustomAppWrite",
      "privManagedDeviceRead",
      "privMonitorAlertRead",
      "privPolicyRead",
      "privSiteRead",
      "privTenantRead",
      "privUserRead"
    ]
  }
]

Ces autorisations couvrent à la fois les plugins Log Shipper et Risk Exchange de Netskope Borderless WAN. Pour les autorisations dont un seul plugin a besoin, reportez-vous au guide de ce plugin.

Détails de l'API

Liste des API utilisées

Point final de l'API	Méthode	Cas d'utilisation
/v2/auditevents	OBTENIR	Récupérez les événements (Audit, Authentification, Client, Passerelle, Système) du locataire Borderless WAN.
/v2/networkevents	OBTENIR	Récupérer les événements réseau (journaux de flux/trafic) du locataire Borderless WAN.
/v2/alerts	OBTENIR	Récupérer les alertes (V2) du locataire Borderless WAN.

Recherche d'événements

API Endpoint: <BASE URL>/v2/auditevents
Method: GET

Request Headers

Clé	Value
Authorization	Bearer <API TOKEN>
User-Agent	netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0

Request Parameters

Clé	Value
first	100
after	end_cursor (fin du curseur de la réponse précédente)
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"
        }
    ]
}

Rechercher des événements réseau

API Endpoint: <BASE URL>/v2/networkevents
Method: GET

Request Headers

Clé	Value
Authorization	Bearer <API TOKEN>
User-Agent	netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0

Request Parameters

Clé	Value
first	100
after	end_cursor (fin du curseur de la réponse précédente)
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
        }
    ]
}

Récupérer les alertes (V2)

API Endpoint: <BASE URL>/v2/alerts
Method: GET

Request Headers

Clé	Value
Authorization	Bearer <API TOKEN>
User-Agent	netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0

Request Parameters

Clé	Value
first	100
after	end_cursor (fin du curseur de la réponse précédente)
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"
        }
    ]
}

Agent utilisateur

netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0

Workflow

Générez un jeton d'authentification pour votre locataire Netskope Borderless WAN.
Configure the Netskope Borderless WAN Tenant plugin.
Validate the Netskope Borderless WAN Tenant plugin.

Regardez une vidéo

Cliquer sur « play » pour regarder une vidéo.

Générer un jeton d'authentification

Connectez-vous à votre tenant Netskope Borderless WAN.
Allez à Settings > API Token et cliquez sur New Token.
Saisissez le nom du jeton, la date d’expiration et la description selon vos besoins.

Pour les autorisations de jeton, reportez-vous à la section Autorisations de ce guide.
Cliquez sur Save et copiez le jeton généré.

Vous utilisez le jeton généré pour configurer le locataire Netskope Borderless WAN dans Cloud Exchange.

Configure the Netskope Borderless WAN Tenant Plugin

Dans Cloud Exchange, allez sur Settings > Plugin Store. Recherchez et sélectionnez le plugin Netskope Borderless WAN Tenant v1.2.0.
Saisissez un nom, l'URL de base complète du tenant (par exemple https://<tenant>.api.infiot.net), et le jeton d'authentification que vous avez généré précédemment.
Cliquez sur Save.

Validate the Netskope Borderless WAN Tenant Plugin

Pour vérifier le locataire Borderless WAN configuré dans Cloud Exchange, accédez à Settings > Tenants. Le locataire nouvellement configuré apparaît dans la liste Locataires configurés.

Troubleshooting the Netskope Borderless WAN Tenant Plugin

Réception d'une erreur lors de la configuration du locataire

Si vous voyez TENANT Netskope Borderless WAN Tenant [BWAN Tenant Demo] : Erreur de validation. Impossible d’établir une connexion avec la plateforme Netskope Borderless WAN. Le serveur proxy ou le serveur Netskope Borderless WAN n’est pas accessible.

What to do: Vérifiez que l’URL de base de votre locataire est correctement saisie. Pour le format, reportez-vous aux Prérequis.

Si vous voyez TENANT Netskope Borderless WAN Tenant [BWAN Tenant Demo] : Erreur de validation. Jeton d’authentification non valide fourni dans les paramètres de configuration. Assurez-vous que le jeton d’authentification possède toutes les autorisations requises et n’est pas expiré.

What to do:

Vérifiez que le jeton d'authentification (Auth Token) de votre locataire est correctement saisi.
Vérifiez que le jeton d’authentification dispose des autorisations nécessaires. Reportez-vous à Générer un jeton d’authentification.