Aperçu de la synchronisation du répertoire

La synchronisation du répertoire garantit que Webex pour les utilisateurs de Cisco BroadWorks peuvent utiliser le répertoire Webex pour appeler n’importe quelle entité d’appel du serveur BroadWorks. Lorsque cette fonctionnalité est activée, le répertoire d’appel complet du serveur BroadWorks est synchronisé avec le répertoire Webex. Les utilisateurs peuvent accéder au répertoire à partir de l’application Webex et appeler n’importe quelle entité d’appel à partir du serveur BroadWorks.

La synchronisation du répertoire inclut la synchronisation des informations d’appel des utilisateurs ainsi que des listes de téléphones. Les enregistrements des listes de téléphones synchronisés sont écrits sur l’un des deux types de contacts dans le répertoire Webex :

  • Contacts de l’organisation—Ces contacts sont stockés par rapport à une organisation et sont disponibles pour tous les utilisateurs de l’organisation.

  • Contacts utilisateur—Ces contacts sont stockés contre un utilisateur et ne sont disponibles que pour l’utilisateur qui possède le contact.


La mise en service de Webex pour Cisco BroadWorks inclut une synchronisation par défaut des utilisateurs de messagerie et leurs informations d’appel associées du serveur BroadWorks au répertoire Webex. Cependant, la synchronisation du provisioning par défaut omette les utilisateurs qui ne envoient pas de messages et les entités non utilisateurs (par exemple un téléphone salle de conférence, fax ou numéro groupe de recherche/groupe de distribution des appels). L’ajout de la synchronisation du répertoire garantit que toutes les entités d’appel sont ajoutées 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 des clients peuvent utiliser l’option Synchroniser maintenant pour ignorer la période d’attente d’une semaine et effectuer une synchronisation immédiate pour l’organisation d’un client donné.

  • 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 cette synchronisation soit programmée ou déclenchée manuellement avec Synchroniser maintenant.

  • En cas de défaillance de la synchronisation, la synchronisation est automatiquement retentée 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 est plus détaillé que l’affichage du Control Hub et peut faciliter le dépannage, l’analyse et l’audit.

  • Les contacts utilisateur sont stockés dans un format chiffré avec uniquement l’utilisateur qui possède le contact qui a accès à la clé de déchiffrement.

  • Cette fonctionnalité synchronise les types de listes téléphoniques suivants à partir du serveur BroadWorks :

    • Listes téléphoniques communes d’entreprise

    • Listes des téléphones communs de groupe

    • Listes de téléphones personnels

Synchronisation du répertoire et maximum des contacts

Voici le nombre maximum de contacts que la synchronisation du répertoire autorise pour chaque type de contact Webex :

  • 500 contacts de l’organisation

  • 500 contacts Utilisateur—Pour un utilisateur, le maximum inclut les contacts utilisateur synchronisés et les contacts manuels (les contacts que l’utilisateur ajoute manuellement via l’application Webex)

Les conditions suivantes s’appliquent :

  • Si une organisation a plus de 500 contacts dans l’une des catégories, la synchronisation exclut les entrées au dessus du seuil de 500 limites. Aucun ordre particulier n’est appliqué aux contacts synchronisés ou omis.

  • Si un utilisateur ajoute des contacts manuellement sur l’application Webex, le maximum de contacts utilisateur est déterminé en sous-traitant les contacts manuels des contacts utilisateur synchronisés. Par exemple, si un utilisateur ajoute 100 contacts manuellement sur l’application Webex, la synchronisation du répertoire permet à 400 contacts utilisateur d’être synchronisés à partir de BroadWorks pour cet utilisateur.

  • Nous vous recommandons que si l’une de vos organisations clientes a plus de 500 contacts dans l’une ou l’autre catégorie, augmentez un cas avec Cisco pour que cette organisation soit exclue de la synchronisation du répertoire.

Le tableau suivant ma communiquée les types de contacts Webex à la liste téléphonique BroadWorks à partir de laquelle les enregistrements sont synchronisés :

Tableau 1. Types de contacts de synchronisation du répertoire et source de synchronisation

Webex Contact Type

Synchronisée à partir de BroadWorks...

API utilisée pour la synchronisation

Contacts de l’organisation

Listes téléphoniques communes d’entreprise

/directories/enterprisecommon

Listes des téléphones communs de groupes (en Prestataire de service)**

/directories/groupcommon

Contacts utilisateur

Listes des téléphones communs de groupe (en mode Entreprise)**

/directories/groupcommon

Listes de téléphones personnels

/directories/personal


**Les listes de téléphones communs de groupe sont synchronisées différemment si BroadWorks est en mode Entreprise ou Prestataire de service mode. La valeur de la isBroadWorksEnterprise paramètre (vrai ou faux) détermine la façon dont la liste se synchronise :

  • True (Vrai)–Synchroniser en tant que contact de l’organisation

  • False (Faux)–Synchroniser en tant que contact utilisateur

Mises à jour

Après la mise à jour d’un contact sur BroadWorks, les grandes lignes suivantes lorsque la mise à jour s’affiche dans l’application Webex d’un utilisateur :

  • Les mises à jour des contacts de l’organisation s’affichent dans l’application Webex après que l’utilisateur a redémarré l’application, ou après l’expiration du délai de cache local de 72 heures de l’application.

  • Les mises à jour des contacts de l’utilisateur s’affichent immédiatement dans l’application Webex pour cet utilisateur.

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, le contact existant dans le répertoire Webex est mis à jour avec le nouveau numéro.

Prérequis pour la synchronisation du répertoire

////Exigences de bascule

Les boutons de fonctionnalité suivants existent pour cette fonctionnalité. Assurez-vous de contacter votre représentant Cisco BroadWorks pour qu’il les définisse.

Bascule de fonctionnalité

Appliqué à...

Descripton

webex-for-broadworks-phone-list-sync

Partenaire

Bascule obligatoire. Permet la synchronisation de la liste téléphonique pour toutes les organisations des clients sous ce partenaire.

Doit être activé.

webex-for-broadworks-phone-list-sync-disable

Organisation du client

Facultatif. Désactive la synchronisation de la liste téléphonique pour une organisation donnée, même si la fonctionnalité est activée au niveau du partenaire et dans le modèle du client.

Appliquez cette bascule uniquement si vous souhaitez désactiver la synchronisation de la liste téléphonique pour une organisation client spécifique. Sinon, vous pouvez le désactiver.


 
Par exemple, vous devez appliquer cette bascule à toutes les organisations qui nécessitent plus de 500 contacts.

hidden-personal-contacts-enabled-ga

Utilisateur

Facultatif. Masque les contacts personnels des recherches du répertoire terminées par cet utilisateur.

hidden-org-contacts-enabled-ga

Utilisateur

Facultatif. Masque les contacts de l’organisation des recherches du répertoire terminées par cet utilisateur.

Préconfiguration requise

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


Les exemples ci-dessous supposent que vous utilisez un serveur XSP. Pour les serveurs ADP, remplacez (XSP_CLI) par (ADP_CLI).
  • 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 la liste complète des exigences minimales requises pour webex pour Cisco BroadWorks, voir Exigences logicielles de BroadWorks dans le Guide de solution pour Webex pour CiscoBroadWorks.

Activer la synchronisation du répertoire (nouveau modèle)

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.

Activer la synchronisation du répertoire (modèle existant)

Les administrateurs partenaires peuvent effectuer les étapes suivantes pour activer la synchronisation du répertoire dans un modèle client existant afin d’activer la fonctionnalité pour les organisations des clients qui utilisent le modèle.

1

Connectez-vous au Hub partenaire et choisissez Paramètres.

2

Faites défiler jusqu’à Appel BroadWorks et cliquez sur Afficher les modèles.

3

Sélectionnez le modèle de client approprié et faites défiler jusqu’à Synchronisation du répertoire BroadWorks.

4

Pour activer la synchronisation du répertoire par défaut pour les nouveauxorganisations des clients qui utilisent ce modèle :

  1. Configurer la Activer la synchronisation du répertoire BroadWorks & de la liste des téléphones pour toutes les organisations des nouveaux clients pour activer.

  2. Cliquez sur Enregistrer.

5

Pour activer la synchronisation du répertoire pour les organisations existantes des clients qui utilisent ce modèle :

  1. Cliquez sur Afficher la liste des clients du statut de synchronisation.

  2. Cochez les cases adjacentes pour chaque organisation pour laquelle vous souhaitez activer la fonctionnalité.

  3. Cliquez sur Activer la synchronisation.


 

Si vous souhaitez désactiver la synchronisation du répertoire, suivez la procédure ci-dessus et :

  • À l’étape 4a, configurer l’option Activer la synchronisation du répertoire téléphonique pour toutes les nouvelles organisations des clients qui basculent sur Désactivé pour désactiver la synchronisation du répertoire par défaut pour les nouvelles organisations des clients qui utilisent ce modèle.

  • À l’étape 5c, cliquez sur Désactiver la synchronisation pour désactiver la fonctionnalité pour les organisations existantes.

Ce qu’il faut 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.

Synchronisation immédiate complète

L’option Synchroniser maintenant permet à l’administrateur partenaire de terminer une synchronisation à la demande pour une organisation client donnée. Cette option peut être sélectionnée uniquement pour les organisations individuelles des clients—il n’y a pas d’option en bloc pour Synchroniser maintenant.

1

Connectez-vous au Hub partenaire (http://admin.webex.com) et choisissez Paramètres.

2

Faites défiler jusqu’à Appel BroadWorks et cliquez sur Afficher les modèles.

3

Sélectionnez le modèle de client approprié et faites défiler jusqu’à Synchronisation du répertoire BroadWorks.

4

Cliquez sur Afficher la liste des clients du statut de synchronisation.

5

Pour l’organisation du client que vous souhaitez synchroniser, cliquez sur les trois points à l’extrême droite et sélectionnez Synchroniser maintenant.

6

Cliquez sur Actualiser pour voir les résultats de synchronisation.

Exporter les enregistrements de synchronisation dans un enregistrement CSV

Les administrateurs partenaires peuvent exporter les informations détaillées de la dernière synchronisation vers un fichier CSV. Le CSV contient une vue plus détaillée de l’enregistrement de synchronisation que l’interface graphique du Control Hub et peut faciliter le dépannage et l’analyse.

1

Connectez-vous au Hub partenaire (http://admin.webex.com) et choisissez Paramètres.

2

Faites défiler jusqu’à Appel BroadWorks et cliquez sur Afficher les modèles.

3

Sélectionnez le modèle de client approprié et faites défiler jusqu’à Synchronisation du répertoire BroadWorks.

4

Cliquez sur Afficher la liste des clients du statut de synchronisation.

5

Cochez les cases adjacentes pour chaque organisation que vous souhaitez inclure dans l’exportation.

6

Cliquez sur Exporter les résultats.

API publiques pour la synchronisation du répertoire

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. Il existe quatre API :

  • Lister les entreprises BroadWorks —Utilisez cette méthode API pour obtenir une liste des entreprises sous un certain Prestataire de service et les entreprisesde chaque id. Vous devez saisir le spEnterpriseId comme attribué dans le provisioning.

  • Mise à jour de la synchronisation du répertoire pour une entreprise BroadWorks— Entrer dans l’entreprise id pour mettre à jour le statut du répertoire syc pour cette entreprise, activer ou désactiver 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 synchronisationimmédiate pour une entreprise donnée id. Pour la syncStatus, saisissez le SYNC_NOW Commande.

  • Obtenir le statut de synchronisation du répertoire pour uneentreprise —Entrer dans 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 Graphicana.

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 à https://developer.webex.com/docs/api/v1/broadworks-subscribersl'.

Synchroniser plusieurs entreprises avec l’API

Terminez cette procédure pour utiliser les API publiques pour terminer la synchronisation du répertoire pour plusieurs entreprises.

  • La synchronisation du répertoire ne vous permet de synchroniser qu’une seule entreprise à la fois. Si vous tentez de synchroniser plusieurs entreprises, vous recevrez l’erreur 429.

  • Le temps qu’il faut pour terminer une synchronisation pour une seule entreprise varie en fonction de la taille de l’entreprise.

1

Exécutez l’API de La liste des entreprises BroadWorks pour générer une liste des entreprises que vous souhaitez synchroniser.

  1. Set startAvec la chaîne de démarrage de l’identificateur de l’entreprise ou du fournisseur de service.

  2. Cliquez sur À vide.

2

Exécutez la synchronisation du répertoire déclencheur pour une API d’entreprise sur la première entreprise de la liste.

  1. Saisissez l’id de l’entreprise.

  2. Configurer syncStatus sur SYNC_NOW

  3. Cliquez sur À vide.

    Une synchronisation immédiate est déclenchée pour l’entreprise. Cette synchronisation est comptabilisée par rapport à la limite d’une synchronisation par instance.
3

Attendez quelques secondes puis exécutez l’API Obtenir le statut de synchronisation du répertoire pour obtenir le statut de synchronisation.

  1. Saisissez l’id de l’entreprise

  2. Cliquez sur À vide.

4

Lorsque la synchronisation est terminée, terminez les étapes 2 à 4 sur l’entreprise suivante de la liste. Répétez ces étapes jusqu’à ce que vous synciez la liste entière.

Codes d’erreur pour la synchronisation du répertoire

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

Code d'erreur

Message d'erreur

600000

Erreur inattendue de la synchronisation inattendue des utilisateurs du répertoire externe de Broadworks.

600001

La synchronisation des utilisateurs du répertoire externe de Broadworks a échoué.

600002

La synchronisation des utilisateurs du répertoire externe Broadworks devait être terminée avant d’être terminée.

600003

Broadworks La synchronisation des utilisateurs du répertoire externe a uniquement partiellement réussi. Échec de la synchronisation de certaines organisations clientes.

600004

La synchronisation des utilisateurs du répertoire externe broadworks n’est pas activée pour le groupe de configset.

600005

La synchronisation des utilisateurs du répertoire externe de Broadworks est en cours pour le groupe de configset.

600006

Broadworks Les fils de discussion de synchronisation des utilisateurs du répertoire externes sont occupés ou arrêtés, par conséquent n’accepteront plus de demandes de synchronisation, essayez ultérieurement.

600007

L’organisation d’identité de la CustomerConfig n’a pas été trouvée.

600008

Le CustomerConfig n’a pas été trouvé dans l’organisation partenaire.

600009

Broadworks External Directory User Sync ne peut pas être exécuté car le cluster broadworks associé à CustomerConfig est occupé

600010

Broadworks External Directory User Sync ne peut pas être exécuté car il n’y a pas de cluster broadworks associé à la CustomerConfig.

600011

La synchronisation des utilisateurs du répertoire externe de Broadworks n’est pas activée pour la conférence du client.

600012

La synchronisation des utilisateurs du répertoire externe Broadworks ne peut pas être exécuté car la synchronisation du répertoire hybride est déjà activée pour la conférence du client.

600013

La synchronisation des utilisateurs du répertoire externe broadworks n’a pas réussi à ajouter des utilisateurs et des comptes d’ordinateurs au magasin d’identités.

600014

La synchronisation des utilisateurs du répertoire externe de Broadworks a échoué lors de la tentative de connexion au cluster Broadworks. Erreur de Broadworks - %s.

600015

Broadworks External Directory User Sync n’a trouvé aucun utilisateur correspondant dans le magasin d’identités.

600017

La synchronisation de la liste téléphonique BroadWorks a échoué pour synchroniser tous les contacts des utilisateurs et des entreprises/organisations.

600018

Échec de la synchronisation de la liste téléphonique BroadWorks pour les utilisateurs de l’entreprise/organisation.

600019

La synchronisation de la liste téléphonique BroadWorks a échoué pour synchroniser les contacts d’entreprise/organisations.