Información general sobre la extensión Cloud Connector
La extensión de Cloud Connector para reenvío de eventos permite crear solicitudes HTTP personalizadas para enviar datos a un destino o recuperar datos de un destino. La extensión de conector de nube es como tener Postman en Adobe Experience Platform Edge Network y se puede usar para enviar datos a un punto final que aún no tiene una extensión dedicada.
Utilice esta referencia para obtener información sobre las opciones disponibles al utilizar esta extensión para generar una regla.
Tipo de acción de extensión de conector de nube
En esta sección se describe el tipo de acción Enviar datos disponible en la extensión de conector de nube de Adobe Experience Platform.
Tipo de solicitud
Para seleccionar el tipo de solicitud que requiere el extremo, seleccione el tipo adecuado en la lista desplegable Request Type.
URL de extremo
En el campo de texto situado junto al menú desplegable Tipo de solicitud, introduzca la dirección URL del extremo al que va a enviar los datos.
Parámetros de consulta, encabezados y configuración de cuerpo
Utilice cada una de estas fichas (Parámetros de Consulta, Encabezados y Elementos de datos de cuerpo) para controlar qué datos se envían a un extremo determinado.
Parámetros de consulta
Defina una clave y un valor para cada par clave-valor que desee enviar como parámetro de cadena de consulta. Para introducir manualmente un elemento de datos, utilice la tokenización del elemento de datos para el reenvío de eventos. Para hacer referencia al valor de un elemento de datos denominado "siteSection" como clave o valor, escriba {{siteSection}}. O bien, seleccione el elemento de datos creado anteriormente seleccionándolo en el menú desplegable.
Para agregar más parámetros de consulta, seleccione Add Another.
Encabezados
Defina una clave y un valor para cada par clave-valor que desee enviar como encabezado. Para introducir manualmente un elemento de datos, utilice la tokenización del elemento de datos para el reenvío de eventos. Para hacer referencia al valor de un elemento de datos denominado "pageName" como clave o valor, escriba {{pageName}}. O bien, seleccione el elemento de datos creado anteriormente seleccionándolo en el menú desplegable.
Para agregar más encabezados, seleccione Add Another.
En la siguiente tabla se hace una lista de los encabezados predefinidos. No está limitado a estos encabezados y puede agregar sus propios encabezados personalizados si es necesario, pero están disponibles para su comodidad.
Accept-Datetime se transmite en una petición HTTP emitida contra una TimeGate para un recurso original, y su valor indica la fecha y hora del estado anterior deseado del recurso original.Set-Cookie.Accept-Transfer-Encoding de manera informal, lo cual sería más intuitivo).Upgrade es RFC 7230, sección 6.7. El estándar establece reglas para actualizar o cambiar a un protocolo diferente en la conexión actual de cliente, servidor y protocolo de transporte. Por ejemplo, este estándar de encabezado permite a un cliente cambiar de HTTP 1.1 a HTTP 2.0, suponiendo que el servidor decida reconocer e implementar el campo de encabezado Upgrade. No se pide a ninguna de las partes que acepte los términos especificados en el campo de encabezado Upgrade. Se puede utilizar en encabezados de cliente y de servidor. Si se especifica el campo de encabezado Upgrade, el remitente DEBE enviar también el campo de encabezado Connection con la opción upgrade especificada.Cuerpo como JSON
Defina una clave y un valor para cada par clave-valor que desee enviar en el cuerpo de la solicitud. Para introducir manualmente un elemento de datos, utilice la tokenización del elemento de datos para el reenvío de eventos. Para hacer referencia al valor de un elemento de datos denominado "appSection" como clave o valor, escriba {{appSection}}. O bien, seleccione el elemento de datos creado anteriormente seleccionándolo en el menú desplegable.
Para añadir pares clave-valor adicionales, seleccione Add Another.
Cuerpo como sin procesar
Defina una clave y un valor para cada par clave-valor que desee enviar en el cuerpo de la solicitud. Para introducir manualmente un elemento de datos, utilice la tokenización del elemento de datos para el reenvío de eventos. Para hacer referencia al valor de un elemento de datos denominado "appSection" como clave o valor, escriba {{appSection}}. O bien, seleccione el elemento de datos creado anteriormente seleccionándolo en el menú desplegable. Puede añadir uno o más elementos de datos.
Avanzadas
Las acciones dentro de las reglas en el reenvío de eventos se ejecutan secuencialmente. Podría haber situaciones en las que desee recuperar datos de un origen externo que no esté presente en el evento entrante desde el cliente y, luego, tomar esta respuesta y transformar o enviar estos datos a un destino final en una acción posterior dentro de una sola regla. La sección avanzada Guardar la respuesta de solicitud lo habilita.
Para guardar el cuerpo de respuesta de un extremo, marque la casilla Save the request response y defina una clave de respuesta en el campo de texto.
Si definió la clave de respuesta como productDetails, haga referencia a estos datos en un elemento de datos y, a continuación, haga referencia a este elemento de datos en una acción posterior dentro de la misma regla. Para crear un elemento de datos que haga referencia a productDetail, cree un elemento de datos de tipo path e introduzca la siguiente ruta:
arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]
arc.ruleStash.adobe-cloud-connector.reponses.productDetails
Agregar una regla de seguridad de la capa de transporte mutuo (mTLS) a la biblioteca de reenvío de eventos mtls-rules
El certificado mTLS es una credencial digital que prueba la identidad de un servidor o cliente en comunicaciones seguras. Cuando usa la API del servicio mTLS, estos certificados le ayudan a comprobar y cifrar las interacciones con el reenvío de eventos de Adobe Experience Platform. Este proceso no solo protege sus datos, sino que también garantiza que todas las conexiones procedan de un socio de confianza.
Instalación de la extensión de conector de Adobe Cloud install
Para instalar la extensión, cree una propiedad de reenvío de eventos o seleccione una propiedad existente para editar en su lugar.
Seleccione Extensions en el panel izquierdo. En la ficha Catalog, seleccione la tarjeta Adobe Cloud Connector y después seleccione Install.
Configuración de una regla de reenvío de eventos rule
Después de instalar la extensión, puede crear una regla de reenvío de eventos que use mTLS y agregarla a la biblioteca.
Cree una nueva regla rule de reenvío de eventos en su propiedad de reenvío de eventos. Proporcione un nombre para la regla y en Actions agregue una nueva acción y establezca la extensión en Adobe Cloud Connector. A continuación, seleccione Make Fetch Call para Action Type.
Después de realizar la selección, aparecerán controles adicionales para configurar el método y el destino de la solicitud mTLS. Para habilitar el uso de certificados activos en los entornos, seleccione Enable in mTLS, luego seleccione Keep Changes para guardar la regla.
La nueva regla ya está lista. Seleccione Save to Library, luego seleccione Build para implementarlo. La solicitud mTLS ya está activa y disponible en su biblioteca.
Próximos pasos
En esta guía se explica cómo configurar reglas mTLS en el reenvío de eventos. Para obtener más información sobre la configuración de mTLS en un entorno, consulte la guía Seguridad de la capa de transporte mutuo (mTLS).
Para obtener más información sobre las funcionalidades de reenvío de eventos en Experience Platform, consulte la descripción general del reenvío de eventos.