DocumentaçãoCommerceGuia de integração do AEM Assets

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Instalar pacotes do Adobe Commerce

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:
  • CMS

Criado para:

  • Usuário

Essa integração do Commerce permite a sincronização de ativos entre o Adobe Commerce e o Adobe Experience Manager Assets (AEM Assets). A extensão fornece um conjunto de ferramentas e serviços para gerenciar imagem de produto, vídeo e outros ativos de mídia em ambas as plataformas.

Adicione esta extensão ao ambiente Commerce instalando a extensão PHP aem-assets-integration. Você também precisa ativar o Adobe I/O Events para Commerce e gerar as credenciais necessárias para a comunicação e os fluxos de trabalho entre o Adobe Commerce e o Adobe Experience Manager Assets.

Requisitos de acesso

Você precisa das seguintes funções e permissões para habilitar a integração do Commerce com o AEM Assets.

TIP
O Adobe Commerce pode ser configurado para usar a autenticação do Adobe IMS.

Fluxo de trabalho de instalação e configuração

Instale o pacote do Adobe Commerce e prepare o ambiente do Commerce concluindo as seguintes tarefas:

  1. Instale a Integração do AEM Assets para a extensão do Commerce (aem-assets-integration).

  2. Configure o Commerce Services Connector para conectar sua instância do Adobe Commerce e com os serviços que permitem a transmissão de dados entre o Adobe Commerce e o AEM Assets.

  3. Configurar o Adobe I/O Events para o Commerce

  4. Obter credenciais de autenticação para acesso à API

Instalar a extensão aem-assets-integration

Instale a versão mais recente da extensão de Integração do AEM Assets (aem-assets-integration) em uma instância do Adobe Commerce com a versão Adobe Commerce 2.4.5+. A extensão é entregue como um metapackage de compositor do repositório.magento.com.

Infraestrutura em nuvem

Use este método para instalar a extensão AEM Assets Integration em uma instância do Commerce Cloud.

  1. Na estação de trabalho local, altere para o diretório do projeto do Adobe Commerce na infraestrutura em nuvem.

    note note
    NOTE
    Para obter informações sobre o gerenciamento local de ambientes de projeto do Commerce, consulte Gerenciamento de ramificações com a CLI no Guia do Usuário do Adobe Commerce na Infraestrutura da Nuvem.

  2. Confira a ramificação de ambiente para atualizar usando a CLI da Adobe Commerce Cloud.

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

  3. Adicione a extensão Integração do AEM Assets para Commerce.

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

  4. Atualizar dependências de pacote.

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

  5. Confirmar e enviar alterações de código para os arquivos composer.json e composer.lock.

  6. Adicione, confirme e envie por push as alterações de código dos arquivos composer.json e composer.lock para o ambiente de nuvem.

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

    O envio das atualizações inicia o processo de implantação da nuvem do Commerce para aplicar as alterações. Verifique o status da implantação no log de implantação.

No local

Use este método para instalar a extensão AEM Assets Integration para uma instância local.

  1. Use o Composer para adicionar a extensão do AEM Assets Integration for Commerce ao seu projeto:

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

  2. Atualize as dependências e instale a extensão:

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

  3. Atualizar o Adobe Commerce:

    code language-shell 
    bin/magento setup:upgrade

  4. Limpe o cache:

    code language-shell 
    bin/magento cache:clean
note tip
TIP
Ao implantar na produção, considere não limpar o código compilado para economizar tempo. Sempre faça backup do sistema antes de fazer alterações.

Configurar o Commerce Services Connector

NOTE
A instalação do Commerce Services Connector é um processo único necessário para usar os serviços SaaS do Adobe Commerce. Se você já tiver configurado o conector para outro serviço, poderá ver a configuração existente no Administrador do Commerce selecionando Systems > Services > Commerce Services Connector.

Para transmitir dados entre sua instância do Adobe Commerce e os serviços que habilitam a Integração do AEM Assets, configure o Commerce Services Connector no Admin (System > Services > Commerce Services Connector).

IDs de projeto e de espaço de dados SaaS para a integração do AEM Assets {width="600" modal="regular"}

Forneça os seguintes valores na configuração

  • Chaves de API de produção e sandbox para autenticação
  • Nome do espaço de dados (identificador SaaS) para armazenamento seguro em nuvem
  • ID da organização IMS onde os ambientes Commerce e AEM Assets são provisionados

Para obter instruções detalhadas, assista ao vídeo de configuração do Commerce Services Connector, ou consulte a documentação do Commerce Services Connector.

Quando você salva a configuração, o sistema gera o projeto SaaS e as IDs do banco de dados para o seu ambiente. Esses valores são necessários para habilitar a sincronização de ativos entre o Adobe Commerce e o AEM Assets.

Configurar o Adobe I/O Events para o Commerce

A Integração do AEM Assets usa o serviço do Adobe I/O Events para enviar dados de eventos personalizados entre a instância do Commerce e o Experience Cloud. Os dados do evento são usados para coordenar workflows para a integração do AEM Assets.

Antes de configurar o Adobe I/O Events, verifique a configuração do trabalho RabbitMQ e cron para seu projeto do Commerce:

NOTE
Para projetos na versão 2.4.5 do Commerce, você deve instalar os módulos do Adobe I/O. Na versão 2.4.6+ do Commerce, esses módulos são carregados automaticamente. Para a integração do AEM Assets com o Commerce, é necessário instalar apenas os módulos. A configuração do App Builder não é necessária.

Ativar a estrutura de eventos do Commerce

Ative a estrutura de eventos no Administrador do Commerce.

NOTE
A configuração do App Builder é necessária somente se você planeja usar uma estratégia de correspondência personalizada para sincronizar ativos entre o Commerce e o AEM Assets.

  1. No Administrador, vá para Stores > Settings > Configuration > Adobe Services > Adobe I/O Events.

  2. Expandir Commerce events.

  3. Defina Enabled como Yes.

    Configuração de administração do Adobe I/O Events Commerce - habilitar eventos do Commerce {width="600" modal="regular"}

  4. Insira o nome da empresa de comerciante em Merchant ID e o nome do ambiente nos campos Environment ID. Use somente caracteres alfanuméricos e sublinhados ao definir esses valores.

recommendation-more-help

Configurar VCL Personalizado para solicitações de bloqueio

Se você usar um trecho de VCL personalizado para bloquear solicitações de entrada desconhecidas, talvez precise incluir o cabeçalho HTTP X-Ims-Org-Idheader para permitir conexões de entrada do serviço AEM Assets Integration for Commerce.

TIP
Você pode usar o módulo Fastly CDN para criar uma ACL do Edge com uma lista de endereços IP que você deseja bloquear.

O seguinte código de trecho de VCL personalizado (formato JSON) mostra um exemplo com um cabeçalho de solicitação 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 criar um trecho com base neste exemplo, revise os valores para determinar se você precisa fazer alterações:

  • name: Nome do trecho VCL. Este exemplo usa o nome blockbyuseragent.

  • dynamic: Define a versão do trecho. Este exemplo usa 0. Consulte os trechos de VCL do Fastly para obter informações detalhadas sobre o modelo de dados.

  • type: Especifica o tipo de trecho VCL, que determina o local do trecho no código VCL gerado. Este exemplo usa recv. Consulte a Referência de trecho Fastly VCL para obter a lista de tipos de trecho.

  • priority: Determina quando o trecho VCL é executado. Este exemplo usa a prioridade 5 para ser executado imediatamente e verificar se uma solicitação de administrador vem de um endereço IP permitido.

  • content: o trecho de código VCL a ser executado, que verifica o endereço IP do cliente. Se o IP estiver na ACL do Edge, o acesso será bloqueado com um erro 405 Not allowed para todo o site. Todos os outros endereços IP de clientes têm acesso permitido.

Para obter informações detalhadas sobre o uso de trechos de VCL para bloquear solicitações de entrada, consulte VCL personalizado para solicitações de bloqueio no Guia de Infraestrutura do Commerce na Nuvem.

style
shade-box

Obter credenciais de autenticação para acesso à API

A integração do AEM Assets para o Commerce exige credenciais de autenticação do OAuth para permitir o acesso da API à instância do Commerce. Essas credenciais são necessárias para autenticar solicitações de API ao gerenciar ativos usando a integração do AEM Assets.

Gere as credenciais adicionando a integração à instância do Commerce e ativando-a.

Adicionar a integração ao ambiente do Commerce

  1. No Admin, vá para Sistema > Extensões > Integrações e clique em Adicionar nova integração.

  2. Insira informações sobre a integração.

    Na seção Geral, especifique apenas o Nome e o Email da integração. Use o email para uma conta do Adobe IMS com acesso à organização em que o Commerce e o Experience Manager Assets são implantados.

    Integração do AEM Assets para a configuração do administrador do Commerce {width="600" modal="regular"}

  3. Confirme sua identidade clicando em Confirmar Identidade.

    O sistema verifica sua identidade ao autenticar no Experience Cloud com sua Adobe Id.

  4. Configure os recursos da API.

    1. No painel esquerdo, clique em API.

    2. Selecione o recurso de mídia externa Catalog > Inventory > Products > External Media.

      Configuração de integração do administrador para recursos de API {width="600" modal="regular"}

  5. Clique em Save.

Gerar credenciais do OAuth

Na página Integrações, gere as credenciais de autenticação do OAuth clicando em Ativar para a integração com o Assets. Você precisa dessas credenciais para registrar o projeto do Commerce com o serviço do Mecanismo de regras da Assets e para enviar solicitações de API para gerenciar ativos entre o Adobe Commerce e o AEM Assets.

  1. Na página Integrações, gere as credenciais clicando em Activate.

    Ativar a configuração do Commerce para integração com o Assets {width="600" modal="regular"}

  2. Se você planeja usar a API, salve as credenciais da chave do consumidor e do token de acesso para configurar a autenticação no cliente da API.

    Credenciais OAuth para autenticar solicitações de API {width="600" modal="regular"}

  3. Clique em Done.

NOTE
Você também pode gerar credenciais de autenticação usando as APIs do Adobe Commerce. Para obter detalhes sobre esse processo e mais informações sobre a autenticação baseada em OAuth para o Adobe Commerce, consulte Autenticação baseada em OAuth na documentação do Adobe Developer.

Próxima etapa

ca3e43e7-8fc7-412c-9d52-80a723c40cea