Configurar o AEM Assets com o Brand Portal

O Adobe Experience Manager Assets Brand Portal permite publicar 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 via Adobe Developer Console, que obtém um token de conta do Adobe Identity Management Services (IMS) para autorização do locatário do Brand Portal.

OBSERVAÇÃO

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

Anteriormente, o Brand Portal era configurado por meio do 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 compatível a partir de 6 de abril de 2020 e é alterada para Console do desenvolvedor do Adobe.

DICA

Somente para clientes existentes

É recomendável continuar usando a configuração existente do Gateway OAuth. Caso encontre problemas com a configuração herdada do Gateway OAuth, 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 a instância de autor do AEM Assets com o Brand Portal, poderá criar configuração por meio do Console do Desenvolvedor do Adobe.
  • Atualizar configuraçã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 ativa e 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 AEM Service Pack mais recente

Baixe e instale o AEM 6.5

É recomendável ter o AEM 6.5 para configurar uma instância de autor AEM. Se você não tiver o AEM ativado e 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 de AEM, consulte implantar e manter.

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 de AEM ou o Service Pack mais recente.

Criar configuração

A configuração do AEM Assets com o Brand Portal requer configurações em ambas as instâncias, na instância de autor do AEM Assets e no Console do desenvolvedor do Adobe.

  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 o 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 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 desenvolvedor do Adobe.

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

  2. No painel Ferramentas Ferramentas, navegue até Segurança > Adobe IMS Configurations.

  3. Na página Configurações do Adobe IMS , clique em Criar. Ele redirecionará para a página Adobe IMS Technical Account Configuration . Por padrão, a guia Certificate é aberta.

  4. Selecione Adobe Brand Portal na lista suspensa Cloud Solution.

  5. Marque a caixa de seleção Create new certificate e especifique um alias para a chave pública. O alias serve 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 no ícone Baixar chave pública e salve o arquivo de chave pública (.crt) no 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.

    Baixar certificado

  8. Clique em Avançar.

    Na guia Account, é criada a 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 Console do Desenvolvedor do Adobe para obter as credenciais e a carga JWT para configurar a conta IMS.

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

No Console do desenvolvedor do Adobe, os projetos e as APIs são configurados no nível de 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 é configurada, você pode 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 Console do desenvolvedor do Adobe 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

    Certifique-se de ter selecionado 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. Na guia Visão geral do projeto, clique em Adicionar API.

  4. Na janela Adicionar uma API, selecione AEM Brand Portal e clique em Próximo.

    Certifique-se de ter acesso ao serviço AEM Brand Portal.

  5. Na janela Configure API, clique em Upload your public key. Em seguida, clique em Selecione um Arquivo e faça upload da chave pública (arquivo .crt) que você baixou na seção obter certificado público.

    Clique em Avançar.

    Fazer upload da chave pública

  6. Verifique a chave pública e clique em Next.

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

    Selecionar Perfil de Produto

  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 Credentials, clique na opção Service Account (JWT).

    OBSERVAÇÃO

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

  9. Na guia 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 guia Generate JWT e copie as informações JWT Payload.

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 etapas a seguir para configurar a conta IMS.

  1. Abra a Configuração IMS e navegue até a guia Account. Você manteve a página aberta enquanto obtinha o certificado público.

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

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

    Especifique a ID do cliente no campo Chave da API, Segredo do Cliente e Carga (Carga JWT) que copiou enquanto cria a 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, uma mensagem é exibida informando que o token foi recuperado com êxito.

CUIDADO

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. No painel 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 que você criou ao configurar a conta IMS.

    No campo URL do serviço, especifique o URL do locatário do Brand Portal (organização).

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

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

    Você pode ver os quatro agentes de replicação criados para o 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 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 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. Para verificar a conexão entre o AEM Assets e o Brand Portal, clique no ícone Testar Conexão.

    Aparece uma mensagem de que seu pacote de teste foi entregue com êxito.

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

    OBSERVAÇÃO

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

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

Agora você pode:

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

Atualizar configuração

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

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

Verificar tarefas em execução

Certifique-se de que nenhum trabalho de publicação esteja 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 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 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 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 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 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 locatário do Brand Portal.

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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now