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.

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

Baixe e instale o AEM Service Pack mais recente

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:

• Se você for um cliente AEM existente, baixe AEM 6.5 do site de licenciamento do Adobe.

• Se você for um parceiro Adobe, use Programa Adobe Partner Training para solicitar AEM 6.5.

Depois de baixar o AEM, para obter instruções sobre como configurar uma instância do autor AEM, consulte implantando e mantendo.

Baixe e instale AEM Service Pack mais recente

Para obter instruções detalhadas, consulte

• Notas de versão do AEM 6.5 Service Pack

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.

Execute as seguintes etapas na sequência listada se você 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
• Configurar conta IMS

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. No painel Ferramentas , navegue até Segurança > Configurações IMS de Adobe.

3. Na página Configurações de Adobe IMS, clique em Criar. Ele redirecionará para a página Configuração técnica de conta do Adobe IMS. Por padrão, a guia Certificado é aberta.

4. Selecione Portal de marca de Adobe na lista suspensa Solução de nuvem.

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. Em seguida, clique em OK para gerar a chave pública.

   

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 Account, é criada a conta Adobe IMS que exige 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 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.

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

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.

   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 Selecione 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 Next.

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 Conta de Serviço (JWT).

   OBSERVAÇÃO

   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.

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

   

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

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:

• Obter certificado público
• Criar conexão de conta de serviço (JWT)

Execute as seguintes etapas 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 ligação de conta de serviço (JWT).

   Clique em Criar.

   A conta IMS está configurada.

   

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

   Clique em Verificar na caixa de diálogo. Na configuração bem-sucedida, uma mensagem é exibida informando que o Token foi recuperado com êxito.

   

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 , navegue até Cloud Services > AEM Portal de marcas.

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

   

   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 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. Para verificar a conexão entre o AEM Assets e o Brand Portal, clique no ícone Testar conexão.

   

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

   OBSERVAÇÃ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. Consulte solução de problemas na publicação paralela no Brand Portal.

Agora você pode:

• Publicar ativos do AEM Assets no Brand Portal
• Publique ativos do Brand Portal para a AEM Assets - Fonte de ativos no Brand Portal
• Publicar pastas do AEM Assets no Brand Portal
• Publicar coleções do AEM Assets no Brand Portal
• Publicar predefinições, esquemas e aspectos no Brand Portal
• Publicar marcações no Brand Portal

Consulte 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 Adobe Developer Console:

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

Verificar a execução de trabalhos

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, nenhuma tarefa de publicação está ativa.

   

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 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 a configuração por meio do Console do desenvolvedor do Adobe na instância do autor do AEM 6.5.