集成 Zoom
部署适用于 Zoom 的 Citrix 集成,以便从任何地方、通过任何设备或内部网安排会议。通过我们与 Zoom 的集成,用户可以:
- 创建一次性或定期会议,添加联合组织者,然后选择不同的时区。微应用还提供用户安排的会议的邀请详细信息。
- 查看、编辑和开始创建的会议。
- 安排 Zoom 办公时间会议。
- 会议结束后收到他们的会议录制通知并播放录制内容。
注意:
我们希望得到你的反馈!请在使 用此集成模板时提供反馈 。对于任何问题,我们的团队还将每天监控我们的 专门论坛 。
有关适用于 Zoom 的开箱即用微应用的全面详细信息,请参阅 使用微应用进行缩放。
查看必备项
这些先决条件假定管理员是组织的 Zoom 集成设置的一部分。此 zoom 管理员帐户必须具有用户信息的完全读取权限。与 Zoom 设置此集成后,需要以下工件才能在 Citrix Workspace 微应用中添加集成:
- 基本 URL:
https://api.zoom.us/v2/
- 授权 URL:
https://zoom.us/oauth/authorize
- 令牌 URL:
https://zoom.us/oauth/token
- 客户端 ID:客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
- Secret:客户端密钥是设置目标应用程序集成时发出的唯一字符串。
注意:
我们建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最高安全性合规性。
将 Citrix Gateway 配置为支持 Zoom 的单点登录,这样一旦用户登录,他们将自动重新登录,而无需再次输入凭据。有关配置 SSO 的更多信息,请参阅 Citrix Gateway 服务 https://docs.citrix.com/en-us/citrix-gateway-service/。
集成需要定期访问您的 Zoom 实例,因此我们建议您创建一个专用用户帐户。您可以在 https://marketplace.zoom.us/docs/api-reference/other-references/privileges 中查看权限/特权。此账户必须具有以下权限:
- 服务帐户所需的权限:完全管理员权限
可以对特定资源发出的 API 请求数量有限,因此我们建议您执行以下操作:
- Zoom API 限制表单链接: https://marketplace.zoom.us/docs/api-reference/rate-limits
- 推荐计划:商务
创建一个新的服务帐号
在此处登录:https://zoom.us/signin。有关新服务帐号,请参阅以下 URL: https://marketplace.zoom.us/docs/guides/getting-started
配置 OAuth 服务器
将 OAuth 服务器配置为通过 Zoom 集成读取数据。
- 使用您的服务帐户登录到 https://marketplace.zoom.us/。
- 选择右上角的 “ 开发 ” 下拉菜单。
- 选择 构建应用程序。
- 选择为 OAuth 应用程序 创建 ,选择应用类型作为 帐户级应用程序。
- 禁用将应用程序发布到市场的开关,然后选择 创建。
-
在重定向 URL 字段和 白名单URL字段中输入此集成的以下授权重定向 URL 。然后选择 “ 继续”。
https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
- 填写必填字段,然后选择 继续。
- 在范围部分下,选择 添加范围 ,然后选择会 议、 录制和 用户的范围。然后选择 “ 完成”。
- 选择 “ 安装”。将打开一个新选项卡以授权应用程序,然后选择 授权 并关闭选项卡。
- 复制并保存屏幕上显示的 clientId 和 S ecret 。配置集成时,可以将这些详细信息用于 服务身份验证 。
配置 OAuth 客户端
配置 OAuth 客户端以通过 Zoom 集成写回数据。
- 使用您的服务帐户登录 https://marketplace.zoom.us/,如上所述。
- 选择右上角的 “ 开发 ” 下拉菜单。
- 选择 构建应用程序。
- 选择 为 OAuth 应用程序创建。选择应用类型作为 用户管理的应用程序。
- 禁用将应用程序发布到市场的开关,然后选择 创建。
-
在重定向 URL 字段和 白名单URL字段中输入此集成的以下授权重定向 URL 。然后选择 “ 继续”。
<https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback>
- 填写必填字段,然后选择 继续。
- 在范围部分下,选择 添加范围 ,然后选择会 议、 录制和 用户的范围。然后选择 “ 完成”。
- 选择 “ 安装”。将打开一个新选项卡以授权应用程序,然后选择 授权 并关闭选项卡。
- 复制并保存屏幕上显示的 clientId 和 S ecret 。配置集成时,可以将这些详细信息用于 服务操作身份验证 。
添加集成
将 Zoom Meeting 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。这样可以提供带有预配置通知和操作的开箱即用的微应用程序,这些通知和操作可在工作区中使用
请按照以下步骤进行操作:
- 在 微应用集成 页面中,选择 添加新集成,然后 从 Citrix 提供的模板中添加新集成。
- 选择 “缩放会议” 磁贴。
- 输入 集成的集成名称 。
- 输入 连接器参数。
- 输入实例 基本 URL:
https://api.zoom.us/v2/
- 从 图标 库中选择用于集成的图标,或将其保留为默认图标。
- 输入实例 基本 URL:
-
在 服务身份验证下,从身份验证 方法 菜单中选择 OAuth 2.0 ,然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
- 从授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL。
- 从 令牌授权菜单中选择授权 标题。
-
授权 URL 是预先填写的:
https://zoom.us/oauth/authorize
-
令牌 URL 已预先填充:
https://zoom.us/oauth/token
-
确保为范围输入以下内容: 会议:读取:管理员,录制内容:读取:管理员,用户:读取:管理员会议:读取,会议:写入
注意:
激活 “创建会议” 微应用;会议:读取、会议:写入、会议:读取:管理员 使即将举行的会议(本周)微应用处于活动状态;会议:读取、会议:写入、会议:读取:管理员 激活 “我的办公时间” 微应用;会议:阅读,会议:write,会议:read: admin 使会议录制文件微应用处于活动状态;录制:read: admin
- 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 服务器时收集此密钥和密钥。您需要添加在集成配置页面上看到的 回调 URL 。
- 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
-
在服务操作身份验证下,启用在操作使用单独的用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。
- 从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。
- 从授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL。
- 从 令牌授权菜单中选择授权 标题。
-
授权 URL 是预先填写的:
https://zoom.us/oauth/authorize
-
令牌 URL 已预先填充:
https://zoom.us/oauth/token
- 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 客户端时收集此密钥和密钥。您需要添加在集成配置页面上看到的 回调 URL 。
- 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
-
启用 启用请求速率限制 开关。在 请求数 中输入 55 ,在 时间间隔 中输入 1 秒。
- (可选)启用 日志记录 切换以保留 24 小时的日志记录以用于支持目的。
- 选择 保存 以继续。
- 在 OAuth 授权下,选择 授权 以使用您的服务帐户登录。出现一个弹出窗口,其中包含 Zoom 登录屏
- 输入您的服务帐户用户名和密码,然后选择登录。
- 选择 接受。
微应用集成 页面随即打开,其中包含您添加的集成及其微应用。在这里,你可以添加另一个集成,继续设置开箱即用的微应用,或者为此集成创建新的微应用。
现在,您已准备好设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到微应用平台,因此我们建议您使用 “ 表 ” 页面筛选实体以进行首次数据同步,以加快同步速度。有关更多信息,请参阅验证所需实体。有关同步规则、不符合其计划的同步和否决规则的完整信息,请参阅同步数据。
有关 API 端点和表实体的更多详细信息,请参阅 Zoom HTTP 连接器规范。有关管理访问和订阅者的详细信息,请参阅 分配订阅者。要删除集成,请从 微应用集成 页面中选择要卸载的集成旁边的菜单。选择 删除集成,然后确认。
使用微应用进行 Zoom
现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始,然后根据您的需求自定义它们。
创建会议: 根据自己的喜好安排会议。用户可以选择会议标题、持续时间、开始日期、共同组织者等。
通知或页面 | 用例工作流 |
---|---|
创建会议页面 | 根据用户首选项提供安排会议的表单,其中包含以下详细信息:会议标题、开始时间、持续时间、周期(一次、每天、每周、每月)、密码、共同组织者、会议的拨入号码。 |
新的 “一次性会议” 页面 | 此页面为创建的会议提供成功消息,其中包含一次性会议的 “ 查看详细信 息” 按钮。 |
新会议周期性页面 | 此页面为创建的会议提供成功消息,其中包含定期会议的 “ 查看详细 信息” 按钮。 |
邀请页面 | 创建会议后立即提供会议的邀请详细信息,例如会议主题、密码、日历详细信息、发生次数详细信息、加入 URL、开始时间、会议 ID、拨入号码。 |
即将举行的会议(本周): 查看本周所有即将举行的会议。用户可以编辑和开始会议。
通知或页面 | 用例工作流 |
---|---|
一次性会议提醒通知 | 当一次性会议的开始时间少于一小时时,会议主持人会收到通知。 |
定期会议提醒通知 | 当定期会议的开始时间少于一小时时,会议主持人会收到通知。 |
所有会议页面 | 提供有关本周即将举行的一次性会议和定期会议的所有即将举行的会议的信息,并提供搜索选项,用于根据会议主题筛选会议。 |
会议详情一次性页面 | 提供即将举行的一次性会议的邀请详细信息,例如会议主题、密码、日历详细信息、加入 URL、开始时间、会议 ID、拨入号码以及编辑和开始按钮选项。 |
会议详情重复出现页 | 提供即将召开的定期会议的邀请详细信息,例如会议主题、密码、日历详细信息、发生次数详细信息、加入 URL、开始时间、会议 ID、拨入号码以及编辑和开始按钮选项。 |
“编辑一次性会议” 页面 | 根据用户首选项提供用于编辑一次性会议的表单,其中包含以下详细信息:会议标题、开始时间、持续时间、时区、周期(一次性、每日、每周、每月)、密码、共同组织者,用于会议。 |
编辑定期会议页面 | 根据用户首选项提供用于编辑定期会议的表单,其中包含以下详细信息:会议标题、开始时间、持续时间、时区、周期(一次性、每日、每周和每月)、密码、共同组织者,用于会议。可以选择保存此事件并保存所有匹配项。 |
一次性会议提醒页面 | 提供即将举行的一次性会议的邀请详细信息,例如会议主题、密码、日历详细信息、加入 URL、开始时间、会议 ID、拨入号码以及 “开始” 和 “关闭” 按钮选项。 |
定期会议提醒页面 | 提供即将召开的定期会议的邀请详细信息,例如会议主题、密码、日历详细信息、加入 URL、开始时间、会议 ID、拨入号码以及 “开始” 和 “关闭” 按钮选项。 |
我的办公时间: 根据喜好安排办公时间会议。用户可以选择持续时间、开始日期、拨入号码等。
通知或页面 | 用例工作流 |
---|---|
虚拟办公时间 | 在表格中提供当月的预定办公时间会议详细信息。如果用户没有安排当月的任何会议,此页面还可以帮助用户创建办公时间。 |
设置虚拟时间 | 根据用户首选项提供安排办公时间会议的表单,其中包含以下详细信息:会议的开始时间、日期、持续时间、时区、周期(一次性、每日、每周、每月)、密码、拨入号码。 |
新会议 | 使用 “查看详细信息” 按钮成功创建会议后显示成功消息。 |
邀请 | 创建会议后立即提供会议的邀请详细信息,例如会议主题、密码、日历详细信息、发生次数详细信息、加入 URL、开始时间、会议 ID、拨入号码。 |
编辑办公时间 | 帮助用户根据以下字段的用户首选项编辑计划的办公时间会议,例如开始时间、持续时间、日期。 |
会议录音: 查看过去七天的所有会议录像。还允许用户从任何设备播放录音。
通知或页面 | 用例工作流 |
---|---|
会议录音通知 | 当有新的会议录制文件可用时,会议主持人会收到通知。 |
“录音表” 页 | 提供用于查看主持人过去七天的所有会议记录的表格。 |
录制详情 | 提供录音的详细信息,例如 “会议主题”、“日期”、“时间”、“下载 URL” 和 “播放录音按钮” 选项。 |