- Начало
- /
- Статия
Благодарим за обратната връзка.
Webex Видео интеграция за Microsoft Teams integration reference
В тази статия
Обратна връзка?Обобщена информация
Webex Видео интеграция за Microsoft Teams позволява на Cisco и SIP-поддържащи видео устройства да се присъединяват към Microsoft Teams срещи.
Ето как интеграцията подобрява изживяването на потребителя на устройството, когато се присъединява към Microsoft Teams срещи, организирани във вашата организация:
-
Webex преживяване на срещи — мултиекран с гъвкави опции за оформление
-
Списък с участници, показващ както Microsoft, така и участници в интеграцията на видео
-
Двупосочно споделяне на съдържание между устройството и Microsoft Teams
-
Индикатори за статус на срещата на устройството, включително запис, транскрипция и чакане на участници във фоайето
Когато внедрявате видео интеграцията с Webex Hybrid Calendar Service, вашите видео устройства получават и опростеното изживяване One Button to Push (OBTP) при присъединяване към срещи.
Преглед на архитектурата
Програмата Microsoft Cloud Video Interop (CVI) позволява на партньори като Cisco да предоставят услуги, които свързват видео устройства с Microsoft Teams срещи.
Webex Video Integration за Microsoft Teams е Microsoft квалифицирано решение за облачно видео взаимодействие, базирано на облачната платформа Webex. Партньорските възможности на CVI в облака Webex са налични Anywhere обаждащите се могат да правят бизнес към бизнес обаждания към публичния интернет. Обичайните Webex услуги предоставят администрация, инфраструктура за обаждания, Interactive Voice Response системи и лобита. Webex медийните клъстери, разположени по целия свят, предоставят транскодиране, преводи на протоколи и ролите на Teams Bot.
С тази архитектура видео устройствата правят повиквания към конкретни SIP URI, хоствани от Webex. Webex Services отговаря на повикванията и ги присвоява на географски релевантни медийни клъстери, работещи в Microsoft Azure. IVR събира детайли за срещите при нужда, а Microsoft Media CVI ботът на Teams в медийния клъстер Webex прави връзката с инфраструктурата за срещи Microsoft Teams. Медийните клъстери осигуряват последователна свързаност между участника, свързан чрез Webex, и останалата част от конференцията, организирана в Microsoft Teams. Цялото решение работи като облачна услуга.
Видео интеграцията позволява на устройствата да се присъединяват към срещи в Teams по следния начин:
-
Ако срещата е активирана за CVI, устройството може да се присъедини чрез Video ID и ключа за наемателя.
-
Ако срещата не е активирана за CVI, устройството може да се присъедини като гост (присъединяване между наематели) чрез Meeting ID и парола.
Можете да подобрите потребителското изживяване, като добавите други Webex услуги. Например, Хибридната календарна услуга автоматично изпраща детайли за срещи и опростени бутони за присъединяване към видео устройствата, когато дойде време за присъединяване към срещата.
Обработка на данни
Видео интеграцията използва следните данни за свързване на устройства с Microsoft Teams срещи и предоставяне на функции по време на срещи:
-
Регистрация на корпоративно приложение: По време на предоставянето администратор използва приложението Webex Video Integration, за да предостави разрешения за достъп до Microsoft tenant на организацията при използване на Microsoft Graph API. За повече информация вижте Webex Интеграция на видео в администраторския център Microsoft Entra.
-
Webex-предоставен "tenant key": Това е стойност за клиент, която се използва в SIP адреси, когато устройството се обажда към VIMT услугата.
-
Среща ID: Microsoft Teams присвоява този идентификатор при създаването на срещата и го включва в поканата за срещата.
Потребителите се нуждаят от Meeting ID, за да се присъединят към срещи от клиенти на Teams, или чрез директно присъединяване към гост, или чрез Cross-Tenant с VIMT услугата.
Видео интеграцията използва този ID, за да специфицира целевата среща Microsoft Teams по време на Cross-Tenant join.
-
Парола за среща: Microsoft Teams присвоява код, чувствителен към регистри, при създаването на срещата, и я включва в поканата за срещата. Потребителите се нуждаят от парола, за да се присъединят към среща с Meeting ID.
Видео интеграцията използва този код за достъп до целевата среща Microsoft Teams по време на присъединяване към Cross-Tenant.
-
Видео ID: Microsoft Teams присвоява този идентификатор на среща, когато тя е създадена от потребител с поддръжка на CVI. Microsoft Teams включва видеото ID в поканата за срещата.
Интеграцията на видео използва Video ID и наемателя Microsoft на клиента ID, за да получи URL адреса за присъединяване към срещата от графика Microsoft API.
(Microsoft обнови етикета на "Video ID" от "VTC conference ID".)
-
Клиентът Microsoft наемател ID: Използва се за идентифициране на целевата Microsoft организация при комуникация с графиката Microsoft API. Също така се използва в административния интерфейс на услугата за идентифициране на предоставения Microsoft tenant.
-
Microsoft домейн имена, проверени от наематели: Използват се като етикети в административния интерфейс на услугата за идентифициране на предоставения Microsoft наемател.
-
Информация за срещата: Когато участник поиска да се присъедини към Microsoft Teams среща чрез видео интеграция, услугата получава подробности за тази среща, включително темата, организатора, дата/час и детайли за връзката. След като се свърже, услугата получава информация в реално време като етикети на участниците, възможности и статус на участниците, свързани с Teams срещата, от графика Microsoft API и ги използва за улесняване на живата среща.
Когато активирате Хибридната календарна услуга за пощенска кутия, услугата използва линка Повече информация , намираща се в тялото на записите в календара, които я включват, за да идентифицира "наемателния ключ" на срещата и видео ID.
-
Медии и съдържание в реално време: Когато участник се присъедини към Microsoft Teams среща чрез видео интеграция, Webex и Microsoft Teams обменят кодирани аудио, видео и високочестотни кадрови програми, за да осигурят двупосочно аудио и видео изживяване между тях.
Ако внедрявате видео интеграцията с Hybrid Calendar Service, вижте също Hybrid Calendar Service Webex с Microsoft 365 Integration Reference.
Удостоверяване и упълномощаване
Webex взаимодейства с твоята Microsoft Teams среда, използвайки Microsoft Graph API. Облачният доставчик на идентичност Microsoft (IdP) обработва автентикацията за графа Microsoft API. Заявките към графа Microsoft API се разрешават чрез представяне на носещи токени, издадени от Microsoft IdP. Цялата комуникация към Microsoft IdP и графа API използва уеб връзки, защитени с TLS.
За да взаимодействате с Microsoft Teams media като услуга, регистрирате видео интеграцията Webex като медиен бот, хостван от приложение, базиран в Microsoft 365 наемател, управляван от Cisco. Ботовете на Teams изискват предварително одобрение, за да могат да комуникират с наемателя Microsoft 365 на организацията.
По време на първоначалната конфигурация услугата иска разрешение за предварително зададен набор от разрешения. Администраторът предоставя тези разрешения за кандидатстване, следвайки описания по-долу поток на съгласие.
След одобрение, услугата Webex може да поиска носителски токени с правилните права и обхват на клиента от Microsoft OAuth v2.0 IdP. Услугата използва носителските токени, за да упълномощава заявки към Microsoft Graph API за предоставяне на детайли, здравни проверки и работа на бота Teams.
Авторизация и Microsoft съгласие на администратора
Администраторите на организации с ролята Пълен администратор могат да използват Control Hub, за да настроят услугата за интеграция на видео за своята организация.
Процесът на предоставяне изисква автентикация и съгласие от глобален администратор на Microsoft 365 наемател, към който принадлежат вашите потребители. Разрешенията за приложения, необходими за работа на бота Teams, могат да бъдат предоставени само от глобален администратор на Microsoft наемателя чрез следния поток на съгласие от администратора.
Потокът включва следните високи стъпки:
-
Влез в Control Hub, след това намери и стартирай настройката за видео интеграция.
за подробни стъпки при настройка вижте Deploy Webex Video Integration for 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 tenant. Тези права не могат да се персонализират и се конфигурират автоматично от процеса на настройка в Control Hub.
Използват се два отделни набора от разрешения:
-
Набор от разрешения, одобрени от потребителя, използвани по време на настройката за проверка на информацията за целевия наемател
-
Набор от разрешения, предоставени от съгласието на администратора за Enterprise Application във вашата директория Entra. Този набор позволява на услугата да достъпва вашата Microsoft Teams среда
Разрешения, одобрени от потребителя
По време на настройката на услугата искаме следните разрешения от влязъл потребител. Те позволяват достъп до наемателя Microsoft, за да се провери информацията за целевия наемател. Използваме тези права само докато настройвате интеграцията; те не се съхраняват.
Можете да прегледате тези разрешения с одобрение на потребителя на страницата с разрешения на приложението във вашата директория Entra.
| Изисква се разрешение | Предназначение |
|---|---|
| "влезте и прочетете потребителския профил" (User.read) | Използваше се за четене на профила на влязъл потребител, за да се идентифицира наемателят му. |
| "Прочетете настройките на директорията RBAC" (RoleManagement.Read.Directory) | Използва се за проверка дали влязълият потребител е член на добре познатите администраторски групи за сигурност в Entra ID. |
| "Поддържай достъп до данни, до които си му дал достъп" (offline_access) | Позволява на услугата да вижда данните, до които сте ѝ дали достъп, без потребителите да са влезли. |
Разрешения за услуги
Потокът Microsoft Admin Consent предоставя следните права на "Cisco Webex Video Integration for MS Teams Enterprise Application" във вашия наемател. Тези права позволяват на услугата Webex да достъпва вашата Teams среда.
Разрешенията остават с приложението в директорията Entra, докато не премахнете услугата Webex, която също премахва приложението.
|
Разрешение |
Използване |
|---|---|
|
Прочетете домейни (Domain.Read.All) |
Позволява на услугата да чете проверените домейн имена на наемателя. Control Hub използва домейните имена, за да идентифицира наемателя, към който услугата е свързана. |
|
Инициирайте изходящи 1-на-1 обаждания от приложението (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 Conference ID към Microsoft Teams срещи. |
|
влезте и прочетете потребителския профил (User.read) |
Необходимо е за другите изброени разрешения. Интеграцията не го използва директно. |
Microsoft Справочник за графови разрешения: 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.
Ако анонимните потребители могат да се присъединят към среща е изключена, само доверени участници, които имат право на заобикаляне на лоби (lobby bypass), могат да се присъединят към срещата чрез видео интеграцията Webex.
Участниците, които използват присъединяване между наематели (включително използване на Meeting ID и парола), винаги се присъединяват като Гости. Тези опити за присъединяване се провалят, ако организацията, която организира срещата, е изключила анонимните потребители, които могат да се присъединят към среща.
Заобикаляне на лобито за доверени участници
Участниците, които се свързват с видео интеграцията чрез следните методи, се третират като доверени и се присъединяват към срещите на Microsoft Teams без да бъдат поставени в лоби:
-
Устройства, регистрирани във вашата Webex организация като устройства, регистрирани в Webex
-
Обаждане от SIP домейни, които са добавени и потвърдени като собственост на вашата организация в Control Hub
Доверените участници се третират като участници във вашата организация. Участниците, които се свързват по тези доверени пътища, могат да заобиколят лобито, ако организаторът е ограничил настройките на Teams за срещи. Ако Кой може да заобиколи лобито? Опцията за среща е зададена на "Организатори и аз" или "Хора, които каня", доверените участници, които се опитват да се присъединят, се игнорират, а всички VIMT обаждащи се се поставят в лобито на Teams при присъединяване към среща.
Участниците, които използват присъединяване между наематели (включително Meeting ID и парола), винаги се присъединяват като Гости. Това означава, че дори доверените участници, които се присъединяват по този начин, трябва да изчакат в лобито, за да бъдат допуснати от домакина.
За повече информация относно добавянето и проверката на домейните SIP, вижте Процес на верификация на домейн за видео устройства SIP.
Webex Интеграция на видео в Microsoft Entra admin center
Няма изискване за поддръжка на приложението след като сте упълномощили услугата за интеграция на видео да достъпва вашия наемател Microsoft 365. Можете да проверите присъствието и обхвата му в списъка с приложения за Enterprise в Microsoft Entra admin center.
Нито едно физическо приложение или софтуер не работи във вашия наемател като част от тази интеграция. Записът за корпоративно приложение служи като дефиниция и заместител за разрешението, дадено на идентичността на приложението Webex.
Кликнете върху името на приложението, след това изберете Разрешения , за да видите разрешенията, които приложението има в наемателя.
