JSON

データの種類

カスタムデータフィード

説明

HTTP Get データフィード (オプションの OAuth2 設定) と同様に、JSON フィードは顧客提供の URL からコンテンツをプルし、Openmix アプリケーションでこのデータを使用できるようにします。データは、常に有効な JSON であると見なされます。Fusion は、データを Openmix に送信する前に、結果をラッパー JSON オブジェクトにラップし、メタデータを追加します。Openmix アプリは、データの取得とエラー条件の決定を行います。

注: JSON ラッパーと組み合わせた顧客の JSON データのサイズは 10 K 未満である必要があります。そうしないと、Fusion はそれを拒否します。これは、インフラストラクチャアプリサーバーによって課されるハードリミットです。

HTTP Get 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」、「失敗」、「タイムアウト」など、何らかの種類の失敗
• タイムスタンプ: Fusion呼び出しの UTC 時刻を表す ISO 8601 文字列。

Fusionでセットアップする

Fusion データフィードには、左側のナビゲーションウィンドウの Openmixの下からアクセスできます。最初の手順については、Fusionインテグレーションドキュメントを参照してください。

サービス固有の設定ダイアログボックスが表示されたら 、次のように入力します。

• 名前: データフィードに与えられた名前。指定しない場合、デフォルトは「サービス-プラットフォーム名」になります。
• 実行間隔: データフィードがサービスから更新される頻度。
• プラットフォーム: データフィードに関連付けられているプラットフォーム。
• URL: URL は、顧客が Openmix で見たいデータを返す、お客様のネットワーク上のエンドポイントです。レスポンス本文は URL から取得され、そのままOpenmixにプッシュされます。唯一の要件は、有効な JSON を返す必要があることです。

オプションの OAuth2 設定

オプションの OAuth2 構成は、もともと Citrix ITM API 経由でOpenmixとレーダーデータをプルするように設計されています。

• 次の技術的な実装を使用します。

  • お客様の希望の（ターゲット）エンドポイントを呼び出す前に、まず OAuth2 リクエストトークンを取得します
  • OAuth2 トークンは、顧客のトークンエンドポイントを介して要求されます。

• HTTPS である必要がある OAuth2 トークン POST 要求では、次のリクエスト本文が顧客のトークンジェネレータに渡されます。

  • client_id (ユーザ入力)
  • client_secret (ユーザ入力)
  • grant_type、client_credentialsにハードコードされている
• 後続の API リクエストでは、OAuth2 トークンが返されます。
• 有効なOAuth2トークンを使用すると、顧客のターゲットURLが呼び出されてAuthorization: Bearer {token} リクエストヘッダーでパスします

JSON OAuth 実装の朗報は、API エンドポイント (Openmix またはレーダー) を呼び出す場合、OAuth2 設定フィールドは必要ないということです。Fusion は、ユーザーの OAuth2 クライアント資格情報をすでに認識しているため、すべてのCitrix ITMベースのAPI URLに対して自動的に渡されます。

インストールが完了すると、Fusion データフィードのホームページにデータフィードが表示され、ログ履歴に緑色のステータスとモニタリングメトリックが表示されます。

Fusion データフィードを編集するには、一覧のデータフィードをクリックし、[ 編集 ] ボタンをクリックします。設定を変更したら、[ 保存] をクリックします。これにより、変更を保存してデータフィードに適用したデータフィードリストに戻ります。