集成Webex
部署Webex集成,从任何设备或内部网络安排Webex会议。用户可以主持一次性或经常性的会议,添加受邀者和共同主持者,并从不同时区进行选择。微应用程序还会发送一封电子邮件给主持人,并向被邀请者发送相应的会议对象,以方便集成日历。
注意:
要了解Webex微应用的全面列表,请参见使用网讯microapps.
检查先决条件
这些先决条件假设管理员将是组织的Webex集成设置的一部分。这个Webex管理员帐户必须有完全读取用户信息的权限。
在你与Webex建立了这个集成之后,你将需要这些工件来在Citrix Workspace Microapps中添加集成,特别是以下设置OAuth集成的参数列表:
- 基URL:
https://webexapis.com/v1/
- 授权网址:
https://webexapis.com/v1/authorize
- 令牌网址:
https://webexapis.com/v1/access_token
- 客户端ID:客户端ID是代表授权服务器唯一的客户端注册信息的字符串。
- 机密:客户端机密是在设置目标应用程序集成时发出的唯一字符串。
注意:
我们建议您始终使用OAuth 2.0作为您的服务身份验证方法。OAuth 2.0确保您的集成符合配置microapp的最大安全遵从性。
将Citrix网关配置为支持Webex的单点登录,这样一旦用户登录,他们就会自动再次登录,而无需再次输入他们的凭证。有关配置SSO的详细信息,请参见Citrix网关服务.
集成需要定期访问您的Webex实例,因此我们建议创建一个专用的用户帐户。此帐户必须具有以下权限。您可以使用Webex控制中心查看权限/特权
- 服务帐户所需的权限:完全管理员权限
针对特定资源的API请求数量有限,因此我们建议如下:
- Webex API限制表单link:https://developer.webex.com/docs/api/basics#rate-limiting
- 推荐方案:Webex Plus
使api
Webex api默认通过付费帐户的web服务启用。
创建一个新的服务帐户
注册:https://web.webex.com/.有关新服务帐户,请参阅以下网址:https://help.webex.com/en-us/nkhozs6/Get-Started-with-Cisco-Webex-Control-Hub.
OAuth服务器配置
配置OAuth服务器通过Webex集成读取数据。
- 使用您的服务帐户登录到:https://developer.webex.com/docs/platform-introduction.
- 选择右上角显示的用户名。
- 选择我的网讯应用并选择创建一个新应用程序.
- 选择创建一个集成在集成贴图下面。
填写必填字段,并在中输入此集成的以下授权重定向URL重定向URL字段:
https://{yourmoappserverurl}/admin/api/gwsc/auth/serverContext
- 下作用域部分中,选择火花:所有和spark管理员:人们阅读检查箱子。
- 选择添加集成在您完成所有必需的字段之后。
- 复制并保存客户和秘密显示在屏幕上。你用这些细节服务认证在配置集成时。
配置OAuth客户端
配置OAuth客户端通过Webex集成回写数据。
- 使用您的服务帐户登录,如上所示:https://developer.webex.com/docs/platform-introduction.
- 选择右上角显示的用户名。
- 选择我的网讯应用并选择创建一个新应用程序.
- 选择创建一个集成在集成贴图下面。
填写必填字段,并在中输入此集成的以下授权重定向URL重定向URL字段:
https:// {yourmicroappserverurl} / app / api /认证/ serviceAction /回调
- 下作用域部分中,选择会议:schedules_write复选框。
- 选择添加集成在您完成所有必需的字段之后。
- 复制并保存客户和秘密显示在屏幕上。你用这些细节服务操作验证在配置集成时。
将集成添加到Citrix Workspace Microapps中
将Webex Meeting集成到Citrix Workspace Microapps中,以连接到您的应用程序。已预先选择身份验证选项。确保在完成流程时选择了这些选项。这提供了具有预先配置的通知和动作的开箱即用的微应用程序,可以在您的工作区中使用。
遵循以下步骤:
- 从Microapp集成页面,选择添加新的集成和从Citrix提供的模板添加新的集成.
- 选择Webex Meetings贴图。
- 输入一个集成的名字的集成。
- 输入连接器参数.
- 输入实例基URL:
https://webexapis.com/v1/
. - 选择一个图标,或者将其保留为默认图标。
- 输入实例基URL:
下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。身份验证选项是预选的。确保在完成流程时选择了这些选项。使用OAuth 2.0安全协议为委托访问生成请求/授权令牌。建议始终使用OAuth 2.0作为可用的服务身份验证方法。OAuth 2.0确保您的集成符合配置的microapp的最大安全性要求。
- 选择授权代码从赠款类型菜单。这授予客户端用来交换访问令牌的临时代码。代码是从授权服务器获得的,您可以在授权服务器中看到客户机正在请求的信息。只有此授权类型才能启用安全用户模拟。这显示了回调URL,在注册应用程序时使用。
- 选择请求体从令牌授权菜单。
- 的授权URL肾上腺素:
https://webexapis.com/v1/authorize
- 的标记的URL肾上腺素:
https://webexapis.com/v1/access_token
- 确保在范围内输入以下内容:火花:所有spark管理员:人们阅读
- 输入您的客户机ID.客户端ID是表示授权服务器唯一的客户端注册信息的字符串。当您配置OAuth服务器时,您将收集这些信息和秘密信息。你需要添加回调URL您可以在集成配置页面上看到。
- 输入您的客户的秘密.客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
下服务操作验证,使在操作中使用单独的用户身份验证切换。服务操作身份验证在服务操作级别进行身份验证。身份验证选项是预选的。确保在完成流程时选择了这些选项。
- 选择OAuth 2.0从身份验证方法菜单并完成身份验证细节。
- 选择授权代码从赠款类型菜单这将授予客户端交换访问令牌的临时代码。代码是从授权服务器获得的,您可以在该服务器上查看客户端请求的信息。只有此授权类型才能启用安全的用户模拟。这将显示回调URL,在注册应用程序时使用。
- 选择请求体从令牌授权菜单。
- 的授权URL肾上腺素:
https://webexapis.com/v1/authorize
- 的标记的URL肾上腺素:
https://webexapis.com/v1/access_token
- 确保在范围内输入以下内容:会议:schedules_write
- 输入您的客户机ID. 客户端ID是表示授权服务器特有的客户端注册信息的字符串。在配置OAuth客户机时,您将收集此信息和机密。您需要添加回调URL您可以在集成配置页面上看到。
- 输入您的客户的秘密.客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
- 启用启用请求速率限制切换。进来One hundred.为的请求数量和1分钟为时间间隔.
(可选)使日志记录为了支持目的,切换到保持24小时的日志记录。
- 选择拯救继续。
- 下OAuth授权中,选择授权以您的服务帐户登录。弹出一个Webex登录屏幕。
- 输入您的服务帐户用户名和密码并选择登录.
- 选择接受.
的Microapp集成页面将打开添加的集成及其MicroApp。从这里,您可以添加另一个集成,继续设置现成的microapp,或为此集成创建新的microapp。
现在可以设置并运行第一次数据同步了。由于可以将大量数据从集成应用程序拉入MicroApp平台,我们建议您使用表格页来为您的第一次数据同步过滤实体,以加快同步。有关更多信息,请参见验证所需的实体. 有关同步规则、不符合其时间表的同步和否决规则的完整信息,请参阅同步数据.
有关API端点和表实体的更多详细信息,请参见Webex HTTP连接器规范.
使用Webex会议微应用
现有的应用集成与开箱即用的微应用一起出现。从这些微应用开始,并根据您的需要定制它们。
创建一个会议:通过选择会议持续时间、时区、受邀者和联合主持人来安排会议。
通知或页面 | 用例的工作流 |
---|---|
创建会议 | 提供一个表单,用于根据用户首选项安排具有以下详细信息的会议:会议标题、开始和结束时间、时区、重复(一次、每日、每周、每月)、密码、会议与会者和会议的共同主持人。 |