- Accueil
- /
- Article
Configurer l’application de l’assistant Entra ID (Azure AD) dans le Control Hub
Si vous gérez vos utilisateurs et vos groupes dans Microsoft Entra ID, utilisez l’application de l’assistant Entra ID (Azure AD) dans Control Hub pour synchroniser les utilisateurs et les groupes avec Webex.
Activer Entra ID dans Control Hub
Dans Webex pour le Gouvernement, l’application de l’assistant Entra ID (Azure AD) est disponible à la fois pour les clients GCC Moderate Entra ID et GCC High Entra ID.
Certaines des fonctionnalités qui sont décrites dans cet article ne sont pas encore disponibles pour tous les clients.
Avant de commencer
1 |
Connectez-vous au Control Hub avec un compte administrateur complet. | ||||||||||
2 |
Allez dans Paramètres de l’organisation et faites défiler jusqu’à Application de l’assistant Microsoft Azure Active Directory. | ||||||||||
3 |
Cliquez sur Configurer pour commencer la configuration. | ||||||||||
4 |
(Facultatif) Pour les administrateurs de Webex for Government, sélectionnez Entra Worldwide ou Entra GCC High et cliquez sur Continuer. Entra Worldwide envoie l’Assistant à l’Entra AD pour GCC Moderate et Commercial. Entra GCC High envoie l’assistant à Entra AD pour GCC High.
| ||||||||||
5 |
Authentifiez votre compte d’administrateur Entra ID. Si vous n’êtes pas un administrateur global ou à rôle privilégié dans Entra ID, vous pouvez demander l’accès pour accorder la permission à l’application Assistant Entra ID (Azure AD). Si vous avez tous les privilèges d’administrateur dans Entra ID, vous pouvez consulter et accorder l’accès aux demandes en allant dans Activité, sélectionnez Demandes de consentement de l’administrateur et cliquez sur Intégration de l’identité Cisco Webex et sélectionnez Vérifier les autorisations et accepter. Ce processus accorde une authentification générale à l'application Webex. . SousEnfin, cliquez sur l’onglet Tous (aperçu) , sélectionnez Intégration de l’identité Cisco Webex et cliquez sur Revoir l’application. Sous , cliquez sur Accorder le consentement de l’administrateur à Cisco pour accorder toutes les autorisations nécessaires pour activer Entra ID dans Control Hub. Voir Prise en charge de Microsoft pour plus d’informations sur ce processus. | ||||||||||
6 |
Vérifiez les autorisations et cliquez sur Accepter pour accorder au compte l’autorisation d’accéder à votre tenant Entra ID. Cisco Webex Identity est une application d’entreprise Entra ID dans Entra ID. L’application Assistant se connecte à cette application pour accéder aux API du graphe Entra ID. Les autorisations requises pour y accéder sont les autorisations minimales nécessaires pour la prendre en charge et l'utiliser.
| ||||||||||
7 |
Pour les clients SMB, acceptez les paramètres par défaut en cochant la case Synchroniser les paramètres par défaut et en cliquant sur Continuer. Pour les clients professionnels, allez à l’étape suivante et continuez la configuration. Si vous acceptez les paramètres par défaut, cela signifie que vous souhaitez :
| ||||||||||
8 |
Pour les clients Entreprise (plus de 1 000 utilisateurs), ou les clients qui souhaitent configurer les paramètres manuellement, cliquez sur l'onglet Attributs et mappez les attributs. Cliquez sur Enregistrer. Vous pouvez mapper d’autres attributs utilisateur à partir d’Entra ID à Webex, ou modifier les mappages des attributs utilisateur existants à l’aide de la page Attributs . Vous pouvez personnaliser le mappage en vous assurant que vous le configurez correctement. La valeur que vous mapiez comme nom d’utilisateur est importante. Webex utilise l’adresse électronique de l’utilisateur comme nom d’utilisateur. Par défaut, le nom principal de l’utilisateur (UPN) dans Entra ID correspond à l’adresse électronique (nom d’utilisateur) dans Control Hub. Vous ne pouvez pas modifier le mappage au cours de la première installation. À ce stade, l’instance correspondante n’est pas complètement construite et il n’y a aucune instance de l’attribut de mappage personnalisé. Cependant, vous pouvez cliquer sur Modifier pour le modifier lorsque l’installation est terminée. | ||||||||||
9 |
Ajoutez des utilisateurs à la portée de la synchronisation en cliquant sur l’onglet Utilisateurs . Vous pouvez saisir le nom d’utilisateur pour rechercher et ajouter l’utilisateur dans le champ de synchronisation. Vous pouvez également supprimer un utilisateur du champ de synchronisation en cliquant sur l’icône de la Corbeille à droite. Cliquez sur Enregistrer. Si vous souhaitez sélectionner tous les utilisateurs à partir d’Entra ID, sélectionnez Sélectionner tous les utilisateurs. Si vous la sélectionnez, vous n’avez pas besoin de sélectionner des groupes dans le champ car cette option synchronise les groupes en même temps. Nous ne recommandons pas l’utilisation de Sélectionner tous les utilisateurs pour les clients d’entreprises significatifs avec des centaines de milliers d’utilisateurs, car le processus d’initialisation nécessite un long temps. Si vous synchronisez accidentellement beaucoup d’utilisateurs dans Control Hub, la suppression de ces utilisateurs prend également plus de temps. Cliquez sur Enregistrer. | ||||||||||
10 |
Sur l'onglet Groupes , vous pouvez rechercher des groupes individuels et les ajouter à Webex.
| ||||||||||
11 |
Sur l’onglet Plus, vous pouvez configurer certaines options de synchronisation avancées :
| ||||||||||
12 |
Vous pouvez décider si vous souhaitez autoriser la synchronisation immédiatement ou ultérieurement. Si vous sélectionnez l’option Autoriser maintenant , tous les paramètres seront appliqués à la prochaine synchronisation. Si vous sélectionnez l’option Enregistrer et autoriser plus tard , la synchronisation ne démarre pas tant que vous n’autorisez pas la synchronisation automatique. | ||||||||||
13 |
L’application communique avec Entra ID pour configurer la configuration et planifie la synchronisation. |
- Actif(s) : la synchronisation a réussi.
- Quarantaine : la tâche de synchronisation a été mise en quarantaine dans Entra ID après plusieurs échecs. Voir la documentation Entra ID pour plus d’informations.
- NotRun : ce statut n’apparaît qu’après la première installation. Le service n'est pas encore exécuté après la première installation.
Vous pouvez également cliquer sur Afficher le résumé pour afficher des informations supplémentaires telles que l’heure et la date de la dernière synchronisation et le nombre d’utilisateurs synchronisés, ignorés ou échoués :
Utilisateurs
- Synchronisé(s) : affiche le nombre d’utilisateurs qui ont été synchronisés avec succès avec Webex.
- Ignorée : affiche le nombre d’utilisateurs qui ont été ignorés lors de la dernière synchronisation. Par exemple, les nouveaux utilisateurs d’Entra ID qui n’ont pas été ajoutés au périmètre de synchronisation de l’application Entra ID (Azure AD). Ces utilisateurs n’ont pas été synchronisés avec Webex ; ajoutez-les dans le champ de synchronisation pour les synchroniser avec Webex.
- Échec : affiche le nombre d’utilisateurs qui n’ont pas pu être synchronisés. Consultez le journal d’audit de mise à disposition de l’application Entra ID pour plus d’informations sur les raisons pour lesquelles la synchronisation de ces utilisateurs a échoué. Si vous devez synchroniser ces utilisateurs immédiatement, vous pouvez provisionner les utilisateurs à la demande.
Groupes
- Synchronisé(s) : affiche le nombre de groupes qui ont été synchronisés avec succès avec Webex et créés dans Control Hub.
- À synchroniser : ce statut indique que tous les utilisateurs d’un groupe n’ont pas encore été ajoutés. Les utilisateurs doivent tout d’abord être synchronisés avec succès avec Webex.
Migrer les configurations existantes de l’application Cisco Webex Enterprise vers l’application Assistant Entra ID (Azure AD)
Si vous avez déjà configuré une application Cisco Webex Enterprise dans Entra ID, vous pouvez migrer automatiquement toutes vos configurations vers l’application de l’assistant Entra ID (Azure AD). Vous pouvez gérer le tout Entra ID dans le Control Hub sans perdre aucune de vos configurations précédentes.
1 |
Connectez-vous au Control Hub avec un compte administrateur complet. | ||||||||||
2 |
Allez à Paramètres de l’organisation et faites défiler jusqu’à la section Synchronisation du répertoire. | ||||||||||
3 |
Cliquez sur Configurer pour commencer la configuration. | ||||||||||
4 |
Authentifiez le compte admin Entra ID à l’aide de la configuration Entra ID. Assurez-vous d’utiliser un compte dont les permissions sont décrites à l’étape suivante. | ||||||||||
5 |
Vérifiez les autorisations et cliquez sur Accepter pour accorder au compte l’autorisation d’accéder à votre tenant Entra ID. La synchronisation de l’identité Cisco Webex est une application d’entreprise Entra ID dans Entra ID. L’application Assistant se connecte à cette application pour accéder aux API du graphe Entra ID. Les permissions requises pour y accéder sont les permissions minimum nécessaires pour l’aider et l’utiliser.
| ||||||||||
6 |
Sélectionnez Migrer une application existante. | ||||||||||
7 |
Après avoir accepté d'autres demandes d'autorisation en lecture seule, sélectionnez l'application existante que vous souhaitez migrer vers l'application Assistant, puis sélectionnez Continuer. Si l’application existante sélectionnée ne déploie pas les utilisateurs sur le même Control Hub, la migration échouera. | ||||||||||
8 |
Une fois la migration terminée, nous vous recommandons d’effectuer un test avant d’activer la synchronisation automatique pour vous assurer qu’il n’y a pas d’erreurs. |
Effectuer un essai à vide
Avant d’activer la synchronisation automatique, nous vous recommandons d’effectuer tout d’abord un essai pour vous assurer qu’il n’y a pas d’erreurs. Une fois l’essai terminé, vous pouvez télécharger un rapport d’essai pour afficher des informations détaillées. Les colonnes disponibles du rapport sont les suivantes :
Nom de la colonne | Description |
---|---|
Type d’objet | Type d’objet dans Entra ID, tel que utilisateur ou groupe. |
Type d’action | Type d’action qui sera effectuée sur l’objet au cours d’une synchronisation. Les types d'actions possibles sont :
|
ID Azure | ID de l’objet dans Entra ID. |
Nom Azure | Nom de l’objet dans Entra ID. |
Nom Webex | Nom de l’objet dans Webex. |
Raison | Raison pour laquelle un type d’action se produira au cours d’une synchronisation. |
1 |
Connectez-vous au Control Hub avec un compte administrateur complet. |
2 |
Allez à Paramètres de l’organisation et faites défiler jusqu’à la section Synchronisation du répertoire. |
3 |
Cliquez sur les trois points verticaux à côté de l'instance que vous souhaitez synchroniser, puis sélectionnez Test. |
4 |
Une fois l’essai terminé, cliquez sur Télécharger le résumé pour télécharger le rapport au format de fichier CSV. |
Activer ou désactiver la synchronisation automatique
L’application de l’assistant Entra ID (Azure AD) et son service principal correspondant vérifie si la synchronisation automatique est activée pour déterminer à quel moment synchroniser les utilisateurs ou les groupes d’Entra ID avec Webex. Activez la Synchronisation automatique pour permettre la synchronisation automatique des utilisateurs et des groupes. Lorsque vous désactivez la Synchronisation automatique , l’application de l’assistant ne synchronise rien avec Webex, mais la configuration existante est conservée.
En général, les utilisateurs sont synchronisés toutes les 40 minutes conformément à la politique de Microsoft.
1 |
Connectez-vous à Control Hub en tant qu’administrateur complet de l’organisation. |
2 |
Allez à Paramètres de l’organisation et faites défiler jusqu’à la section Synchronisation du répertoire. |
3 |
Commutez le bouton sur la droite pour activer la synchronisation automatique. Désactivez-le en commutant la bascule de synchronisation automatique sur la gauche. |
Modifier la configuration de l’application de l’assistant Entra ID (Azure AD)
1 |
Connectez-vous au Control Hub avec un compte administrateur complet. |
2 |
Allez à Paramètres de l’organisation et faites défiler jusqu’à la section Synchronisation du répertoire. |
3 |
Cliquez sur Modifier la configuration. |
4 |
Personnalisez le mappage des attributs en sélectionnant un attribut dans la colonne de gauche qui provient d’Entra ID. L’attribut de destination dans le Cloud Webex se trouve dans la colonne de droite. Voir Mappage des attributs de l’application Assistant Entra ID (Azure AD) pour plus d’informations sur le mappage des attributs. |
5 |
Dans les onglets Utilisateurs et Groupes , ajoutez ou supprimez des utilisateurs et des groupes de la portée de la synchronisation. Les groupes imbriqués ne se synchronisent pas automatiquement avec le Cloud. Veillez à sélectionner les groupes qui sont imbriqués dans les groupes que vous souhaitez synchroniser. |
6 |
Dans l’onglet Plus, modifiez vos préférences si nécessaire. |
7 |
Cliquez sur Enregistrer pour enregistrer la configuration modifiée. Vos mises à jour sont appliquées dans la prochaine synchronisation. Le mécanisme de synchronisation automatique Entra ID gère la synchronisation des utilisateurs et des groupes d’utilisateurs. |
Modifier le nom de l’instance Webex
Changer la façon dont le nom de l’instance de l’identité Cisco Webex s’affiche dans la liste des applications d’entreprise Entra ID.
1 |
Connectez-vous au Control Hub avec un compte administrateur complet. |
2 |
Allez à Paramètres de l’organisation et faites défiler jusqu’à la section Synchronisation du répertoire. |
3 |
Cliquez sur Modifier le nom de l’instance. |
4 |
Saisissez le nouveau nom de l’instance et cliquez sur Enregistrer. |
Supprimer la configuration de l’application de l’assistant Entra ID (Azure AD)
Lorsque vous supprimez l’application Assistant Entra ID (Azure AD), elle supprime la configuration de la synchronisation d’Entra ID. La configuration n’est pas conservée par Webex ou Entra ID. Si vous souhaitez utiliser la synchronisation d’Entra ID à l’avenir, vous devez effectuer une reconfiguration complète.
Ne supprimez pas l’application Cisco Webex dans Entra ID.
1 |
Connectez-vous au Control Hub avec un compte administrateur complet. |
2 |
Allez à Paramètres de l’organisation et faites défiler jusqu’à la section Synchronisation du répertoire. |
3 |
Cliquez sur Supprimer l’instance. |
4 |
Dans la page Supprimer l’instance Azure AD ? sélectionnez Révoquer le consentement de l’administrateur Azure AD si vous souhaitez supprimer l’accord de consentement de Webex. Si vous sélectionnez cette option, vous devez saisir vos identifiants et accorder à nouveau les autorisations. |
5 |
Cliquez sur Supprimer. |
Provisionner un utilisateur à Webex à la demande
Vous pouvez provisionner Webex à un utilisateur immédiatement, indépendamment d’une synchronisation Entra ID, et vérifier instantanément le résultat. Ceci est utile lors du dépannage de problèmes pendant la configuration.
1 |
Connectez-vous au Control Hub avec un compte administrateur complet. |
2 |
Allez dans Paramètres de l’organisation et faites défiler jusqu’à la section Synchronisation du répertoire . |
3 |
Cliquez sur Provisionner un utilisateur à la demande. |
4 |
Recherchez et sélectionnez l’utilisateur que vous souhaitez déployer, puis cliquez sur Déployer. |
5 |
L'un des résultats suivants s'affiche lorsqu'il est terminé :
|
6 |
Cliquez sur Réessayer pour provisionner à nouveau le même utilisateur, s’il a été ignoré ou a échoué. |
7 |
Cliquez sur Provisionner un autre utilisateur pour revenir à la page de provisionnement. |
8 |
Cliquez sur Terminé lorsque vous avez terminé. |
Importer les domaines vérifiés Entra ID vers Control Hub
Les clients peuvent avoir des centaines de domaines vérifiés dans Entra ID. Pendant qu’ils s’intègrent au Control Hub, s’ils souhaitent importer les domaines vérifiés d’Entra ID vers le Control Hub. Ceci peut économiser de nombreux efforts au cours du processus de maintenance ou d’installation.
1 |
Allez à la secion du domaine dans l’onglet Paramètres de l’organisation dans Control Hub. |
2 |
Cliquez sur Ajouter avec Entra ID. |
3 |
Dans la page Ajouter des domaines vérifiés , recherchez et sélectionnez les domaines à ajouter. |
4 |
Cliquez sur Ajouter. Les domaines verfiés apparaîtront dans la liste des domaines vérifiés.
|
Mappage des attributs de l’application de l’assistant Entra ID (Azure AD)
L’application de l’assistant Entra ID (Azure AD) peut prendre en charge et synchroniser toutes les modifications que vous apportez à vos expressions d’attributs. Par exemple, dans Entra ID, vous pouvez mapper le displayName
afin qu’il affiche à la fois les attributs surname
et givenName
. Ces modifications s’affichent dans l’application Assistant.
Vous trouverez plus d’informations sur le mappage des expressions d’attributs dans Entra ID sur le site d’aide Microsoft.
Utilisez le tableau suivant pour obtenir des informations sur les attributs Entra ID spécifiques.
Entra ID ne synchronise pas les valeurs nulles. Si vous définissez une valeur d'attribut sur null dans Entra ID, il n'est pas supprimé ou corrigé avec une valeur null dans Webex. Voir les limites sur le site d’aide Microsoft pour plus d’informations.
Attribut Entra ID (source) |
Attribut utilisateur Webex (cible) | Description |
---|---|---|
Nomprincipal de l’utilisateur |
Nom d’utilisateur |
Il s’agit de l’ID unique de l’utilisateur dans Webex. Il s’agit d’un courrier électronique formaté. |
Nom d'affichage |
Nom d'affichage |
Nom d’utilisateur qui s’affiche sur l’application Webex. |
Nom |
nom.nomdname |
|
Nom donné |
nom.givenName |
|
Objectid |
id externe |
Il s’agit de l’UID de l’utilisateur dans Entra ID. Généralement, c’est une chaîne de 16 octets. Nous vous recommandons de ne pas modifier ce mappage. |
Jobtitle |
titre |
|
UtilisationLocation |
adresses[type eq « work"].pays |
Nous vous recommandons d’utiliser le mappage de la fonction delocalisation aux adresses [type eq « work"].pays. Si vous choisissez un autre attribut, vous devez vous assurer que les valeurs d’attribut sont conformes aux normes. Par exemple, usa doit être USA. La Chine doit être un NC, etc. |
ville |
adresses[type eq « work"].localité |
|
Adresse postale |
adresses[type eq « work"].streetAddress |
|
État |
adresses[type eq « work"].région |
|
Code postal |
adresses[type eq « work"].code postal |
|
Numéro de téléphone |
Numéros de téléphone[typeq « work"].valeur |
|
mobile |
Numéros de téléphone[type eq « mobile"].valeur |
|
Numéro téléphonique du fax |
Numéros de téléphone[type eq « fax"].valeur |
|
manager |
manager |
Synchronise les informations du gestionnaire des utilisateurs avec Webex afin que les utilisateurs puissent toujours voir les informations correctes du gestionnaire sur la carte de contact d’un utilisateur. Lorsqu’un utilisateur est créé, Entra ID vérifie si l’objet gestionnaire de l’utilisateur est dans Webex Identity ou non. Si non, l'attribut du gestionnaire de l'utilisateur est ignoré. S'il existe un attribut manager, deux conditions doivent être remplies pour que l'attribut s'affiche sur la carte de contact de l'utilisateur :
Ces conditions vérifient la mise à jour de l'attribut du gestionnaire de l'utilisateur lorsque le jeton d'authentification d'un utilisateur a expiré. Les modifications apportées aux attributs du gestionnaire ne seront pas répercutées sur la carte de contact de l’utilisateur tant que l’utilisateur ne se connectera pas pour la première fois après la modification. |
FAQ
Comment puis-je migrer vers l’application de l’assistant Entra ID (Azure AD) à partir de la mise à disposition du Connecteur de répertoire Cisco ?
Lors de l’installation, l’application Assistant détecte si votre organisation utilise Directory Connector. Si elle est activée, une boîte de dialogue dans laquelle vous pouvez choisir d'utiliser Entra ID et de bloquer Directory Connector. Cliquez sur Bloquer pour confirmer que vous souhaitez continuer la configuration de l’application de l’assistant Entra ID (Azure AD).
Vous pouvez également choisir de désactiver le connecteur de répertoire avant de configurer l’application Assistant. Après la configuration, l’application Assistant gère les profils utilisateur. Cependant, l’application d’assistant gère uniquement les utilisateurs qui ont été ajoutés au périmètre de synchronisation ; vous ne pouvez pas utiliser l’application d’assistant pour gérer les utilisateurs synchronisés par Directory Connector qui ne faisaient pas partie du périmètre de synchronisation.
Puis-je configurer l’authentification unique avec Microsoft Entra ?
Vous pouvez configurer une intégration de l’authentification unique (SSO) entre une organisation cliente du Control Hub et un déploiement qui utilise Microsoft Entra ID comme fournisseur d’identité.
Quand est-ce que l’avatar de l’utilisateur est mis à jour dans Webex ?
Les avatars de l’utilisateur sont synchronisés avec Webex lorsque l’utilisateur est créé dans Webex Identity. Cette mise à jour repose sur l’avatar de l’utilisateur mis à jour dans Entra ID. L’application Assistant récupère ensuite le nouvel avatar à partir d’Entra ID.