Cisco Webex Control Hub avec Workspace Integration
Pour pouvoir utiliser les API de Cisco Webex pour surveiller vos équipements Cisco Webex, vous devez :
- Avoir un accès à Control Hub en tant qu'administrateur (https://admin.webex.com)
- Activer l'integration Zebrix Control dans Control Hub > Workspace > Integration
- Déclarer dans Zebrix Control un service externe de type Cisco Control Hub with Workspace Integration.
- Créer et configurer vos équipements.
Activer l'intégration Zebrix Control dans Control Hub
Commencez par télécharger le fichier d'integration Zebrix : Manifest Workspace Integration
Une fois authentifié sur le Control Hub, aller dans Workspace > Integrations
Puis en cliquant sur le bouton Add Integration, choisir Upload Integration
Deposez le fichier d'integration Zebrix (telechargé au debut de cette section (manifest_webex_workspace_zebrix_control.json)
Cliquez sur Upload
Vous devez récupérer et stocker dans un endroit sur les Client ID et Secret Oauth pour l'authentification au service Webex.
Puis activez l'integration en cliquant sur Actions > Activate
Enfin, vous devrez récupérer l'activation code (JWT)
Extraire les données de l'activation code (JWT)
Comme expliqué dans la documentation Cisco, pour extraire les champs necessaire pour la configuration du drivers, vous pouvez soit utiliser :
- via JWT.io
- Via un script NodeJS (voir documentation)
Pour la configuration dans Zebrix Control, il vous faudra récuperer les champs suivants :
- oauthUrl
- appUrl
- webexapisBaseUrl
- refreshToken
Par exemple, en utilisant JWT.io :
Configuration de le Service Externe (Cisco Control Hub with Workspace Integration) dans Zebrix Control
Configurons le __ Service Externe (Cisco Control Hub with Workspace Integration)__ dans l'interface d'administration Zebrix Control :
- Client ID : Utilisez l'AccessKey ID (Client ID) récupéré précédemment.
- Client Secret : Utilisez l'AccessKey Secret (Client Secret) récupéré précédemment.
- oauthUrl : Utilisez l'oauthUrl récupéré précédemment.
- appUrl : Utilisez l'appUrl récupéré précédemment.
- webexapisBaseUrl : Utilisez l'webexapisBaseUrl récupéré précédemment.
- refreshToken : Utilisez l'refreshToken récupéré précédemment.
Votre Service Externe est maintenant ajouté dans Zebrix Control.
Comment récupérer l'ID de l'équipement (configuration du Driver) ?
Il existe plusieurs méthode pour récupérer l'ID de l'équipement Webex.
Requête API
Vous pouvez la récupérer sur la page List Webex device API
Script PowerShell
Nous mettons également à votre disposition un script Powershell permettant de récupérer la liste des équipements et les exporter dans un CSV.
Invoke-WebRequest -Uri "https://control.zebrix.net/download/webex/Get-Devices.ps1" -OutFile "Get-Devices.ps1" ./Get-Devices.ps1 -UseImplicitFlow -AutoExport
Control Hub
Connectez vous sur le control Hub et rendez vous sur la page du périphérique concerné.
Cliquez sur Afficher tous les statuts
Aller dans la section Webex
L'ID recherché est le Webex DeveloperId
Attention: le Webex DeveloperId changera à chaque factory reset.
Ouverture des ports
La sonde doit pouvoir établir une connexion sortante vers les différentes URL configurées : oauthUrl, appUrl et webexapisBaseUrl.
Configuration des équipements
Afin de permettre la remontée complète des métriques Room Analytics dans Zebrix Control, plusieurs paramètres doivent être activés sur les terminaux Cisco. Ces paramètres garantissent notamment la détection de présence, le comptage de personnes et l’analyse acoustique, même lorsque le terminal n’est pas en appel.
Contactez le support Zebrix pour plus d'informations.