Créer une connexion à une source de données avec des points d'extrémité REST

Vous pouvez vous connecter à des sources de données avec des points d'extrémité REST et analyser les données. Par exemple, connectez-vous à des applications de logiciel-service ou de plate-forme-service, ou des données officielles telles que des données météorologiques, spatiales ou de recensement.

La connexion à des données à l'aide de points d'extrémité REST vous permet d'analyser les données provenant de nombreuses applications de logiciel-service ou de plate-forme-service transactionnelles sans avoir à comprendre le format ou la structure interne des données.
Avant de commencer, créez un fichier JSON pour la source de données à laquelle vous vous connectez. Voir Spécifier les détails de connexion à un point d'extrémité REST dans un fichier JSON.
  1. Dans la page d'accueil d'Oracle Analytics, cliquez sur Créer, puis sur Connexion et enfin sur API REST (prévisualisation).
  2. Dans Nom de la connexion, spécifiez un nom convivial permettant d'identifier cette connexion dans Oracle Analytics.
  3. Cliquez sur Importer un fichier et sélectionnez le fichier ZIP du connecteur REST que vous avez créé comme préalable.
    Les champs Description et URL de base REST sont alimentés à partir du fichier importé, et la table des points d'extrémité affiche le nom et l'URL relative de chaque point d'extrémité disponible.
  4. Facultatif : Modifiez les points d'extrémité en fonction de vos exigences d'affaires. Par exemple, vous pouvez supprimer les points d'extrémité dont vous n'avez pas besoin.
    • Pour modifier un point d'extrémité, cliquez deux fois sur la valeur de Nom ou URL relative dans la table et modifiez le texte.
    • Pour ajouter un point d'extrémité, cliquez sur Ajouter un point d'extrémité afin d'ajouter une rangée dans la table, puis modifiez le nom et l'URL relative par défaut.
    • Pour supprimer un point d'extrémité, cliquez sur Supprimer une rangée à côté du point d'extrémité (c'est-à-dire X).
  5. Dans Authentification, sélectionnez la méthode de protection de la connexion.
    Conseil : Assurez-vous de sélectionner un type d'authentification qui correspond à la valeur du champ authentication-type spécifié dans le fichier JSON chargé. Voir Spécifier les détails de connexion à un point d'extrémité REST dans un fichier JSON.
    • Aucune authentification - Permet la connexion sans authentification. Utilisez cette option pour la connexion aux points d'extrémité publics.
    • De base - Authentifie la connexion avec un nom d'utilisateur et un mot de passe.
    • En-tête HTTP - Authentifie la connexion avec un jeton de sécurité.
    • Code OAuth2 - Permet la connexion à un client à l'aide d'un code d'autorisation généré dans votre application cible (appelé type de droit Code d'autorisation). Il s'agit du type de connexion OAuth2 le plus sécurisé.
    • Données d'identification de mot de passe OAuth2 - Permet la connexion à un client approuvé à l'aide d'un mot de passe (appelé type de droit Données d'identification de mot de passe ou Responsable de ressource). Utilisez ce type de connexion si vous utilisez un client approuvé.
    • OAuth2 implicite - Permet la connexion à un client à l'aide d'un code public généré dans votre application cible (appelé type de droit Code d'autorisation). Moins sécurisé que le type de connexion Code OAuth2, mais néanmoins plus facile à mettre en oeuvre.
    • Données d'identification de client OAuth2 - Permet la connexion à un client à l'aide d'un jeton (appelé type de droit Données d'identification du client).
    Pour des directives sur la spécification des détails de connexion OAuth2, voir Valeurs d'authentification OAuth2 pour les sources de données de type REST.
  6. Cliquez sur Enregistrer.

Valeurs d'authentification OAuth2 pour les sources de données de type REST

Lorsque vous vous connectez à une source de données de type REST à l'aide de l'un des types d'authentification OAuth2 (Code OAuth2, Données d'identification de mot de passe OAuth2, OAuth2 implicite ou Données d'identification de client OAuth2), vous êtes invité à spécifier les détails de connexion appropriés pour le type d'authentification que vous utilisez.

Champ ou option de boîte de dialogue Description

Autoriser

Cliquez sur Autoriser pour tester la connexion et demander les codes et jetons nécessaires.

URL Auth

Entrez l'URL pour la page d'authentification dans l'application cible. Par exemple, https://example.com/login/oauth/authorize.

ID client

Entrez l'ID client que vous copiez à partir de votre application cible, par exemple, Chimp, qui est généralement une chaîne de nombres entiers et de lettres.

Clé secrète client

Entrez la clé secrète client que vous copiez à partir de votre application cible, par exemple, Chimp, qui est généralement une chaîne de nombres entiers et de lettres.

Mot de passe

Entrez le mot de passe utilisé pour la connexion à l'application cible.

Portée

Entrez read: ou write: suivi du nom de la cible. Par exemple, read:org.

URL de jeton

Entrez l'URL d'autorisation fournie par l'application cible. Par exemple, https://example.com/login/oauth/access_token.

Nom d'utilisateur

Entrez le nom d'utilisateur utilisé pour la connexion à l'application cible.