Externa datakällor external-data-sources

Arbeta med externa datakällor gs-ext-data-sources

Med externa datakällor kan du definiera en anslutning till tredjepartssystem, till exempel om du använder ett bokningssystem för hotell för att kontrollera om personen har registrerat ett rum. Till skillnad från den inbyggda datakällan Adobe Experience Platform kan du skapa så många externa datakällor du behöver.

REST API:er som använder POST eller GET och returnerar JSON stöds. API-nyckel, grundläggande och anpassade autentiseringslägen stöds.

Låt oss ta ett exempel på en API-tjänst för väder som jag vill använda för att anpassa kundens beteenden efter väderdata i realtid.

Här är två exempel på API-anropet:

Anropet består av en huvud-URL (https://api.adobeweather.org/weather), två parameteruppsättningar (“city” för staden och"lat/long" för latitud och longitud) och API-nyckeln (appid).

Skapa och konfigurera en extern datakälla create-ext-data-sources

Nedan beskrivs de viktigaste stegen för att skapa och konfigurera en ny extern datakälla:

Endast alfanumeriska tecken och understreck tillåts. Maximala längden är 30 tecken.

För parameteruppsättningen"long/lat" skapar vi en fältgrupp med följande information:

Om ett GET-anrop kräver parametrar anger du parametrarna i fältet Dynamic Values och de läggs till automatiskt i slutet av anropet. Vid ett POST-samtal måste du:

{"id":{"param":"identifier"}}

När dina ändringar har sparats är datakällan konfigurerad och klar att användas i dina resor, till exempel under dina förhållanden eller för att anpassa ett e-postmeddelande. Om temperaturen är över 30°C kan du välja att skicka ett visst meddelande.

Anpassat autentiseringsläge custom-authentication-mode

Det anpassade autentiseringsläget används för komplex autentisering, som ofta används för att anropa API-omslutningsprotokoll som OAuth2, för att hämta en åtkomsttoken som ska injiceras i den faktiska HTTP-begäran för åtgärden.

När du konfigurerar den anpassade autentiseringen använder du knappen Click to check the authentication för att kontrollera om den anpassade autentiseringsnyttolasten är korrekt konfigurerad.

När testet är klart blir knappen grön.

I det här autentiseringsläget är åtgärdskörningen en tvåstegsprocess:

Definition av slutpunkten som ska anropas för att generera åtkomsttoken custom-authentication-endpoint

Definition av hur åtkomsttoken måste matas in i åtgärdens HTTP-begäran custom-authentication-access-token

Autentiseringsformatet är:

{
    "type": "customAuthorization",
    "endpoint": "<URL of the authentication endpoint>",
    "method": "<HTTP method to call the authentication endpoint, in 'GET' or 'POST'>",
    (optional) "headers": {
        "<header name>": "<header value>",
        ...
    },
    (optional, mandatory if method is 'POST') "body": {
        "bodyType": "<'form'or 'json'>,
        "bodyParams": {
            "param1": value1,
            ...
        }
    },
    "tokenInResponse": "<'response' or json selector in format 'json://<field path to access token>'",
    "cacheDuration": {
        (optional, mutually exclusive with 'duration') "expiryInResponse": "<json selector in format 'json://<field path to expiry>'",
        (optional, mutually exclusive with 'expiryInResponse') "duration": <integer value>,
        "timeUnit": "<unit in 'milliseconds', 'seconds', 'minutes', 'hours', 'days', 'months', 'years'>"
    },
    "authorizationType": "<value in 'bearer', 'header' or 'queryParam'>",
    (optional, mandatory if authorizationType is 'header' or 'queryParam') "tokenTarget": "<name of the header or queryParam if the authorizationType is 'header' or 'queryParam'>",
}

Du kan ändra cachevaraktigheten för token för en anpassad autentiseringsdatakälla. Nedan visas ett exempel på en anpassad autentiseringsnyttolast. Cachevaraktigheten definieras i parametern cacheDuration. Den anger kvarhållningstiden för den genererade token i cachen. Enheten kan vara millisekunder, sekunder, minuter, timmar, dagar, månader, år.

Här följer ett exempel på autentiseringstypen för innehavare:

{
    "type": "customAuthorization",
    "endpoint": "https://<your_auth_endpoint>/epsilon/oauth2/access_token",
    "method": "POST",
    "headers": {
      "Authorization": "Basic EncodeBase64(<epsilon Client Id>:<epsilon Client Secret>)"
    },
    "body": {
      "bodyType": "form",
      "bodyParams": {
        "scope": "cn mail givenname uid employeeNumber",
        "grant_type": "password",
        "username": "<epsilon User Name>",
        "password": "<epsilon User Password>"
      }
    },
    "tokenInResponse": "json://access_token",
    "cacheDuration": {
      "duration": 5,
      "timeUnit": "minutes"
    },
  },

Certifikatbaserad anpassad autentisering certificate-credential

För företags-API:er som framtvingar certifikatbaserad identitetsverifiering - t.ex. Microsoft Entra ID - kan du konfigurera certifikatbaserad anpassad autentisering genom att lägga till "subType": "certificateCredential" i din anpassade autentiseringsnyttolast. Journey Optimizer använder Adobe hanterade certifikat för att signera en JWT-klientkontroll och byta ut den mot en åtkomsttoken. Ingen klienthemlighet krävs.

Det här alternativet lägger till två obligatoriska fält i standardschemat customAuthorization: subType och aud . Alla andra fält (endpoint, method, body params, tokenInResponse) förblir oförändrade. När subType inte finns är beteendet identiskt med standardautentiseringen - befintliga konfigurationer påverkas inte.

Fälten client_assertion och client_assertion_type skrivs aldrig av användaren. De injiceras automatiskt av plattformen vid körning, omedelbart före token-slutpunktsanropet.

Här är ett exempel på autentiseringstypen för certifikatautentisering:

{
  "type": "customAuthorization",
  "subType": "certificateCredential",
  "aud": "https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token",
  "authorizationType": "Bearer",
  "endpoint": "https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token",
  "method": "POST",
  "body": {
    "bodyType": "form",
    "bodyParams": {
      "client_id": "<your-client-id>",
      "grant_type": "client_credentials",
      "scope": "https://api.example.com/.default"
    }
  },
  "tokenInResponse": "json://access_token"
}

Här är ett exempel på autentiseringstypen för sidhuvud:

{
  "type": "customAuthorization",
  "endpoint": "https://myapidomain.com/v2/user/login",
  "method": "POST",
  "headers": {
    "x-retailer": "any value"
  },
  "body": {
    "bodyType": "form",
    "bodyParams": {
      "secret": "any value",
      "username": "any value"
    }
  },
  "tokenInResponse": "json://token",
  "cacheDuration": {
    "expiryInResponse": "json://expiryDuration",
    "timeUnit": "minutes"
  },
  "authorizationType": "header",
  "tokenTarget": "x-auth-token"
}

Här är ett exempel på svaret på inloggnings-API-anropet:

{
  "token": "xDIUssuYE9beucIE_TFOmpdheTqwzzISNKeysjeODSHUibdzN87S",
  "expiryDuration" : 5
}