==== Cisco Control Hub ====

=== Configuration Service App ===

== Création de l'application ==
Pour créer une application, il faut se connecter sur le site developer.webex.com
  * Aller sur [[https://developer.webex.com/my-apps/new/service-app|Create a Service App]]
{{:fr:guide:cisco:pasted:20250311-143208.png}}

  * Remplir tous les champs obligatoires
  * Selectionner les 3 //scopes//
    * spark-admin:devices_read
    * spark:xapi_statuses
    * spark:xapi_commands
  * Cliquer **Add Service App** tout en bas

== Autorisation de l'application ==
  * Générer une demande d'autorisation à l'application en cliquant sur Request admin authorization
{{:fr:guide:cisco:pasted:20250311-154103.png}}

{{:fr:guide:cisco:pasted:20250311-153925.png}}

  * Copier le Client ID et le Client Secret
{{:fr:guide:cisco:pasted:20250311-154140.png}}

  * Demander à un administrateur du domain Webex d'autoriser l'application depuis le control hub
Dans le menu Gestion > Applications > Application de Service.
Cliquer sur l'application créé
{{:fr:guide:cisco:pasted:20250311-155438.png}}

  * Sélectionner Autoriser
{{:fr:guide:cisco:pasted:20250311-155620.png}}

{{:fr:guide:cisco:pasted:20250311-155645.png}}

  * Enregistrer
{{:fr:guide:cisco:pasted:20250311-155900.png}}

== Génération d'un token ==
Une fois l'application autorisée, il faut générer un token
  * Se connecter à :  https://developer.webex.com/my-apps
{{:fr:guide:cisco:pasted:20250311-152346.png}}
  * Cliquer sur l'application

  * Dans la partie Org Authorizations, sélectionner l'organisation, 
  * Saisir le **Client Secret** initialement copié, puis cliquer **Generate tokens**
{{:fr:guide:cisco:pasted:20250311-164041.png}}

  * Conserver l'**Access Token** et **Refresh Token**
{{:fr:guide:cisco:pasted:20250311-161923.png}}


=== Configurer la Service App dans Zebrix Control ===
  * Aller dans Configuration > Services Externes
  * Ajouter un service externe.
  * Sélectionner le type Cisco ControlHub
  * Saisir l'ID client, Secret client et le Refresh token
{{:fr:guide:cisco:pasted:20250311-162504.png}}

La configuration est terminée

=== 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 [[https://developer.webex.com/docs/api/v1/devices/list-devices|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.

<code>
Invoke-WebRequest -Uri "https://control.zebrix.net/download/webex/Get-Devices.ps1" -OutFile "Get-Devices.ps1"
./Get-Devices.ps1 -UseImplicitFlow -AutoExport
</code>

== 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
{{ .:pasted:20250619-105956.png }}

Aller dans la section **Webex**
{{ .:pasted:20250619-105655.png }}
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 ( HTTPS 443 ) vers l'URL "https://webexapis.com/v1".

=== 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.
{{ .:pasted:20251226-133956.png }}