摘要

Webex Video Integration for Microsoft Teams允许支持Cisco和SIP的视频设备加入Microsoft Teams会议。

以下是该集成如何增强设备用户加入在组织中主持的 Microsoft Teams 会议时的体验:

  • Webex会议体验 - 具有灵活的布局选项的多屏幕

  • 同时显示 Microsoft 和视频集成参加者的参加者列表

  • 设备和 Microsoft Teams 内容共享双向连接

  • 设备上的会议状态指示器,包括录制、转录和在大厅等候的与会者

当您部署与Webex混合日历服务的视频集成时,您的视频设备还将获得一个按钮以推送(OBTP)简化会议加入体验。

架构概述

Microsoft Cloud Video Interop (CVI)计划使像Cisco这样的合作伙伴能够提供将视频设备连接到Microsoft Teams会议的服务。

CVI 体系结构映像基于 https://docs.microsoft.com/en-us/microsoftteams/cloud-video-interop
解决方案架构

Webex Video Integration for Microsoft Teams是基于Webex云平台构建的Microsoft合格第三方云视频互操作解决方案。Webex云中的CVI合作伙伴功能可随时随地向公共互联网进行企业对企业呼叫。通用Webex服务提供管理、呼叫基础设施、交互式语音响应系统和大堂。位于世界各地的Webex媒体集群提供转码、协议翻译和Teams Bot角色。

使用此架构,视频设备会向Webex托管的特定的SIP URI进行呼叫。Webex服务会接听呼叫,并将其分配给在Microsoft Azure中运行的地域相关媒体集群。如果需要,IVR会收集会议详细信息,Webex媒体集群中的Microsoft Teams的Media CVI机器人将连接到Microsoft Teams会议基础设施。对于通过 Webex 连接的参加者与 Microsoft Teams 上主持的会议的其余部分,媒体集群提供两者之间的背靠背连接。整个解决方案作为云服务运行。

视频集成使设备可以按照以下方式加入Teams会议:

  • 如果会议已为CVI启用,则设备可以使用视频ID和租户密钥加入。

  • 如果会议未为CVI启用,则设备可以使用会议ID和密码作为访客(跨租户加入)加入。

您可以通过添加其他Webex服务来增强用户体验。例如,混合日历服务在需要加入会议时自动向视频设备推送会议详细信息和简化的“加入”按钮。

数据处理

视频集成使用以下数据将设备连接到 Microsoft Teams 会议并提供会议中功能:

  • 企业应用程序注册:在配置期间,管理员使用Webex Video Integration应用程序授予在使用Microsoft Graph API时访问组织的Microsoft租户的权限。有关详细信息,请参阅 Microsoft Entra管理中心中的Webex视频集成

  • 由Webex配置的“租户密钥”:这是当设备呼叫VIMT服务时在SIP地址中使用的每个客户值。

  • 会议ID:Microsoft Teams在创建会议时分配此标识符,并将其包含在会议邀请函中。

    用户需要会议ID才能从Teams客户端加入会议,或通过Direct Guest Join或Cross-Tenant加入VIMT服务。

    视频集成使用此ID在跨租户加入期间指定Microsoft Teams会议的目标。

  • 会议密码:Microsoft Teams在创建会议时分配个案敏感密码,并将其包含在会议邀请函中。用户需要密码才能使用会议ID加入会议。

    视频集成使用此密码在跨租户加入期间访问Microsoft Teams会议的终端。

  • 视频ID:当此标识符由启用CVI的用户创建时,Microsoft Teams将此标识符分配给会议。Microsoft Teams在会议邀请中包括视频ID。

    视频集成使用视频ID和客户的Microsoft租户ID从Microsoft Graph API获取会议加入URL。

    (Microsoft将标签从“VTC会议ID”更新为“视频ID”。)

  • 客户的Microsoft租户ID:用于在与 Microsoft Graph API 通信时识别目标 Microsoft 组织。还在服务的管理界面中用于识别预配置的 Microsoft 租户。

  • Microsoft租户验证的域名:用作服务管理界面中的标签,以识别预配置的 Microsoft 租户。

  • 会议信息:当参加者请求通过视频集成加入 Microsoft Teams 会议时,此服务会检索该会议的详细信息,包括会议主题、组织者、日期/时间和连接详细信息。在连接后,此服务从 Microsoft Graph API 检索连接到 Teams 会议的参加者的实时信息(例如参加者标签、功能和状态),并用于协助实时会议。

    当您为邮箱启用混合日历服务时,日历服务使用位于包含该邮箱的日历条目正文中的更多信息 链接来标识会议“租户密钥”和视频ID。

  • 实时媒体和内容: 当参加者通过视频集成加入Microsoft Teams会议时,Webex和Microsoft Teams会交换编码的音频、视频和高帧率内容,以便在它们之间启用双向音频和视频体验。

如果您部署了与混合日历服务的视频集成,另请参阅 带有Microsoft 365集成参考的Webex混合日历服务

身份验证和授权

Webex使用Microsoft Graph API与Microsoft Teams环境交互。基于云的 Microsoft 身份提供程序 (IdP) 会处理 Microsoft Graph API 的验证。对 Microsoft Graph API 的请求通过提供由 Microsoft IdP 颁发的持有者令牌获得授权。与 Microsoft IdP 和 Graph API 的所有通信都使用 TLS 保护的 Web 连接。

要以服务形式与Microsoft Teams媒体交互,请将Webex视频集成注册为由Cisco管理的Microsoft 365租户中的应用程序托管媒体机器人。Teams Bot 要求事先授权才能与组织的 Microsoft 365 租户通信。

在初始配置期间,服务会请求对一组预定义的权限进行授权。管理员通过遵循下面所述的同意流程授予这些应用程序权限。

获得批准后,Webex服务可以从Microsoft OAuth v2.0 IdP请求持有者令牌(具有正确的权限和客户范围)。该服务使用持有人令牌授权向Microsoft Graph API请求进行配置详细信息、健康检查和Teams bot的操作。

授权和Microsoft管理员同意

具有完全管理员 角色的组织管理员可以使用Control Hub为其组织设置视频集成服务。

配置过程需要验证您的用户所属的Microsoft 365租户的全球管理员并征得您的同意。运行Teams bot所需的应用程序权限只能由Microsoft租户的全球管理员使用以下管理员同意流程授予。

该流程包含以下高级步骤:

  1. 登录Control Hub,查找并启动视频集成设置(有关详细设置步骤,请参阅部署Microsoft Teams的Webex视频集成)。

    在设置过程中,浏览器重定向到Microsoft云进行身份验证和同意。

  2. 以全局管理员身份登录Microsoft租户。

    该应用程序提示您允许:

    • 登录并阅读您的个人资料
    • 读取目录RBAC设置

    这是为了使应用程序能够验证您的帐户在您的租户内获得授权,以授予必要的权限。

  3. 勾选此复选框以代表贵组织同意,然后单击接受

    应用程序将您登录并检查您的权限。

    成功授权后,应用程序将再次提示您。这一次,提示会向您显示应用程序成功将视频设备连接到Microsoft Teams会议所需的权限。

    提示会显示应用程序名称、供应商域和请求的权限。

  4. 单击接受 为Webex Video Integration应用程序授予这些权限。

    您将重定向回Control Hub,在那里您可以看到完成Microsoft Teams配置所需的定制PowerShell命令。

  5. 使用PowerShell完成Microsoft Teams配置,然后关闭Control Hub面板。

    设置过程会测试组织的 Microsoft Graph API 调用。如果成功,则设置完成。如果不成功,管理员可以再次尝试授权过程。

已授予的权限

适用于Microsoft Teams的Webex视频集成需要您的Microsoft租户中的明确权限。这些权限无法自定义,并且由Control Hub中的设置过程自动配置。

使用两组单独的权限:

  • 设置期间用于验证目标租户信息的一组用户同意权限

  • 管理员同意在Entra目录中授予企业应用程序的一组权限。此设置使服务能够访问您的Microsoft Teams环境

用户同意权限

在设置服务期间,我们向已签名的用户请求以下权限。它们允许访问Microsoft租户,以验证有关目标租户的信息。我们仅在设置集成时使用这些权限;它们不会存储。

您可以在Entra目录中的应用程序的权限 页面中查看这些用户同意 权限。

表1。 用户同意的权限以及设置流程需要这些权限的原因
需要许可目的
“登录并读取用户配置文件”(User.read)用于读取用户档案中签名以识别用户的租户。
“读取目录RBAC设置”(RoleManagement.Read.Directory)用于检查已签名的用户是否是Entra ID中已知管理员安全组的成员。
“保持对已授予其访问权限的数据的访问权限” (offline_access)允许服务在不登录用户的情况下查看您授予其访问的数据。

服务权限

Microsoft管理同意流程授予租户中的“Cisco Webex Video Integration for MS Teams企业应用程序”以下权限。这些权限启用Webex服务以访问您的Teams环境。

在Entra目录中的应用程序中保留这些权限,直到您删除Webex服务(该服务也删除应用程序)。

表 2. 管理员授予的权限以及Webex服务需要它们的原因

权限

使用情况

读取域 (Domain.Read.All)

允许服务读取租户的已验证域名。Control Hub 使用域名识别服务所链接到的租户。

从应用程序发起一对一去电 (Calls.Initiate.All)

允许 bot 向 Microsoft Teams 用户创建呼叫。(保留供将来使用。)

从应用程序发起群发去电 (Calls.InitiateGroupCall.All)

允许 bot 向一组 Microsoft Teams 用户创建呼叫。(保留供将来使用。)

作为应用程序加入组呼叫和会议 (Calls.JoinGroupCall.All)

允许 bot 使用目录用户的权限加入您组织中的组呼叫和已安排的会议。用于加入有权绕过 Microsoft Teams 等候区的参加者。

作为访客加入组呼叫和会议 (Calls.JoinGroupCallAsGuest.All)

允许 Bot 作为访客加入组织中的组呼叫和已安排的会议。用于加入无权绕过 Microsoft Teams 等候区的参加者。

作为应用程序访问通话中的媒体流 (Calls.AccessMedia.All)

允许 bot 无需登录用户即可直接访问通话中的媒体流。

阅读在线会议详细信息 (OnlineMeetings.Read.All)

允许服务阅读组织中的在线会议详细信息。用于查找 VTC 会议标识并将其解析为 Microsoft Teams 会议。

登录并读取用户档案 (User.read)

获取所列的其他权限时需要。集成不会直接使用它。

Microsoft Graph 权限参考: https://docs.microsoft.com/en-us/graph/permissions-reference

Microsoft 会议 Bot 概述: 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视频集成加入会议。

使用跨租户加入(包括使用会议ID和密码)的参加者始终以客人的身份加入。如果主持会议的组织禁用匿名用户可以加入会议,则这些加入尝试失败。

为受信任的参加者绕过大堂

使用以下方法连接视频集成的与会者被视为值得信赖的与会者,无需安排在大厅中即可加入Microsoft Teams会议:

  • 向Webex组织注册的设备注册为Webex注册的设备

  • 从 Control Hub 中已添加并验证为您的组织所拥有的 SIP 域进行呼叫

受信任的参加者将被视为您的组织中的参加者。如果组织者限制了Teams会议大厅设置,通过这些受信任路径连接的与会者可以绕过大厅。如果谁可以绕过大堂? 会议选项设置为“组织者与我”或“我邀请的人”,尝试加入的受信任与会者将被忽略,并且所有的VIMT呼叫者在加入会议时都放置在Teams会议大厅中。

使用跨租户加入(包括使用会议ID和密码)的参加者始终以客人的身份加入。这意味着即使是值得信赖的参加者也要在大堂等候,才能被主持人接纳。

有关添加和验证 SIP 域的更多信息,请参阅 SIP 视频设备的域验证过程

Microsoft Entra管理中心中的Webex视频集成

在您授权视频集成服务访问Microsoft 365租户后,应用程序没有维护要求。您可以在Microsoft Entra管理中心中的“企业应用程序”列表中验证其存在和范围。

在此集成过程中,您的租户中不会运行任何物理应用程序或软件。企业应用程序条目是授权给Webex应用程序标识的定义和占用者。

单击应用程序名称,然后单击权限以查看该应用程序在租户中拥有的权限。