Externe databronnen concept_t2s_kqt_52b

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 POST of GET gebruiken 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).

Hier volgen de belangrijkste stappen voor het maken en configureren van een nieuwe externe gegevensbron:

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:

Klik op Save .

De gegevensbron is nu geconfigureerd en klaar om te worden gebruikt in uw reizen, bijvoorbeeld in uw omstandigheden, of om een e-mail aan te passen. Als de temperatuur boven 30°C ligt, kunt u besluiten een specifieke communicatie te sturen.

Aangepaste verificatiemodus section_wjp_nl5_nhb

Deze authentificatiemodus 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, kunt u op de hieronder knoop klikken om te controleren of wordt de lading van de douaneauthentificatie correct gevormd.

Als de test succesvol is, wordt de knoop groen.

Bij deze verificatie is de uitvoering van de handeling een proces dat uit twee stappen bestaat:

Deze verificatie bestaat uit twee delen.

De definitie van het eindpunt dat moet worden geroepen om het toegangstoken te produceren:

De definitie van de manier waarop het toegangstoken in het HTTP- verzoek van de actie moet worden ingespoten:

De indeling van deze verificatie is:

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

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 cacheduur 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.

"authentication": {
    "type":"customAuthorization",
    "authorizationType":"Bearer",
    "endpoint":"http://localhost:${port}/epsilon/oauth2/access_token",
    "method":"POST",
    "headers": {
        "Authorization":"Basic EncodeBase64(${epsilonClientId}:${epsilonClientSecret})"
        },
    "body": {
        "bodyType":"form",
        "bodyParams": {
             "scope":"cn mail givenname uid employeeNumber",
             "grant_type":"password",
             "username":"${epsilonUserName}",
             "password":"${epsilonUserPassword}"
             }
        },
    "tokenInResponse":"json://access_token",
    "cacheDuration":
             { "duration":5, "timeUnit":"seconds" }
    }