集成 GoToMeeting
部署 GotoMeeting 集成,从任何设备或内部网安排 GotoMeetings。使用 GotoMeeting 中 的 “创建 会议” 微应用,任何用户都可以举办一次性会议。
注意:
我们希望得到你的反馈!请在使 用此集成模板时提供反馈 。对于任何问题,我们的团队还将每天监控我们的 专门论坛 。
有关开箱即用的 GotoMeeting 微应用的完整列表,请参阅 使用 GoToMeeting 微应用。
查看必备项
这些先决条件假定管理员是组织的 GoToMeeting 集成设置的一部分。此 GotoMeeting 管理员帐户必须具有用户信息的完全读取权限。
与 GoToMeeting 设置此集成后,您将需要这些工件才能在 Citrix Workspace 微应用中添加集成,特别是以下用于设置 OAuth 集成的参数列表:
-
基本 URL:
https://api.getgo.com/
-
授权 URL:
https://api.getgo.com/oauth/v2/authorize
-
令牌 URL:
https://api.getgo.com/oauth/v2/token
- 客户端 ID:客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
- Secret:客户端密钥是设置目标应用程序集成时发出的唯一字符串。
-
帐户 ID:此值将替换 所有组织者 端点中的
your_accountId
参数。请参阅 收集帐户 ID。
注意:
我们建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
将 Citrix Gateway 配置为支持 GoToMeeting 的单点登录,这样一旦用户登录,他们将自动重新登录,而无需再次输入凭据。有关配置 SSO 的更多信息,请参阅 Citrix Gateway 服务。
集成需要定期访问您的 GoToMeeting 实例,因此我们建议您创建一个专用用户帐户。您可以使用 https://goto-developer.logmeininc.com/admin/#section/Overview/Users-Roles-Licenses-and-Groups 查看权限/特权。
- 服务帐户所需的权限:完全管理员权限
可以对特定资源发出的 API 请求数量有限,因此我们建议您执行以下操作:
- GoTto 会议 API 限制表单链接: https://goto-developer.logmeininc.com/guides/FAQ/Ref-Rate-Limits/
启用 API
默认情况下,GoTto Meeting API 是通过 Web 服务为付费帐户启用的。
创建一个新的服务帐号
在这里注册: https://developer.goto.com/. 有关新服务帐号的更多信息,请参阅: https://support.goto.com/meeting/new-gotomeeting-guide。
配置 OAuth 服务器
将 OAuth 服务器配置为通过 GoTO Meeting 集成读取数据。
- 使用您的服务帐户登录到 https://developer.goto.com/GoToMeetingV1。
- 在顶部导航栏中选择 OAuth 客户端 。
- 选择 创建新客户端。
-
填写详细信息,然后在重定向 URL 字段中输入此集成的以下授权 重定向 URL :
https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
- 在 “ 范围 ” 部分下,选中 “ 范围 ” 复选框。
- 选择保存。
- 复制并保存屏幕上显示的 clientId 和 S ecret 。配置集成时,可以将这些详细信息用于 服务身份验证 。
配置 OAuth 客户端
配置 OAuth 客户端以通过 GoTO Meeting 集成写回数据。
- 使用您的服务帐户登录 https://developer.goto.com/GoToMeetingV1,如上所述。
- 在顶部导航栏中选择 OAuth 客户端 。
- 选择 创建新客户端。
-
填写详细信息,然后在重定向 URL 字段中输入此集成的以下授权 重定向 URL :
https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
- 在 “ 范围 ” 部分下,选中 “ 范围 ” 复选框。
- 选择保存。
- 复制并保存屏幕上显示的 clientId 和 S ecret 。配置集成时,可以将这些详细信息用于 服务操作身份验证 。
收集帐户 ID
收集帐户 ID,然后使用此值替换 所有组织者 端点中的 your_accountId
参数。
- 使用管理员凭据登录 https://admin.logmeininc.com/portal/
- 看看主页上的 URL。使用此模型可以找到帐户 ID:
https://admin.logmeininc.com/portal/#accounts/<accountID>/users?filterType=usertype
- 复制并保存帐户 ID 以便在设置过程中使用。请参阅 替换数据加载值。
将集成添加到 Citrix Workspace 微应用
将 GotoMeeting 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。这样可以提供带有预配置通知和操作的开箱即用的微应用程序,这些通知和操作可在工作区中使用
请按照以下步骤进行操作:
- 在 微应用集成 页面中,选择 添加新集成,然后 从 Citrix 提供的模板中添加新集成。
- 选择 GoToMeeting 磁贴。
- 输入 集成的集成名称 。
- 输入 连接器参数。
- 输入实例 基本 URL:
https://api.getgo.com/
。 - 从 图标 库中选择用于集成的图标,或将其保留为默认图标。
- 输入实例 基本 URL:
-
在 服务身份验证下,从身份验证 方法 菜单中选择 OAuth 2.0 ,然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
- 从授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL。
- 从 令牌授权菜单中选择授权 标题。
-
授权 URL 已预先填充:
https://api.getgo.com/oauth/v2/token
。 -
令牌 URL 已预先填充:
https://api.getgo.com/oauth/v2/authorize
。 - 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 服务器时收集此密钥和密钥。您需要添加在集成配置页面上看到的 回调 URL 。
- 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
-
在服务操作身份验证下,启用在操作使用单独的用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。
- 从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。
- 从授权类型菜单中选择授权码。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL。
- 从 令牌授权菜单中选择授权 标题。
-
授权 URL 已预先填充:
https://api.getgo.com/oauth/v2/token
。 -
令牌 URL 已预先填充:
https://api.getgo.com/oauth/v2/authorize
。 - 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。您在配置 OAuth 客户端时收集此密钥和密钥。您需要添加在集成配置页面上看到的 回调 URL 。
- 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
-
启用 启用请求速率限制 开关。在 请求数 中输入 100 ,在 时间间隔 中输入 1 分钟。
- (可选)启用 日志记录 切换以保留 24 小时的日志记录以用于支持目的。
- 选择 保存 以继续。
- 在 OAuth 授权下,选择 授权 以使用您的服务帐户登录。此时将显示带有 Webex 登录屏幕的弹出窗口。
- 输入您的服务帐户用户名和密码,然后选择登录。
- 选择 接受。
替换数据加载值
替换 所有组织者 端点中的 your_accountId
参数。使用您在收集帐户 ID 中收 集的帐户 ID值。
- 在 微应用集成 页面中,选择 GotoMeeting 集成旁边的菜单,然后选择 编辑。将打开 “ 数据加载 ” 屏幕。如果您在配置屏幕中,请从左侧导航栏中选择 数据加载 。
- 选择 所有组织者 端点旁边的菜单,然后选择 编辑,或选择端点的名称: 所有组织者。
- 在 “编辑数据端点 ” 屏幕中,查找屏幕截图中所示的值。将此值替换为您之前收集的帐户 ID。
-
选择屏幕底部的 应用 并确认。
现在,您已准备好设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到微应用平台,因此我们建议您使用 “ 表 ” 页面筛选实体以进行首次数据同步,以加快同步速度。有关更多信息,请参阅验证所需实体。有关同步规则、不符合其计划的同步和否决规则的完整信息,请参阅同步数据。
有关 API 端点和表实体的更多详细信息,请参阅 GoToMeeting HTTP 连接器规范。
使用 GoToMeeting 微应用
现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始,然后根据您的需求自定义它们。
创建会议: 根据用户偏好安排会议。用户可以选择日期、开始时间和结束时间、密码和共同组织者。
通知或页面 | 用例工作流 |
---|---|
“创建会议” 页 | 提供根据用户首选项安排会议的表单,其中包含以下详细信息:会议主题、开始时间和结束时间、密码以及会议的联合组织者。 |
新会议页面 | 成功安排会议后,提供成功消息以及查看会议详细信息的选项(使用 “查看详细信息” 按钮)。 |
“会议详情” 页 | 提供有关用户安排的会议的详细信息。 |