La synchronisation du répertoire garantit que Webex pour les utilisateurs de Cisco BroadWorks peuvent utiliser le répertoire Webex à partir de l’application Webex pour appeler toutes les entités d’appel à partir du serveur BroadWorks. Cette fonctionnalité synchronise les informations d’appel BroadWorks qui ne font pas partie du provisioning de l’utilisateur dans le répertoire Webex.

Webex pour Cisco BroadWorks mise à jour le répertoire d’utilisateurs de Webex avec les détails d’appel de Webex pour les utilisateurs de Cisco BroadWorks (numéro de téléphone principal, numéro de téléphone mobile, extension), mais omette les enregistrements d’appels externes. Cependant, lorsque la synchronisation du répertoire est en cours, la fonctionnalité synchronise également les enregistrements d’appels suivants avec le répertoire Webex.

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

• Entités d’appel non utilisateur (par ex. un téléphone privé, salle de conférence fax, un numéro groupe de recherche/groupe de distribution des appels téléphone)

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

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

Conditions de 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 au cours d’une seule opération.

• Par défaut, la synchronisation initiale est 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 maintenan t 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 est hebdomadaire pour chaque client. Chaque synchronisation se produit une semaine après la dernière synchronisation, que la dernière synchronisation soit 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 programmée et une synchronisation à la demande (via l’API ou le Partenaire Hub GUI). Cependant, les administrateurs ne peuvent pas lancer deux synchronisations à la demande en même temps à partir du même BroadWorks. Cette restriction existe indépendamment du fait que la synchronisation a été initiée via l’API ou via l’option Synchroniser maintenant dans le concentrateur partenaire. De plus, Webex ne programme pas deux synchronisations programmées qui s’exécutent en même temps à partir des mêmes BroadWorks.

• En cas de défaillance 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 des statuts de synchronisation pour un client donné. De plus, vous pouvez exporter les informations détaillées de la dernière synchronisation vers un enregistrement CSV. L’enregistrement CSV offre plus de détails que l’affichage du Control Hub et peut faciliter le dépannage, l’analyse et l’audit.

• Webex stocke les contacts utilisateur dans un format chiffré. Seul l’utilisateur qui possède le contact a accès à la clé de déchiffrement.

• Pour les utilisateurs de BroadWorks uniquement et les entités d’appel non utilisateur, 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

  • Extension

  Cependant, la synchronisation exclut les utilisateurs de BroadWorks uniquement et les entités d’appel non utilisateur de la synchronisation si aucun numéro de téléphone principal ou extension 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 des téléphones BroadWorks et Maximums des contacts

La synchronisation du répertoire synchronise également les entrées de la liste téléphonique de BroadWorks aux 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 par rapport à une organisation. Chaque utilisateur peut accéder aux contacts de l’organisation pour son organisation. Le maximum peut atteindre 30000 contacts.

• Contacts utilisateur—Webex stocke ces contacts par rapport à un utilisateur. Seul l’utilisateur qui possède le contact peut accéder à l’entrée du contact. Le maximum est jusqu’à 2000 contacts (1 500 contacts synchronisés + 500 contacts d’entrée manuelle).

Le tableau suivant maie les types de contacts Webex par rapport à la source de contact (synchronisées à partir d’une liste téléphonique BroadWorks ou ajoutées 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 de contacts autorisés dans l’une des catégories, nous vous recommandons de lever un cas avec 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 entrent dans la catégorie utilisateur de contact plus grande 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 de 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 a mis à jour un contact sur BroadWorks, les conditions suivantes soulignent lorsque la mise à jour s’affiche dans l’application Webex d’un utilisateur :

• Si la mise à jour est pour un utilisateur de BroadWorks uniquement appelant ou une entité appel non-utilisateur, la mise à jour s’affiche dans l’application Webex d’un utilisateur immédiatement suivant la synchronisation suivante du répertoire.

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

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

  • 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’organisation—Le répertoire Webex est mis à jour lors de la synchronisation du répertoire suivante, mais les utilisateurs ne voient pas le changement dans l’application Webex tant qu’ils n’auront pas redémarré l’application Webex ou jusqu’à ce que le délai du cache local de 72 heures n’expire.

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

• Valeurs limitant la fréquence—Configurer les propriétés du système de contrôle de surcharge suivantes (XSP_CLI/Applications/Xsi-Actions/OverloadControl) :

  • UserDirectoryTransactionLimit—Définissez sur une valeur nulle.

  • globalDirectoryTransactionLimit—Définissez sur une valeur nulle.

  Il est recommandé de configurer userDirectoryTransactionLimit and globalDirectoryTransactionLimit to a null value. Toutefois, si vous décidez d’attribuer des valeurs, chacune doit être définie sur au moins cinq fois la valeur de la transactionLimitPeriod Mic mic (qui doit être 1).

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

  • Transaction utilisateurLimit—Définissez au moins 100.

  • transactionLimitPeriodSecs—Set sur 1.

• Valeurs de radiomessageure—Configurer les propriétés du système de radiomessageure (XSP_CLI/Applications/Xsi-Actions/Paging) :

  • PageSize par défaut—Set sur 50

  • UserMaxLimit disponible—Set sur 100

• Interface CTI—Assurez-vous de charger les certificats de l’AC Webex dans le trust store 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 patches du système suivants au déploiement de BroadWorks avant d’activer cette fonctionnalité :

• Pour R22 : AP.as.22.0.1123.ap368517

• Pour R23 : AP.as.23.0.1075.ap368517

• Pour R24 : aucun correctif requis

Les administrateurs partenaires peuvent activer la synchronisation du répertoire pour un modèle client tout en créant le nouveau modèle. Toutes les nouvelles organisations des clients qui sont attribué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 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 doit être effectué une seule fois.

Les API publiques sont disponibles sur les developer.webex.com qui permettent aux administrateurs partenaires de mettre à jour les paramètres de synchronisation du répertoire pour les organisations des clients qu’ils gèrent, pour déclencher une synchronisation immédiate ou obtenir des informations sur le statut de 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 service donné et l'id de chaque entreprise. Vous devez saisir le spEnterpriseId comme attribué lors de la mise à disposition.

• Mise à jour de la synchronisation du répertoire pour une entreprise BroadWorks—Saisissez l'ID de l'entreprise pour mettre à jour le statut syc du répertoire pour cette entreprise, activant ou 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 un id d'entreprise donné. Pour le syncStatus, saisissez la commande SYNCHRONISER_MAINTENANT .

• Obtenir le statut de synchronisation du répertoire pour une entreprise—Saisissez l'ID de l'entreprise et lancez-le afin d'obtenir un statut et un ID de suivi 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.

De plus, les administrateurs peuvent utiliser la synchronisation du répertoire déclencheur pour l’API d’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 connectez pour lire la spécification API à l'. 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.