DocumentaciónCommerceGuía de integración de AEM Assets

[Solo PaaS]{class="badge informative" title="Se aplica solo a proyectos de Adobe Commerce en la nube (infraestructura PaaS administrada por Adobe) y a proyectos locales."}

Instalación de paquetes de Adobe Commerce

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Usuario

Esta integración para Commerce permite la sincronización de recursos entre Adobe Commerce y Adobe Experience Manager Assets (AEM Assets). La extensión proporciona un conjunto de herramientas y servicios para administrar la imagen del producto, el vídeo y otros recursos de medios en ambas plataformas.

Agregue esta extensión al entorno de Commerce instalando la extensión PHP aem-assets-integration. También debe habilitar Adobe I/O Events para Commerce y generar las credenciales necesarias para la comunicación y los flujos de trabajo entre Adobe Commerce y Adobe Experience Manager Assets.

Requisitos de acceso

Necesita las siguientes funciones y permisos para habilitar la integración de Commerce con los AEM Assets.

TIP
Adobe Commerce se puede configurar para usar autenticación IMS de Adobe.

Flujo de trabajo de instalación y configuración

Instale el paquete de Adobe Commerce y prepare el entorno de Commerce realizando las siguientes tareas:

  1. Instale la integración de AEM Assets para la extensión de Commerce (aem-assets-integration).

  2. Configure Commerce Services Connector para conectar su instancia de Adobe Commerce y con los servicios que permiten la transmisión de datos entre Adobe Commerce y los AEM Assets.

  3. Configuración de Adobe I/O Events para Commerce

  4. Obtener credenciales de autenticación para el acceso a API

Instalar la extensión aem-assets-integration

Instale la última versión de la extensión de integración de AEM Assets (aem-assets-integration) en una instancia de Adobe Commerce con versión Adobe Commerce 2.4.5+. La extensión se entrega como un metapaquete de composición desde el repositorio repo.magento.com.

Infraestructura en la nube

Utilice este método para instalar la extensión AEM Assets Integration en una instancia de Commerce Cloud.

  1. En la estación de trabajo local, cambie al directorio del proyecto para su proyecto de Adobe Commerce en la nube.

    note note
    NOTE
    Para obtener información sobre cómo administrar los entornos de proyecto de Commerce localmente, consulte Administración de ramas con la CLI en la Guía del usuario de Adobe Commerce on Cloud Infrastructure.

  2. Consulte la rama de entorno para actualizar con la CLI de Adobe Commerce Cloud.

    code language-shell 
    magento-cloud environment:checkout <environment-id>

  3. Añada la extensión AEM Assets Integration para Commerce.

    code language-shell 
    composer require "magento/aem-assets-integration" "<version-tbd>" --no-update

  4. Actualizar dependencias del paquete.

    code language-shell 
    composer update "magento/aem-assets-integration"

  5. Confirme y envíe los cambios de código para los archivos composer.json y composer.lock.

  6. Agregue, confirme e inserte los cambios de código para los archivos composer.json y composer.lock en el entorno de nube.

    code language-shell 
    git add -A
git commit -m "Install AEM Assets Integration extension for Adobe Commerce"
git push origin <branch-name>

    Al insertar las actualizaciones, se inicia el proceso de implementación en la nube de Commerce para aplicar los cambios. Compruebe el estado de implementación desde el registro de implementación.

Local

Utilice este método para instalar la extensión AEM Assets Integration para una instancia local.

  1. Use el Compositor para añadir la extensión Integración de AEM Assets para Commerce a su proyecto:

    code language-shell 
    composer require "magento/aem-assets-integration" --no-update

  2. Actualice las dependencias e instale la extensión:

    code language-shell 
    composer update  "magento/aem-assets-integration"

  3. Actualizar Adobe Commerce:

    code language-shell 
    bin/magento setup:upgrade

  4. Borre la caché:

    code language-shell 
    bin/magento cache:clean
note tip
TIP
Al implementar en producción, considere no borrar el código compilado para ahorrar tiempo. Realice siempre una copia de seguridad del sistema antes de realizar cambios.

Configuración de Commerce Services Connector

NOTE
La configuración del Conector de servicios de Commerce es un proceso único necesario para usar Servicios SaaS de Adobe Commerce. Si ya ha configurado el conector para otro servicio, puede ver la configuración existente desde el administrador de Commerce seleccionando Systems > Services > Commerce Services Connector.

Para transmitir datos entre su instancia de Adobe Commerce y los servicios que habilitan la integración de AEM Assets, configure Commerce Services Connector desde el administrador (System > Services > Commerce Services Connector).

Id. de espacio de datos y proyecto SaaS para la integración de AEM Assets {width="600" modal="regular"}

Proporcione los siguientes valores en la configuración

  • Claves de API de producción y zona protegida para la autenticación
  • Nombre del espacio de datos (identificador SaaS) para el almacenamiento seguro en la nube
  • ID de la organización IMS donde se aprovisionan los entornos Commerce y AEM Assets.

Para obtener instrucciones detalladas, vea el vídeo de configuración del Conector de servicios de Commerce; consulte la documentación del Conector de servicios de Commerce.

Al guardar la configuración, el sistema genera los ID de proyecto SaaS y de base de datos para su entorno. Estos valores son necesarios para habilitar la sincronización de recursos entre Adobe Commerce y los AEM Assets.

Configuración de Adobe I/O Events para Commerce

La integración de AEM Assets utiliza el servicio Adobe I/O Events para enviar datos de evento personalizados entre la instancia de Commerce y Experience Cloud. Los datos de evento se utilizan para coordinar los flujos de trabajo de la integración de AEM Assets.

Antes de configurar Adobe I/O Events, compruebe la configuración del trabajo de RabbitMQ y cron para su proyecto de Commerce:

NOTE
Para los proyectos de la versión 2.4.5 de Commerce, debe instalar los módulos de Adobe I/O. En Commerce versión 2.4.6+, estos módulos se cargan automáticamente. Para la integración de AEM Assets para Commerce, solo necesita instalar los módulos. No se requiere la configuración de App Builder.

Habilitar el marco de eventos de Commerce

Habilite el marco de eventos desde el administrador de Commerce.

NOTE
La configuración de App Builder solo es necesaria si planea utilizar una estrategia de coincidencia personalizada para sincronizar recursos entre Commerce y los AEM Assets.

  1. Desde el administrador, vaya a Stores > Settings > Configuration > Adobe Services > Adobe I/O Events.

  2. Expandir Commerce events.

  3. Establezca Enabled en Yes.

    Configuración de administración de Adobe I/O Events Commerce - habilitar eventos de Commerce {width="600" modal="regular"}

  4. Escriba el nombre de la compañía comerciante en Merchant ID y el nombre de entorno en los campos Environment ID. Utilice únicamente caracteres alfanuméricos y guiones bajos al configurar estos valores.

recommendation-more-help

Configurar VCL personalizado para bloquear solicitudes

Si utiliza un fragmento de VCL personalizado para bloquear solicitudes entrantes desconocidas, es posible que tenga que incluir el encabezado HTTP X-Ims-Org-Idheader para permitir conexiones entrantes desde el servicio AEM Assets Integration for Commerce.

TIP
Puede utilizar el módulo Fastly de CDN para crear una ACL de Edge con una lista de direcciones IP que desee bloquear.

El siguiente código de fragmento de VCL personalizado (formato JSON) muestra un ejemplo con un encabezado de solicitud X-Ims-Org-Id.

{
  "name": "blockbyuseragent",
  "dynamic": "0",
  "type": "recv",
  "priority": "5",
  "content": "if ( req.http.X-ims-org ~ \"<YOUR-IMS-ORG>\" ) {error 405 \"Not allowed\";}"
}

Antes de crear un fragmento basado en este ejemplo, revise los valores para determinar si necesita realizar algún cambio:

  • name: nombre del fragmento de VCL. Este ejemplo usa el nombre blockbyuseragent.

  • dynamic: establece la versión del fragmento. Este ejemplo utiliza 0. Consulte los fragmentos de VCL de Fastly para obtener información detallada del modelo de datos.

  • type: especifica el tipo de fragmento de VCL, que determina la ubicación del fragmento en el código de VCL generado. Este ejemplo utiliza recv. Consulte Fastly VCL snippet reference para obtener la lista de tipos de fragmentos.

  • priority: Determina cuándo se ejecuta el fragmento de VCL. Este ejemplo utiliza la prioridad 5 para ejecutarse inmediatamente y comprobar si una solicitud de administrador proviene de una dirección IP permitida.

  • content: fragmento de código VCL que se va a ejecutar, que comprueba la dirección IP del cliente. Si la IP está en la ACL de Edge, se bloquea el acceso con un error 405 Not allowed para todo el sitio web. Todas las demás direcciones IP de cliente tienen acceso permitido.

Para obtener información detallada sobre el uso de fragmentos de VCL para bloquear solicitudes entrantes, consulte VCL personalizado para bloquear solicitudes en la Guía de infraestructura de Commerce en la nube.

style
shade-box

Obtener credenciales de autenticación para el acceso a API

La integración de AEM Assets para Commerce requiere credenciales de autenticación de OAuth para permitir el acceso de la API a la instancia de Commerce. Estas credenciales son necesarias para autenticar solicitudes de API al administrar recursos mediante la integración de AEM Assets.

Para generar las credenciales, agregue la integración a la instancia de Commerce y actívela.

Añadir la integración al entorno de Commerce

  1. Desde el administrador, ve a Sistema > Extensiones > Integraciones y luego haz clic en Agregar nueva integración.

  2. Introduzca información sobre la integración.

    En la sección General, solo especifique la integración Nombre y Correo electrónico. Utilice el correo electrónico para una cuenta de Adobe IMS con acceso a la organización en la que se implementan Commerce y Experience Manager Assets.

    Integración de AEM Assets para la configuración de administración de Commerce {width="600" modal="regular"}

  3. Comprueba tu identidad haciendo clic en Confirmar identidad.

    El sistema comprueba su identidad autenticándose en Experience Cloud con su Adobe ID.

  4. Configure los recursos de API.

    1. En el panel izquierdo, haga clic en API.

    2. Seleccione el medio externo Catalog > Inventory > Products > External Media.

      Configuración de integración de administración para recursos de API {width="600" modal="regular"}

  5. Haga clic en Save.

Generar credenciales de OAuth

En la página Integraciones, genere las credenciales de autenticación de OAuth haciendo clic en Activar para la integración de Assets. Necesita estas credenciales para registrar el proyecto de Commerce con el servicio del motor de reglas de Assets y enviar solicitudes de API para administrar recursos entre Adobe Commerce y los AEM Assets.

  1. En la página Integraciones, genere las credenciales haciendo clic en Activate.

    Activar la configuración de Commerce para la integración de Assets {width="600" modal="regular"}

  2. Si planea utilizar la API, guarde las credenciales de la clave del consumidor y el token de acceso para configurar la autenticación en el cliente de API.

    Credenciales de OAuth para autenticar solicitudes de API {width="600" modal="regular"}

  3. Haga clic en Done.

NOTE
También puede generar credenciales de autenticación mediante las API de Adobe Commerce. Para obtener más información sobre este proceso y sobre la autenticación basada en OAuth para Adobe Commerce, consulte Autenticación basada en OAuth en la documentación de Adobe Developer.

Siguiente paso

d5b74cdc-d9a8-404d-9105-1e69985d7e1b