La synchronisation des annuaires permet aux utilisateurs de Webex pour Cisco BroadWorks d'utiliser l'annuaire Webex depuis l'application Webex pour appeler n'importe quelle entité appelante depuis le serveur BroadWorks. Cette fonctionnalité synchronise les informations d'appel de BroadWorks qui ne figuraient pas dans le provisionnement des utilisateurs dans l'annuaire Webex.

L'approvisionnement utilisateur de Webex pour Cisco BroadWorks met à jour l'annuaire Webex avec les informations relatives aux appels des utilisateurs de Webex pour Cisco BroadWorks (numéro de téléphone principal, numéro de téléphone portable, poste), mais omet les enregistrements d'appels externes. Cependant, lorsque la synchronisation de l'annuaire est activée, cette fonctionnalité synchronise également les enregistrements d'appels suivants avec l'annuaire Webex.

• Utilisateurs qui appellent uniquement Broadworks (qui ne sont pas connectés à Webex)

• Entités appelantes qui ne sont pas des utilisateurs (par exemple, 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 de BroadWorks et montre comment ils sont ajoutés à l'annuaire Webex.

Conditions de synchronisation des annuaires

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

• Par défaut, la synchronisation initiale a lieu une semaine après son activation (l'heure choisie pour démarrer la synchronisation est aléatoire). Cependant, les organisations clientes peuvent utiliser l'option Sync Now pour contourner le délai d'attente d'une semaine et déclencher une synchronisation immédiate pour une organisation cliente donnée.

• Par défaut, la synchronisation des annuaires est effectuée chaque semaine pour chaque client. Chaque synchronisation a lieu une semaine après la dernière, que celle-ci ait été planifiée ou déclenchée manuellement avec Sync Now.

• 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 de Partner Hub). Cependant, les administrateurs ne peuvent pas effectuer deux synchronisations à la demande en même temps depuis le même BroadWorks. Cette restriction existe, que la synchronisation ait été initiée via l'API ou via l'option Sync Now de Partner Hub. De plus, Webex ne planifie pas deux synchronisations programmées à exécuter en même temps depuis le même BroadWorks.

• En cas d'échec de synchronisation, Webex recommence automatiquement la synchronisation toutes les 24 heures jusqu'à la prochaine synchronisation planifiée.

• La synchronisation ne tient pas compte des utilisateurs qui n'ont pas de numéro de téléphone.

• Dans Partner Hub, vous pouvez consulter les informations relatives à l'état de synchronisation d'un client donné. De plus, 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 à résoudre les problèmes, à analyser et à auditer.

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

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

  • Numéro de téléphone principal

  • Numéro de téléphone portable

  • Prolongation

  Cependant, la synchronisation exclut de la synchronisation les utilisateurs qui appellent uniquement Broadworks et les entités appelantes qui ne sont pas des utilisateurs si aucun numéro de téléphone principal ou aucune extension n'est présent.

  Le réglage du service de confidentialité au niveau utilisateur de BroadWorks n'est pas pris en charge dans le cadre de la synchronisation des annuaires.

Liste téléphonique et nombre maximum de contacts BroadWorks

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

• Contacts de l'organisation : Webex enregistre ces contacts par rapport à une organisation. Chaque utilisateur peut accéder aux contacts de son organisation. Le maximum est de 30 000 contacts.

• Contacts utilisateur : Webex enregistre ces contacts par rapport à un utilisateur. Seul l'utilisateur propriétaire du contact peut accéder à la saisie du contact. Le maximum est de 2 000 contacts (1 500 contacts synchronisés + 500 contacts à saisie manuelle).

Le tableau suivant met en correspondance les types de contacts Webex et leur source (synchronisés à partir d'une liste téléphonique BroadWorks ou ajoutés manuellement) :

Les conditions suivantes s'appliquent à la manière dont Directory Sync gère le nombre maximum 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 des annuaires exclut les entrées dépassant le 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é dans l'une ou l'autre des catégories, nous vous recommandons de déposer une plainte auprès de Cisco pour que cette organisation soit exclue de la synchronisation des annuaires.

• 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 des contacts utilisateur 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 l'annuaire Webex gère les mises à jour :

• Si le nom du contact change sur BroadWorks, le contact existant est supprimé de l'annuaire Webex et un nouveau contact est créé.

• Si le numéro de contact change sur BroadWorks, Webex met à jour le contact existant dans l'annuaire Webex avec le nouveau numéro.

Une fois qu'un administrateur met à jour un contact sur BroadWorks, les conditions suivantes indiquent quand la mise à jour s'affiche dans l'application Webex d'un utilisateur :

• Si la mise à jour concerne un utilisateur qui appelle uniquement Broadworks ou une entité qui n'appelle pas un utilisateur, elle s'affiche dans l'application Webex de l'utilisateur immédiatement après la synchronisation de l'annuaire suivante.

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

  • Pour les contacts des utilisateurs : les mises à jour s'affichent dans l'application Webex de l'utilisateur immédiatement après la synchronisation de l'annuaire qui suit.

  • Pour les contacts de groupe, les mises à jour s'affichent sur l'application Webex de l'utilisateur immédiatement après la synchronisation de l'annuaire qui suit.

  • Pour les contacts de l'organisation : l'annuaire Webex est mis à jour lors de la prochaine synchronisation de l'annuaire, mais les utilisateurs ne verront pas les modifications dans l'application Webex tant qu'ils ne redémarreront pas l'application Webex ou que le délai de cache local de 72 heures n'aura pas expiré.

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

• Valeurs limites de débit : définissez les propriétés suivantes du système OverloadControl (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 sur une valeur nulle. Cependant, si vous décidez d'attribuer des valeurs, chacune doit être réglée sur au moins cinq fois la valeur de TransactionLimitPeriodSeconds (qui devrait être 1).

• Limites de transactions : définissez les valeurs suivantes (XSP_CLI/System/CommunicationUtility/DefaultSettings) :

  • UserTransactionLimit : défini sur au moins 100.

  • Période limite de transaction en secondes, définie sur 1.

• Valeurs de pagination : définissez les propriétés du système de pagination (XSP_CLI/Applications/XSI-Actions/Paging) :

  • Taille de page par défaut : fixée à 50

  • Limite maximale d'utilisateurs disponible : fixée à 100

• Interface CTI : assurez-vous de télécharger les certificats Webex CA sur le Trust Store de l'interface CTI et d'activer l'authentification des clients 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 R22 : AP.AS.22.0.1123.AP368517

• Pour R23 : AP.AS.23.0.1075.AP368517

• Pour R24 : aucun patch n'est requis

Les administrateurs partenaires peuvent activer la synchronisation des annuaires pour un modèle de client lors de la création du nouveau modèle. La synchronisation des annuaires sera activée pour toutes les nouvelles organisations clientes qui seront affectées à ce modèle. Pour plus de détails, voir « Configurer vos modèles d'intégration » dans la section Configurer votre organisation partenaire dans Partner Hub, dans le Guide des solutions pour Webex pour Cisco BroadWorks.

Que faire ensuite

Assurez-vous que vos utilisateurs savent qu'ils doivent cliquer sur l'onglet Contacts de l'application Webex au moins une fois pour activer cette fonctionnalité. Cela ne doit être fait qu'une seule fois.

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

• Répertorier BroadWorks Enterprises : utilisez cette méthode d'API pour obtenir la liste des entreprises appartenant à un fournisseur de services donné et l'identifiant de chaque entreprise. Vous devez saisir le SPEnterpriseID tel qu'il a été attribué lors de l'approvisionnement.

• Mettre à jour la synchronisation des annuaires pour une entreprise BroadWorks : saisissez l'identifiant de l'entreprise pour mettre à jour l'état de synchronisation des annuaires pour cette entreprise, en activant ou en désactivant la synchronisation des annuaires.

• Déclencher la synchronisation des annuaires pour une entreprise —Utilisez cette méthode d'API si vous souhaitez déclencher une synchronisation immédiate pour un identifiant d'entreprise donné. Pour le SyncStatus, entrez la commande SYNC_NOW.

• Obtenir le statut de synchronisation de l'annuaire pour une entreprise — Entrez l'identifiant de l'entreprise et lancez pour obtenir le statut et le TrackingID de la dernière synchronisation. Vous pouvez utiliser le TrackingID pour effectuer des analyses supplémentaires via des outils tels que Kibana et Grafana.

En outre, les administrateurs peuvent utiliser l'API Trigger Directory Sync pour un utilisateur unique afin de déclencher une synchronisation d'annuaire à la demande pour un seul utilisateur.

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

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

Les codes d'erreur suivants s'appliquent à Directory Sync.

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