Configurar o AEM Assets com o Brand Portal

O Adobe Experience Manager Assets Brand Portal permite publicar os ativos da marca aprovados do Adobe Experience Manager Assets na Brand Portal e distribuí-los aos usuários da 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.

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 do AEM Assets Author com o Brand Portal, poderá criar uma 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 configuração por meio do Console do Adobe Developer.

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 ativa e em execução do AEM Assets Author 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 AEM 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 em execução, baixe-o dos seguintes locais:

• Se você for um cliente do AEM, baixe o AEM 6.5 da Site de licenciamento do Adobe.

• Se você for um parceiro de Adobe, use o Programa de treinamento para parceiros Adobe para solicitar o AEM 6.5.

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 a tabela Notas de versão do AEM 6.5 Service Pack.

Entre em contato com o Suporte ao cliente do Adobe se você não conseguir encontrar o pacote AEM ou o Service Pack mais recente.

Criar configuração

A configuração do AEM Assets com Brand Portal requer configurações na instância do AEM Assets Author e 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.

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

1. Obter um certificado público
2. Criar conexão de conta de serviço (JWT)
3. Configurar uma 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 AEM Assets Author com o locatário do Brand Portal.

A configuração IMS inclui duas etapas:

• Obter um certificado público
• Configurar uma conta IMS

Obter certificado público

A chave pública (certificado) autentica seu perfil no Console do Adobe Developer.

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

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

3. Na página Configurações do Adobe IMS, clique em Criar. Ele redireciona para a guia 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 serve como o nome da chave pública.

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

   

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

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

   

8. Clique em Avançar.

   No Conta , uma 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 do IMS.

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

No Console do Adobe Developer, os projetos e as APIs são configurados no nível do locatário do 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: eles geram um par de chaves (chaves privadas e públicas) ou fazem upload de 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.

Para criar as credenciais da conta de serviço e a carga JWT, faça o seguinte:

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) 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 que você possa 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.

   

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.

   

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 exibir as credenciais e executar ações, como gerar tokens JWT, copiar detalhes da credencial e recuperar segredo do cliente.

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

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

   

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 a conta IMS

Verifique se você já executou as seguintes etapas:

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

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.

   

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.

   

Configurar o serviço em nuvem Brand Portal

1. Faça logon na sua instância do AEM Assets Author.

2. No Ferramentas , navegue até Cloud Service > 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.

   Sua instância do autor do AEM Assets agora está configurada com o locatário do Brand Portal.

Testar e validar a configuração

1. Faça logon na instância da nuvem do AEM Assets.

2. No 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, de modo que aumentam 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:

• Publicar ativos do AEM Assets no Brand Portal
• Publicar ativos do Brand Portal no AEM Assets - Origem 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 a Documentação do Brand Portal para obter mais informações.

Configuração de atualização

Para atualizar suas configurações existentes para o Console do Adobe Developer, siga as etapas abaixo, na sequência listada:

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

Verificar trabalhos 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 edições. 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 sua instância do AEM Assets Author.

2. No 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 e nenhum trabalho de publicação está ativo.

   

Excluir configurações existentes

Execute 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 do AEM Assets Author 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 uma configuração por meio do Console do Adobe Developer na instância do autor do AEM 6.5.