[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

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:

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.

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