Specifica dei dettagli della connessione agli endpoint REST in un file JSON

Prima di creare una connessione da Oracle Analytics Cloud agli endpoint REST di un'origine dati, creare un file JSON compresso contenente i dettagli della connessione.

È possibile scaricare un modello JSON dalla Libreria pubblica di Oracle Analytics. Memorizzare i dettagli della connessione in un file JSON basato sul modello, quindi comprimere il file JSON nel formato ZIP. È inoltre possibile scaricare i file JSON di esempio per una serie di applicazioni SaaS e PaaS.

Formato del modello JSON per la connessione agli endpoint 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"
    }
}

Esempio JSON per la connessione agli endpoint 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"
    }
}

Informazioni sull'autenticazione OAuth2

Prima di iniziare, assicurarsi che l'origine dati di destinazione supporti l'autenticazione OAuth2: non tutte le origini dati supportano OAuth2.

Quando si crea il file JSON utilizzando uno dei modelli scaricati, specificare il tipo di autenticazione appropriato nel campo authentication-type.

Tipi di OAuth2 Valori validi per il campo authentication-type.
Codice OAuth2 OAuth2Code
Credenziali password OAuth2 OAUTH2PasswordGrant
OAuth2 - Implicito OAUTH2ImplicitGrant
Credenziali client OAuth2 OAUTH2ClientCredentials

In questo esempio, il metodo di autenticazione Credenziali password OAuth2 viene specificato utilizzando "OAUTH2PasswordGrant" come valore di authentication-type.
Segue la descrizione di GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png
.png

Altri suggerimenti per la creazione del file JSON

  • Rimuovere i parametri e i valori non necessari dal file.
  • Assicurarsi che il valore del tipo di autenticazione sia impostato su noauth, BasicAuth, HttpHeader o una delle impostazioni OAuth2 presenti nella tabella precedente.