Configurar o AEM Assets com o Brand Portal

Versão Link do artigo
AEM as a Cloud Service Clique aqui
AEM 6.5 Este artigo

O Adobe Experience Manager Assets Brand Portal permite publicar os ativos de marca aprovados do Adobe Experience Manager Assets no Brand Portal e distribuí-los aos usuários do Brand Portal.

O AEM Assets é configurado com o Brand Portal por meio do Adobe Developer Console, que obtém um token de conta Adobe Identity Management Services (IMS) para autorização do locatário do Brand Portal.

OBSERVAÇÃO

A configuração do AEM Assets com o Console do Adobe Developer AEM é compatível com o Brand Portal 6.5.4.0 e superior.

Anteriormente, o Brand Portal era configurado por meio do Gateway OAuth herdado, que usa a troca do 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 compatível a partir de 6 de abril de 2020 e foi alterada para o Console do Adobe Developer.

DICA

Somente para clientes existentes

É recomendável continuar usando a configuração herdada existente do Gateway OAuth. Caso encontre problemas com a configuração do gateway OAuth herdada, exclua a configuração existente e crie uma nova configuração por meio do Adobe Developer Console.

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, poderá criar a configuração por meio do Console do Adobe Developer.
  • 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 Adobe Developer Console.

As informações fornecidas baseiam-se na suposição 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.

  • Uso dos 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

Baixe e instale o Service Pack mais recente do AEM

Baixe e instale o AEM 6.5

É recomendável ter o AEM 6.5 para configurar uma instância de autor de AEM. Se você não tiver o AEM em execução, baixe-o dos seguintes locais:

Depois de baixar o AEM, para obter instruções sobre como configurar uma instância de autor AEM, consulte implantação e manutenção.

Baixar e instalar o Service Pack mais recente do AEM

Para obter instruções detalhadas, consulte

Entrar em contato com o suporte caso não consiga encontrar o pacote AEM ou o Service Pack mais recente.

Criar configuração

A configuração do AEM Assets com Brand Portal exige configurações no, na instância do autor do AEM Assets, bem como no console do Adobe Developer.

  1. No AEM Assets, crie uma conta IMS e gere um certificado público (chave pública).
  2. No Console do Adobe Developer, 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 da Brand Portal usando a conta IMS e o terminal Brand Portal (URL da organização).
  7. Teste sua configuração publicando um ativo do AEM Assets no Brand Portal.
OBSERVAÇÃO

Uma instância de autor do AEM Assets só deve ser configurada com um locatário do Brand Portal.

Execute as seguintes etapas na sequência listada se estiver configurando o AEM Assets com o Brand Portal pela primeira vez:

  1. Obter certificado público
  2. Criar conexão de conta de serviço (JWT)
  3. Configurar conta IMS
  4. Configurar o serviço em nuvem
  5. Testar configuração

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 Console do Adobe Developer.

  1. Faça logon na instância de autor do AEM Assets. O URL padrão é http://localhost:4502/aem/start.html.

  2. No Ferramentas Ferramentas , navegue até Segurança > Configurações do Adobe IMS.

  3. Na página Configurações do Adobe IMS, clique em Criar. Ele será redirecionado para a Configurações da conta técnica do Adobe IMS página. Por padrão, a variável Certificado é aberta.

  4. Selecionar Adobe Brand Portal no Solução em nuvem lista suspensa.

  5. Selecione o Criar novo certificado e especifique um alias para a chave pública. O alias atua como nome da chave pública.

  6. Clique em Criar certificado. Em seguida, clique em OK para gerar a chave pública.

    Criar certificado

  7. Clique em Baixar chave pública e salve o arquivo de chave pública (.crt) em sua máquina.

    A chave pública será usada posteriormente para configurar a API do locatário do Brand Portal e gerar credenciais da conta de serviço no Adobe Developer Console.

    Baixar certificado

  8. Clique em Avançar.

    No Conta , a conta do Adobe IMS é criada e requer as credenciais da conta de serviço geradas no Console do Adobe Developer. Mantenha esta página aberta por enquanto.

    Abra uma nova guia e criar uma conexão de conta de serviço (JWT) no console do Adobe Developer 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 Adobe Developer, os projetos e as APIs são configurados no nível do locatário da Brand Portal (organização). Configurar uma API cria uma conexão de conta de serviço (JWT). Há dois métodos para configurar a API: gerar um par de chaves (chaves privadas e públicas) ou carregar 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 Console do Adobe Developer fazendo upload da chave pública. Essas credenciais são necessárias para configurar a conta do IMS no AEM Assets. Depois que a conta IMS é configurada, você pode configurar o serviço de nuvem da 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 Console do Adobe Developer com privilégios de administrador de sistema na organização IMS (locatário do Brand Portal). O URL padrão é https://www.adobe.com/go/devs_console_ui.

    OBSERVAÇÃO

    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. Clique em Criar novo projeto. Um projeto em branco com um nome gerado pelo sistema é criado para sua organização.

    Clique em Editar projeto para atualizar o Título do projeto e Descrição e clique em Salvar.

  3. No Visão geral do projeto clique em Adicionar API.

  4. No Adicionar uma janela de API, selecione AEM Brand Portal e clique em Próxima.

    Verifique se você tem acesso ao serviço do AEM Brand Portal.

  5. No Configurar API clique em Fazer upload da sua chave pública. Em seguida, clique em Selecionar um arquivo e faça upload da chave pública (arquivo .crt) que você baixou na obter certificado público seção.

    Clique em Avançar.

    Fazer upload da chave pública

  6. Verifique a chave pública e clique em Próxima.

  7. Selecionar Assets Brand Portal como o perfil de produto padrão e clique em Salvar API configurada.

    Selecionar perfil de produto

  8. Após configurar a API, você é redirecionado para a página Visão geral da API. Na navegação à esquerda, em Credenciais, clique no link Conta de serviço (JWT) opção.

    OBSERVAÇÃO

    Você pode visualizar as credenciais e executar ações como gerar tokens JWT, copiar detalhes da credencial, recuperar segredo do cliente e assim por diante.

  9. No Credenciais do cliente , copie o ID do cliente.

    Clique em Recuperar segredo do cliente e copie o segredo do cliente.

    Credenciais da Conta de Serviço

  10. Navegue até a Gerar JWT e copie a guia Carga JWT informações.

Agora você pode usar a ID do cliente (chave de 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é o Conta guia. Você manteve a página aberta enquanto obtenção do certificado público.

  2. Especifique um Título para a conta IMS.

    No Servidor de autorização especifique o URL: https://ims-na1.adobelogin.com/.

    Especifique a ID do cliente no Chave de API campo, Segredo do cliente, e Carga (carga JWT) que você copiou enquanto criação da conexão da conta de serviço (JWT).

    Clique em Criar.

    A conta IMS está configurada.

    Configurar a conta IMS

  3. Selecione a configuração da conta IMS e clique em Verificar integridade.

    Clique em Marcar na caixa de diálogo. Na configuração bem-sucedida, é exibida a mensagem de que a variável O token foi recuperado com sucesso.

ATENÇÃO

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 Brand Portal Cloud Service:

  1. Faça logon na instância de autor do AEM Assets.

  2. No Ferramentas Ferramentas , navegue até 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 criada enquanto configuração da conta IMS.

    No 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.

    A 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. No Ferramentas Ferramentas , navegue até Implantação > Replicação.

  3. Na página Replicação, clique em Agentes sobre o 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 seu locatário do Brand Portal e clique no URL do agente de replicação.

    OBSERVAÇÃO

    Os agentes de replicação funcionam em paralelo e compartilham a distribuição de tarefas igualmente, aumentando assim a velocidade de publicação em quatro vezes a velocidade original. Após a configuração do Cloud Service, não é necessária uma configuração adicional para habilitar os agentes de replicação ativados por padrão para permitir a publicação paralela de vários ativos.

  4. Para verificar a conexão entre o AEM Assets e o Brand Portal, clique no link Testar conexão ícone.

    Será exibida uma mensagem informando que o o pacote de teste foi entregue com sucesso.

  5. Verifique os resultados do teste em todos os quatro agentes de replicação.

    OBSERVAÇÃO

    Evite desativar qualquer um dos agentes de replicação, pois isso pode causar falha na replicação dos ativos (em execução na fila).

    Verifique se todos os quatro agentes de replicação estão configurados para evitar erro de tempo limite. Consulte solucionar problemas na publicação paralela no Brand Portal.

    Não modifique nenhuma configuração gerada automaticamente.

Agora você pode:

Consulte Documentação do Brand Portal para obter mais informações.

Configuração de atualização

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

  1. Verificar trabalhos em execução
  2. Excluir configurações existentes
  3. Criar configuração

Verificar trabalhos em execução

Verifique se nenhum trabalho de publicação está em execução na instância do autor do AEM Assets antes de fazer qualquer modificação. Para isso, você pode verificar o status de processos ativos em todos os quatro agentes de replicação e garantir que as filas estejam ociosas.

  1. Faça logon na instância de autor do AEM Assets.

  2. No Ferramentas Ferramentas , navegue até Implantação > Replicação de implantação.

  3. Na página Replicação, clique em Agentes sobre o autor.

  4. Localize os agentes de replicação do seu locatário do Brand Portal.

    Certifique-se de que o A fila está ociosa 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 o Brand Portal Cloud Service
  • Excluir usuário do MAC
  1. Faça logon na instância de autor do 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 Brand Portal cloud service.

  4. Navegue até /home/users/mac e exclua a variável usuário do Mac do seu locatário do Brand Portal.

Agora você pode criar configuração pelo Adobe Developer Console na instância do autor do AEM 6.5.

Nesta página