Show Menu
TÓPICOS×

Configurar o AEM Assets com o Brand Portal

O Portal de Marcas dos Ativos Adobe Experience Manager permite que você publique os ativos de marca aprovados dos Ativos Adobe Experience Manager no Portal de Marcas e os distribua aos usuários do Portal de Marcas.
A AEM Assets é configurada com o Brand Portal via Adobe Developer Console, que obtém um token de conta Adobe Identity Management Services (IMS) para autorização do locatário do Brand Portal.
A configuração do AEM Assets com o Brand Portal via Adobe Developer Console é suportada no AEM 6.5.4.0 e superior.
Anteriormente, o Brand Portal era configurado pelo gateway OAuth herdado, que usa a troca JSON Web Token (JWT) para obter um Token de acesso IMS para autorização.
A configuração por meio do gateway OAuth herdado não é mais suportada a partir de 6 de abril de 2020 e é alterada para o Console do desenvolvedor do Adobe.
Somente para clientes existentes
É recomendável continuar usando a configuração existente do gateway OAuth. Caso encontre problemas com a configuração herdada do OAuth Gateway, exclua a configuração existente e crie uma nova configuração por meio do Console do desenvolvedor do Adobe.
Esta ajuda descreve os dois casos de uso a seguir:
  • Nova configuração : Se você for um novo usuário do Brand Portal e quiser configurar sua instância de autor do AEM Assets com o Brand Portal, você poderá criar configuração por meio do Adobe Developer Console.
  • Configuração de atualização: Se você for um usuário existente do Brand Portal com configuração no gateway OAuth herdado, exclua a configuração existente e crie uma nova configuração por meio do Console do desenvolvedor do Adobe.
As informações fornecidas baseiam-se no pressuposto de que qualquer pessoa que leia esta Ajuda está familiarizada com as seguintes tecnologias:
  • Instalação, configuração e administração de pacotes Adobe Experience Manager e AEM.
  • Usando sistemas operacionais Linux e Microsoft Windows.

Pré-requisitos

Você precisa do seguinte para configurar o AEM Assets com o Brand Portal:
  • Uma instância do autor do AEM Assets em execução com o Service Pack mais recente
  • Um URL de locatário do Brand Portal
  • Um usuário com privilégios de administrador do sistema na organização IMS do locatário do Brand Portal

Baixe e instale o AEM 6.5

É recomendável ter AEM 6.5 para configurar uma instância do autor AEM. Se você não tiver AEM funcionando, baixe-o dos seguintes locais:
Depois de baixar o AEM, para obter instruções sobre como configurar uma instância AEM do autor, consulte implantação e manutenção .

Baixe e instale AEM Service Pack mais recente

Para obter instruções detalhadas, consulte
Entre em contato com o suporte se não conseguir encontrar o pacote AEM ou o Service Pack mais recente.

Criar configuração

A configuração do AEM Assets com o Brand Portal requer configurações tanto na instância do autor da AEM Assets quanto no Adobe Developer Console.
  1. No AEM Assets, crie uma conta IMS e gere um certificado público (chave pública).
  2. No Console do desenvolvedor do Adobe, crie um projeto para seu locatário do Brand Portal (organização).
  3. No projeto, configure uma API usando a chave pública para criar uma conexão de conta de serviço (JWT).
  4. Obtenha as credenciais da conta de serviço e as informações de carga JWT.
  5. No AEM Assets, configure a conta IMS usando as credenciais da conta de serviço e a carga JWT.
  6. No AEM Assets, configure o serviço em nuvem do Brand Portal usando a conta IMS e o terminal do Brand Portal (URL da organização).
  7. Teste sua configuração publicando um ativo do AEM Assets para o Brand Portal.
Uma instância do autor da AEM Assets só deve ser configurada com um locatário do Brand Portal.
Execute as seguintes etapas na sequência listada se você estiver configurando o AEM Assets com o Brand Portal pela primeira vez:

Criar configuração IMS

A configuração IMS autentica sua instância do autor do AEM Assets com o locatário do Brand Portal.
A configuração IMS inclui duas etapas:

Obter certificado público

A chave pública (certificado) autentica seu perfil no Adobe Developer Console.
  1. Faça logon na instância do autor do AEM Assets. O URL padrão é http://localhost:4502/aem/start.html .
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Na página Configurações de Adobe IMS, clique em Criar . It will redirect to the Adobe IMS Technical Account Configuration page. By default, the Certificate tab opens.
  4. Selecione Adobe Brand Portal na lista suspensa Cloud Solution .
  5. Marque a caixa de seleção Criar novo certificado e especifique um alias para a chave pública. O alias serve como nome da chave pública.
  6. Clique em Criar certificado . Then, click OK to generate the public key.
  7. Clique no ícone Baixar chave pública e salve o arquivo de chave pública (.crt) em seu computador.
    A chave pública será usada posteriormente para configurar a API para o locatário do Brand Portal e gerar credenciais de conta de serviço no Console do desenvolvedor do Adobe.
  8. Clique em Avançar .
    Na guia Conta , é criada uma conta Adobe IMS que requer as credenciais da conta de serviço geradas no Console do desenvolvedor do Adobe. Mantenha esta página aberta por enquanto.
    Abra uma nova guia e crie uma conexão de conta de serviço (JWT) no Adobe Developer Console para obter as credenciais e a carga JWT para configurar a conta IMS.

Criar conexão de conta de serviço (JWT)

No Console do desenvolvedor do Adobe, os projetos e as APIs são configurados no nível locatário (organização) do Brand Portal. Configurar uma API cria uma conexão de conta de serviço (JWT). Há dois métodos para configurar a API, gerando um par de chaves (chaves privadas e públicas) ou carregando uma chave pública. Para configurar o AEM Assets com o Brand Portal, você deve gerar uma chave pública (certificado) no AEM Assets e criar credenciais no Adobe Developer Console fazendo upload da chave pública. Essas credenciais são necessárias para configurar a conta IMS no AEM Assets. Depois que a conta IMS for configurada, você poderá configurar o serviço em nuvem do Brand Portal no AEM Assets.
Execute as seguintes etapas para gerar as credenciais da conta de serviço e a carga JWT:
  1. Faça logon no Adobe Developer Console com privilégios de administrador do sistema na organização IMS (locatário do Brand Portal). O URL padrão é https://www.adobe.com/go/devs_console_ui .
    Verifique se você selecionou a organização IMS correta (locatário do Brand Portal) na lista suspensa (organização) localizada no canto superior direito.
  2. Click Create new project . Um projeto em branco com um nome gerado pelo sistema é criado para sua organização.
    Clique em Editar projeto para atualizar o Título e a Descrição do projeto e clique em Salvar .
  3. Na guia Visão geral do projeto, clique em Adicionar API .
  4. Na janela ​Adicionar uma API, selecione AEM Portal de marca e clique em Avançar .
    Verifique se você tem acesso ao serviço Portal de marcas AEM.
  5. Na janela Configurar API , clique em Carregar sua chave pública. Em seguida, clique em Selecionar um arquivo e carregue a chave pública (arquivo .crt) que você baixou na seção obter certificado público.
    Clique em Avançar .
  6. Verifique a chave pública e clique em Avançar .
  7. Selecione Assets Brand Portal como o perfil de produto padrão e clique em Salvar API configurada.
  8. Depois que a API for configurada, você será redirecionado para a página de visão geral da API. Na navegação à esquerda em Credenciais , clique na opção Service Account (JWT) .
    Você pode visualização as credenciais e executar ações como gerar tokens JWT, copiar detalhes das credenciais, recuperar o segredo do cliente e assim por diante.
  9. Na guia Credenciais do cliente, copie a ID do cliente.
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload information.
Agora você pode usar a ID do cliente (chave da API), o segredo do cliente e a carga JWT para configurar a conta IMS no AEM Assets.

Configurar conta IMS

Verifique se você executou as seguintes etapas:
Execute as seguintes etapas para configurar a conta IMS.
  1. Abra a Configuração IMS e navegue até a guia Conta . Você manteve a página aberta ao obter o certificado público.
  2. Especifique um Título para a conta IMS.
    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/ .
    Especifique a ID do cliente no campo de chave da API, o Segredo do cliente e a Carga JWT que você copiou ao criar a conexão da conta de serviço (JWT).
    Clique em Criar .
    A conta IMS está configurada.
  3. Select the IMS account configuration and click Check Health .
    Clique em Verificar na caixa de diálogo. Na configuração bem-sucedida, será exibida uma mensagem informando que o Token foi recuperado com êxito .
Você deve ter apenas uma configuração IMS.
A configuração IMS deve ser aprovada na verificação de integridade. Se a configuração não for aprovada na verificação de integridade, ela será inválida. Você deve excluí-la e criar uma configuração nova e válida.

Configurar o serviço em nuvem

Execute as seguintes etapas para configurar o serviço em nuvem do Brand Portal:
  1. Faça logon na instância do autor do AEM Assets.
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. Na página Configurações do Brand Portal, clique em Criar .
  4. Especifique um Título para a configuração.
    Selecione a configuração IMS que você criou ao configurar a conta IMS.
    No campo URL do serviço, especifique o URL do locatário (organização) do Brand Portal.
  5. Clique em Salvar e fechar . A configuração da nuvem é criada.
    Sua instância do autor do AEM Assets agora está configurada com o locatário do Brand Portal.

Testar configuração

Execute as seguintes etapas para validar a configuração:
  1. Faça logon na instância da nuvem do AEM Assets.
  2. From the Tools panel, navigate to Deployment > Replication .
  3. Na página Replicação, clique em Agentes no autor .
    Você pode ver os quatro agentes de replicação criados para seu locatário do Brand Portal.
    Localize os agentes de replicação do locatário do Brand Portal e clique no URL do agente de replicação.
    Os agentes de replicação trabalham em paralelo e compartilham a distribuição de tarefas igualmente, aumentando assim a velocidade de publicação em quatro vezes a velocidade original. Depois que o serviço de nuvem é configurado, não é necessária uma configuração adicional para habilitar os agentes de replicação que são ativados por padrão para habilitar a publicação paralela de vários ativos.
  4. To verify the connection between AEM Assets and Brand Portal, click on the Test Connection icon.
    Será exibida uma mensagem informando que o pacote de teste foi entregue com êxito.
  5. Verifique os resultados do teste em todos os quatro agentes de replicação.
    Evite desabilitar qualquer agente de replicação, pois isso pode fazer com que a replicação dos ativos (em execução na fila) falhe.
    Verifique se todos os quatro agentes de replicação estão configurados para evitar o erro de tempo limite. See troubleshoot issues in parallel publishing to Brand Portal .
Agora você pode:
See Brand Portal documentation for more information.

Atualizar configuração

Execute as seguintes etapas na sequência listada para atualizar suas configurações existentes para o Adobe Developer Console:

Verificar trabalhos em execução

Certifique-se de que nenhum trabalho de publicação esteja em execução na sua instância do autor do AEM Assets antes de fazer qualquer modificação. Para isso, você pode verificar o status de trabalhos ativos em todos os quatro agentes de replicação e garantir que as filas estejam inativas.
  1. Faça logon na instância do autor do AEM Assets.
  2. No painel Ferramentas , navegue até Implantação > Replicação de implantação.
  3. Na página Replicação, clique em Agentes no autor .
  4. Localize os agentes de replicação do seu locatário do Brand Portal.
    Certifique-se de que a Fila esteja inativa para todos os agentes de replicação; nenhum trabalho de publicação está ativo.

Excluir configurações existentes

Você deve executar a seguinte lista de verificação ao excluir as configurações existentes:
  • Excluir todos os quatro agentes de replicação
  • Excluir serviço em nuvem do Brand Portal
  • Excluir usuário MAC
  1. Faça logon na instância do autor da AEM Assets e abra o CRX Lite como administrador. O URL padrão é http://localhost:4502/crx/de/index.jsp .
  2. Navegue até /etc/replications/agents.author e exclua todos os quatro agentes de replicação do seu locatário do Brand Portal.
  3. Navegue até /etc/cloudservices/mediaportal e exclua a configuração do serviço em nuvem do Brand Portal.
  4. Navegue até /home/users/mac e exclua o usuário ​MAC do seu locatário do Brand Portal.
Agora é possível criar a configuração por meio do Console do desenvolvedor do Adobe na instância do autor do AEM 6.5.