JSON

Type de données

Flux de données personnalisé

Description

Comme pour le flux de données HTTP Get (avec la configuration OAuth2 facultative), le flux JSON extrait le contenu d’une URL fournie par le client et met ces données à la disposition d’une application Openmix. Les données sont supposées être toujours un JSON valide. Fusion enveloppe le résultat dans un objet JSON wrapper pour ajouter des métadonnées avant d’envoyer les données à Openmix. L’application Openmix est responsable de la récupération des données et de la prise de décisions concernant les conditions d’erreur.

Remarque : Les données JSON du client combinées avec l’enveloppe JSON doivent avoir une taille inférieure à 10 000 ou Fusion les rejettera. Il s’agit d’une limite stricte imposée par les serveurs d’applications d’infrastructure.

Semblable au flux de données HTTP Get Fusion, ce flux fournit également une intégration OAuth2 facultative (principalement utilisée pour récupérer des données à partir de l’API du portail).

Format de flux de données

Exemple de réussite : récupération de JSON valide

      {
        "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-->

Exemple de réussite : Récupération de données à partir de l’API du portail

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

Champs

• Corps : charge utile JSON validée récupérée à partir de l’URL du client ou de l’objet JSON vide « {} » si aucun JSON valide n’est récupéré
• Code de réponse : Indique si une requête HTTP spécifique a été effectuée avec succès.
• Statut : « Succès » si Fusion a reçu une réponse avec un JSON valide dans le corps. Sinon, un type d’échec, par exemple, « invalid_json », « failure », « timeout » et ainsi de suite
• Horodatage : chaîne ISO 8601 représentant l’heure UTC de l’appel Fusion.

Configurer dans Fusion

Vous pouvez accéder aux flux de données Fusion à partir du volet de navigation gauche, sous Openmix. Pour les étapes initiales, veuillez vous référer à Integration de Fusion Documentation.

Lorsque vous accédez à la boîte de dialogue de configuration spécifique au service, entrez les éléments suivants :

• Nom : nom donné au flux de données. La valeur par défaut est « Service - Platform Name » s’il n’est pas spécifié.
• Exécuter chaque : fréquence à laquelle le flux de données est mis à jour à partir du service.
• Plateforme : Plateforme associée au flux de données.
• URL : l’URL est un point de terminaison sur le réseau du client qui renvoie certaines données que le client souhaite voir dans Openmix. Le corps de la réponse est extrait de l’URL et poussé tel quel vers Openmix. La seule exigence est qu’il doit retourner un JSON valide.

Configuration OAuth2 facultative

La configuration OAuth2 facultative a été initialement conçue pour extraire les données Openmix et Radar via l’API Citrix ITM.

• Utilisez l’implémentation technique suivante :

  • Avant d’appeler le point de terminaison souhaité (cible) du client, obtenez d’abord un jeton de requête OAuth2
  • Le jeton OAuth2 est demandé via le point de terminaison du jeton du client.

• Dans la requête POST de jeton OAuth2 qui doit être HTTPS, le corps de requête suivant est transmis au générateur de jetons du client :

  • client_id (entrée utilisateur)
  • client_secret (entrée utilisateur)
  • grant_type, codé en dur àclient_credentials
• Un jeton OAuth2 est renvoyé pour les demandes d’API suivantes.
• Avec un jeton OAuth2 valide, l’URL cible du client est appelée passant dans l’en-tête deAuthorization: Bearer {token} requête

La bonne nouvelle pour l’implémentation JSON OAuth est que si vous appelez un point de terminaison API (Openmix ou radar), les champs de configuration OAuth2 ne sont pas requis. Fusion connaît déjà les informations d’identification du client OAuth2 de l’utilisateur et les transmet donc automatiquement pour toutes les URL API basées sur Citrix ITM.

Une fois l’installation terminée, le flux de données sera répertorié sur la page d’accueil des flux de données Fusion avec un état vert et des mesures de surveillance dans l’historique des journaux.

Pour modifier un flux de données Fusion, cliquez sur le flux de données dans la liste, puis cliquez sur le bouton Modifier. Une fois la configuration modifiée, cliquez sur Enregistrer. Cela vous ramène à la liste des flux de données avec vos modifications enregistrées et appliquées au flux de données.