Configuración de Adobe I/O para los activadores de Adobe Experience Cloud

PRECAUCIÓN

Si utiliza una versión anterior de la integración de los activadores mediante autenticación oAuth, debe pasar a Adobe I/O como se describe a continuación. El modo de autenticación oAuth heredado con Campaign se eliminará el 30 de noviembre de 2021. Obtenga más información

Tenga en cuenta que durante este cambio a Adobe I/O, es posible que se pierdan algunos activadores entrantes.

Requisitos previos

Esta integración solo se aplica a partir de las versiones de Campaign Classic 20.3, 20.2.4, 19.1.8 y Gold Standard 11.

Antes de iniciar esta implementación, compruebe lo siguiente:

  • Un identificador de organización válido: el identificador de organización de Identity Management System (IMS) es el identificador único de Adobe Experience Cloud que se utiliza, por ejemplo, para el servicio VisitorID y el inicio de sesión único (SSO) de IMS. Obtenga más información
  • un acceso para desarrolladores para su organización. El administrador del sistema de la organización IMS debe seguir el procedimiento Adición de desarrolladores a un único perfil de producto
    detallado en esta página para proporcionar acceso de desarrollador al perfil Analytics - {tenantID} del producto de Adobe Analytics asociado a activadores.

Paso 1: Crear/actualizar proyecto de Adobe I/O

  1. Acceda a Adobe I/O e inicie sesión con el acceso de desarrollador de la organización IMS.

    NOTA

    Asegúrese de haber iniciado sesión en el portal correcto de la organización.

  2. Extraiga el ID del cliente de integración existente del archivo de configuración de instancia ims/authIMSTAClientId. El atributo no existente o vacío indica que el identificador del cliente no está configurado.

    NOTA

    Si el ID del cliente está vacío, puede usar directamente la opción Create a New project en Adobe I/O.

  3. Identifique el proyecto existente mediante el ID de cliente extraído. Busque proyectos existentes con el mismo ID de cliente que el extraído en el paso anterior.

  4. Seleccione + Add to Project y elija API.

  5. En la ventana Add an API seleccione Adobe Analytics.

  6. Elija Service Account (JWT) como el tipo de autenticación.

  7. Si el ID del cliente está vacío, seleccione Generate a key pair para crear un par de claves pública y privada.

    Las claves se descargan automáticamente con una fecha de caducidad predeterminada de 365 días. Una vez caducado, deberá crear un nuevo par de claves y actualizar la integración en el archivo de configuración. Con la Opción 2, puede elegir crear y cargar manualmente su Public key con una fecha de caducidad más larga.

    PRECAUCIÓN

    Debe guardar el archivo config.zip cuando aparezca el mensaje de descarga, ya que no podrá volver a descargarlo.

  8. Haga clic en Next.

  9. Elija cualquier Product profile existente o cree uno nuevo si es necesario. No se requiere permiso para este Product profile. Para obtener más información sobre Analytics Product Profiles, consulte la Documentación de Adobe Analytics.

    A continuación, haga clic en Save configured API.

  10. En el proyecto, seleccione Adobe Analytics y copie la siguiente información en Service Account (JWT):

    • Client ID
    • Client Secret
    • Technical account ID
    • Organization ID

PRECAUCIÓN

El certificado de Adobe I/O caducará pasados 12 meses. Debe generar un nuevo par de claves cada año.

Paso 2: Adición de las credenciales del proyecto en Adobe Campaign

NOTA

Este paso no es necesario si el identificador de cliente no estaba vacío en el Paso 1: Crear/actualizar proyecto de Adobe I/O.

La clave privada debe codificarse en formato UTF-8 base64. Para ello:

  1. Utilice la clave privada generada en el Paso 1: Creación o actualización de la sección Proyecto de Adobe I/O. La clave privada debe ser la misma que se utilizó para crear la integración.

  2. Codifique la clave privada mediante el siguiente comando: base64 ./private.key > private.key.base64. Esto guardará el contenido de base64 en un nuevo archivo private.key.base64.

    NOTA

    A veces, se pueden añadir automáticamente líneas adicionales al copiar/pegar la clave privada. Recuerde eliminarlas antes de codificar la clave privada.

  3. Copie el contenido del archivo private.key.base64.

  4. Inicie sesión mediante SSH en cada contenedor donde esté instalada la instancia de Adobe Campaign y añada las credenciales del proyecto en Adobe Campaign ejecutando el siguiente comando como usuario neolane. Esto insertará las credenciales Technical Account en el archivo de configuración de instancia.

    nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>

Paso 3: Actualización de la etiqueta canalizada

NOTA

Este paso no es necesario si el identificador de cliente no estaba vacío en el Paso 1: Crear/actualizar proyecto de Adobe I/O.

Para actualizar la etiqueta pipelined, debe actualizar el tipo de autenticación del proyecto de Adobe I/O en el archivo de configuración config-< instance-name >.xml como se indica a continuación:

<pipelined ... authType="imsJwtToken"  ... />

A continuación, ejecute un config -reload y un reinicio del pipelined para que se tengan en cuenta los cambios.

En esta página