Synchronisation du répertoire dans Webex pour Cisco BroadWorks

La synchronisation du répertoire garantit que les utilisateurs de Webex pour Cisco BroadWorks peuvent utiliser le répertoire Webex de l’application Webex pour appeler n’importe quelle entité appelante à partir du serveur BroadWorks. Cette fonctionnalité synchronise les informations d’appel BroadWorks qui ne faisaient pas partie du provisionnement des utilisateurs dans le répertoire Webex.

La mise à disposition des utilisateurs de Webex pour Cisco BroadWorks met à jour le répertoire Webex avec les détails d’appel pour Webex pour les utilisateurs de Cisco BroadWorks (numéro de téléphone principal, numéro de téléphone mobile, numéro de poste), mais omet les enregistrements d’appels externes. Cependant, lorsque la synchronisation du répertoire est activée, la fonctionnalité synchronise également les enregistrements d’appel suivants avec le répertoire Webex.

• Utilisateurs appelants BroadWorks uniquement (qui ne sont pas intégrés à Webex)

• Entités appelantes non utilisateurs (par ex., un téléphone de salle de conférence, un télécopieur, un numéro de groupe de recherche)

• Entrées de la liste téléphonique BroadWorks

Le tableau suivant résume les enregistrements d’appels BroadWorks et montre comment ils sont ajoutés au répertoire Webex.

Conditions de la synchronisation du répertoire

• Les administrateurs partenaires doivent activer la fonctionnalité au niveau du partenaire. Les administrateurs partenaires peuvent activer ou désactiver la fonctionnalité pour plusieurs organisations clientes en une seule opération.

• Par défaut, la synchronisation initiale se produit une semaine après l’activation de la synchronisation (l’heure choisie pour démarrer la synchronisation est aléatoire). Cependant, les organisations clientes peuvent utiliser l'option Synchroniser maintenant pour contourner la période d'attente d'une semaine et déclencher une synchronisation immédiate pour une organisation cliente donnée.

• Par défaut, la Synchronisation du répertoire s'exécute chaque semaine pour chaque client. Chaque synchronisation se produit une semaine après la dernière synchronisation, que la dernière synchronisation ait été programmée ou déclenchée manuellement avec Synchroniser maintenant.

• Le nombre maximum de synchronisations simultanées par cluster BroadWorks est de deux : une synchronisation planifiée et une synchronisation à la demande (via l’API ou l’interface graphique du Partner Hub). Cependant, les administrateurs ne peuvent pas exécuter deux synchronisations à la demande en même temps à partir du même BroadWorks. Cette restriction existe que la synchronisation ait été initiée via l’API ou via l’option Synchroniser maintenant dans Partner Hub. De plus, Webex ne programmera pas deux synchronisations programmées pour s’exécuter en même temps à partir du même BroadWorks.

• En cas d’échec de la synchronisation, Webex retente la synchronisation automatiquement toutes les 24 heures jusqu’à la prochaine synchronisation programmée.

• La synchronisation ignore les utilisateurs qui n’ont pas de numéro de téléphone.

• Dans Partner Hub, vous pouvez afficher les informations d’état de la synchronisation pour un client donné. En outre, vous pouvez exporter des informations détaillées sur la dernière synchronisation vers un enregistrement CSV. L’enregistrement CSV fournit plus de détails que l’affichage du Control Hub et peut aider au dépannage, à l’analyse et à l’audit.

• Webex stocke les contacts des utilisateurs dans un format chiffré. Seul l'utilisateur propriétaire du contact a accès à la clé de déchiffrement.

• Pour les utilisateurs appelants BroadWorks uniquement et les entités appelantes non-utilisateurs, cette fonctionnalité synchronise les types de numéros de téléphone suivants de BroadWorks :

  • Numéro de téléphone principal

  • Numéro de téléphone portable

  • Numéro de poste

  Cependant, la synchronisation exclut les utilisateurs appelants BroadWorks uniquement et les entités appelantes non-utilisateurs de la synchronisation si aucun numéro de téléphone principal ou numéro de poste n’est présent.

  Le paramètre du service de confidentialité de niveau utilisateur BroadWorks n’est pas pris en charge dans le cadre de la synchronisation du répertoire.

Liste téléphonique BroadWorks et maximums de contacts

La synchronisation du répertoire synchronise également les entrées de la liste téléphonique BroadWorks avec les contacts Webex. Les entrées synchronisées sont ajoutées à l'un des types de contacts suivants :

• Contacts de l’organisation—Webex stocke ces contacts dans une organisation. Chaque utilisateur peut accéder aux contacts de l’organisation de son organisation. Le maximum peut atteindre 30000 contacts.

• Contacts utilisateur—Webex stocke ces contacts par rapport à un utilisateur. Seul l'utilisateur propriétaire du contact peut accéder à l'entrée du contact. Le maximum est de 2000 contacts (1500 contacts synchronisés + 500 contacts à saisie manuelle).

Le tableau suivant fait correspondre les types de contacts Webex à la source de contact (synchronisés à partir d'une liste téléphonique BroadWorks ou ajoutés manuellement) :

Les conditions suivantes s'appliquent à la façon dont la synchronisation du répertoire gère les maximums de contacts :

• Si une organisation dépasse le nombre maximum de contacts autorisés pour la synchronisation (30 000 contacts de l'organisation ou 30 000 contacts communs de groupe par groupe), la synchronisation du répertoire exclut les entrées au-dessus du seuil maximum. Aucun ordre particulier n'est appliqué aux contacts synchronisés ou omis.

• Si l’un de vos clients dépasse le nombre maximum autorisé de contacts dans l’une ou l’autre des catégories, nous vous recommandons de soumettre un cas à Cisco pour que cette organisation soit exclue de la synchronisation du répertoire.

• Les contacts manuels sont des contacts qu’un utilisateur ajoute manuellement sur l’application Webex. Un utilisateur peut ajouter jusqu'à 500 contacts manuels. Les contacts manuels font partie de la catégorie de contacts utilisateur plus large sur Webex, mais ne sont pas inclus dans la synchronisation.

• La limite globale combinée pour les contacts de l'organisation (30 000) et les contacts de groupe (30 000 par groupe) est de 200 000.

Mises à jour

Voici comment le répertoire Webex gère les mises à jour :

• Si le nom du contact change sur BroadWorks, le contact existant est supprimé du répertoire Webex et un nouveau contact est créé.

• Si le numéro du contact change sur BroadWorks, Webex met à jour le contact existant dans le répertoire Webex avec le nouveau numéro.

Après qu’un administrateur ait mis à jour un contact sur BroadWorks, les conditions suivantes décrivent lorsque la mise à jour s’affiche dans l’application Webex d’un utilisateur :

• Si la mise à jour concerne un utilisateur appelant BroadWorks uniquement ou une entité appelante non-utilisateur, la mise à jour s’affiche dans l’application Webex d’un utilisateur immédiatement après la synchronisation du répertoire suivante.

• Si la mise à jour concerne une entrée de liste téléphonique BroadWorks :

  • Pour les contacts utilisateur : les mises à jour s’affichent dans l’application Webex de l’utilisateur immédiatement après la synchronisation du répertoire suivante.

  • Pour les contacts de groupe - Les mises à jour s’affichent dans l’application Webex des utilisateurs immédiatement après la synchronisation du répertoire suivante.

  • Pour les contacts de l’entreprise—Le répertoire Webex est mis à jour lors de la synchronisation du répertoire suivante, mais les utilisateurs ne verront pas la modification dans l’application Webex jusqu’à ce qu’ils redémarrent l’application Webex ou jusqu’à l’expiration du délai de cache local de 72 heures.

Nous vous recommandons d'utiliser les paramètres suivants :

• Valeurs limites de débit : définissez les propriétés du système OverloadControl suivantes (XSP_CLI/Applications/Xsi-Actions/OverloadControl) :

  • userDirectoryTransactionLimit—Défini sur une valeur nulle.

  • globalDirectoryTransactionLimit : défini sur une valeur nulle.

  Il est recommandé de définir userDirectoryTransactionLimit et globalDirectoryTransactionLimit à une valeur nulle. Toutefois, si vous décidez d'attribuer des valeurs, chacune doit être définie à au moins cinq fois la valeur de transactionLimitPeriodSeconds (qui doit être 1).

• Limites de transaction—Définissez les valeurs suivantes (XSP_CLI/System/CommunicationUtility/DefaultSettings) :

  • userTransactionLimit—Défini sur au moins 100.

  • transactionLimitPeriodSecs : défini sur 1.

• Valeurs de radiomessagerie : définissez les propriétés du système de radiomessagerie (XSP_CLI/Applications/Xsi-Actions/Radiomessagerie) :

  • defaultPageSize—Défini sur 50

  • availableUserMaxLimit : défini sur 100

• Interface CTI—Assurez-vous de télécharger ces certificats d'autorité de certification Webex dans le magasin de confiance de l'interface CTI et d'activer l'authentification du client sur l'interface CTI.

De plus, en fonction de votre version de BroadWorks, nous vous recommandons d'appliquer les correctifs système suivants au déploiement de BroadWorks avant d'activer cette fonctionnalité :

• Pour le R22 : AP.as.22.0.1123.ap368517

• Pour R23 : AP.as.23.0.1075.ap368517

• Pour le R24 : aucun patch requis

Les administrateurs partenaires peuvent activer la synchronisation du répertoire pour un modèle client lors de la création du nouveau modèle. Toutes les nouvelles organisations clientes qui sont affectées à ce modèle auront la synchronisation du répertoire activée. Pour des détails, voir « Configurer vos modèles clients » dans Configurer votre organisation partenaire dans Partner Hub dans le Guide de la solution pour Webex pour Cisco BroadWorks.

Que faire ensuite

Assurez-vous que vos utilisateurs savent qu’ils doivent cliquer sur l’onglet Contacts sur l’application Webex au moins une fois pour activer la fonctionnalité sur l’application Webex. Ceci ne doit être effectué qu’une seule fois.

Des API publiques sont disponibles sur developer.webex.com qui permettent aux administrateurs partenaires de mettre à jour les paramètres de synchronisation du répertoire pour les organisations clientes qu'ils gèrent, de déclencher une synchronisation immédiate ou d'obtenir des informations sur le statut de la synchronisation. Les méthodes de synchronisation du répertoire sont regroupées sous BroadWorks Enterprises :

• Lister les entreprises BroadWorks—Utilisez cette méthode API pour obtenir une liste des entreprises sous un fournisseur de services donné et les id. Vous devez saisir le spEnterpriseId comme affecté dans le provisionnement.

• Mettre à jour la synchronisation du répertoire pour une entreprise BroadWorks—Saisissez l'entreprise id pour mettre à jour le statut syc du répertoire pour cette entreprise, en activant ou en désactivant la synchronisation du répertoire.

• Déclencher la synchronisation du répertoire pour une entreprise—Utilisez cette méthode API si vous souhaitez déclencher une synchronisation immédiate pour une entreprise donnée id. Pour le syncStatus, saisissez le SYNC_NOW commande.

• Obtenir le statut de la synchronisation du répertoire pour une entreprise—Saisissez l'entreprise id et exécuter afin d’obtenir un statut et trackingId de la dernière synchronisation. Vous pouvez utiliser le trackingID pour exécuter des analyses supplémentaires via des outils tels que Kibana et Grafana.

En outre, les administrateurs peuvent utiliser l'API Déclencher la synchronisation du répertoire pour un seul utilisateur pour déclencher une synchronisation du répertoire à la demande pour un seul utilisateur.

Pour une documentation API détaillée, voir https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Vous devez vous connecter pour lire les spécifications de l'API sur https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Les codes d'erreur suivants s'appliquent à la synchronisation du répertoire.

Le tableau suivant résume les mises à jour de cet article.