- Главная
- /
- Статья
Благодарим вас за обратную связь.
Справочник по интеграции Webex Video для Microsoft Teams
В этой статье
Отправить обратную связь?Сводка
Интеграция видео Webex для Microsoft Teams позволяет видеоустройствам с поддержкой Cisco и SIP присоединяться к совещаниям Microsoft Teams.
Вот как эта интеграция повышает удобство работы пользователей устройств при участии в совещаниях Microsoft Teams, проводимых в вашей организации:
-
Интерфейс совещаний Webex — многоэкранный режим с гибкими вариантами компоновки
-
Список участников, в котором указаны участники Microsoft и интеграции видео
-
Двунаправленный обмен контентом между устройством и Microsoft Teams
-
Индикаторы состояния собрания на устройстве, включая запись, расшифровку и ожидание участников в холле
При развертывании интеграции видео со службой гибридных календарей Webex ваши видеоустройства также получат упрощенный интерфейс присоединения к совещаниям нажатием одной кнопки (OBTP).
Обзор архитектуры
Программа Microsoft Cloud Video Interop (CVI) позволяет таким партнерам, как Cisco, предоставлять услуги по подключению видеоустройств к совещаниям Microsoft Teams.
Webex Video Integration для Microsoft Teams — это сертифицированное корпорацией Майкрософт стороннее решение Cloud Video Interop, построенное на облачной платформе Webex. Возможности партнеров CVI в облаке Webex доступны везде, где абоненты могут звонить в общедоступный Интернет для деловых звонков. Распространенные сервисы Webex обеспечивают администрирование, инфраструктуру вызовов, интерактивные системы голосового ответа и лобби. Мультимедийные кластеры Webex, расположенные по всему миру, обеспечивают транскодирование, перевод протоколов и роли ботов Teams.
Благодаря этой архитектуре видеоустройства совершают вызовы на определенные URI SIP, размещенные в Webex. Сервисы Webex отвечают на вызовы и назначают их географически релевантным мультимедийным кластерам, работающим в Microsoft Azure. При необходимости IVR собирает сведения о собрании, а бот Microsoft Teams Media CVI в медиакластере Webex обеспечивает подключение к инфраструктуре совещаний Microsoft Teams. Мультимедийные кластеры обеспечивают прямую связь между участником, подключенным через Webex, и остальной частью конференции, организованной в Microsoft Teams. Все решение работает как облачный сервис.
Интеграция видео позволяет устройствам присоединяться к совещаниям Teams следующим образом:
-
Если к собранию включена поддержка CVI, устройство может присоединиться, используя идентификатор видео и ключ арендатора.
-
Если конференция не включена для CVI, устройство может присоединиться к ней в качестве гостя (межпользовательское присоединение), используя идентификатор собрания и пароль.
Можно улучшить пользовательский интерфейс, добавив другие сервисы Webex. Например, служба гибридного календаря автоматически передает сведения о совещании и упрощенные кнопки «Присоединиться» на видеоустройства, когда приходит время присоединиться к совещанию.
Обработка данных
Интеграция видео использует следующие данные для подключения устройств к совещаниям Microsoft Teams и предоставления функций во время совещаний:
-
Регистрация корпоративных приложений. Во время подготовки администратор использует приложение Webex Video Integration для предоставления разрешений на доступ клиенту Microsoft организации при использовании Microsoft Graph API. Дополнительные сведения см. в разделе Интеграция видео Webex в Центре администрирования Microsoft Entra.
-
«Ключ клиента», предоставленный Webex: это значение для каждого клиента, которое используется в адресах SIP при вызове устройства в службу VIMT.
-
Идентификатор совещания: Microsoft Teams присваивает этот идентификатор при создании совещания и включает его в приглашение на собрание.
Пользователям нужен идентификатор совещания, чтобы присоединиться к совещаниям клиентов Teams, путем прямого гостевого присоединения или межпользовательского присоединения к сервису VIMT.
Интеграция видео использует этот идентификатор для указания целевого совещания Microsoft Teams во время межпользовательского присоединения.
-
Пароль к собранию. При создании совещания Microsoft Teams присваивает пароль, учитывающий регистр символов, и включает его в приглашение на собрание. Пользователям нужен пароль, чтобы присоединиться к совещанию с идентификатором совещания.
Интеграция видео использует этот пароль для доступа к целевому совещанию Microsoft Teams во время межпользовательского присоединения.
-
Идентификатор видео: Microsoft Teams присваивает этот идентификатор совещанию, когда оно создается пользователем с поддержкой CVI. Microsoft Teams включает идентификатор видео в приглашение на собрание.
Интеграция видео использует идентификатор видео и идентификатор клиента Microsoft для получения URL-адреса для присоединения к совещанию из Microsoft Graph API.
(Корпорация Майкрософт заменила название «Идентификатор конференции VTC» на «Идентификатор видеозаписи»).
-
Идентификатор арендатора Microsoft клиента: используется для идентификации целевой организации Microsoft при взаимодействии с Microsoft Graph API. Также используется в административном интерфейсе службы для идентификации предоставленного клиента Microsoft.
-
Доменные имена, проверенные арендаторами Microsoft: используются в качестве меток в административном интерфейсе службы для идентификации предоставленного клиента Microsoft.
-
Информация о совещании: когда участник запрашивает участие в собрании Microsoft Teams с помощью интеграции видео, служба получает сведения об этом совещании, включая тему совещания, организатора, дату и время и сведения о подключении. После подключения сервис в режиме реального времени получает информацию об участниках, их возможностях и статусе участников, подключенных к совещанию Teams, из API Microsoft Graph и использует их для облегчения проведения совещания в реальном времени.
Когда вы включаете службу гибридного календаря для почтового ящика, служба календаря использует ссылку «Дополнительная информация», расположенную в самом тексте записей календаря, чтобы идентифицировать «ключ клиента» совещания и идентификатор видео.
-
Медиафайлы и контент в реальном времени. Когда участник присоединяется к совещанию Microsoft Teams с помощью интеграции видео, Webex и Microsoft Teams обмениваются закодированным аудио, видео и контентом с высокой частотой кадров, чтобы обеспечить двустороннее воспроизведение аудио и видео.
Если вы развертываете интеграцию видео со службой гибридных календарей, ознакомьтесь также со справочником по гибридной службе календарей Webex с Microsoft 365.
Аутентификация и авторизация
Webex взаимодействует со средой Microsoft Teams с помощью API Microsoft Graph. Облачный поставщик удостоверений Microsoft (IdP) отвечает за аутентификацию в API Microsoft Graph. Запросы к Microsoft Graph API авторизуются путем предоставления токенов на предъявителя, выпущенных Microsoft IdP. Вся связь с Microsoft IdP и Graph API использует веб-соединения, защищенные TLS.
Чтобы работать с медиафайлами Microsoft Teams как с сервисом, вы регистрируете интеграцию видео Webex в качестве мультимедийного бота, размещенного в приложении, размещенном в клиенте Microsoft 365 под управлением Cisco. Для связи с клиентом Microsoft 365 организации ботам Teams требуется предварительное разрешение.
Во время первоначальной настройки служба запрашивает авторизацию для предварительно определенного набора разрешений. Администратор предоставляет этим приложениям разрешения, следуя процедуре получения согласия , описанной ниже.
После одобрения служба Webex может запросить у Microsoft OAuth 2.0 IdP токены на предъявителя с правильными разрешениями и областью действия клиента. Служба использует токены на предъявителя для авторизации запросов к API Microsoft Graph на предоставление сведений, проверку работоспособности и работу бота Teams.
Авторизация и согласие администратора Microsoft
Администраторы организации с ролью полного администратора могут использовать Control Hub для настройки службы интеграции видео в своей организации.
Процесс подготовки требует аутентификации и согласия глобального администратора арендатора Microsoft 365, к которому принадлежат ваши пользователи. Разрешения приложения, необходимые для работы бота Teams, могут быть предоставлены только глобальным администратором клиента Microsoft, используя следующую последовательность разрешений администратора.
Этот процесс включает следующие высокоуровневые шаги:
-
Войдите в Control Hub, затем найдите и запустите настройку интеграции видео.
подробные инструкции по настройке см. в разделе Развертывание интеграции видео Webex для Microsoft Teams).
В процессе настройки браузер перенаправляется в облако Microsoft для аутентификации и получения согласия.
-
Войдите в систему в качестве глобального администратора для клиента Microsoft.
Приложение запрашивает ваше разрешение на следующее:
- Войдите в систему и прочитайте свой профиль
- Прочитайте настройки каталога RBAC
Это необходимо для того, чтобы приложение могло подтвердить, что ваша учетная запись авторизована арендатором для предоставления необходимых разрешений.
-
Ознакомьтесь с запрошенными разрешениями и нажмите «Принять». Вам не нужно проверять согласие от имени вашей организации, так как это не обязательно.
Приложение регистрирует вас и проверяет ваши разрешения.
После успешной авторизации приложение снова запросит вас. На этот раз в командной строке отображаются разрешения, необходимые приложению для успешного подключения видеоустройств к совещаниям Microsoft Teams.
В командной строке указаны имя приложения, домен поставщика и запрошенные разрешения.
-
Нажмите кнопку «Принять», чтобы предоставить эти разрешения приложению Webex Video Integration.
Вы будете перенаправлены обратно в Control Hub, где вы увидите специализированные команды PowerShell, необходимые для завершения настройки Microsoft Teams.
-
Используйте PowerShell для завершения настройки Microsoft Teams, затем закройте панель Control Hub.
В процессе настройки тестируется вызов Microsoft Graph API для организации. В случае успеха настройка завершена. В противном случае администратор может снова попробовать процесс авторизации.
Разрешения предоставлены
Интеграция видео Webex для Microsoft Teams требует явных разрешений в вашем клиенте Microsoft. Эти разрешения нельзя настраивать, они автоматически настраиваются в процессе установки в Control Hub.
Используются два отдельных набора разрешений:
-
Набор одобренных пользователем разрешений, используемых во время настройки для проверки информации о целевом арендаторе
-
Набор разрешений, предоставленных корпоративному приложению в каталоге Entra с согласия администратора. Этот набор позволяет службе получать доступ к вашей среде Microsoft Teams
Разрешения, согласованные пользователем
Во время настройки сервиса мы запрашиваем у вошедшего пользователя следующие разрешения. Они предоставляют клиенту Microsoft доступ к проверке информации о целевом арендаторе. Мы используем эти разрешения только во время настройки интеграции; они не сохраняются.
Ознакомиться с этими разрешениями, согласованными пользователем, можно на странице « Разрешения» приложения в каталоге Entra.
| Требуется разрешение | Назначение |
|---|---|
| «Войдите и прочитайте профиль пользователя» (User.read) | Используется для чтения профиля вошедшего пользователя для идентификации арендатора пользователя. |
| «Чтение настроек каталога RBAC» (RoleManagement.read.Directory) | Используется для проверки того, является ли зарегистрированный пользователь членом известных групп безопасности администраторов в Entra ID. |
| «Сохраняйте доступ к данным, к которым вы ему предоставили доступ» (offline_access) | Позволяет сервису просматривать данные, к которым вы предоставили доступ, без входа пользователей в систему. |
Разрешения на обслуживание
Процесс получения согласия администраторов Microsoft предоставляет вашему арендатору следующие разрешения для приложения «Интеграция Cisco Webex видео для корпоративного приложения MS Teams». Эти разрешения позволяют сервису Webex получать доступ к вашей среде Teams.
Разрешения сохраняются в приложении в каталоге Entra до тех пор, пока вы не удалите сервис Webex, который также удалит приложение.
|
Разрешение |
Использование |
|---|---|
|
Чтение доменов (Domain.Read.All) |
Позволяет сервису считывать проверенные доменные имена арендатора. Control Hub использует доменные имена для идентификации арендатора, с которым связана служба. |
|
Инициируйте исходящие вызовы «один на один» из приложения (Calls.Initiate.All) |
Позволяет боту создавать звонки пользователям Microsoft Teams. (Зарезервировано для использования в будущем.) |
|
Инициируйте исходящие групповые вызовы из приложения (Calls.initiategroupCall.all) |
Позволяет боту создавать звонки группе пользователей Microsoft Teams. (Зарезервировано для использования в будущем.) |
|
Присоединяйтесь к групповым звонкам и встречам в виде приложения (Calls.joinGroupCall.all) |
Позволяет боту присоединяться к групповым звонкам и запланированным встречам в вашей организации с привилегиями пользователя каталога. Используется для присоединения к участникам, которым разрешено обходить лобби Microsoft Teams. |
|
Присоединяйтесь к групповым звонкам и встречам в качестве гостя (Calls.joinGroupCallasGuest.all) |
Позволяет боту присоединяться к групповым звонкам и запланированным встречам в вашей организации в качестве гостя. Используется для присоединения к участникам, которым не разрешено обходить лобби Microsoft Teams. |
|
Получайте доступ к медиапотокам в режиме вызова в виде приложения (Calls.accessMedia.all) |
Позволяет боту получать прямой доступ к медиапотокам во время разговора без авторизованного пользователя. |
|
Ознакомьтесь с подробностями онлайн-встречи (OnlineMeetings.Read.all) |
Позволяет сервису читать сведения об онлайн-собраниях в вашей организации. Используется для поиска и сопоставления идентификаторов конференций VTC с совещаниями Microsoft Teams. |
|
Войдите в систему и прочитайте профиль пользователя (User.READ) |
Требуется для других перечисленных разрешений. Интеграция не использует его напрямую. |
Справочник по разрешениям Microsoft Graph: https://docs.microsoft.com/en-us/graph/permissions-reference
Обзор ботов Microsoft для собраний: https://docs.microsoft.com/en-us/microsoftteams/platform/bots/calls-and-meetings/calls-meetings-bots-overview
Доступ к собраниям
Участники, подключающиеся с помощью интеграции видео, обычно рассматриваются как гостевые пользователи собраний Microsoft Teams, и их можно разместить в холле (зале ожидания). Пользователь Microsoft Teams должен вручную допустить присутствующего в лобби участника, прежде чем он услышит или увидит других участников.
Управлять поведением в лобби Microsoft Teams можно с помощью политик собраний, установленных администратором Microsoft Teams, и опций собраний, установленных организатором собрания. По умолчанию гостевые пользователи Microsoft Teams должны пользоваться лобби. Дополнительные сведения о политиках собраний Teams см. в разделе Управление политиками собраний в Teams.
Если возможность участия анонимных пользователей в совещании отключена, только доверенные участники, которым разрешено обойти лобби, могут присоединиться к совещанию с помощью интеграции видео Webex.
Участники, использующие межпользовательское присоединение (включая использование идентификатора совещания и пароля), всегда присоединяются в качестве гостей. Эти попытки присоединиться не увенчаются успехом, если организация, проводящая собрание, запретила анонимным пользователям присоединяться к совещанию.
Обойти лобби для доверенных участников
Участники, подключившиеся к интеграции видео следующими способами, считаются доверенными участниками и присоединяются к совещаниям Microsoft Teams без помещения в лобби:
-
Устройства, зарегистрированные в вашей организации Webex как устройства, зарегистрированные в Webex
-
Вызов с доменов SIP, которые были добавлены и подтверждены как принадлежащие вашей организации в Control Hub
Доверенные участники рассматриваются как участники вашей организации. Участники, подключающиеся по этим надежным каналам, могут обойти лобби, если организатор ограничил настройки фойе собраний Teams. Если «Кто» может обойти лобби? Опция «Организаторы и я» или «Приглашенные мной люди», доверенные участники, пытающиеся присоединиться к совещанию, игнорируются, а все абоненты VIMT при присоединении к совещанию попадают в фойе собрания Teams.
Участники, использующие межпользовательское присоединение (включая использование идентификатора совещания и пароля), всегда присоединяются в качестве гостей. Это означает, что даже доверенные участники, присоединившиеся таким образом, должны дождаться приема организатора в фойе.
Дополнительные сведения о добавлении и проверке доменов SIP см. в разделе Процесс проверки домена для видеоустройств SIP.
Интеграция видео Webex в центре администрирования Microsoft Entra
После того как вы разрешили службе интеграции видео получить доступ к клиенту Microsoft 365, обслуживание приложения не требуется. Проверить наличие и область действия приложения можно в списке корпоративных приложений в Центре администрирования Microsoft Entra.
В рамках этой интеграции в вашем клиенте не запускается ни одно физическое приложение или программное обеспечение. Запись корпоративного приложения служит определением и заменителем авторизации, предоставленной идентификатору приложения Webex.
Нажмите на имя приложения, затем нажмите Разрешения, чтобы увидеть разрешения , которые приложение имеет в клиенте.
