HPE Aruba Networking Central Plugin pour Risk Exchange

Ce document explique comment configurer le plugin HPE Aruba Networking Central v1.0.0 avec le module Risk Exchange de la plateforme Netskope Cloud Exchange. Ce plugin est utilisé pour récupérer les données des clients Wired et Wireless d'Aruba Networking Central de HPE Greenlake. Il récupère les clients à partir de la page Clients d'Aruba Networking Central > . Ce plugin prend également en charge les actions Ajouter un client à la liste noire, Supprimer un client de la liste noire et Déconnecter un client d'un périphérique de mise en réseau sur Aruba Networking Central.

Conditions préalables

Pour réaliser cette intégration, vous avez besoin de :

• Un locataire Netskope (ou plusieurs, par exemple des instances de production et de développement/test).
• Un locataire Netskope Cloud Exchange avec les plugins Tenant et Risk Exchange déjà configurés.
• Connectivité à la plateforme HPE GreenLake.
• Un abonnement au service HPE Aruba Networking Central.
• Accès pour générer l'ID du client, le secret du client et tirer des clients avec ou sans fil.
• Connectivité avec l'hôte suivant : https://*.central.arubanetworks.com.

Support du plugin HPE Aruba Networking Central

Ce plugin est utilisé pour récupérer les données des clients Wired et Wireless d'Aruba Networking Central de HPE Greenlake. Il récupère les clients à partir de la page Clients d'Aruba Networking Central > . Ce plugin prend également en charge les actions Ajouter un client à la liste noire, Supprimer un client de la liste noire et Déconnecter un client d'un périphérique réseau sur Aruba Networking Central.

Mises en correspondance

Les mappages sont utilisés pour afficher les clients câblés et sans fil tirés et leurs détails respectifs. Les champs mappés lors de la configuration du plugin seront visibles sur la page Enregistrements une fois les données extraites. Voici les mappings suggérés à utiliser lors de la configuration du plugin.

Mappages de traction

Permissions

Pour récupérer des clients et effectuer des actions à l'aide du plugin, vous aurez besoin de ces rôles :

• Plate-forme HPE Greenlake > Workspace Observer
• HPE Aruba Networking Central > Aruba Central view edit role

Détails de l'API

{"status":true}

{
    "Server": "openresty/1.13.6.2",
    "Date": "Wed, 16 Apr 2025 09:36:57 GMT",
    "Content-Type": "application/json",
    "Content-Length": "16",
    "Connection": "keep-alive",
    "X-RateLimit-Limit-Second": "3",
    "X-RateLimit-Remaining-Second": "0",
    "Cache-Control": "no-cache, no-store, must-revalidate, private",
    "Pragma": "no-cache",
    "Set-Cookie": "csrftoken=IjdkMGABRFVkYTA23ftqN2M3ialjMDBiNjUyYTIzYzZiO83F2BViZDQi.Z_96OQ.6qxNHAMZKZOGqSHgPSYiy77Rg38; Secure; Path=/, session=e8067gfte772a53b_67ff7a39.OO4EUpf-lqpXP5QTvCD64flNbJy0; Secure; HttpOnly; Path=/"
}

{
   "auth_code": "dfmyIjq3cZ5G1ofsxS4Dgl122q0vQyE"
}

{
    "refresh_token": "knsdFAjnfEFks34adf76WDKW62jad",
    "token_type": "bearer",
    "access_token": "Nfjad8449NFf7asd0ea3wj3FFmwlald",
    "expires_in": 7200
}

{
    "refresh_token": "5nadsiuef7F7aFJ02pdam",
    "token_type": "bearer",
    "access_token": "naknfde7faoijfdioREMD9e3s",
    "expires_in": 7200
}

{
    "clients": [
        {
            "associated_device": "Network device 0",
            "associated_device_mac": "23:7f:de:3f:61:27",
            "associated_device_name": "23:7f:de:3f:61:27",
            "authentication_type": "",
            "band": 5,
            "channel": "100 (80 MHz)",
            "client_category": "Home Audio/Video Equipment",
            "client_type": "WIRELESS",
            "connected_device_type": "AP",
            "connection": "802.11ac",
            "encryption_method": "WPA2_PSK",
            "failure_stage": "",
            "group_id": 0,
            "group_name": "default",
            "health": 92,
            "hostname": "Google-Home",
            "ht_type": 5,
            "ip_address": "32.127.208.96",
            "label_id": [],
            "labels": [],
            "last_connection_time": 1742203795505,
            "macaddr": "27:88:56:2a:ac:c8",
            "manufacturer": "Google, Inc.",
            "maxspeed": 433,
            "name": "WirelessClient0",
            "network": "netskope",
            "os_type": "Chromecast Media Player",
            "phy_type": 1,
            "radio_mac": "23:7f:de:3f:61:27",
            "radio_number": 0,
            "signal_db": -64,
            "signal_strength": 4,
            "snr": 28,
            "speed": 325,
            "swarm_id": "1jLK1NxqiVhglBXXN2qA5BYiWuFCUejF2Fz8Yx5kRYORIiByix",
            "user_role": "netskope",
            "username": "user.name@domain.com",
            "vlan": 244
        }
    ],
    "count": 1
}

{
    "clients": [
        {
            "macaddr": "74:84:b4:11:af:b3",
            "name": "WiredClient0",
            "ip_address": "137.115.81.35",
            "username": "User.name@domain.com",
            "associated_device": "Network device 0",
            "group_name": "default",
            "interface_mac": "dd:e2:cb:7d:5c:fa",
            "interface_port": 63526,
            "vlan": 456,
            "associated_device_name": "dd:e2:cb:7d:5c:fa",
        }
    ],
    "count": 1
}

{
    "serial": "FT592BGL",
    "state": "QUEUED",
    "task_id": 17447940919521
}

Matrice de performance

Ces mesures de performance sont effectuées sur une pile CE de grande taille avec ces spécifications de VM en tirant 500 000 clients câblés et clients sans fil du plugin HPE Aruba Networking Central.

Agent utilisateur

netskope-ce-5.1.1-cre-hpe-aruba-networking-central-v1.0.0

Workflow

1. Obtenez l'URL de base de votre API, l'ID du client, le secret du client et l'ID du client à partir de la plateforme HPE GreenLake.
2. Configurez le plugin HPE Aruba Networking Central.
3. Ajouter une règle de gestion.
4. Ajouter des actions.
5. Validez le plugin HPE Aruba Networking Central.

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

Obtenez votre URL de base API, votre ID client, votre secret client et votre ID client auprès de HPE GreenLake.

Pour obtenir l'URL de base de votre API, l'ID du client et le secret du client :

1. Connectez-vous à votre compte HPE GreenLake et accédez à votre espace de travail.
2. Allez sur Services > Catalog et cherchez HPE Aruba NetworkingCentra l.
3. Cliquez sur le service et cliquez sur Add Region pour déployer un service.
4. Après le déploiement réussi du service, cliquez sur Launch pour démarrer le service.
5. Allez dans Organization > Platform Integration et cliquez sur REST API sous la section API Gateway .
6. Sous API , vous trouverez l' URL de base de l'API. Il vous suffit de copier l'URL de base sans le chemin d'accès pour configurer le plugin.
   Par exemple : https://apigw-uswest5.central.arubanetworks.com.
7. Pour obtenir l'identifiant et le secret du client, rendez-vous à l'adresse suivante My Apps & Tokens.
8. Cliquez sur Add Apps & Tokens, puis sur Generate pour générer l'identifiant et le secret du client.
9. Enregistrez-les pour les utiliser lors de la configuration du plugin.
10. Pour Customer ID, vous cliquez sur l’icône Profil et copiez l’identifiant client.

Configurer le plugin HPE Aruba Networking Central

1. Connectez-vous à Cloud Exchange et accédez à Settings > Plugins. Recherchez et sélectionnez la case du plugin HPE Aruba Networking Central v1.0.o (CRE) .
2. Saisissez un nom de configuration du plugin et modifiez l'intervalle de synchronisation si nécessaire. 
3. Cliquez sur Next et entrez les paramètres de configuration :
   • API Base URL : Votre URL de base API pour l'instance Aruba Networking Central. 
   • Nom d'utilisateur : le nom d'utilisateur de votre compte HPE Greenlake.
   • Mot de passe : Le mot de passe de votre compte HPE Greenlake.
   • ID client : Votre ID de client de la centrale de réseautage Aruba. 
   • Secret du client : votre secret du client Aruba Networking Central. 
   • Identifiant client : Votre numéro de client Aruba Networking Central. 
   • Type de client : Le type de client à extraire d'Aruba Networking Central. Select au moins un des types de clients.

   

4. Cliquez Next. Select l'entité dans la liste déroulante Entité . Les champs d'entité peuvent être créés sur la page de l'éditeur de schéma , ou en utilisant l'option + Ajouter un champ dans la liste déroulante des champs. Fournissez les cartographies de terrain. Pour la cartographie suggérée, veuillez vous référer à la section Cartographies.
5. Cliquez sur Save.

Ajouter une règle de gestion de l'échange de risques pour HPE Aruba Networking Central

1. Dans Risk Exchange, allez sur Business Rules et cliquez sur Create New Rule dans le coin supérieur droit.
2. Saisissez le nom de la règle. Select l'entité pour les champs qui ont été configurés pour le plugin HPE Aruba Networking Central, et configurez la requête en fonction de vos besoins.
3. Cliquez sur Save.

Ajoutez des actions d'échange de risques pour HPE Aruba Networking Central

Le plugin HPE Aruba Networking Central prend en charge les types d'action suivants :

Ajouter un client à une liste noire

Cette action ajoutera des clients à la liste noire de HPE Aruba Networking Central.

Supprimer un client d'une liste noire

Cette action supprimera les clients de la liste noire de HPE Aruba Networking Central.

Déconnecter un client d'un périphérique de mise en réseau

Cette action déconnectera le client d'un périphérique de mise en réseau existant.

No Action

Aucune action ne sera effectuée pour cette action. Vous pouvez générer des alertes UBA dans Ticket Orchestrator en utilisant cette action et en activant l'option Générer des alertes.

Vous pouvez effectuer les actions liées à Netskope sur les clients extraits de HPE Aruba Networking Central. Pour plus d'informations sur les actions et leurs validations, reportez-vous au guide de l'échange de risques.

Configurer une action

1. Allez à Risk Exchange > Actions et cliquez sur Add Action Configuration.
2. Select une règle de gestion, une configuration et une action dans leurs listes déroulantes respectives.
3. Pour l'action Déconnecter un client d'un périphérique de mise en réseau, sélectionnez le champ contenant l'adresse MAC et sélectionnez le champ contenant le périphérique Serial mapped.
4. Activez la case à cocher Exiger l'approbation si une approbation est nécessaire avant d'effectuer une action.
5. Si l'option « Approbation requise » est activée, pour approuver l'action, allez à Risk Exchange > Action Logs, sélectionnez l'action à approuver et cliquez sur Approve. Pour les actions « Ajouter un client à une liste noire » et « Supprimer un client d'une liste noire » , vous devrez fournir l'adresse MAC du client et l'identifiant Swarm dans les paramètres de l'action.
6. Cliquez Save.
   

Validez le plugin HPE Aruba Networking Central

Valider dans Cloud Exchange

Pour vérifier les clients tirés de HPE Aruba Networking Central, allez sur Logging et recherchez les journaux du plugin CRE HPE Aruba Networking Central.

Pour vérifier la déconnexion du client du périphérique réseau, consultez les journaux.

Pour vérifier les enregistrements extraits et stockés dans Cloud Exchange, allez sur Records dans Risk Exchange. Select l'entité que vous avez utilisée lors de l'ajout du mappage dans la configuration du plugin.

Valider dans HPE Aruba Networking Central

Le plugin extrait les clients filaires et sans fil de HPE Aruba Networking Central. Les clients sont extraits de la page Aruba Networking Central > Clients > Connected.

Pour vérifier les détails du client, cliquez sur l'un des clients.

Dépannage du plugin HPE Aruba Networking

Réception d'une erreur dans le plugin workflow

CRE HPE Aruba Networking Central [nom_de_configuration] : Validation error occurred, Received exit code 401, Unauthorized, Verify Username, Password, Client ID, Client Secret et Customer ID provided in the configuration parameters.

What to do: Vérifiez l'ID client et le secret pour HPE Aruba Networking Central. Consultez la section « Obtenez votre URL de base API, votre ID client, votre secret client et votre ID client à partir de HPE GreenLake » .

Les clients ne sont pas extraits de HPE Aruba Networking Central.

Si aucune donnée n'est extraite pour les clients, cela peut être dû à l'une des raisons suivantes :

• Aucun client n'est disponible sur la plateforme pour tirer
• La cartographie n'est pas ajoutée dans le plugin

What to do:

1. Accédez à HPE Aruba Networking Central et vérifiez si les clients sont disponibles pour être extraits de la page Clients > Connected.
2. Modifiez la configuration du plugin et vérifiez la page Entity Source. Certains champs doivent être mis en correspondance afin d'extraire les clients.

Impossible d'effectuer une action sur HPE Aruba Networking Central

Si un client a échoué lors de l'exécution de l'action Déconnecter le client du périphérique réseau, cela peut être dû à l'une des raisons suivantes :

• Le client n'existe pas sur HPE Aruba Networking Central.
• Le client est hors ligne à ce moment-là.

What to do:

Pour vérifier les clients connectés, reportez-vous à la section Valider dans HPE Aruba Networking Central.