集成 Webex

部署 Citrix 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
  • 客户端 ID:客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
  • 秘密:客户端密钥是设置目标应用程序集成时发出的唯一字符串。

注意:

我们建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

将 Citrix Gateway 配置为支持 Webex 的单点登录,以便在用户登录后,他们将自动重新登录,而无需再次输入凭据。有关配置 SSO 的详细信息,请参阅Citrix Gateway 服务

集成需要定期访问您的 Webex 实例,因此我们建议您创建一个专用的用户帐户。此帐户必须具有以下权限。您可以在上使用 Webex 控制中心查看权限/权限

  • 服务帐户所需的权限:完全管理员权限

可以向特定资源发出的 API 请求数量有限,因此我们建议采取以下措施:

启用 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 集成读取数据。

  1. 使用您的服务帐户登录到: https://developer.webex.com/docs/platform-introduction
  2. 选择右上角的用户名。
  3. 选择“我的 Webex 应用 程序”,然后选择“创建新应用”。
  4. 选择“集成”磁贴下的“创建 集成”。
  5. 填写必填字段,然后在重定向 URL 字段中输入此集成的以下授权重定向 URL

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  6. 在“范围”部分下,选择“闪亮:全 部”和“火花管理员:人员 _ 读取”复选框。
  7. 完成所有必填字段后,选择 添加集 成。
  8. 复制并保存屏幕上显示的客户端 ID密码。配置集成时,您将这些详细信息用于服务身份验证

配置 OAuth 客户端

配置 OAuth 客户端以通过 Webex 集成写回数据。

  1. 使用您的服务帐户登录,如上所示: https://developer.webex.com/docs/platform-introduction
  2. 选择右上角的用户名。
  3. 选择“我的 Webex 应用 程序”,然后选择“创建新应用”。
  4. 选择“集成”磁贴下的“创建 集成”。
  5. 填写必填字段,然后在重定向 URL 字段中输入此集成的以下授权重定向 URL

    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  6. 在“范围”部分下,选 中“会议:计划写入”复选框。
  7. 完成所有必填字段后,选择 添加集 成。
  8. 复制并保存屏幕上显示的客户端 ID密码。配置集成时,您将这些详细信息用于服务操作身份验证

将集成添加到 Citrix Workspace 微应用

将 Webex 会议集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。

请按照以下步骤进行操作:

  1. 微应用集成页面中,选择添加新集成,然后选择从 Citrix 提供的模板添加新集成
  2. 选择“Webex 会议”磁贴。
  3. 输入集成的集成名称
  4. 输入连接器参数
    • 输入实例 基本 URLhttps://webexapis.com/v1/
    • 图标 库中选择集成的图标,或将其保留为默认图标。

    名称和基本 URL

  5. 服务身份验证下,从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

    1. 授权类型菜单中选择授权代码。这将授予客户端交换访问令牌的临时代码。代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有此授权类型才能启用安全用户模拟。这将显示您在注册应用程序时使用的 回调 URL
    2. 令牌授权菜单中选择请求正文
    3. 授权 URL 已预填充: https://webexapis.com/v1/authorize
    4. 令牌 URL 已预填充: https://webexapis.com/v1/access_token
    5. 确保为范围输入以下内容: 火花:所有 火花-管理员:人 _ 读
    6. 输入您的客户端 ID。客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。在配置 OAuth 服务器时,您将收集这些信息和密码。您需要添加集成配置页面上看到的回调 URL
    7. 输入您的客户端密码。客户端密钥是设置目标应用程序集成时发出的唯一字符串。

    服务身份验证

  6. 服务操作身份验证下,启用在操作中使用单独用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。

    1. 从“身份验证方法”菜单中选择“OAuth 2.0”,然后完成身份验证详细信息。
    2. 授权类型菜单中选择授权代码。这将授予客户端交换访问令牌的临时代码。代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有此授权类型才能启用安全用户模拟。这将显示您在注册应用程序时使用的回调 URL
    3. 令牌授权菜单中选择请求正文
    4. 授权 URL 已预填充: https://webexapis.com/v1/authorize
    5. 令牌 URL 已预填充: https://webexapis.com/v1/access_token
    6. 确保为范围输入以下内容: 会议:计划 _ 写
    7. 输入您的客户端 ID。客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。您在配置 OAuth 客户端时收集此信息和密码。您需要添加集成配置页面上看到的回调 URL
    8. 输入您的客户端密码。客户端密钥是设置目标应用程序集成时发出的唯一字符串。

    服务操作身份验证

  7. 启用 启用请求速率限制 切换。为请求数输入 100,在时间间隔中输入 1 分钟
  8. (可选)启用日志记录开关以保留 24 小时的日志记录以供支持。

    速率限制和记录切换

  9. 选择 保存 以继续。
  10. OAuth 授权下,选择 授权 以使用您的服务帐户登录。此时将出现一个带有 Webex 登录屏幕的弹出窗口。
    1. 输入您的服务帐户用户名和密码,然后选择“登录”。
    2. 选择“接受”。 服务身份验证

微应用集成页面将打开,其中包含您添加的集成及其微应用。在这里,您可以添加另一个集成,继续设置现成的微应用,或者为此集成创建一个新的微应用。

现在,您可以设置和运行第一个数据同步。由于可以将大量数据从集成应用程序提取到 微应用平台,因此我们建议您使用页面筛选第一次数据同步的实体,以加快同步速度。有关详细信息,请参阅验证所需实体。有关同步规则、不符合其计划的同步以及否决规则的完整信息,请参阅 同步数据

有关 API 端点和表实体的更多详细信息,请参阅Webx HTTP 连接器规格

使用 Webex 会议微应用

现有的应用程序集成带有现成的微应用。从这些微应用开始,并根据您的需求定制它们。

创建会议: 使用选择持续时间、时区、被邀请者和共同主持人的选项安排会议。

通知或页面 用例工作流
“创建会议”页 提供一个表单,根据用户首选项安排具有以下详细信息的会议:会议标题、开始和结束时间、时区、重复(一次、每日、每周、每月)、密码、会议与会者和会议共同主持人。
集成 Webex