Dans cet article
Résumé
Vue d'ensemble de l'architecture
Gestion des données
dropdown icon
Authentification et autorisation
    Autorisations accordées
    Autorisations consenties par l'utilisateur
    Autorisations de service
Intégration de Webex Video dans le centre d'administration Microsoft Entra
Documentation de référence supplémentaire

Référence d'intégration de Webex Video pour Microsoft Teams

list-menuDans cet article
list-menuUn commentaire ?

Résumé

L'intégration vidéo Webex pour Microsoft Teams permet aux appareils vidéo compatibles Cisco et SIP de participer aux réunions Microsoft Teams.

Voici comment l'intégration améliore l'expérience de l'utilisateur de l'appareil lorsqu'il participe à des réunions Microsoft Teams organisées dans votre organisation :

  • Expérience de réunion Webex : plusieurs écrans avec des options de mise en page flexibles

  • Liste des participants indiquant les participants à Microsoft et à l'intégration vidéo

  • Partage de contenu bidirectionnel entre l'appareil et Microsoft Teams

  • Indicateurs d'état de la réunion sur l'appareil, y compris l'enregistrement, la transcription et l'attente des participants dans le hall

Lorsque vous déployez l'intégration vidéo au service de calendrier hybride Webex, vos appareils vidéo bénéficient également de l'expérience de participation aux réunions simplifiée One Button to Push (OBTP).

Vue d'ensemble de l'architecture

Le programme Microsoft Cloud Video Interop (CVI) permet à des partenaires tels que Cisco de fournir des services qui associent des appareils vidéo aux réunions Microsoft Teams.

CVI Architecture image based on https://docs.microsoft.com/en-us/microsoftteams/cloud-video-interop
Architecture des solutions

Webex Video Integration pour Microsoft Teams est une solution tierce d'interopérabilité vidéo dans le cloud qualifiée Microsoft, basée sur la plateforme cloud Webex. Les fonctionnalités des partenaires CVI dans le cloud Webex sont disponibles partout où les appelants peuvent passer des appels interentreprises sur Internet public. Les services Webex courants fournissent l'administration, l'infrastructure d'appel, les systèmes de réponse vocale interactifs et les halls d'accueil. Les clusters de médias Webex situés dans le monde entier fournissent le transcodage, la traduction de protocoles et les rôles de Teams Bot.

Grâce à cette architecture, les appareils vidéo passent des appels vers des URI SIP spécifiques hébergés par Webex. Les services Webex répondent aux appels et les attribuent à des clusters de médias géographiquement pertinents qui fonctionnent sur Microsoft Azure. L'IVR collecte les informations sur les réunions si nécessaire, et le bot Media CVI de Microsoft Teams du cluster multimédia Webex établit la connexion à l'infrastructure de réunion Microsoft Teams. Les clusters multimédia fournissent la connectivité directe entre le participant connecté via Webex et le reste de la conférence organisée sur Microsoft Teams. L'ensemble de la solution fonctionne comme un service cloud.

L'intégration vidéo permet aux appareils de participer aux réunions Teams comme suit :

  • Si la réunion est activée pour le CVI, l'appareil peut y participer à l'aide de l'identifiant vidéo et de la clé du locataire.

  • Si la réunion n'est pas activée pour le CVI, l'appareil peut y participer en tant qu'invité (adhésion multilocataire) à l'aide de l'identifiant et du mot de passe de la réunion.

Vous pouvez améliorer l'expérience utilisateur en ajoutant d'autres services Webex. Par exemple, le service de calendrier hybride transmet automatiquement les détails de la réunion et simplifie les boutons de participation aux appareils vidéo au moment de rejoindre la réunion.

Gestion des données

L'intégration vidéo utilise les données suivantes pour connecter des appareils aux réunions Microsoft Teams et proposer des fonctionnalités pendant les réunions :

  • Enregistrement d'une application d'entreprise : pendant le provisionnement, un administrateur utilise l'application Webex Video Integration pour autoriser l'accès au client Microsoft de l'organisation à l'aide de l'API Microsoft Graph. Pour plus d'informations, consultez Webex Video Integration dans le centre d'administration Microsoft Entra.

  • Une « clé de locataire » provisionnée par WebEx : il s'agit d'une valeur par client qui est utilisée dans les adresses SIP lorsque l'appareil appelle le service VIMT.

  • ID de réunion : Microsoft Teams attribue cet identifiant lors de la création de la réunion et l'inclut dans l'invitation à la réunion.

    Les utilisateurs ont besoin de l'identifiant de réunion pour participer à des réunions depuis des clients Teams, ou via Direct Guest Join, ou via Cross-Tenant Join via le service VIMT.

    L'intégration vidéo utilise cet identifiant pour spécifier la réunion Microsoft Teams cible lors de l'adhésion entre locataires.

  • Code secret de la réunion : Microsoft Teams attribue un mot de passe sensible aux majuscules lors de la création de la réunion et l'inclut dans l'invitation à la réunion. Les utilisateurs ont besoin du code d'accès pour participer à une réunion à l'aide de l'identifiant de réunion.

    L'intégration vidéo utilise ce code d'accès pour accéder à la réunion Microsoft Teams cible lors de l'adhésion entre locataires.

  • Identifiant vidéo : Microsoft Teams attribue cet identifiant à une réunion lorsqu'elle est créée par un utilisateur compatible CVI. Microsoft Teams inclut l'identifiant vidéo dans l'invitation à la réunion.

    L'intégration vidéo utilise le Video ID et l'identifiant Microsoft du locataire du client pour obtenir l'URL de participation à la réunion via l'API Microsoft Graph.

    (Microsoft a modifié le libellé en « ID vidéo » au lieu de « ID de conférence VTC ».)

  • ID de locataire Microsoft du client : utilisé pour identifier l'organisation Microsoft cible lors de la communication avec l'API Microsoft Graph. Également utilisé dans l'interface administrative du service pour identifier le locataire Microsoft provisionné.

  • Noms de domaine vérifiés par Microsoft Tenant : utilisés comme étiquettes dans l'interface administrative du service pour identifier le locataire Microsoft provisionné.

  • Informations sur la réunion : lorsqu'un participant demande à participer à une réunion Microsoft Teams par le biais de l'intégration vidéo, le service récupère les informations relatives à cette réunion, y compris le sujet de la réunion, l'organisateur, la date/heure et les informations de connexion. Une fois connecté, le service récupère des informations en temps réel telles que les étiquettes des participants, leurs capacités et le statut des participants connectés à la réunion Teams à partir de l'API Microsoft Graph et les utilise pour faciliter la réunion en direct.

    Lorsque vous activez le service de calendrier hybride pour une boîte aux lettres, le service de calendrier utilise le lien Plus d'informations, situé dans le corps des entrées du calendrier qui l' incluent, pour identifier la « clé du locataire » et l'identifiant vidéo de la réunion.

  • Médias et contenus en temps réel : lorsqu'un participant rejoint une réunion Microsoft Teams par le biais de l'intégration vidéo, Webex et Microsoft Teams échangent du contenu audio et vidéo codé et du contenu à haute fréquence d'images pour permettre une expérience audio et vidéo bidirectionnelle entre eux.

Si vous déployez l'intégration vidéo avec le service de calendrier hybride, consultez également le service de calendrier hybride Webex avec Microsoft 365 Integration Reference.

Authentification et autorisation

Webex interagit avec votre environnement Microsoft Teams à l'aide de l'API Microsoft Graph. Le fournisseur d'identité Microsoft (IdP) basé sur le cloud gère l'authentification pour l'API Microsoft Graph. Les requêtes adressées à l'API Microsoft Graph sont autorisées en présentant des jetons au porteur émis par l'IdP Microsoft. Toutes les communications avec l'IdP Microsoft et l'API Graph utilisent des connexions Web sécurisées par TLS.

Pour interagir avec Microsoft Teams Media As a Service, vous enregistrez l'intégration vidéo Webex en tant que bot multimédia hébergé par une application et hébergé par un client Microsoft 365 géré par Cisco. Les robots Teams ont besoin d'une autorisation préalable pour pouvoir communiquer avec le client Microsoft 365 d'une organisation.

Lors de la configuration initiale, le service demande l'autorisation pour un ensemble d' autorisations prédéfini. Un administrateur autorise ces applications en suivant le flux de consentement décrit ci-dessous.

Une fois approuvé, le service Webex peut demander des jetons au porteur, avec les autorisations et le périmètre client appropriés, auprès de l'IdP Microsoft OAuth v2.0. Le service utilise les jetons porteurs pour autoriser les demandes adressées à l'API Microsoft Graph concernant les informations d'approvisionnement, les bilans de santé et le fonctionnement du bot Teams.

Autorisation et consentement de l'administrateur Microsoft

Les administrateurs de l'organisation ayant le rôle d'administrateur complet peuvent utiliser Control Hub pour configurer le service d'intégration vidéo pour leur organisation.

Le processus d'approvisionnement nécessite l'authentification et le consentement d'un administrateur global du client Microsoft 365 auquel appartiennent vos utilisateurs. Les autorisations d'application requises pour faire fonctionner le bot Teams ne peuvent être accordées que par un administrateur global du locataire Microsoft en utilisant le flux de consentement administratif suivant.

Le flux comprend les étapes de haut niveau suivantes :

  1. Connectez-vous à Control Hub, puis recherchez et lancez la configuration de l'intégration vidéo.

    pour les étapes de configuration détaillées, voir Déployer l'intégration vidéo Webex pour Microsoft Teams).

    Pendant le processus de configuration, votre navigateur est redirigé vers le cloud Microsoft pour authentification et consentement.

  2. Connectez-vous en tant qu'administrateur global pour le client Microsoft.

    L'application vous demande l'autorisation de :

    • Connectez-vous et lisez votre profil
    • Lire les paramètres RBAC du répertoire

    Cela permet à l'application de vérifier que votre compte est autorisé au sein de votre locataire à accorder les autorisations nécessaires.

  3. Passez en revue les autorisations demandées et cliquez sur Accepter. Vous n' avez pas besoin de vérifier le consentement au nom de votre organisation, car ce n'est pas obligatoire.

    L'application vous connecte et vérifie vos autorisations.

    Une fois que vous avez été autorisée, l'application vous invite à nouveau. Cette fois, l'invite vous indique les autorisations dont l'application a besoin pour connecter correctement des appareils vidéo à vos réunions Microsoft Teams.

    L'invite indique le nom de l'application, le domaine du fournisseur et les autorisations demandées.

  4. Cliquez sur Accepter pour accorder ces autorisations à l'application Webex Video Integration.

    Vous êtes redirigée vers Control Hub, où vous pouvez consulter les commandes PowerShell personnalisées dont vous avez besoin pour terminer la configuration de Microsoft Teams.

  5. Utilisez PowerShell pour terminer la configuration de Microsoft Teams, puis fermez le panneau Control Hub.

    Le processus de configuration teste un appel d'API Microsoft Graph pour l'organisation. En cas de succès, la configuration est terminée. Sinon, l'administrateur peut recommencer la procédure d'autorisation.

Autorisations accordées

L'intégration vidéo Webex pour Microsoft Teams nécessite des autorisations explicites auprès de votre client Microsoft. Ces autorisations ne sont pas personnalisables et sont automatiquement configurées par le processus de configuration dans Control Hub.

Deux ensembles d'autorisations distincts sont utilisés :

  • Un ensemble d'autorisations accordées par l'utilisateur et utilisées lors de la configuration pour vérifier les informations du locataire cible

  • Un ensemble d'autorisations accordées par l'administrateur à l'application d'entreprise de votre annuaire Entra. Ce kit permet au service d'accéder à votre environnement Microsoft Teams

Autorisations consenties par l'utilisateur

Lors de la configuration du service, nous demandons les autorisations suivantes à l' utilisateur connecté. Ils permettent d'accéder au locataire Microsoft pour vérifier les informations le concernant. Nous utilisons ces autorisations uniquement lorsque vous configurez l'intégration ; elles ne sont pas stockées.

Vous pouvez consulter ces autorisations accordées par l'utilisateur sur la page Autorisations de l'application, dans votre annuaire Entra.

Tableau 1. Les autorisations accordées par l'utilisateur et les raisons pour lesquelles le processus de configuration en a besoin
Autorisation requiseObjectif
« Connectez-vous et lisez le profil utilisateur » (User.read)Utilisé pour lire le profil de l'utilisateur connecté afin d'identifier son locataire.
« Lire les paramètres RBAC du répertoire » (RoleManagement.read.directory)Utilisé pour vérifier si l'utilisateur connecté est membre des groupes de sécurité d'administration bien connus d'Entra ID.
« Conservez l'accès aux données auxquelles vous leur avez donné accès » (offline_access)Permet au service de voir les données auxquelles vous lui avez donné accès sans que les utilisateurs soient connectés.

Autorisations de service

Le flux Microsoft Admin Consent accorde les autorisations suivantes à « l'intégration Cisco Webex vidéo pour l'application d'entreprise MS Teams » de votre locataire. Ces autorisations permettent au service Webex d'accéder à votre environnement Teams.

Les autorisations sont conservées pour l'application dans votre répertoire Entra jusqu'à ce que vous supprimiez le service Webex, qui supprime également l'application.

Tableau 2. Autorisations accordées par l'administrateur et pourquoi le service Webex en a besoin

Autorisation

Utilisation

Domaines de lecture (Domain.Read.All)

Permet au service de lire les noms de domaine vérifiés du locataire. Control Hub utilise les noms de domaine pour identifier le locataire auquel le service est lié.

Lancer des appels individuels sortants depuis l'application (Calls.Initiate.All)

Permet au bot de passer des appels aux utilisateurs de Microsoft Teams. (Réservé pour une utilisation future.)

Lancer des appels de groupe sortants depuis l'application (Calls.InitiateGroupCall.all)

Permet au bot de passer des appels à un groupe d'utilisateurs de Microsoft Teams. (Réservé pour une utilisation future.)

Participez à des appels et à des réunions de groupe via une application (Calls.JoinGroupCall.all)

Permet au bot de participer à des appels de groupe et à des réunions planifiées dans votre organisation avec les privilèges d'un utilisateur de l'annuaire. Utilisé pour rejoindre des participants autorisés à contourner le lobby de Microsoft Teams.

Participez à des appels de groupe et à des réunions en tant qu'invitée (Calls.JoinGroupCallasGuest.all)

Permet au bot de participer à des appels de groupe et à des réunions programmées dans votre organisation en tant qu'invité. Utilisé pour rejoindre des participants qui ne sont pas autorisés à contourner le lobby de Microsoft Teams.

Accédez aux flux multimédia via un appel en tant qu'application (Calls.AccessMedia.all)

Permet au bot d'accéder directement aux flux multimédia lors d'un appel, sans qu'un utilisateur soit connecté.

Lire les détails des réunions en ligne (OnlineMeetings.Read.all)

Permet au service de lire les informations relatives aux réunions en ligne au sein de votre organisation. Utilisé pour rechercher et résoudre les identifiants de conférence VTC pour les réunions Microsoft Teams.

Connectez-vous et lisez le profil utilisateur (User.read)

Obligatoire pour les autres autorisations répertoriées. L'intégration ne l'utilise pas directement.

Référence des autorisations Microsoft Graph : https://docs.microsoft.com/en-us/graph/permissions-reference

Présentation de Microsoft Meeting Bots : https://docs.microsoft.com/en-us/microsoftteams/platform/bots/calls-and-meetings/calls-meetings-bots-overview

Accès aux réunions

Les participants qui se connectent via l'intégration vidéo sont normalement traités comme des utilisateurs invités aux réunions Microsoft Teams et peuvent être placés dans un hall (salle d'attente). Un utilisateur de Microsoft Teams doit admettre manuellement un participant qui se trouve dans le hall pour que celui-ci puisse entendre ou voir les autres participants.

Vous pouvez contrôler le comportement du lobby de Microsoft Teams grâce aux règles de réunion définies par un administrateur dans Microsoft Teams et aux options de réunion définies par l'organisateur de la réunion. Par défaut, les utilisateurs invités de Microsoft Teams doivent utiliser le lobby. Pour plus d'informations sur les politiques relatives aux réunions de Teams, voir Gérer les politiques des réunions dans Teams.

Si la participation des utilisateurs anonymes à une réunion est désactivée, seuls les participants de confiance autorisés à contourner le lobby peuvent rejoindre la réunion grâce à l'intégration vidéo Webex.

Les participants qui utilisent l'adhésion interlocataire (y compris en utilisant le numéro de réunion et le code d'accès) s'inscrivent toujours en tant qu'invités. Ces tentatives de participation échouent si l'organisation qui organise la réunion a désactivé la possibilité pour les utilisateurs anonymes de participer à une réunion.

Lobby Bypass pour les participants de confiance

Les participants qui se connectent à l'intégration vidéo en utilisant les méthodes suivantes sont traités comme des participants de confiance et rejoignent les réunions Microsoft Teams sans être placés dans un lobby :

  • Appareils enregistrés auprès de votre organisation Webex en tant qu'appareils enregistrés

  • Appels depuis des domaines SIP qui ont été ajoutés et vérifiés comme appartenant à votre organisation dans Control Hub

Les participants fiables sont traités comme des participants au sein de votre organisation. Les participants qui se connectent par ces voies fiables peuvent contourner le lobby si l'organisateur a restreint les paramètres du lobby des réunions Teams. Si le Who peut contourner le lobby ? l'option de réunion est réglée sur « Les organisateurs et moi » ou « Les personnes que j'invite », les participants fiables qui tentent de participer sont ignorés et tous les appelants VIMT sont redirigés vers le hall de réunion de Teams lorsqu'ils rejoignent une réunion.

Les participants qui utilisent l'adhésion interlocataire (y compris en utilisant le numéro de réunion et le code d'accès) s'inscrivent toujours en tant qu'invités. Cela signifie que même les participants de confiance qui s'inscrivent de cette manière doivent attendre dans le hall pour être admis par l'hôte.

Pour plus d'informations sur l'ajout et la vérification de domaines SIP, voir Processus de vérification des domaines pour les appareils vidéo SIP.

Intégration de Webex Video dans le centre d'administration Microsoft Entra

Aucune maintenance n'est requise pour l'application une fois que vous avez autorisé le service d'intégration vidéo à accéder à votre client Microsoft 365. Vous pouvez vérifier sa présence et sa portée dans la liste des applications d'entreprise du centre d'administration Microsoft Entra.

Aucune application physique ni aucun logiciel ne s'exécute dans votre locataire dans le cadre de cette intégration. L'entrée de l'application d' entreprise sert de définition et d'espace réservé à l' autorisation accordée à l'identité de l'application Webex.

Cliquez sur le nom de l'application, puis sur Autorisations pour voir les autorisations accordées à l'application pour le locataire.

Cet article était-il utile ?
Cet article était-il utile ?