集成 Zoom
部署适用于 Zoom 的 Citrix 集成，以便从任何位置、从任何设备或内部网安排会议。通过我们针对 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
- 填写必填字段，然后选择继续。
- 在“范围部分下，选择添加作用域，然后为会议、录制和用户选择作用域。然后选择完成。
- 选择安装。将打开一个新选项卡以授权应用程序，然后选择 授权 并关闭该选项卡。
- 复制并保存屏幕上显示的客户端 ID 和密码。配置集成时，您将这些详细信息用于服务身份验证。
配置 OAuth 客户端
配置 OAuth 客户端以通过 Zoom 集成写回数据。
- 使用您的服务帐户登录，如上所示： https://marketplace.zoom.us/。
- 选择右上角的开发下拉菜单。
- 选择 构建应用程序。
- 选择“为 OAuth 应用程序创建”。选择应用类型作为 用户管理的应用程序。
- 禁用将应用发布到商城的切换，然后选择创建。
-
在重定向 URL字段和白名单 URL字段中输入此集成的以下授权重定向 URL。然后选择继续。
<https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback>
- 填写必填字段，然后选择继续。
- 在“范围部分下，选择添加作用域，然后为会议、录制和用户选择作用域。然后选择完成。
- 选择安装。将打开一个新选项卡以授权应用程序，然后选择 授权 并关闭该选项卡。
- 复制并保存屏幕上显示的客户端 ID 和密码。配置集成时，您将这些详细信息用于服务操作身份验证。
将集成添加到 Citrix Workspace 微应用
将 Zoom 会议集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。这样可以提供现成的微应用，以及可以在 Workspace 内使用的预配置通知和操作。
请按照以下步骤进行操作：
- 在微应用集成页面中，选择添加新集成，然后选择从 Citrix 提供的模板添加新集成。
- 选择“Zoom 会议”磁贴。
- 输入集成的集成名称。
- 输入连接器参数。
- 输入实例 基本 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 - 确保为范围输入以下内容：account:write:adminDelete account:read:adminDelete account:masterDelete meeting:master meeting:read:adminDelete meeting:write:adminDelete recording:masterDelete recording:read:adminDelete recording:write:adminDelete user:masterDelete user:read:adminDelete user:write:adminDelete。
- 输入您的客户端 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、拨入号码。 |
| 编辑办公时间 | 帮助用户根据以下字段（如开始时间、持续时间、日期）的用户首选项编辑计划的“办公时间会议”。 |
会议录音： 查看过去 7 天的所有会议录音。还允许用户从任何设备播放录音。
| 通知或页面 | 用例工作流 |
|---|---|
| 会议录音通知 | 当有新的会议录音可用时，会议主持人会收到通知。 |
| “录制表” 页 | 提供表格以查看主持人过去七天的所有会议录音。 |
| 录制件详细信息 | 提供录制的详细信息，如“会议主题”、“日期”、“时间”、“下载 URL”和“播放录音按钮”选项。 |