Las fuentes de datos externas permiten definir una conexión a sistemas de terceros, por ejemplo, si utiliza un sistema de reserva de hoteles para comprobar si la persona ha registrado una habitación. A diferencia de la fuente de datos integrada de Adobe Experience Platform, puede crear tantas fuentes de datos externas como necesite.
Las protecciones cuando se trabaja con sistemas externos se enumeran en esta página.
Las API de REST que utilizan POST o GET y arrojan JSON son compatibles. Se admiten los modos de autenticación básica y personalizada de la clave de API.
Veamos el ejemplo de un servicio de API meteorológica que quiero usar para personalizar el comportamiento de mi recorrido según los datos del tiempo real.
Estos son dos ejemplos de llamada API:
La llamada se compone de una dirección URL principal (https://api.adobeweather.org/weather), dos conjuntos de parámetros ("ciudad" para la ciudad y "lat/long" para la latitud y longitud) y la clave de API (appid).
Estos son los pasos principales para crear y configurar una nueva fuente de datos externa:
En la lista de fuentes de datos, haga clic en Crear fuente de datos para crear una nueva fuente de datos externa.
Se abre el panel de configuración de la fuente de datos en el lado derecho de la pantalla.
Escriba un nombre para la fuente de datos.
No utilice espacios ni caracteres especiales. No utilice más de 30 caracteres.
Añada una descripción a la fuente de datos. Este paso es opcional.
Añada la dirección URL del servicio externo. En nuestro ejemplo: https://api.adobeweather.org/weather.
Recomendamos encarecidamente utilizar HTTPS por motivos de seguridad. Además, tenga en cuenta que no permitimos el uso de direcciones de Adobe que no están disponibles para el público ni de direcciones IP.
Configure la autenticación según la configuración del servicio externo: Sin autenticación, Básico, Personalizado o Clave de API. Para obtener más información sobre el modo de autenticación personalizada, consulte esta sección. En nuestro ejemplo, elegimos:
Añada un nuevo grupo de campos a cada conjunto de parámetros de API haciendo clic en Agregar nuevo grupo de campos. No utilice espacios ni caracteres especiales en el nombre del grupo de campos. En nuestro ejemplo, necesitamos crear dos grupos de campos, uno para cada conjunto de parámetros (city y long/lat).
Para el conjunto de parámetros "long/lat", creamos un grupo de campos con la siguiente información:
Utilizado en: muestra el número de recorridos que utilizan un grupo de campos. Puede hacer clic en Ver recorridos para mostrar la lista de recorridos que utilizan este grupo de campos.
Método: seleccione el POST o el método de GET. En nuestro caso, seleccionamos el método GET.
Valores dinámicos: introduzca los diferentes parámetros separados por coma, "long,lat" en nuestro ejemplo. Dado que los valores de parámetro dependen del contexto de ejecución, se definirán en los recorridos. Más información
Carga de respuesta: haga clic dentro de Carga útil y pegue un ejemplo de la carga útil devuelta por la llamada. Para nuestro ejemplo, hemos utilizado una carga útil encontrada en un sitio web de la API meteorológica. Compruebe que los tipos de campo son correctos. Cada vez que se llama a la API, el sistema recupera todos los campos incluidos en el ejemplo de carga útil. Observe que puede hacer clic en Pegar una nueva carga útil si desea cambiar la carga útil que se mueve actualmente.
Carga útil enviada: este campo no aparece en nuestro ejemplo. Solo está disponible si selecciona el método POST. Pegue la carga útil que se enviará al sistema de terceros.
En caso de una llamada de GET que requiera parámetros, introduzca los parámetros en la variable Valores dinámicos y se añaden automáticamente al final de la llamada. En caso de una llamada POST, debe hacer esto:
enumerar los parámetros que se van a pasar en el momento de la llamada en el Valores dinámicos campo (en el ejemplo siguiente: "identificador").
Especificarlos también con la misma sintaxis en el cuerpo de la carga útil enviada. Para ello, debe agregar: "param": "nombre del parámetro" (en el ejemplo siguiente: "identificador"). Siga esta sintaxis:
{"id":{"param":"identifier"}}
Haga clic en Guardar.
La fuente de datos ahora está configurada y lista para utilizarse en sus recorridos, por ejemplo en sus condiciones o para personalizar un correo electrónico. Si la temperatura es superior a 30 °C, puede decidir enviar una comunicación específica.
Este modo de autenticación se utiliza para la autenticación compleja, utilizada frecuentemente para llamar a protocolos de ajuste de API como OAuth2, para recuperar un token de acceso que se va a insertar en la petición HTTP real de la acción.
Al configurar la autenticación personalizada, puede hacer clic en el botón a continuación para comprobar si la carga de autenticación personalizada está configurada correctamente.
Si la prueba se realiza correctamente, el botón se vuelve verde.
Con esta autenticación, la ejecución de la acción es un proceso de dos pasos:
Esta autenticación consta de dos partes.
Definición del extremo al que se va a llamar para generar el token de acceso:
Definición de la forma en que se debe insertar el token de acceso en la petición HTTP de la acción:
authorizationType: define cómo se debe insertar el token de acceso generado en la llamada HTTP para la acción. Los valores posibles son:
tokenInResponse: indica cómo extraer el token de acceso de la llamada de autenticación. Esta propiedad puede ser:
El formato de esta autenticación es:
{
"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>'"
}
Puede cambiar la duración de caché del token para una fuente de datos de autenticación personalizada. A continuación se muestra un ejemplo de una carga útil de autenticación personalizada. La duración de caché se define en el parámetro "cacheDuration". Especifica la duración de retención del token generado en la caché. La unidad puede ser milisegundos, segundos, minutos, horas, días, meses, años.
Este es un ejemplo del tipo de autenticación del portador:
{
"authentication": {
"type": "customAuthorization",
"authorizationType": "Bearer",
"endpoint": "https://localhost:${port}/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"
}
}
}
El token de autenticación se almacena en caché por recorrido: si dos recorridos utilizan la misma acción personalizada, cada recorrido tiene su propio token en caché. Ese token no se comparte entre esos recorridos.
La duración de la caché ayuda a evitar demasiadas llamadas a los extremos de autenticación. La retención del token de autenticación se almacena en caché en los servicios, no hay persistencia. Si se reinicia un servicio, se inicia con una caché limpia. La duración de la caché de forma predeterminada es de 1 hora. En la carga útil de autenticación personalizada, se puede adaptar especificando otra duración de retención.
Este es un ejemplo del tipo de autenticación de encabezado:
{
"type": "customAuthorization",
"authorizationType": "header",
"tokenTarget": "x-auth-token",
"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"
}
A continuación, se muestra un ejemplo de la respuesta de la llamada de API de inicio de sesión:
{
"token": "xDIUssuYE9beucIE_TFOmpdheTqwzzISNKeysjeODSHUibdzN87S"
}