JSON

Art der Daten

Benutzerdefinierter Datenfeed

Beschreibung

Ähnlich wie der HTTP-Get Data Feed (mit optionaler OAuth2-Konfiguration) zieht der JSON-Feed Inhalte von einer vom Kunden bereitgestellten URL ab und stellt diese Daten einer Openmix-Anwendung zur Verfügung. Es wird davon ausgegangen, dass die Daten immer ein gültiger JSON sind. Fusion umschließt das Ergebnis in ein Wrapper-JSON-Objekt, um Metadaten hinzuzufügen, bevor die Daten an Openmix gesendet werden. Die Openmix App ist dafür verantwortlich, die Daten abzurufen und Entscheidungen über Fehlerbedingungen zu treffen.

Hinweis: Die JSON-Daten des Kunden in Kombination mit dem JSON-Wrapper müssen weniger als 10 KB groß sein, sonst lehnt Fusion sie ab. Dies ist eine harte Grenze, die von den Infrastruktur-App-Servern auferlegt wird.

Ähnlich wie der HTTP Get Fusion Datenfeed bietet dieser Feed auch eine optionale OAuth2-Integration (hauptsächlich zum Abrufen von Daten aus der Portal-API).

Datenfeed-Format

Erfolgsbeispiel: Abrufen von gültigem 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-->

Erfolgsbeispiel: Abrufen von Daten aus der Portal-API

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

Felder

  • Text: Validierte JSON-Nutzlast, die von der Kunden-URL oder einem leeren JSON-Objekt “{}” abgerufen wird, wenn kein gültiger JSON abgerufen wurde
  • Antwortcode: Gibt an, ob eine bestimmte HTTP-Anforderung erfolgreich abgeschlossen wurde.
  • Status: “Erfolg”, wenn Fusion eine Antwort mit einem gültigen JSON im Body erhalten hat. Andernfalls eine Art von Fehler, z. B. “invalid_json”, “failure”, “timeout” usw.
  • Zeitstempel: ISO 8601-Zeichenfolge, die die UTC-Zeit des Fusion-Aufrufs darstellt.

In Fusion einrichten

Sie können im linken Navigationsbereich unter Openmixauf Fusion Data Feeds zugreifen. Erste Schritte finden Sie in der Fusion IntegrationDokumentation.

Im Dialogfeld für die dienstspezifische Konfiguration geben Sie Folgendes ein:

  • Name: Der Name, der dem Datenfeed gegeben wurde. Dies wird standardmäßig auf “Service - Plattformname” gesetzt, wenn nicht angegeben.
  • Ausführen alle: Die Häufigkeit, mit der der Datenfeed vom Dienst aktualisiert wird.
  • Plattform: Die Plattform, die dem Datenfeed zugeordnet ist.
  • URL: Die URL ist ein Endpunkt im Netzwerk des Kunden, der einige Daten zurückgibt, die der Kunde in Openmix sehen möchte. Der Antworttext wird von der URL abgerufen und unverändert an Openmix übertragen. Die einzige Voraussetzung ist, dass es gültige JSON zurückgeben muss.

Optionale OAuth2-Konfiguration

Die optionale OAuth2-Konfiguration wurde ursprünglich entwickelt, um Openmix- und Radar-Daten über die Citrix ITM-API abzurufen.

  • Verwenden Sie die folgende technische Implementierung:

    • Bevor Sie den gewünschten (Ziel-) Endpunkt des Kunden aufrufen, erhalten Sie zuerst ein OAuth2-Anforderungstoken
    • Das OAuth2-Token wird über den Token-Endpunkt des Kunden angefordert.
  • In der OAuth2-Token POST-Anforderung, die HTTPS sein muss, wird der folgende Anforderungstext an den Token-Generator des Kunden übergeben:

    • client_id (Benutzereingabe)
    • client_secret (Benutzereingabe)
    • grant_type, fest codiert inclient_credentials
  • Für nachfolgende API-Anforderungen wird ein OAuth2-Token zurückgegeben.
  • Bei einem gültigen OAuth2-Token wird die Ziel-URL des Kunden als Übergabe desAuthorization: Bearer {token} Anforderungs-Headers aufgerufen

Die gute Nachricht für die JSON OAuth-Implementierung ist, dass, wenn Sie einen API-Endpunkt (Openmix oder Radar) aufrufen, die OAuth2-Konfigurationsfelder nicht erforderlich sind. Fusion kennt die OAuth2-Client-Anmeldeinformationen des Benutzers bereits und übergibt sie daher automatisch für alle Citrix ITM-basierten API-URLs.

Sobald die Installation abgeschlossen ist, wird der Datenfeed auf der Fusion Data Feeds Homepage mit einem grünen Status und Überwachungsmetriken im Protokollverlauf aufgeführt.

Um einen Fusion-Datenfeed zu bearbeiten, klicken Sie auf den Datenfeed in der Liste und dann auf die Schaltfläche Bearbeiten . Nachdem Sie die Konfiguration geändert haben, klicken Sie auf Speichern. Dadurch gelangen Sie zurück zur Datenfeed-Liste, in der Ihre Änderungen gespeichert und auf den Datenfeed angewendet werden.

JSON