Support du service d'annuaire UC Webex connecté au cloud pour Unified CM

Support du service d'annuaire UC Webex connecté au cloud

Vous pouvez synchroniser et gérer les utilisateurs depuis le cloud Active Directory (par exemple, Microsoft Entra ID) vers des infrastructures de communications unifiées sur site ou hébergées dans le cloud, comme Cisco Unified Communications Manager (Unified Communications Manager) et Cisco Unity Connection (Unity Connection) grâce au service d'annuaire des communications unifiées connecté au cloud Webex. Pendant la synchronisation, le système importe une liste d'utilisateurs et les données associées depuis l'Entra ID (ou un service Cloud Directory similaire) qui est synchronisé avec le Webex Common Identity Service. Dans Control Hub, vous devez sélectionner le Unified CM cluster qui doit être synchronisé, sélectionner le mappage de champs Unified CM d'identifiant utilisateur approprié, puis sélectionner l'accord de synchronisation requis pour effectuer la synchronisation.

Prérequis

Intégrez les Unified CM clusters aux communications unifiées connectées au cloud. Voir Configurer les communications unifiées connectées au cloud pour les appareils sur site
Synchroniser les utilisateurs d'Entra ID avec Control Hub
Les clusters Unified Communications Manager doivent être en version 11.5 (1) SU9, 12.5 (1) SU4, ou 14 et versions ultérieures

Activer le service d'annuaire

Vous devez activer le service d'annuaire pour chaque cluster de Webex Cloud-Connected UC afin de permettre la synchronisation et la gestion des utilisateurs depuis le cloud vers Unified Communications Manager.

Par défaut, le service d'annuaire n'est pas activé pour tous les clusters intégrés.

1	Depuis la vue client dans Control Hub, accédez à Services > Connected UC. Sur la carte UC Management, cliquez sur Inventaire. La liste des groupes de clusters apparaît avec la description, l'état, les clusters et les nœuds.
2	Cliquez sur Détails à côté du groupe de clusters auquel appartient le nœud. La page Inventaire apparaît et affiche la liste des clusters appartenant au groupe de clusters sélectionné.
3	Cliquez sur Détails à côté du cluster auquel appartient le nœud de produit concerné. Le nom du nœud avec la version, le produit et le statut apparaît.
4	Cliquez sur l'icône représentant des points de suspension à côté de l'historique des événements et choisissez Gestion des services. La page de gestion des services apparaît avec la liste des services.
5	Utilisez le bouton à bascule pour activer le service d'annuaire.
6	Cliquez sur Soumettre.

Service d'annuaire

Utilisez la carte Directory Service pour synchroniser les utilisateurs depuis des annuaires basés sur le cloud avec Unified Communications Manager.

1	Depuis la vue client dans Control Hub, accédez à Services > Connected UC.
2	Sur la carte Directory Service, cliquez sur Afficher les clusters. La page du service d'annuaire s'affiche.

Vous pouvez consulter la liste des informations sur le cluster sur cette page.

Voir les détails du cluster

Sur la page de sélection du cluster dans Directory Service, choisissez le cluster avec lequel vous souhaitez synchroniser les données utilisateur.

La page de sélection du cluster fournit également les détails du cluster, l'état du provisionnement, le dernier état synchronisé, le produit associé et la raison de la panne, le cas échéant. Vous pouvez sélectionner le fuseau horaire local ; par défaut, c'est le fuseau horaire du navigateur qui est sélectionné.

Informations sur le cluster	Description
Nom du cluster	Le nom du cluster.
Statut	État de la synchronisation.
Dernière synchronisation	Date de la dernière synchronisation.
Produit	Informations sur le produit.

Synchronisation du service d'annuaire Provision

La synchronisation du service d'annuaire UC connecté au cloud Webex vous permet d'importer les données des utilisateurs finaux depuis Webex Common Identity Service dans la base de données Unified Communications Manager pour les afficher dans la fenêtre de configuration de l'utilisateur final.

Assurez-vous de ne pas effectuer d'opérations de provisionnement lors de la mise à niveau prévue du module de communications unifiées Webex connecté au cloud.

Si vous effectuez le provisionnement pendant la mise à niveau du module, les étapes 1, 2 ou 3 peuvent afficher des états d'erreur au bout d'un certain temps et le bouton Réessayer apparaîtra après un certain temps. Vous pouvez relancer l'approvisionnement en cliquant sur le bouton Réessayer. Assurez-vous de vérifier l'état du cluster pour terminer la mise à niveau avant de réessayer le provisionnement.

Sur la page de sélection du cluster dans Directory Service, choisissez le cluster que vous souhaitez configurer pour permettre la synchronisation.

Cliquez sur Démarrer l'approvisionnement.

Dans la fenêtre de configuration du mappage des champs, assurez-vous que le mappage choisi pour le champ ID Unified CM utilisateur identifie de manière unique l'utilisateur du cluster une fois que vous avez commencé le provisionnement.

Choisissez le mappage de champs Unified CM d'identifiant utilisateur approprié pour synchroniser l'utilisateur depuis Webex.

Le champ ID utilisateur Unified CM correspond à l'adresse e-mail de l'utilisateur dans Webex.
Le champ Mail ID Unified CM correspond à l'adresse e-mail de l'utilisateur dans Webex.
Le champ ID utilisateur Unified CM correspond à l'adresse e-mail sans domaine de l'utilisateur dans Webex.

Un nouveau compte utilisateur sera créé si le mappage ne peut pas être effectué correctement pour un compte utilisateur existant dansUnified CM. L'adresse e-mail (ou la partie identifiant de l'adresse e-mail) de l'utilisateur sera utilisée comme identifiant unique pour le compte utilisateur nouvellement créé.

Cliquez sur Suivant.

Sélectionnez un accord dans la liste déroulante pour créer un nouveau contrat de synchronisation.

Une fois le nouvel accord de synchronisation créé, tous les accords de synchronisation existants pointant vers le répertoire local sont supprimés. Vous pouvez apporter des modifications au nouvel accord de synchronisation une fois qu'il aura été créé.

]

Dans la section Aperçu de l'accord, passez en revue les détails du contrat (informations du répertoire LDAP externe existant disponibles dans Unified Communications Manager) avant de commencer la synchronisation.

Vous pouvez consulter les informations suivantes :

Informations sur les groupes
Modèle de groupe de fonctionnalités appliqué avec des modèles de lignes et d'appareils universels
Informations sur la ligne et le masque pour synchroniser les numéros de téléphone des utilisateurs
Les nouveaux utilisateurs et leurs extensions

Section Champs utilisateur standard à synchroniser. Les champs utilisateur suivants sont synchronisés entre Webex Common Identity Service et Unified Communications Manager :

Champs utilisateur des communications unifiées synchronisés	Champs utilisateur du Webex Common Identity Service synchronisés
Nom d'utilisateur	Le nom d'utilisateur est synchronisé si l'option « Le champ ID utilisateur Unified CM correspond à l'adresse e-mail de l'utilisateur sur Webex » est sélectionnée.
	ID utilisateur existant (e-mail entrantUnified CM) provenant de la base de données Unified Communications Manager qui correspond à l'identifiant e-mail dans Webex Common Identity Service si l'option « Le champ ID e-mail Unified CM correspond à l'adresse e-mail de l'utilisateur dans Webex » est sélectionnée.
	ID de messagerie sans la partie domaine si l'option « Le champ ID utilisateur Unified CM correspond à l'adresse e-mail sans la partie domaine de l'utilisateur dans Webex » est sélectionnée.
Prénom	Nom. Prénom
Nom de famille	Nom. Nom de famille
Nom d'affichage	DisplayName
Numéro de téléphone	Numéros de téléphone. Work
Numéro de portable	Numéros de téléphone. Mobile
Adresse e-mail	e-mails
Titre	titre

Nom d'hôte ou adresse IP du serveur d'annuaire

Cliquez sur Suivant pour sélectionner le filtre de groupe.

Dans la liste déroulante Sélectionner les groupes, sélectionnez le ou les groupes que vous souhaitez synchroniser. Cochez la case Sélectionner tous les groupes si vous souhaitez sélectionner tous les groupes d'utilisateurs.

Par défaut, tous les utilisateurs sont synchronisés. Si vous ne sélectionnez aucun groupe, tous les utilisateurs et leurs données associées seront automatiquement synchronisés.

Pour les groupes imbriqués dans un annuaire, les utilisateurs doivent sélectionner le sous-ensemble de groupes d'utilisateurs spécifiquement lors de l'approvisionnement, car ils ne sont pas inclus par défaut dans le groupe parent. Vous devez vérifier l'absence d'imbrication répétitive (le cas échéant) afin de vous assurer que seuls les utilisateurs requis sont inclus lors du provisionnement.

Toute modification apportée à l'accord de synchronisation, par exemple la suppression d'un utilisateur ou d'un groupe cible, ne sera pas diffusée lors des synchronisations périodiques. Vous devriez désactiver le service d'annuaire pour ce cluster depuis Control Hub, puis le réapprovisionner à nouveau avec un accord de synchronisation nouveau ou modifié.

Cliquez sur Suivant pour préparer le processus de synchronisation.

Dans la fenêtre Activer la synchronisation, activez la synchronisation une fois que le système a correctement copié les données utilisateur dans un espace de stockage temporaire Unified CM et qu'un nouvel accord de synchronisation a été créé (après les étapes 1 et 2, comme le montre la capture d'écran ci-dessous).

L'option Télécharger le rapport vous permet de consulter partiellement les résultats. Pour récupérer les rapports complets du Unified CM cluster, exécutez la commande CLI suivante : file get activelog /cm/trace/CIService/log4j/DryRunResults.csv. Ici, le résultat de la course à sec Unified CM indique ce qui suit :

Nouveaux utilisateurs : utilisateurs présents sur Webex Identity Service mais absents de la base de données Unified CM
Utilisateurs correspondants : utilisateurs présents sur Webex Identity Service et dans la base de données Unified CM
Utilisateurs incompatibles : utilisateurs présents dans la base de Unified CM données mais absents sur Webex Identity Service

Vous pouvez consulter le rapport et décider si vous souhaitez conserver la même liste d'utilisateurs et en ajouter ou en supprimer. En fonction de la décision, vous pouvez arrêter le processus et annuler les modifications d'approvisionnement.

Toute mise à jour des données utilisateur dans l'annuaire cloud après la synchronisation de l'annuaire sera mise à jour lors de la prochaine période de synchronisation. C'est parce que l'annuaire cloud est synchronisé périodiquement une fois par jour.

Après la vérification de l'accord de synchronisation, cliquez sur Aperçu Unified CM pour vous connecter à votre infrastructure locale et apporter des modifications au nouvel accord de synchronisation.

L'accès au VPN est obligatoire.

vous ne pouvez modifier que les informations du groupe pourUnified CM. Vous ne pouvez pas renommer le contrat ni en modifier les détails.

Cochez la case pour accepter les termes selon lesquels l'accord de synchronisation est révisé et vérifiéUnified CM.

Cliquez sur Activer la synchronisation pour procéder à la synchronisation.

Pendant la synchronisation, vous ne pourrez effectuer aucune action tant que vous n'aurez pas terminé. Une fois la synchronisation terminée pour un cluster en particulier, la page du service d'annuaire répertorie ce cluster avec l'état Provisioned. À ce stade, vous avez autorisé Entra ID à approvisionner et à synchroniser les utilisateurs de Webex dans l'infrastructure UC et vous avez suivi les étapes pour configurer la synchronisation.

Une fois le provisionnement initial terminé, une synchronisation périodique a lieu toutes les 24 heures. Toute modification apportée au répertoire du cloud sera transmise aux clusters pendant cette période.

Vous devez activer la synchronisation dans les 20 heures suivant la création du nouvel accord. Les utilisateurs synchronisés LDAP deviennent inactifs et sont supprimés après 24 heures d'inactivité. Les utilisateurs ne pourront pas se connecter et utiliser les Unified CM services.

Une fois l'approvisionnement d'Entra ID terminé pour un cluster donné, vous ne pouvez pas créer de nouveaux accords de synchronisation ni modifier les paramètres de configuration pour le même cluster, à l'exception des paramètres de groupe. Si vous souhaitez créer un nouveau contrat de synchronisation pour le même cluster, vous devez vous rendre sur la page Gestion des services et désactiver le service d'annuaire. Vous pouvez ensuite créer un nouveau contrat d'approvisionnement.

Si la synchronisation échoue pour une raison ou une autre, les dernières modifications d'approvisionnement seront répercutées lors de la prochaine période de synchronisation, le lendemain.

Si vous utilisez Entra ID IdP pour l'authentification SSO une fois le provisionnement réussi, assurez-vous de configurer les bonnes réclamations dans l'Entra ID IdP. Par exemple, lors du provisionnement, si l'option 1 est sélectionnée pour le mappage des identifiants utilisateurs, assurez-vous qu'elle user.userprincipalnameest définie comme UID dans la section « Réclamations supplémentaires ».

Les attributs suivants sont synchronisés entre Webex Common Identity Service et Unified Communications Manager :

Champs utilisateur des communications unifiées synchronisés	Champs utilisateur du Webex Common Identity Service synchronisés
Nom d'utilisateur	Le nom d'utilisateur est synchronisé si l'option « Le champ ID utilisateur Unified CM correspond à l'adresse e-mail de l'utilisateur sur Webex » est sélectionnée.
	ID utilisateur existant (e-mail entrantUnified CM) provenant de la base de données Unified Communications Manager qui correspond à l'identifiant e-mail dans Webex Common Identity Service si l'option « Le champ ID e-mail Unified CM correspond à l'adresse e-mail de l'utilisateur dans Webex » est sélectionnée.
	ID de messagerie sans la partie domaine si l'option « Le champ ID utilisateur Unified CM correspond à l'adresse e-mail sans la partie domaine de l'utilisateur dans Webex » est sélectionnée.
Prénom	Nom. Prénom
Nom de famille	Nom. Nom de famille
Nom d'affichage	DisplayName
Numéro de téléphone	Numéros de téléphone. Work
Numéro de portable	Numéros de téléphone. Mobile
Adresse e-mail	e-mails
Titre	titre

Toute mise à jour des données utilisateur dans l'annuaire cloud après la synchronisation de l'annuaire sera mise à jour lors de la prochaine période de synchronisation. C'est parce que l'annuaire cloud est synchronisé périodiquement une fois par jour.
L'authentification unique (SSO) doit être utilisée pour les connexions. Ce document ne traite que de l'intégration de l'authentification unique (SSO).
Avant de réapprovisionner un cluster depuis Control Hub, nous vous recommandons d'arrêter manuellement le service Dirsync depuis l'interface graphique. Cisco Unified Serviceability
Après le réapprovisionnement, si vous constatez que les utilisateurs marqués comme utilisateurs incompatibles sont les mêmes que les nouveaux utilisateurs (utilisateurs partageant le même identifiant de messagerie), nous vous recommandons d'attendre 48 heures au maximum pour que les modifications de synchronisation prennent effet. Si vous voulez voir les modifications mises à jour immédiatement, assurez-vous de procéder comme suit avant de procéder au réapprovisionnement :
1. Désactivez le service d'annuaire depuis la page de gestion des services de Control Hub.
2. Supprimer le contrat de synchronisation Webex Common Identity Service deUnified CM.
3. Désactivez la case à cocher Activer la synchronisation depuis le serveur LDAP sur la page de configuration du système LDAP de l'interface utilisateur. Cisco Unified CM Administration
4. Supprimez les utilisateurs finaux de la fenêtre Utilisateur final.
5. Activez le service d'annuaire depuis la page de gestion des services de Control Hub.

État de l'offre

Sur le tableau de bord du service d'annuaire, vous pouvez consulter et suivre l'état de votre cluster et consulter les erreurs.

Le tableau suivant répertorie l'état de la fourniture, sa description et les actions correspondantes.

Tableau 1. État de l'approvisionnement
État de l'offre	Description
Traitement	L'approvisionnement est en cours.
Action requise	Prenez les mesures nécessaires si une intervention manuelle est requise pour un cluster en particulier. Par exemple, Si vous souhaitez poursuivre ou abandonner la synchronisation après une utilisation à sec. Une fois le nouvel accord créé, vérifiez s'il y a des notifications et prenez les mesures nécessaires.
Erreur	Si une action est requise dans l'assistant « Activer la synchronisation », vérifiez-la et, si nécessaire, prenez les mesures nécessaires. En cas d'erreur au cours des étapes de provisionnement, l'administrateur doit consulter la page Historique des événements du service : Directory Service. Cisco Webex Control Hub Cela vous permet d'isoler, de déboguer et de résoudre les problèmes éventuels. Pour accéder aux événements, voir Accéder à l'historique des événements pour les services hybrides. Pour plus d'informations sur les différents types d'événements et leurs détails, consultez le tableau « Événements et solutions possibles » ci-dessous.
Provisionné	L'approvisionnement du cluster est terminé.
Non approvisionné	L'approvisionnement du cluster n'a pas encore commencé.

Tableau 2. Événements et résolutions
Événements	Action requise
Échec de la synchronisation périodique	Veillez à attendre la fin de la synchronisation périodique du lendemain. Vérifiez que la synchronisation est terminée avec succès. Si le problème persiste, contactez le Cisco TAC support.
Échec de copie des données	Cliquez sur le bouton Réessayer pour poursuivre le transfert de données. Si le problème persiste, contactez le Cisco TAC support.
Échec de l'accord de synchronisation	Cliquez sur le bouton Réessayer pour réessayer de créer le contrat de synchronisation. Si le problème persiste, contactez le Cisco TAC support.
Ignorer la synchronisation périodique	Aucune action n'est requise.
Le transfert de données a échoué	Cliquez sur le bouton Réessayer pour poursuivre le transfert de données. Si le problème persiste, contactez le Cisco TAC support.
Synchronisation utilisateur incompatible	Vérifiez les connexions de synchronisation des annuaires Unified CM pour détecter les erreurs de synchronisation des utilisateurs ou contactez le Cisco TAC support pour obtenir de l'aide.
Utilisateurs approvisionnés avec succès	Aucune action n'est requise.
Synchronisation périodique : transfert de données réussi	Aucune action n'est requise.
Impossible de récupérer les informations utilisateur de certains groupes sélectionnés sur Webex Common Identity.	Accédez au tableau de bord et sélectionnez le cluster pour obtenir les informations sur les groupes ayant échoué en cliquant sur le lien de téléchargement fourni. Vérifiez si les utilisateurs sont présents dans Webex Common Identity et cliquez sur Réessayer. Contactez le Cisco TAC support pour obtenir de l'aide supplémentaire.
Impossible de récupérer les informations utilisateur de tous les groupes sélectionnés sur Webex Common Identity.	Cliquez sur le bouton Réessayer pour poursuivre le transfert de données. Si le problème persiste, contactez le Cisco TAC support pour obtenir de l'aide.

Résolution des problèmes de synchronisation

Cette section fournit les informations et les solutions nécessaires pour résoudre certains des problèmes courants que vous pouvez rencontrer lors des différentes étapes de la synchronisation des utilisateurs entre Control Hub et la base de données Unified Communications Manager.

Utilisateurs incompatibles

Si vous voyez des utilisateurs qui ne correspondent pas, activez la synchronisation dans les 20 heures suivant la création du nouveau contrat. Les utilisateurs existants sont marqués comme inactifs et supprimés Unified CM après 24 heures d'inactivité.

Erreur : échec de la copie des données. Veuillez réessayer

La communication entre les communications unifiées connectées au cloud et le cloud Webex est perturbée ou impossible de récupérer les données des utilisateurs depuis le cloud Webex.

Solution : Pour vérifier si votre connexion est réussieCisco Cloud, vérifiez l'état de ces services sur : https://status.webex.com/. Cliquez sur Réessayer.
La communication entre les communications unifiées connectées au cloud Unified CM est perturbée ou impossible de transférer les données utilisateur vers la Unified CM base de données.

Solution : vérifiez la connectivité réseau entre les communications unifiées connectées au cloud Unified CM et cliquez sur Réessayer. Si le problème persiste, contactez le Cisco TAC support.

Erreur. Impossible de créer un accord de synchronisation. Veuillez réessayer

La communication entre les communications unifiées connectées au cloud Unified CM est perturbée ou impossible d'envoyer les données de l'accord de synchronisation dans la Unified CM base de données.

Solution : vérifiez la connectivité réseau entre les communications unifiées connectées au cloud Unified CM et cliquez sur Réessayer. Si le problème persiste, contactez le Cisco TAC support.
L'accord de synchronisation n'a pas été créé correctement.

Erreur : impossible d'activer la synchronisation des annuaires. Veuillez réessayer

La communication entre UC connectée au cloud et Unified CM est perturbée, et le service Cisco DirSync n'est pas déclenché.

Solution : vérifiez la connectivité réseau entre les communications unifiées connectées au cloud Unified CM et cliquez sur Réessayer. Si le problème persiste, contactez le Cisco TAC support.

Impossible d'obtenir les détails de l'accord de synchronisation. Veuillez essayer après un certain temps.

La communication entre UC connectée au cloud et Unified CM est perturbée.

Solution : vérifiez la connectivité réseau entre les communications unifiées connectées au cloud Unified CM et cliquez sur Réessayer. Si le problème persiste, contactez le Cisco TAC support.

Impossible de récupérer les données utilisateur des groupes sélectionnés

Lors de la première mise en service, vous pouvez rencontrer des problèmes lors du téléchargement des données utilisateur depuis l'un des groupes que vous avez sélectionnés pour la synchronisation. Sur le message d'erreur, cliquez sur le lien de téléchargement pour voir les informations relatives au groupe qui a échoué.

Vous pouvez également télécharger les informations sur les groupes ayant échoué pour les clusters déjà provisionnés depuis la page Historique des événements deCisco Webex Control Hub. Accédez au tableau de bord et sélectionnez le cluster pour obtenir les informations sur les groupes ayant échoué en cliquant sur le lien de téléchargement fourni. Vérifiez si les utilisateurs sont présents dans Webex Common Identity et cliquez sur Réessayer. Contactez le Cisco TAC support pour obtenir de l'aide supplémentaire.

Problèmes connus et limites liés à la synchronisation du service d'annuaire UC connecté au cloud Webex

Si vous rencontrez un problème avec cette fonctionnalité, vérifiez si nous la connaissons déjà et nous vous recommandons une solution.

Vous pouvez désactiver le service d'annuaire pour un cluster depuis Control Hub, puis le réactiver à nouveau. Nous vous recommandons d'attendre au moins 60 secondes avant d'activer le service d'annuaire pour la synchronisation.
Après la suppression, si vous souhaitez intégrer à nouveau le même Unified CM cluster à l'organisation, vous devez d'abord désactiver le service d'annuaire, puis reprovisionner le même cluster.
Lors du provisionnement, la liste des informations du groupe ne s'affiche pas en raison de problèmes de synchronisation avec Webex Common Identity Service. Il est recommandé aux utilisateurs d'abandonner l'approvisionnement et de réessayer après un certain temps.

Cisco AI Assistant

Merci pour votre commentaire.