集成 Webex
部署 Webex 集成以从任何设备或内部网安排 Webex 会议。用户可以主持一次性/定期会议，添加受邀者和联合主持人，以及从不同的时区中进行选择。微应用还会向主持人和受邀者发送一封电子邮件，其中包含相应的会议对象，以便轻松集成日历。
注意：
我们希望得到你的反馈！请在使 用此集成模板时提供反馈 。对于任何问题，我们的团队还将每天监控我们的 专门论坛 。
有关开箱即用的 Webex 微应用的完整列表，请参阅 使用 Webex 微应用。
查看必备项
这些先决条件假定管理员将成为组织 Webex 集成设置的一部分。此 Webex 管理员帐户必须具有用户信息的完全读取权限。
与 Webex 设置此集成后，您将需要这些工件才能在 Citrix Workspace 微应用中添加集成，特别是以下用于设置 OAuth 集成的参数列表：
- 基本 URL：
https://webexapis.com/v1/ - 授权 URL：
https://webexapis.com/v1/authorize - 令牌 URL：
https://webexapis.com/v1/access_token - CLIENT ID：客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
- SECRET：客户端密钥是设置目标应用程序集成时发出的唯一字符串。
注意：
我们建议您始终使用 OAuth 2.0 作为服务身份验证方法（如果可用）。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
将 Citrix Gateway 配置为支持 Webex 的单点登录，这样一旦用户登录，他们将自动重新登录，而无需再次输入凭据。有关配置 SSO 的更多信息，请参阅 Citrix Gateway 服务。
集成需要定期访问 Webex 实例，因此我们建议创建一个专用用户帐户。此帐户必须具有以下权限。您可以在上使用 Webex Control Hub 查看权限/特权
- 服务帐户所需的权限：完全管理员权限
可以对特定资源发出的 API 请求数量有限，因此我们建议您执行以下操作：
- Webex API 限制表单链接： https://developer.webex.com/docs/api/basics#rate-limiting
- 推荐计划：Webex Plus
启用 API
默认情况下，Webex API 是通过 Web 服务为付费帐户启用的。
创建一个新的服务帐号
在此处注册：https://web.webex.com/。有关新服务帐号，请参阅以下 URL： https://help.webex.com/en-us/nkhozs6/Get-Started-with-Cisco-Webex-Control-Hub。
配置 OAuth 服务器
将 OAuth 服务器配置为通过 Webex 集成读取数据。
- 使用您的服务帐户登录到 https://developer.webex.com/docs/platform-introduction。
- 选择右上角的用户名。
- 选择 我的 Webex 应用程序 ，然后选择 创建新应用程序。
- 选择 “ 集成” 磁贴下的 “创建 集成”。
-
填写必填字段，然后在重定向 URL 字段中输入此集成的以下授权 重定向 URL ：
https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
- 在 “ 范围 ” 部分下，选中 “ 火花:全 部” 和 “ 火花管理员:人/read ” 复选框。
- 完成所有必填字段后，选择 添加集 成。
- 复制并保存屏幕上显示的 clientId 和 S ecret 。配置集成时，可以将这些详细信息用于 服务身份验证 。
配置 OAuth 客户端
配置 OAuth 客户端以通过 Webex 集成写回数据。
- 使用您的服务帐户登录 https://developer.webex.com/docs/platform-introduction，如上所述。
- 选择右上角的用户名。
- 选择 我的 Webex 应用程序 ，然后选择 创建新应用程序。
- 选择 “ 集成” 磁贴下的 “创建 集成”。
-
填写必填字段，然后在重定向 URL 字段中输入此集成的以下授权 重定向 URL ：
https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
- 在 范围 部分下，选中 会议:chedules_write 复选框。
- 完成所有必填字段后，选择 添加集 成。
- 复制并保存屏幕上显示的 clientId 和 S ecret 。配置集成时，可以将这些详细信息用于 服务操作身份验证 。
将集成添加到 Citrix Workspace 微应用
将 Webex Meeting 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。这样可以提供带有预配置通知和操作的开箱即用的微应用程序，这些通知和操作可在工作区中使用
请按照以下步骤进行操作：
- 在 微应用集成 页面中，选择 添加新集成，然后 从 Citrix 提供的模板中添加新集成。
- 选择 Webex 会议磁贴。
- 输入 集成的集成名称 。
- 输入 连接器参数。
- 输入实例 基本 URL：
https://webexapis.com/v1/。 - 从 图标 库中选择用于集成的图标，或将其保留为默认图标。
- 输入实例 基本 URL：
-
在 服务身份验证下，从身份验证 方法 菜单中选择 OAuth 2.0 ，然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
- 从授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取，您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL。
- 从令牌授权菜单中选择请求正文。
-
授权 URL 是预先填写的：
https://webexapis.com/v1/authorize -
令牌 URL 已预先填充：
https://webexapis.com/v1/access_token - 确保为范围: spark: all spark: all spark- admin: people_read输入了以下内容
- 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 服务器时收集此密钥和密钥。您需要添加在集成配置页面上看到的 回调 URL 。
- 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
-
在服务操作身份验证下，启用在操作使用单独的用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。
- 从身份验证方法菜单中选择 OAuth 2.0，然后填写身份验证详细信息。
- 从授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取，您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL。
- 从令牌授权菜单中选择请求正文。
-
授权 URL 是预先填写的：
https://webexapis.com/v1/authorize -
令牌 URL 已预先填充：
https://webexapis.com/v1/access_token - 确保为范围: 会议:chedules_write输入了以下内容
- 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 客户端时收集此密钥和密钥。您需要添加在集成配置页面上看到的 回调 URL 。
- 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
- 启用 启用请求速率限制 开关。在 请求数 中输入 100 ，在 时间间隔 中输入 1 分钟。
-
（可选）启用 日志记录 切换以保留 24 小时的日志记录以用于支持目的。
- 选择 保存 以继续。
- 在 OAuth 授权下，选择 授权 以使用您的服务帐户登录。此时将显示带有 Webex 登录屏幕的弹出窗口。
- 输入您的服务帐户用户名和密码，然后选择登录。
- 选择 接受。
微应用集成 页面随即打开，其中包含您添加的集成及其微应用。在这里，您可以添加另一个集成，继续设置开箱即用的微应用，或为此集成创建新的微应用。
现在，您已准备好设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到微应用平台，因此我们建议您使用 “ 表 ” 页面筛选实体以进行首次数据同步，以加快同步速度。有关更多信息，请参阅验证所需实体。有关同步规则、不符合其计划的同步和否决规则的完整信息，请参阅同步数据。
有关 API 终端节点和表实体的更多详细信息，请参阅 Webex HTTP 连接器规范。
使用 Webex Meetings 微应用
现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始，然后根据您的需求自定义它们。
创建会议： 使用选择持续时间、时区、受邀者和共同主持人的选项安排会议。
| 通知或页面 | 用例工作流 |
|---|---|
| 创建会议页面 | 提供根据用户首选项安排会议的表单，其中包含以下详细信息：会议标题、开始和结束时间、时区、周期（一次、每天、每周、每月）、密码、会议与会者和会议的共同主持人。 |