JSON

数据类型

自定义数据源

说明

与 HTTP 获取数据源(使用可选的 OAuth2 配置)类似,JSON 源从客户提供的 URL 中提取内容,并将此数据提供给 Openmix 应用程序。假定数据始终是有效的 JSON。Fusion将结果封装在一个包装 JSON 对象中,以便在将数据发送到 Openmix 之前添加元数据。Openmix 应用程序负责检索数据并对错误条件做出任何决定。

注意:客户的 JSON 数据与 JSON 包装相结合的大小必须低于 10K,否则 Fusion 将拒绝它。这是基础结构应用程序服务器施加的硬限制。

与 HTTP 获取Fusion数据源类似,此源还提供了可选的 OAuth2 集成(主要用于从门户 API 检索数据)。

数据源格式

成功示例:检索有效的 JSON

      {
        "body": {
          "active_user_sessions": 9,
          "available": "YES",
          "component": "fusion",
          "current_time": "2017-05-31 17:16:19"
        },
          "responseCode": 200,
          "status": "success",
          "timestamp": "2017-05-31T17:16:19.655Z"
      }
<!--NeedCopy-->

成功示例:从门户 API 检索数据

{"body":[["Akamai CDN,"856244],["Telenor CDN,"1575138],["Arkena North,"1567285]],"timestamp":"2017-04-18T19:21:20.490Z","responseCode":200,"status":"success"}

字段

  • 正文: 如果没有检索到有效的 JSON,则从客户 URL 或空 JSON 对象“{}”检索到验证的 JSON 有效负载
  • 响应代码: 指示特定 HTTP 请求是否已成功完成。
  • 状态: 如果 Fusion 在正文中收到了有效 JSON 的响应,则状态为“成功”。否则,某种类型的失败,例如“invalid_json”、“失败”、“超时”等
  • 时间戳: ISO 8601 字符串表示 Fusion 调用的 UTC 时间。

在Fusion中设置

您可以从左侧导航窗格中的 Openmix下访问 Fusion 数据源。有关初始步骤,请参阅Fusion 集成文档

进入 特定于服务的配置 对话框时,输入以下内容:

  • 名称: 给数据源的名称。如果未指定,则默认为“服务-平台名称”。
  • 每次运行: 从服务更新数据源的频率。
  • 平台: 与数据源关联的平台。
  • URL:URL 是客户网络上的终端节点,用于返回客户希望在 Openmix 中看到的一些数据。响应正文从 URL 中检索并按原样推送到 Openmix。唯一的要求是它必须返回有效的 JSON。

可选的 OAuth2 配置

可选 OAuth2 配置最初旨在通过 Citrix ITM API 提取 Openmix 和 Radar 数据。

  • 使用以下技术实现:

    • 在调用客户所需(目标)终端节点之前,首先获取 OAuth2 请求令牌
    • OAuth2 令牌是通过客户的令牌终端节点请求的。
  • 在必须为 HTTPS 的 OAuth2 令牌 POST 请求中,以下请求正文将传递给客户的令牌生成器:

    • client_id(用户输入)
    • client_secret(用户输入)
    • grant_type,硬编码为 client_credentials
  • 为后续 API 请求返回 OAuth2 令牌。
  • 使用有效的 OAuth2 令牌,客户的目标 URL 被调用,传入请Authorization: Bearer {token} 求标头

JSON OAuth 实现的好消息是,如果您正在调用 API 端点(即 Openmix 或 Radar),OAuth2 配置字段不是必填项Fusion 已经知道用户的 OAuth2 客户端凭据,因此将其自动传递给所有基于 Citrix ITM 的 API URL。

安装完成后,数据源将在 Fusion 数据源主页上列出,并在日志历史记录中显示绿色状态和监视指标。

要编辑Fusion数据源,请单击列表中的数据源,然后单击编 按钮。更改配置后,单击保存。这将使您返回到数据源列表,并将更改保存并应用于数据源。

JSON