Externe databronnen external-data-sources

Werken met externe gegevensbronnen gs-ext-data-sources

Met externe gegevensbronnen kunt u een verbinding met systemen van derden definiëren, bijvoorbeeld als u een boekingssysteem voor hotels gebruikt om te controleren of de persoon een kamer heeft geregistreerd. In tegenstelling tot de ingebouwde Adobe Experience Platform gegevensbron kunt u zoveel externe gegevensbronnen maken als u nodig hebt.

REST-API’s die gebruikmaken van POST of GET en JSON retourneren, worden ondersteund. API-sleutel, standaard- en aangepaste verificatiemodi worden ondersteund.

Laten we het voorbeeld nemen van een weerdienst van API die ik wil gebruiken om het gedrag van mijn reis aan te passen aan weergegevens in real time.

Hier volgen twee voorbeelden van de API-aanroep:

De vraag wordt samengesteld uit een belangrijkste URL (https://api.adobeweather.org/weather), twee parametersreeksen ("stad"voor de stad en "lang/lang"voor de breedte en lengtegraad) en API sleutel (toegevoegd).

Een externe gegevensbron maken en configureren create-ext-data-sources

Hieronder vindt u de belangrijkste stappen voor het maken en configureren van een nieuwe externe gegevensbron:

Alleen alfanumerieke tekens en onderstrepingstekens zijn toegestaan. De maximumlengte is 30 tekens.

Voor de parameterset “long/lat” maken we een veldgroep met de volgende informatie:

Als een GET-aanroep parameters vereist, voert u de parameter(s) in het veld Dynamic Values in en worden deze automatisch aan het einde van de aanroep toegevoegd. In het geval van een vraag van de POST, moet u:

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

Zodra uw veranderingen worden bewaard, wordt de gegevensbron gevormd en klaar om in uw reizen, bijvoorbeeld in uw voorwaarden te worden gebruikt of een e-mail te personaliseren. Als de temperatuur boven 30°C ligt, kunt u besluiten een specifieke communicatie te sturen.

Aangepaste verificatiemodus custom-authentication-mode

De wijze van de douaneauthentificatie wordt gebruikt voor complexe authentificatie, vaak gebruikt om API omsluitende protocollen zoals OAuth2 te roepen, om een toegangstoken terug te winnen dat in het echte HTTP- verzoek voor de actie moet worden ingespoten.

Wanneer u de douaneauthentificatie vormt, gebruik de Click to check the authentication knoop om te controleren als de lading van de douaneauthentificatie correct wordt gevormd.

Wanneer de test succesvol is, wordt de knoop groen.

In deze verificatiemodus bestaat de uitvoering van de handeling uit twee stappen:

Definitie van het eindpunt dat moet worden geroepen om het toegangstoken te produceren custom-authentication-endpoint

Definitie van de manier waarop het toegangstoken in het HTTP- verzoek van de actie moet worden ingespoten custom-authentication-access-token

De indeling van deze verificatie is:

{
    "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'>",
}

U kunt de geheim voorgeheugenduur van het teken voor een bron van de douaneauthentificatiegegevens veranderen. Hieronder ziet u een voorbeeld van een aangepaste payload voor verificatie. De duur van de cache wordt gedefinieerd in de parameter cacheDuration . Hiermee wordt de retentieduur van het gegenereerde token in de cache opgegeven. De eenheid kan milliseconden, seconden, minuten, uren, dagen, maanden, jaren zijn.

Hier is een voorbeeld voor het dragerauthentificatietype:

{
    "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"
    },
  },

Aangepaste verificatie op basis van certificaten certificate-credential

Voor onderneming-API’s die verificatie van de identiteit op basis van certificaten afdwingen, zoals de Microsoft Entra-id, kunt u op certificaten gebaseerde aangepaste verificatie configureren door "subType": "certificateCredential" toe te voegen aan de aangepaste payload van de autorisatie. Journey Optimizer gebruikt door Adobe beheerd certificaat om een JWT-clientbevestiging te ondertekenen en deze voor een toegangstoken uit te wisselen. Er is geen clientgeheim vereist.

Met deze optie voegt u twee verplichte velden toe aan het standaardschema customAuthorization : subType en aud . Alle andere velden (endpoint , method , body params tokenInResponse ) blijven ongewijzigd. Wanneer subType afwezig is, is het gedrag identiek aan standaard douaneauthentificatie — bestaande configuraties worden niet beïnvloed.

De velden client_assertion en client_assertion_type worden nooit door de gebruiker geschreven. Zij worden automatisch geïnjecteerd door het platform bij runtime, onmiddellijk vóór de symbolische eindpuntvraag.

Hier volgt een voorbeeld van het verificatietype voor certificaatreferentie:

{
  "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"
}

Hier ziet u een voorbeeld van het type headerverificatie:

{
  "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"
}

Hier is een voorbeeld van de reactie van de login API vraag:

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