Spécification des détails de connexion à une adresse REST dans un fichier JSON

Avant de créer une connexion d'Oracle Analytics Cloud vers les adresses REST d'une source de données, créez un fichier JSON compressé contenant les détails de connexion.

Vous pouvez télécharger un modèle JSON à partir de la bibliothèque publique Oracle Analytics. Stockez les détails de connexion dans un fichier JSON reposant sur le modèle, puis compressez ce fichier JSON au format ZIP. Vous pouvez également télécharger des exemples de fichiers JSON pour un large éventail d'applications SaaS et PaaS.

Formatage du modèle JSON pour la connexion à des adresses REST

{
    "name": "Connection name",
    "description": "Brief description",
    "baseURL": "URL, e.g. https://api.surveymonkey.com/v3",
    "endpoints": {
        "Endpoint 1": "Endpoint 1 URL, e.g. https://api.surveymonkey.com/v3/users/endpoint1",
        "Endpoint 2": "Endpoint 2 URL, e.g. https://api.surveymonkey.com/v3/question_bank/endpoint2",
        "Endpoint n": "Endpoint n URL, e.g. https://api.surveymonkey.com/v3/users/endpointn"
    },
    "authentication": {
        "type": "Authentication type"
    }
}

Exemple JSON pour la connexion à des adresses REST Survey Monkey

{
    "name": "Survey Monkey Connection",
    "description": "Survey Monkey connection",
    "baseURL": "https://api.surveymonkey.com/v3",
    "endpoints": {
        "Users": "https://api.surveymonkey.com/v3/users/me",
        "Questions": "https://api.surveymonkey.com/v3/question_bank/questions"
    },
    "authentication": {
        "type": "HttpHeader"
    }
}

A propos de l'authentification OAuth2

Avant de commencer, assurez-vous que la source de données cible prend en charge l'authentification OAuth2, ce qui n'est pas le cas de toutes les sources de données.

Lorsque vous créez le fichier JSON à l'aide de l'un des modèles téléchargés, indiquez le type d'authentification approprié dans le champ authentication-type.

Types OAuth2 Valeurs valides pour le champ authentication-type
Code OAuth2 OAuth2Code
Informations d'identification par mot de passe OAuth2 OAUTH2PasswordGrant
OAuth2 implicite OAUTH2ImplicitGrant
Informations d'identification de client OAuth2 OAUTH2ClientCredentials

Dans cet exemple, la méthode d'authentification Informations d'identification par mot de passe OAuth2 est indiquée à l'aide de "OAUTH2PasswordGrant" comme la valeur de authentication-type.
La description de GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png est la suivante
.png

Autres conseils concernant la création du fichier JSON

  • Enlevez les valeurs et les paramètres inutiles du fichier.
  • Assurez-vous que la valeur du type d'authentification est définie sur noauth, BasicAuth, HttpHeader ou sur l'un des paramètres OAuth2 dans le tableau ci-dessus.