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

Le provisionnement utilisateur Webex pour Cisco BroadWorks met à jour le répertoire Webex avec les détails d'appel pour Webex pour les utilisateurs Cisco BroadWorks (numéro de téléphone principal, numéro de téléphone mobile, extension), mais omet les enregistrements d'appel externes. Cependant, lorsque la synchronisation de répertoire est activée, la fonctionnalité synchronise également les enregistrements suivants avec le répertoire Webex.

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

• Entités appelant non-utilisateurs (p. ex., téléphone de salle de conférence, télécopieur, numéro de groupe de chasse)

• 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 synchronisation de répertoire

• Les administrateurs partenaires doivent activer la fonctionnalité au niveau des partenaires. 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 a lieu 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 Sync Now 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, le répertoire Sync fonctionne chaque semaine pour chaque client. Chaque synchronisation intervient une semaine après la dernière synchronisation, que la dernière synchronisation ait été programmée ou déclenchée manuellement avec Sync Now.

• Le nombre maximum de syncs simultanés par cluster BroadWorks est de deux : une synchronisation programmée et une synchronisation à la demande (via API ou GUI Partner Hub). Cependant, les administrateurs ne peuvent pas exécuter deux syncs à la demande en même temps à partir du même BroadWorks. Cette restriction existe indépendamment du fait que la synchronisation ait été initiée via l’API ou via l’option Sync Now dans Partner Hub. De plus, Webex ne programmera pas deux syncs programmés pour fonctionner en même temps à partir des mêmes BroadWorks.

• En cas d'échec de synchronisation, Webex réessaie automatiquement la synchronisation 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 synchronisation pour 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 Hub de contrôle et peut aider dans le dépannage, l'analyse et l'audit.

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

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

  • Primarna telefonska številka

  • Numéro de téléphone mobile

  • Razširitev

  Cependant, la synchronisation exclut les utilisateurs appelant uniquement BroadWorks et les entités appelant non-utilisateur de la synchronisation si aucun numéro de téléphone principal ou extension n'est présent.

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

Liste de téléphone et maximums de contacts BroadWorks

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

• Contacts de l'organisation — Webex stocke ces contacts contre une organisation. Chaque utilisateur peut accéder aux contacts de l'organisation pour son organisation. Le maximum est de 30000 contacts.

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

Le tableau suivant établit une correspondance entre les types de contacts Webex et la source de contacts (synchronisée à partir d'une liste téléphonique BroadWorks ou ajoutée manuellement) :

Les conditions suivantes s'appliquent à la façon dont Directory Sync gère les maximums de contacts :

• Si une organisation dépasse le maximum de contacts autorisés pour la synchronisation (30000 contacts d'organisation ou 30000 contacts communs Groupe par groupe), la synchronisation de 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 catégorie, nous vous recommandons de soulever un cas avec Cisco afin que cette organisation soit exclue de la synchronisation des répertoires.

• 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 plus large des contacts utilisateurs sur Webex, mais ne sont pas inclus dans la synchronisation.

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

Posodobitve

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

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

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

Après qu'un administrateur met à 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 uniquement BroadWorks ou une entité appelant non-utilisateur, la mise à jour s’affiche dans l’application Webex d’un utilisateur immédiatement après la synchronisation ultérieure du répertoire.

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

  • Pour les contacts utilisateurs – Les mises à jour s’affichent dans l’application Webex de l’utilisateur immédiatement après la synchronisation ultérieure 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 ultérieure du répertoire.

  • Pour les contacts d'organisation – Le répertoire Webex est mis à jour lors de la synchronisation ultérieure du répertoire, mais les utilisateurs ne verront pas le changement dans l'application Webex tant qu'ils ne redémarreront pas l'application Webex ou tant que le temporisateur local de 72 heures n'expire pas.

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éfinir une valeur nulle.

  • globalDirectoryTransactionLimit—Défini à une valeur nulle.

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

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

  • userTransactionLimit—Défini à au moins 100.

  • transactionLimitPeriodSecs—Réglé sur 1.

• Paging Values – Paramétrer les propriétés du système de paging (XSP_CLI/Applications/Xsi-Actions/Paging) :

  • defaultPageSize—Régler à 50

  • availableUserMaxLimit—Set to 100

• Interface CTI — Assurez-vous de télécharger les certificats Webex CA 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 R22 : AP.as.22.0.1123.ap368517

• Pour R23 : AP.as.23.0.1075.ap368517

• Pour R24 : aucun patch requis

Les administrateurs partenaires peuvent activer Directory Sync pour un modèle client tout en créant le nouveau modèle. Toute nouvelle organisation cliente affectée à ce modèle aura la synchronisation des répertoires activée. Pour plus de détails, voir « Configurer vos modèles d'intégration » dans Configurer votre organisation partenaire dans Partner Hub dans le Guide des solutions pour Webex pour Cisco BroadWorks.

Que faire Suivant

Assurez-vous que vos utilisateurs savent qu’ils doivent cliquer sur l’onglet Contacts de l’application Webex au moins une fois pour activer la fonctionnalité de l’application Webex. Cela 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 Directory Sync pour les organisations clientes qu’ils gèrent, de déclencher une synchronisation immédiate ou d’obtenir des informations d’état de synchronisation. Les méthodes de synchronisation des répertoires sont regroupées sous BroadWorks Enterprises :

• Liste des entreprises BroadWorks—Utilisez cette méthode API pour obtenir une liste des entreprises d'un fournisseur de services donné et l'id de chaque entreprise. Vous devez saisir le spEnterpriseId tel qu'affecté dans le provisionnement.

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

• Déclencher une synchronisation de 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, saisir la commande SYNC_NOW .

• Get Directory Sync Status for an Enterprise—Saisissez l'id de l'entreprise et lancez-le afin d'obtenir un statut et un 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 for a Single User pour déclencher une synchronisation de répertoire à la demande pour un seul utilisateur.

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

Vous devez vous connecter pour lire la spécification de l'API à l'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.