Configurar o AEM Assets as a Cloud Service com o Brand Portal

A configuração do Adobe Experience Manager Assets Brand Portal permite publicar ativos de marca aprovados do Adobe Experience Manager Assets como uma instância Cloud Service no Brand Portal e distribuí-los aos usuários do Brand Portal.

Ativar o Brand Portal usando o Cloud Manager

O usuário do Cloud Manager ativa o Brand Portal para uma instância do AEM Assets como Cloud Service. O fluxo de trabalho de ativação cria as configurações necessárias (token de autorização, configuração IMS e serviço de nuvem do Brand Portal) no back-end e reflete o status do locatário do Brand Portal no Cloud Manager. Ativar o Brand Portal permite que os usuários do AEM Assets publiquem ativos no Brand Portal e os distribuam para os usuários do Brand Portal.

Pré-requisitos

Você precisa do seguinte para ativar o Brand Portal em seu AEM Assets como uma instância Cloud Service:

  • Uma instância ativa e em execução do AEM Assets como Cloud Service.
  • Um usuário com acesso ao Cloud Manager, atribuído aos Perfis do Cloud Manager Product. Consulte acessar o Cloud Manager para obter mais informações.
OBSERVAÇÃO

Uma instância do AEM Assets as a Cloud Service tem direito a se conectar a apenas um locatário do Brand Portal. Você pode ter vários ambientes (desenvolvimento, produção e estágio) para seu AEM Assets como uma instância Cloud Service, onde o Brand Portal é ativado em um ambiente.

Etapas para ativar o Brand Portal

Você pode ativar o Brand Portal ao criar os ambientes para sua AEM Assets como uma instância Cloud Service ou separadamente. Vamos supor que os ambientes já foram criados e agora você precisa ativar o Brand Portal.

  1. Faça logon no Adobe Cloud Manager e navegue até Ambientes.

    A página Ambientes exibe a lista de todos os ambientes existentes.

  2. Selecione os ambientes (um por um) na lista para exibir os detalhes do ambiente.

    O Brand Portal tem direito a um dos ambientes disponíveis e é refletido no Environment Information.

    Depois de encontrar o ambiente associado ao Brand Portal, clique no botão Ativate Brand Portal para iniciar o workflow de ativação.

    Ativar o Brand Portal

  3. São necessários alguns minutos para ativar o locatário do Brand Portal, pois o fluxo de trabalho de ativação cria as configurações necessárias no back-end. Quando o locatário do Brand Portal é ativado, o status é alterado para Ativado.

    Exibir status

OBSERVAÇÃO

O Brand Portal deve ser ativado na mesma organização IMS do AEM Assets como uma instância Cloud Service.

Se você tiver uma configuração de nuvem Brand Portal existente (manualmente configurada usando o Adobe Developer Console) para uma organização IMS (org1-existing) e seu AEM Assets como uma instância Cloud Service estiver configurado para outra organização IMS (org2-new), ativar o Brand Portal no Cloud Manager redefinirá a organização do Brand Portal IMS para org2-new. Embora a configuração de nuvem configurada manualmente em org1-existing esteja visível na instância do autor do AEM Assets, mas não estará mais em uso após ativar o Brand Portal no Cloud Manager.

Se a configuração de nuvem existente do Brand Portal e a instância do AEM Assets as Cloud Service estiverem usando a mesma organização IMS (org1), será necessário ativar o Brand Portal somente no Cloud Manager.

Não modifique configurações geradas automaticamente.

Consulte também:

Faça logon no locatário do Brand Portal:

Após a ativação do locatário do Brand Portal no Cloud Manager, é possível fazer logon no Brand Portal pelo Admin Console ou diretamente usando o URL do locatário.

O URL padrão do seu locatário do Brand Portal é: https://<tenant-id>.brand-portal.adobe.com/.

Onde, a ID do locatário é a organização IMS.

Execute as seguintes etapas se não tiver certeza do URL do Brand Portal:

  1. Faça logon em Admin Console e navegue até Produtos.

  2. No painel esquerdo, selecione Adobe Experience Manager Brand Portal - Brand Portal.

  3. Clique em Vá para Brand Portal para abrir diretamente o Brand Portal no navegador.

    Ou copie o URL do locatário do Brand Portal do link Ir para Brand Portal e cole-o em seu navegador para abrir a interface do Brand Portal.

    Acessar o Brand Portal

Testar conexão

Execute as etapas a seguir para validar a conexão entre sua AEM Assets como uma instância Cloud Service e o locatário do Brand Portal:

  1. Faça logon no AEM Assets.

  2. No painel Ferramentas, navegue até Implantação > Distribuição.

    Um agente de distribuição Brand Portal (bpdistributionagent0) é criado em Publicar no Brand Portal.

  3. Clique em Publicar no Brand Portal para abrir o agente de distribuição.

    Você pode ver as filas de distribuição na guia Status.

    Um agente de distribuição contém duas filas:

    • fila de processamento: para distribuição de ativos no Brand Portal.

    • fila de erros: para os ativos em que a distribuição falhou.

    OBSERVAÇÃO

    É recomendável analisar as falhas e limpar a fila de erros periodicamente.

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

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

    OBSERVAÇÃO

    Evite desativar o agente de distribuição, pois isso pode causar falha na distribuição dos ativos (em execução na fila).

Para verificar a conexão entre sua instância do AEM Assets as a Cloud Service e o locatário do Brand Portal, publique um ativo do AEM Assets para o Brand Portal. Se a conexão for bem-sucedida, o ativo publicado estará visível na interface do Brand Portal.

Agora você pode:

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

Registros de distribuição

Você pode monitorar os registros do agente de distribuição para o fluxo de trabalho de publicação de ativos.

Agora, vamos publicar um ativo do AEM Assets para o Brand Portal e ver os logs.

  1. Siga as etapas (de 1 a 4) conforme mostrado na seção Testar conexão e navegue até a página do agente de distribuição.

  2. Clique em Logs para visualizar o processamento e os logs de erro.

O agente de distribuição gerou os seguintes logs:

  • INFORMAÇÕES: É um registro gerado pelo sistema que dispara para uma configuração bem-sucedida do agente de distribuição.
  • DSTRQ1 (Solicitação 1): acionado na conexão de teste.

Ao publicar o ativo, os seguintes registros de solicitação e resposta são gerados:

Solicitação do agente de distribuição:

  • DSTRQ2 (Solicitação 2): a solicitação de publicação de ativo é acionada.
  • DSTRQ3 (Solicitação 3): O sistema aciona outra solicitação para publicar a pasta do AEM Assets (na qual o ativo existe) e replicar a pasta no Brand Portal.

Resposta do agente de distribuição:

  • queue-bpdistributionagent0 (DSTRQ2): o ativo é publicado no Brand Portal.
  • queue-bpdistributionagent0 (DSTRQ3): O sistema replica a pasta AEM Assets (contendo o ativo) no Brand Portal.

No exemplo acima, uma solicitação e uma resposta adicionais são acionadas. O sistema não pôde localizar a pasta principal (Adicionar caminho) no Brand Portal porque o ativo foi publicado pela primeira vez, portanto, acionou uma solicitação adicional para criar uma pasta principal com o mesmo nome no Brand Portal, onde o ativo é publicado.

OBSERVAÇÃO

A solicitação adicional é gerada caso a pasta principal não exista no Brand Portal ou tenha sido modificada no AEM Assets.

Junto com o fluxo de trabalho de automação para ativar o Brand Portal no AEM Assets como um Cloud Service, existe outro método para configurar manualmente o AEM Assets como um Cloud Service com o Brand Portal usando o Console do Desenvolvedor do Adobe, o que não é mais recomendado.

OBSERVAÇÃO

Entre em contato com o Suporte ao cliente se tiver algum problema ao ativar o locatário do Brand Portal.

Configuração manual usando o Console do desenvolvedor do Adobe

A seção a seguir descreve como configurar manualmente o AEM Assets as a Cloud Service com o Brand Portal usando o Console do Desenvolvedor do Adobe.

Anteriormente, o AEM Assets as a Cloud Service era configurado manualmente com o Brand Portal via Console do Desenvolvedor do Adobe, que obtém um token de conta do Adobe Identity Management Services (IMS) para autorização do locatário do Brand Portal. Ela requer configurações no AEM Assets e no Console do desenvolvedor do Adobe.

  1. No AEM Assets, crie uma conta IMS e gere uma chave pública (certificado).
  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.
  4. Obtenha as credenciais da conta de serviço e as informações de carga JSON Web Token (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 de 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 para o Brand Portal.
OBSERVAÇÃO

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

Pré-requisitos

Você precisa do seguinte para configurar o AEM Assets com o Brand Portal:

  • Criar e executar o AEM Assets como uma instância Cloud Service
  • 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

Criar configuração

Execute as etapas a seguir na sequência especificada para configurar o AEM Assets com o Brand Portal.

  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

Criar configuração IMS

A configuração IMS autentica sua AEM Assets como uma instância Cloud Service 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 no AEM Assets.

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

  3. Na página Configurações do Adobe IMS , clique em Criar. Ele redirecionará para a página Configuração de conta técnica do Adobe IMS. 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 é usada posteriormente para configurar a API do 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 do 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 de 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 Console do desenvolvedor do Adobe fazendo upload da chave pública. Essas credenciais são necessárias para configurar a conta IMS no AEM Assets. Após configurar a conta IMS, é possível 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 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.

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 serviço de nuvem do Brand Portal:

  1. Faça logon no AEM Assets.

  2. No painel 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 (organização) do Brand Portal.

  5. Clique em Salvar e fechar. A configuração da nuvem é criada.

    Sua instância do AEM Assets as a Cloud Service agora está configurada com o locatário do Brand Portal.

Agora é possível testar a configuração, verificando o agente de distribuição e publicando ativos no Brand Portal.

Nesta página