Cet article décrit comment déployer Directory Sync dans Webex pour Cisco BroadWorks. Cet article est destiné aux administrateurs de fournisseurs de services des organisations partenaires.
Présentation de la synchronisation des répertoires
La synchronisation du répertoire garantit que les utilisateurs de Webex pour Cisco BroadWorks peuvent utiliser le répertoire Webex à partir de l'application Webex pour appeler toute entité appelante à partir du serveur BroadWorks. Cette fonctionnalité synchronise les informations d'appel BroadWorks qui ne faisaient pas partie de la configuration de l'utilisateur avec le répertoire Webex.
Le provisionnement des utilisateurs de Webex pour Cisco BroadWorks met à jour le répertoire Webex avec les détails des appels pour les utilisateurs de Webex pour 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'appels suivants avec le répertoire Webex.
Utilisateurs appelant BroadWorks uniquement (qui ne sont pas intégrés à Webex)
Entités d'appel non utilisateur (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 BroadWorks et montre comment ils sont ajoutés au répertoire Webex.
Enregistrements des appels BroadWorks |
Description |
Ajouté au répertoire Webex via... |
---|---|---|
Webex pour les utilisateurs de Cisco BroadWorks |
Les utilisateurs sont activés pour Webex pour Cisco BroadWorks |
Provisionnement de l'utilisateur (par exemple, provisionnement en flux continu) |
Utilisateurs appelant BroadWorks uniquement |
Appeler des utilisateurs qui pas intégré à Webex |
Synchronisation du répertoire |
Entités appelantes non utilisateur |
Par exemple, un téléphone de salle de conférence, un télécopieur, un numéro de groupe de recherche |
Synchronisation du répertoire |
Listes téléphoniques BroadWorks |
Entrées de la liste téléphonique BroadWorks :
|
Synchronisation du répertoire (synchronisation de la liste téléphonique) |
Pour plus de détails sur le provisionnement des utilisateurs, voir le Guide de la solution Webex pour Cisco BroadWorks .
|
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 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 le Synchroniser maintenant option 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 des répertoires s'exécute chaque semaine pour chaque client. Chaque synchronisation a lieu 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 programmée et une synchronisation à la demande (via l' API ou l'interface graphique du hub partenaire). Cependant, les administrateurs ne peuvent pas exécuter 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é lancée via l' API ou via le Synchroniser maintenant option dans Partner Hub. De plus, Webex ne programmera pas deux synchronisations programmées pour qu’elles s’exécutent en même temps à partir du même BroadWorks.
Si un échec de synchronisation se produit, Webex tente à nouveau 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 de statut 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 Control Hub et peut aider dans le dépannage, l'analyse et l'audit.
Webex stocke les contacts des utilisateurs dans un format chiffré. Seul l'utilisateur qui possède le 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 à partir 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 poste n'est présent.
Liste téléphonique BroadWorks et nombre maximum de contacts
La synchronisation du répertoire 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 contacts suivants :
Contacts de l'organisation—Webex stocke ces contacts pour une organisation. Chaque utilisateur peut accéder aux contacts de son organisation. Le maximum est de 30 000 contacts.
Contacts utilisateur—Webex stocke ces contacts pour un utilisateur. Seul l'utilisateur qui possède le contact peut accéder à l'entrée du contact. Le maximum est de 2 000 contacts (1 500 contacts synchronisés + 500 contacts à saisie manuelle).
Seules les entrées de la liste téléphonique sont ajoutées aux Contacts Webex. Les utilisateurs appelant BroadWorks uniquement et les entités appelant non utilisateur qui sont inclus dans la synchronisation du répertoire ne sont pas ajoutés aux Contacts à moins qu’un utilisateur Webex ne les ajoute manuellement aux Contacts.
|
Le tableau suivant mappe les types de contacts Webex par rapport à la source des contacts (synchronisés à partir d'une liste téléphonique BroadWorks ou ajoutés manuellement) :
Type de contact Webex |
Source de contact |
Maximum |
Synchronisé à partir de BroadWorks... |
API utilisée pour la synchronisation |
---|---|---|---|---|
Contacts de l’organisation |
Synchronisation du répertoire |
30000 contacts |
Listes téléphoniques courantes d'entreprise |
|
Listes téléphoniques communes du groupe (pour un groupe de fournisseurs de services)** |
|
|||
Contacts de l'utilisateur |
Synchronisation du répertoire |
1500 contacts |
Listes téléphoniques personnelles |
/directories/personal |
Ajouté manuellement par l'utilisateur |
500 contacts |
N/A |
N/A |
|
Contacts du groupe |
Synchronisation du répertoire |
30000 contacts par groupe |
Listes téléphoniques communes des groupes (pour un groupe Entreprise)** |
/directories/groupcommon |
**Les entrées des listes téléphoniques communes de groupe se synchronisent différemment selon que BroadWorks est en mode Entreprise ou en mode Fournisseur de services. La valeur du
|
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 d'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 maximal autorisé de contacts dans l'une ou l'autre des catégories, nous vous recommandons de demander à Cisco d'exclure cette organisation 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 appartiennent à la catégorie des contacts utilisateur plus large sur Webex, mais ne sont pas inclus dans la synchronisation.
La limite globale combinée des contacts de l'organisation (30 000) et des 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.
Lorsqu'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 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 de répertoires suivante.
Si la mise à jour concerne une entrée de la liste téléphonique BroadWorks :
Pour les contacts de l'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'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 ne redémarrent pas l'application Webex ou jusqu'à ce que le temporisateur local de 72 heures du cache expire.
Les mises à jour des informations utilisateur de Webex pour Cisco BroadWorks sont traitées dans le cadre des processus de mise à disposition.
|
Control Hub contient une option pour ajouter ou modifier des contacts au niveau de l'organisation dans Control Hub via un fichier CSV. Les administrateurs partenaires et les administrateurs clients ayant accès à Control Hub peuvent accéder à cette option. Cependant, la mise à jour des contacts via Control Hub n'est pas prise en charge par Webex pour Cisco BroadWorks. Les mises à jour des contacts appliquées dans Control Hub ne sont pas synchronisées avec BroadWorks et ne sont pas disponibles pour les recherches dans le répertoire à partir des téléphones de bureau.
|
Prérequis pour la synchronisation des répertoires
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) avec (ADP_ CLI).
|
Valeurs de limitation de débit—Définissez les propriétés système OverloadControl suivantes (XSP_ CLI/Applications/Xsi-Actions/OverloadControl) :
userDirectoryTransactionLimit—Définir sur une valeur nulle.
globalDirectoryTransactionLimit : défini sur une valeur nulle.
Il est recommandé de définir userDirectoryTransactionLimit et globalDirectoryTransactionLimit sur une valeur nulle. Toutefois, si vous décidez d'affecter des valeurs, chacune doit être définie sur 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éfinissez 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/Paging) :
defaultPageSize—Définir sur 50
availableUserMaxLimit : défini sur 100
Interface CTI—Assurez-vous de télécharger ces 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 BroadWorks, nous vous recommandons d'appliquer les correctifs système suivants au déploiement 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
Activer la synchronisation du répertoire (Nouveau modèle)
Les administrateurs partenaires peuvent activer Directory Sync pour un modèle client lors de la création du nouveau modèle. La synchronisation des répertoires sera activée pour toutes les nouvelles organisations clientes affectées à ce modèle. Pour plus de détails, voir « Configurer vos modèles client » dans Configurer votre organisation partenaire dans Partner Hub au sein de la Guide des solutions pour Webex pour Cisco BroadWorks .
Que faire ensuite
Assurez-vous que vos utilisateurs savent qu’ils doivent cliquer sur le Contacts sur l'application Webex au moins une fois afin d'activer la fonctionnalité sur l'application Webex. Cette opération ne doit être effectuée qu'une seule fois.
Activer la synchronisation du répertoire (modèle existant)
1 | Connectez-vous à Partner Hub 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 des répertoires par défaut pour les nouvelles organisations clientes qui utilisent ce modèle :
|
||
5 | Pour activer la synchronisation des répertoires pour les organisations clientes existantes qui utilisent ce modèle :
|
Que faire ensuite
Assurez-vous que vos utilisateurs savent qu’ils doivent cliquer sur le Contacts sur l'application Webex au moins une fois afin d'activer la fonctionnalité sur l'application Webex. Cette opération ne doit être effectuée qu'une seule fois.
Déclencher la synchronisation immédiate
1 | Connectez-vous à Partner Hub (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 statuts de synchronisation des clients . |
5 | Pour l'organisation cliente 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 la synchronisation. |
Exporter les enregistrements de synchronisation au format CSV
1 | Connectez-vous à Partner Hub (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 statuts de synchronisation des clients . |
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 Directory Sync
Les 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 l'état de la synchronisation. Les méthodes de synchronisation d'annuaire sont regroupées sous Entreprises BroadWorks :
Répertorier les entreprises BroadWorks : utilisez cette méthode d' API pour obtenir une liste d'entreprises sous un fournisseur de services donné et
id
. Vous devez saisir lespEnterpriseId
tel qu’il a été attribué lors de l’approvisionnement.Mettre à jour la synchronisation du répertoire pour une entreprise BroadWorks —Entrez dans l’entreprise
id
pour mettre à jour l'état de synchronisation d'annuaire pour cette entreprise, en activant ou en désactivant la synchronisation d'annuaire.Déclencher la synchronisation du répertoire pour une entreprise : utilisez cette méthode d' API si vous souhaitez déclencher une synchronisation immédiate pour une entreprise donnée
id
. Pour lesyncStatus
, saisissez leSYNC_NOW
commande.Obtenir l'état de synchronisation d'annuaire pour une entreprise —Entrez dans l’entreprise
id
et exécuter afin d'obtenir un statut ettrackingId
de la dernière synchronisation. Vous pouvez utiliser letrackingID
pour exécuter des analyses supplémentaires via des outils tels que Kibana et Grafana.
De plus, les administrateurs peuvent utiliser le Déclencher la synchronisation du répertoire pour un seul utilisateur API pour déclencher une synchronisation d'annuaire à la demande pour un seul utilisateur.
Pour une documentation détaillée de l' API , voirhttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
Vous devez vous connecter pour lire les spécifications de l' API à l'adressehttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Synchroniser plusieurs entreprises avec l' API
|
1 | Exécutez le Répertorier les entreprises BroadWorks API pour générer une liste des entreprises que vous souhaitez synchroniser.
|
2 | Exécutez le Déclencher la synchronisation du répertoire pour une entreprise API sur la première entreprise de la liste. |
3 | Patientez quelques secondes, puis exécutez le Obtenir l'état de synchronisation du répertoire API pour obtenir le statut de synchronisation.
|
4 | Une fois la synchronisation terminée, effectuez les étapes 2 à 4 sur l'entreprise suivante dans la liste. Répétez ces étapes jusqu'à ce que vous ayez synchronisé 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 Broadworks External Directory User Sync. |
600001 |
La synchronisation des utilisateurs du répertoire externe Broadworks a échoué. |
600002 |
La synchronisation des utilisateurs de l’annuaire externe Broadworks a dû être interrompue avant la fin. |
600003 |
La synchronisation des utilisateurs du répertoire externe Broadworks n’a réussi que partiellement. Certaines entreprises clientes n’ont pas réussi à se synchroniser. |
600000 |
La synchronisation des utilisateurs du répertoire externe Broadworks n’est pas activée pour le ConfigSet. |
600005 |
La synchronisation des utilisateurs du répertoire externe Broadworks est en cours pour le ConfigSet. |
6000006 |
Les fils de synchronisation des utilisateurs du répertoire externe Broadworks sont occupés ou en train de s’arrêter, ils n’accepteront donc pas d’autres demandes de synchronisation, réessayez ultérieurement. |
600007 |
L’organisation d’identité de la configuration client (CustomerConfig) est introuvable. |
600008 |
La configuration du client est introuvable dans l’organisation partenaire |
600009 |
La synchronisation des utilisateurs du répertoire externe Broadworks ne peut pas être exécutée car le cluster Broadworks associé à CustomerConfig est occupé |
600010 |
La synchronisation des utilisateurs du répertoire externe Broadworks ne peut pas être exécutée car il n’y a pas de groupe Broadworks associé à la configuration du client. |
600011 |
La synchronisation des utilisateurs du répertoire externe Broadworks n’est pas activée pour la configuration du client. |
600012 |
La synchronisation des utilisateurs du répertoire externe Broadworks ne peut pas être exécutée car la synchronisation du répertoire hybride est déjà activée pour la configuration du client. |
600013 |
La synchronisation des utilisateurs du répertoire externe Broadworks n’a pas réussi à ajouter des utilisateurs et des comptes de machine au magasin d’identité. |
600014 |
La synchronisation des utilisateurs du répertoire externe Broadworks a échoué lors de la tentative de connexion au groupe Broadworks. Erreur de Broadworks - %s. |
600015 |
La synchronisation des utilisateurs du répertoire externe Broadworks n’a pas trouvé d’utilisateur correspondant dans le magasin d’identité. |
600017 |
La synchronisation de la liste téléphonique BroadWorks n’a pas réussi à synchroniser tous les contacts de l’utilisateur et de l’entreprise/organisation. |
600018 |
Échec de la synchronisation de la liste téléphonique BroadWorks pour les utilisateurs de l'entreprise/de l'organisation. |
600019 |
La synchronisation de la liste téléphonique BroadWorks n'a pas réussi à synchroniser les contacts de l'entreprise/de l'organisation. |
600020 |
La synchronisation des utilisateurs du répertoire externe BroadWorks ne peut pas être désactivée car la synchronisation CustomerConfig est en cours. |
600022 |
La synchronisation d'un seul utilisateur du répertoire externe BroadWorks n'est pas possible car l'entreprise n'a pas d'utilisateur provisionné. |
600023 |
La synchronisation d'un seul utilisateur du répertoire externe BroadWorks n'est pas possible car l'utilisateur existe déjà dans cette organisation. |
600024 |
La synchronisation d'un seul utilisateur du répertoire externe BroadWorks n'est pas possible car aucun utilisateur correspondant n'a été trouvé dans BroadWorks. |
600025 |
La synchronisation des utilisateurs du répertoire externe BroadWorks n'a pas réussi à mettre à jour le compte utilisateur dans CI. |
600026 |
La synchronisation des utilisateurs du répertoire externe BroadWorks n'a pas réussi à mettre à jour le compte de l'ordinateur dans CI. |
600027 |
La synchronisation d'un seul utilisateur du répertoire externe BroadWorks n'est pas possible car plusieurs utilisateurs ont été trouvés dans BroadWorks. |
600028 |
La synchronisation d'un seul utilisateur de l'annuaire externe BroadWorks n'est pas possible car au moins une synchronisation de répertoire d'entreprise doit avoir été effectuée. |
600029 |
La synchronisation des utilisateurs du répertoire externe BroadWorks a échoué car l’entreprise n’a pas d’utilisateur provisionné. |
Historique des modifications
Le tableau suivant résume les mises à jour apportées à cet article.
Date |
Révision |
---|---|
14 février 2023 |
Mise à jour Valeurs maximales et source de la synchronisation du répertoire rubrique. |
10 décembre 2022 |
Terme mis à jour Terminer la synchronisation immédiate à Déclencher la synchronisation du répertoire |
19 juillet 2022 |
Clarifications et corrections apportées aux informations générales :
|
09 mai 2022 |
|
07 avril 2022 |
|
28 mars 2022 |
|
24 mars 2022 |
Ajout de la liste des types de numéros de téléphone synchronisés à Conditions de synchronisation du répertoire . La synchronisation inclut maintenant les numéros de téléphone mobile. |
16 mars 2022 |
|
17 décembre 2021 |
|
16 décembre 2021 |
|
08 décembre 2021 |
|