集成缩放
部署Citrix集成以获取缩放以从任何位置和任何设备或Intranet中安排会议。通过我们为缩放的集成,用户可以:
- 创建一次性或定期会议,添加共同组织者,并选择不同的时区。microapp还提供了用户计划的会议的邀请详细信息。
- 查看、编辑和启动创建的会议。
- 安排缩放办公时间会议。
- 会议结束后收到他们的会议录制通知并播放录音。
注意:
有关Zoom的开箱即用微应用程序的详细信息,请参见使用microapps进行缩放.
检查先决条件
这些先决条件假设管理员是组织的Zoom集成设置的一部分。此缩放管理帐户必须具有对用户信息的完全读取权限。在您设置了与Zoom的集成后,您将需要这些工件在Citrix Workspace Microapps中添加集成:
- 基本网址:
https://api.zoom.us/v2/
- 授权网址:
https://zoom.us/oauth/authorize
- 令牌网址:
https://zoom.us/oauth/token.
- 客户端ID:客户端ID是表示授权服务器特有的客户端注册信息的字符串。
- 机密:客户端机密是在设置目标应用程序集成时发出的唯一字符串。
注意:
我们建议您始终使用OAuth 2.0作为可用的服务身份验证方法。OAuth 2.0确保您的集成符合配置的microapp的最大安全性要求。
配置Citrix网关支持单点登录Zoom,这样一旦用户登录,他们就会自动再次登录,而无需再次输入凭证。有关配置单点登录的更多信息,请参见Citrix网关服务https://docs.citrix.com/en-us/citrix-gateway-service/.
集成需要定期访问Zoom实例,因此我们建议创建一个专用用户帐户。您可以在以下位置查看权限/特权:https://marketplace.zoom.us/docs/api -reference/other -references/privileges.. 此帐户必须具有以下权限:
- 服务帐户所需的权限:完全管理员权限
因此,可以对特定资源进行的API请求的数量是有限的,因此我们推荐以下内容:
- 缩放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应用程序,选择应用程序类型为帐户级应用程序.
- 禁用将应用发布到marketplace的切换,然后选择创造.
属性中为此集成输入以下授权重定向url重定向URL字段和白名单网址领域然后选择继续.
https://{yourmoappserverurl}/admin/api/gwsc/auth/serverContext
- 填写所需字段,然后选择继续.
- 在Scopes部分下,选择添加作用域并选择作用域会议,记录和用户. 然后选择完毕.
- 选择安装.打开一个新选项卡以授权应用程序然后选择批准然后关闭选项卡。
- 复制并保存ClientId.和秘密显示在屏幕上。您可以使用这些详细信息服务认证在配置集成时。
配置OAuth客户端
配置OAuth客户端通过Zoom集成回写数据。
- 使用您的服务帐户登录,如上所示:https://marketplace.zoom.us/.
- 选择开发右上方的下拉菜单。
- 选择构建应用程序.
- 选择创造对于OAuth应用程序。选择app-type as用户管理的应用.
- 禁用将应用发布到marketplace的切换,然后选择创造.
属性中为此集成输入以下授权重定向url重定向URL字段和白名单网址领域然后选择继续.
- 填写所需字段,然后选择继续.
- 在Scopes部分下,选择添加作用域并选择作用域会议,记录和用户. 然后选择完毕.
- 选择安装.打开一个新选项卡以授权应用程序然后选择批准然后关闭选项卡。
- 复制并保存ClientId.和秘密显示在屏幕上。您可以使用这些详细信息服务操作身份验证在配置集成时。
添加集成
将Zoom Meeting集成添加到Citrix Workspace MicroApp以连接到您的应用程序。身份验证选项是预选的。确保在完成流程时选择了这些选项。这提供了现成的MicroApp,带有预先配置的通知和操作,可以在您的工作区内使用。
遵循以下步骤:
- 从Microapp集成第页,选择添加新的集成和从Citrix提供的模板中添加新集成.
- 选择缩放会议瓷砖。
- 输入集成的名字为了整合。
- 输入连接器参数.
- 输入实例基URL:
https://api.zoom.us/v2/
- 选择一个偶像,或者将其保留为默认图标。
- 输入实例基URL:
下服务认证中,选择OAuth 2.0来自身份验证方法菜单并完成身份验证详细信息。预先选择身份验证选项。确保在完成此过程时选择这些选项。使用OAuth 2.0安全协议为委派访问生成请求/授权令牌。建议您始终使用OAuth 2.0作为您的服务身份验证方法可用。OAuth 2.0可确保您的集成符合您配置的MicroApp的最大安全性符合性。
- 选择授权代码来自格兰特类型菜单这将授予客户端交换访问令牌的临时代码。代码是从授权服务器获得的,您可以在该服务器上查看客户端请求的信息。只有此授权类型才能启用安全的用户模拟。这将显示回调URL,注册应用程序时使用。
- 选择授权标题来自令牌授权菜单
- 这个授权URL预付款:
https://zoom.us/oauth/authorize
- 这个令牌URL预付款:
https://zoom.us/oauth/token.
确保为范围输入以下内容:会议:读:管理,录制:读:管理,用户:读:管理会议:读,会议:写
注意:
激活“创建会议”微应用程序;meeting:read,meeting:write, meeting:read:admin激活即将到来的会议(本周)微应用程序;meeting:read,meeting:write, meeting:read:admin激活My Office Hours微应用;meeting:read,meeting:write, meeting:read:admin激活meeting Recordings微应用程序;记录:阅读: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授权中,选择批准使用您的服务帐户登录。将出现一个弹出窗口,其中显示缩放登录屏幕。
- 输入您的服务帐户用户名和密码,然后选择登录.
- 选择接受.
这个Microapp集成页面将打开添加的集成及其MicroApp。从这里,您可以添加另一个集成,继续设置现成的microapp,或为此集成创建新的microapp。
现在可以设置和运行第一次数据同步了。由于大量数据可以从集成的应用程序中提取到Microapps平台,我们建议您使用桌子页面以筛选第一次数据同步的实体,以加快同步速度。有关详细信息,请参阅验证所需的实体.有关同步规则、不满足其调度和否决规则的同步的完整信息,请参见同步数据.
有关API端点和表实体的更多详细信息,请参见缩放HTTP连接器规格. 有关管理访问和订阅服务器的详细信息,请参阅分配用户.删除一个集成,从Microapp集成页面选择要卸载的集成旁边的菜单。选择删除集成,并确认。
使用microapps进行缩放
现有的应用程序集成附带出开箱即用的MicroApps。从这些MicroApp开始,为您的需求定制它们。
创建一个会议:根据您的喜好安排会议。用户可以选择会议标题,持续时间,开始日期,协调员等等。
通知或页面 | 用例工作流 |
---|---|
创建会议 | 提供用于安排会议的表单,其中包含以下详细信息(根据用户偏好):会议标题、开始时间、持续时间、重复(一次、每日、每周、每月)、密码、共同组织者、会议拨入号码。 |
“新会议一次”页面 | 此页面为创建会议提供了成功消息查看详情一次性会议的按钮。 |
新会议定期网页 | 此页面为创建会议提供了成功消息查看详细信息用于定期会议的按钮。 |
邀请页 | 创建会议后立即提供会议的邀请详细信息,例如会议主题、密码、日历详细信息、事件详细信息、加入URL、开始时间、会议Id、拨入号码。 |
即将到来的会议(本周):查看本周所有即将召开的会议。用户可以编辑并启动会议。
通知或页面 | 用例工作流 |
---|---|
一次性会议提醒通知 | 当一次性会议的开始时间少于一小时时,会议主持人将收到通知。 |
定期会议提醒通知 | 当定期会议的开始时间少于一小时时,会议主持人将收到通知。 |
所有会议页面 | 提供有关当前一周的即将到期和经常性会议的所有举行会议的信息,以便在会议主题的基础上过滤会议。 |
会议详细信息一次性页面 | 提供即将到来的一次性会议的邀请详细信息,例如会议主题,密码,日历详细信息,加入URL,开始时间,会议ID,拨入号码,其中包含编辑和启动按钮的选项。 |
会议详细信息重复页面 | 提供即将举行的定期会议的邀请详细信息,例如会议主题、密码、日历详细信息、事件详细信息、加入URL、开始时间、会议Id、拨入号码以及“编辑”和“开始”按钮选项。 |
“编辑一次会议”页面 | 提供一个表单,用于编辑一次性会议,其中包含以下详细信息(根据用户首选项):会议标题、开始时间、持续时间、时区、重复(一次性、每日、每周、每月)、密码、会议的共同组织者。 |
编辑定期会议页面 | 提供一个表单,用于编辑定期会议,其中包含根据用户首选项显示的以下详细信息:会议标题、开始时间、持续时间、时区、定期(一次性、每日、每周和每月)、密码、会议的共同组织者。使用保存此事件和保存所有事件的选项。 |
一次性会议提醒页面 | 提供即将召开的一次性会议的邀请详细信息,例如会议主题、密码、日历详细信息、加入URL、开始时间、会议Id、拨入号码,以及“开始”和“关闭”按钮选项。 |
定期会议提醒页面 | 通过“开始”和“关闭”按钮,提供即将召开的循环会议的邀请详细信息,如会议主题、密码、日历详细信息、加入URL、开始时间、会议Id、拨入号码。 |
我的办公时间:根据偏好安排办公时间会议。用户可以选择持续时间、开始日期、拨入号码等。
通知或页面 | 用例工作流 |
---|---|
虚拟办公时间 | 表格中提供当月预定的办公时间会议的详细信息。如果用户没有为当月安排任何会议,此页面还可以帮助用户创建办公时间。 |
设置虚拟时间 | 提供一个表格,用于安排办公时间会议,其中包含以下详细信息(根据用户偏好):会议的开始时间、日期、持续时间、时区、重复(一次性、每日、每周、每月)、密码、拨入号码。 |
新的会议 | 使用“查看详细信息”按钮成功创建会议后,显示成功消息。 |
邀请 | 创建会议后立即提供会议的邀请详细信息,例如会议主题、密码、日历详细信息、事件详细信息、加入URL、开始时间、会议Id、拨入号码。 |
编辑办公时间 | 帮助用户根据用户首选项编辑计划的Office小时会议,例如对以下字段,例如开始时间,持续时间,日期。 |
会议录音:查看最近7天的会议记录。还允许用户播放任何设备的录音。
通知或页面 | 用例工作流 |
---|---|
会议记录的通知 | 当有新的会议录音可用时,会议主持人收到通知。 |
记录表格页面 | 提供表格以查看主机在过去七天内的所有会议录制。 |
记录详细信息 | 提供录制的详细信息,例如会议主题、日期、时间、下载URL以及播放录制按钮选项。 |