Plugin WAN sans frontières Netskope pour l’expéditeur de journal

Notes de mise à jour

1.2.0 (Requires minimum Cloud Exchange version 6.1.0 and minimum Netskope BWAN Tenant version 1.2.0)

Added

Prise en charge ajoutée pour un New type d'événement : type d'événement réseau et type d'alerte : alertes (V2).

1.1.0

Changed

API Borderless WAN mise à jour pour le point de terminaison des événements.

1.0.0

Added

Initial release.

Ce document explique comment configurer le plugin Netskope Borderless WAN v1.2.0 avec le module Log Shipper de la plate-forme Netskope Cloud Exchange. Ce plugin est utilisé pour récupérer les événements (Audit, Authentification, Client, Passerelle, Système) à partir de la page Monitor > Events, les événements réseau (journaux de flux/trafic) à partir de la page Monitor > Flows et les alertes à partir de la page Monitor > Alerts(V2) du locataire Netskope Borderless WAN.

Conditions préalables

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

Un locataire Borderless WAN (ou plusieurs, par exemple, des instances de production et de développement/test).
Un locataire Netskope Cloud Exchange avec le plugin Tenant et le plugin Log Shipper déjà configurés.
Un plugin tiers (par exemple, Syslog) est déjà configuré.
Version minimale du plugin Netskope Borderless WAN Tenant requise : 1.2.0 pour la configuration du plugin.
Connectivité à l’hôte du locataire WAN sans frontières.
Exemple : https://<tenant>.api.infiot.net
Pour la configuration de Secrets Manager, reportez-vous à Secrets Manager. Pour configurer Azure Key Vault Secrets Manager, reportez-vous à Prérequis pour Azure Key Vault Secrets Manager.

Support du plugin Netskope Borderless WAN

Ce plugin est utilisé pour récupérer des événements (audit, authentification, client, passerelle, système) à partir de la page Surveiller > Événements, des événements réseau (journaux de flux/trafic) à partir de la page Surveiller > Flux, et des alertes à partir de la page Surveiller > Alertes(V2) du locataire Netskope Borderless WAN.

Type de données	Support
Soutien aux alertes	Oui (Alertes (V2))
Soutien aux événements	Oui (audit, authentification, client, passerelle, système, événements réseau)
Soutien WebTx	Non pris en charge
Journal de bord CE	Non pris en charge

Permissions

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

[
  {
    "rap_resource": "",
    "rap_privs": [
      "privAuditRecordRead",
      "privMonitorAlertRead",
      "privTenantRead"
    ]
  }
]

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érer les événements (audit, authentification, client, passerelle, système) à partir 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.

Notez que tous les appels à l'API pour un plugin source sont effectués à partir du plugin locataire, de sorte que l'agent utilisateur sera celui du plugin locataire.

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>)` Par exemple : `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"
        }
    ]
}

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"
        }
    ]
}

Matrice de performance

Cette analyse des performances a été réalisée sur une grande pile dans Cloud Exchange avec ces spécifications de VM.

Description	Specifications
Détails de la pile	Taille : Grande RAM : 32 GB CPU : 16 cœurs
Événements tirés de Borderless WAN	~80K EPM

Agent utilisateur

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

Tous les appels API pour un plugin source sont effectués à partir du plugin locataire Borderless WAN, de sorte que l'agent utilisateur sera celui du plugin locataire.

Workflow

Générez un jeton d'authentification sur votre locataire Borderless WAN.
Configurez le plugin Borderless WAN pour Log Shipper.
Configurez une règle de gestion.
Configurez la livraison des journaux.
Validez le plugin Borderless WAN.

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

Générer un jeton d'authentification sur votre locataire Borderless WAN

Connectez-vous au tenant Borderless WAN de Netskope.
Allez à Settings > API Token et cliquez sur New Token.
Saisir le Token Name, le Expiration et le Description selon vos besoins. Pour les autorisations, consulter les autorisations.
Cliquez sur Save et copiez le jeton généré.

Le jeton généré sera utilisé lors de la configuration du locataire Borderless WAN de Netskope dans Cloud Exchange.

Configurer le plugin Netskope Borderless WAN pour Log Shipper

Dans Cloud Exchange, aller dans Settings > Plugin Store. Dans la catégorie CLS, rechercher et sélectionner le plugin Netskope Borderless WAN v1.2.0 (CLS).
Saisissez un nom de configuration de plugin et sélectionnez votre locataire Borderless WAN configuré :
- Configuration Name: Nom de la configuration du plugin.
- Tenant: Tenant to pull alerts from. Select your Borderless WAN tenant.
Cliquez sur Next et entrez les paramètres de configuration :
- Event Types: Les types d'événements sélectionnés seront récupérés. Au moins un type d'événement doit être sélectionné.
- Initial Range for Events (in hours): Nombre d'heures pendant lesquelles les données d'événement sont récupérées pour l'exécution initiale. La valeur doit être comprise entre 0 et 8 760.
- Alert Types: Les types d'alertes sélectionnés seront récupérés. Au moins un type d'alerte doit être sélectionné.
- Initial Range for Alerts (in days): Nombre de jours pendant lesquels les données d'alerte doivent être extraites pour l'exécution initiale. La valeur doit être comprise entre 0 et 365.
Cliquez sur Save. La configuration du plugin sera disponible sur la page Log Shipper > Plugins.

Configurer une règle de gestion de l'expéditeur de journaux pour le plugin Borderless WAN

Dans Log Shipper, allez à Business Rules.
Par défaut, une règle de gestion filtre toutes les alertes et tous les événements. Si vous souhaitez filtrer un type d'alerte ou d'événement spécifique, cliquer sur Create New Rule et configurer une nouvelle règle de gestion en ajoutant un nom de règle et un/des filtre(s).

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.
Cliquez sur Save.

Configurer la distribution des journaux pour le plugin Borderless WAN

Dans Log Shipper, allez à Log Delivery et cliquez sur Add Log Delivery Configuration.
Select la configuration source (votre configuration de plugin Borderless WAN), la configuration de destination (Syslog ou selon vos besoins), une règle métier, puis cliquez sur Save.
Une fois la configuration de la livraison des journaux ajoutée, les données commenceront à être extraites du locataire Borderless WAN, transformées et ingérées dans la plateforme de destination.

Validez le plugin Borderless WAN

Valider le retrait

In Cloud Exchange, go to Logging and search for the pulled logs.

Validez les événements et les alertes sur le locataire Borderless WAN

Connectez-vous à votre locataire Borderless WAN.
Aller à Monitor > Events. Le plugin extrait les événements d'audit, d'authentification, de client, de passerelle et de système de cette page.
Aller à Monitor > Flows. Le plugin extrait les événements réseau de cette page.
Allez sur Monitor > Alerts(V2). Le plugin récupère les alertes de cette page.

Dépannage du plugin Borderless WAN

Aucun événement n'est récupéré même si le plugin est activé

What to do: Vérifiez que les événements et les alertes sont présents sur le locataire Borderless WAN pour la même période. Pour les étapes, voir Valider les événements et les alertes sur le locataire Borderless WAN.

Comportements connus

Vous pouvez rencontrer cette erreur dans les journaux :

02/05/2025 12:06:59 – error Une erreur s'est produite lors du partage d'analyses utilisant User-Agent avec Netskope.

What to do: Comme vous utilisez un locataire Borderless WAN au lieu d'un locataire Netskope, il ne reconnaîtra pas l'agent utilisateur de Netskope, il affichera donc ce journal des erreurs.

Limitation

Limitations de l'API Borderless WAN : Nous avons observé des incohérences dans les données renvoyées par les API BWAN, ce qui peut entraîner des divergences dans le nombre d'événements affichés sur la plateforme par rapport à ceux reçus et envoyés depuis CE. C'est parce que les API BWAN sont actuellement confrontées au problème des événements de dernière minute.