הגדרת פרטי חיבור נקודת קצה של REST בקובץ JSON

לפני שתיצור חיבור מ-Oracle Analytics Cloud אל נקודות קצה REST של מקור נתונים, צור קובץ JSON ב-zip המכיל את פרטי החיבור.

תוכל להוריד את תבנית ה-JSON מ-Oracle Analytics Public Library. אחסן את פרטי החיבור בקובץ JSON המבוסס על התבנית, ולאחר מכן דחוס את קובץ ה-JSON בפורמט של ZIP. תוכל להוריד גם קובצי JSON לדוגמה לטווח יישומים של SaaS ושל PaaS.

פורמט תבנית JSON להתחברות אל נקודות קצה של 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"
    }
}

דוגמת JSON להתחברות אל נקודות קצה 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"
    }
}

אודות אימות זהות של OAuth2

לפני שתתחיל, ודא שמקור הנתונים היעד שלך תומך באימות זהות של OAuth2; לא כל מקורות הנתונים תומכים ב-OAuth2.

כאשר אתה יוצר את קובץ ה-JSON באמצעות אחת מהתבניות שהורדת, ציין את סוג אימות הזהות המתאים בשדה סוג אימות זהות.

סוגי OAuth2 ערכים תקפים לשדה סוג אימות זהות.
קוד OAuth2 OAuth2Code
פרטי אימות סיסמה של OAuth2 OAUTH2PasswordGrant
OAuth2 במשתמע OAUTH2ImplicitGrant
פרטי אימות לקוח של OAuth2 OAUTH2ClientCredentials

בדוגמה זו, שיטת אימות הזהות 'פרטי אימות סיסמה של OAuth2' מוגדרת באמצעות "OAUTH2PasswordGrant" כערך סוג אימות זהות.
להלן תיאור של GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png
.png

עצות נוספות ליצירת קובץ JSON

  • הסר פרמטרים וערכים מיותרים מהקובץ.
  • ודא שערך סוג אימות הזהות מוגדר ל-noauth, BasicAuth, HttpHeader או אחת מהגדרות OAuth2 בטבלה למעלה.