Configurar o Experience Manager Assets com o Brand Portal

Última atualização em 2023-11-17
  • Criado para:
  • Admin
Versão Link do artigo
AEM 6.5 Clique aqui
AEM as a Cloud Service Este artigo

A configuração do Adobe Experience Manager Assets Brand Portal permite publicar ativos de marca aprovados do Adobe Experience Manager Assets as a Cloud Service para o 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 um Experience Manager Assets as a Cloud Service instância. O fluxo de trabalho de ativação cria as configurações necessárias (token de autorização, configuração do IMS e Brand Portal Cloud Service) no back-end e reflete o status do locatário do Brand Portal no Cloud Manager. A ativação do Brand Portal permite que os usuários do Experience Manager Assets publiquem ativos no Brand Portal e os distribuam aos usuários do Brand Portal.

Pré-requisitos

Você precisa do seguinte para ativar o Brand Portal no seu Experience Manager Assets as a Cloud Service instância:

  • Um Experience Manager Assets as a Cloud Service instância.
  • Um usuário com acesso ao Cloud Manager, atribuído aos Perfis do Cloud Manager Product. Consulte acesso ao Cloud Manager para obter mais informações.
OBSERVAÇÃO

Um ambiente de produção configurado é necessário para um Experience Manager Assets as a Cloud Service instância para se conectar com o locatário do Brand Portal.

Etapas para ativar o Brand Portal

Você pode ativar o Brand Portal ao criar os ambientes de produção para o seu Experience Manager Assets as a Cloud Service instância ou separadamente. Vamos supor que o ambiente já tenha sido criado e que agora você seja solicitado a ativar o Brand Portal.

  1. Faça logon no Adobe Cloud Manager e acesse Ambientes.

    A variável 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 na variável Informações do ambiente.

    Depois de encontrar o ambiente associado ao Brand Portal, clique no link Ativar Brand Portal para iniciar o fluxo de trabalho de ativação.

    Ativar Brand Portal

  3. Leva 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. Depois que o locatário do Brand Portal é ativado, o status muda para Ativated.

    Exibir Status

OBSERVAÇÃO

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

Se você tiver uma configuração de nuvem existente do Brand Portal (configurado manualmente usando o console do Adobe Developer) para uma organização IMS (org1-existing) e seu Experience Manager Assets as a Cloud Service estiver configurada para outra organização IMS (org2-new), ativar o Brand Portal no Cloud Manager redefinirá a organização IMS do Brand Portal para org2-new. Embora a configuração de nuvem definida manualmente em org1-existing está visível na instância do autor do Experience Manager 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 o Experience Manager Assets as a Cloud Service As instâncias do usam a mesma organização IMS (org1). Você só precisa ativar o Brand Portal no Cloud Manager.

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

Consulte também:

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

Após a ativação do locatário do Brand Portal no Cloud Manager, você poderá fazer logon no Brand Portal pelo Admin Console ou usando diretamente 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. Fazer logon em Admin Console e navegue até Produtos.

  2. No painel esquerdo, selecione ADOBE EXPERIENCE MANAGER BRAND PORTAL - BRAND PORTAL.

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

    Ou copie o URL do locatário do Brand Portal da Ir para o Brand Portal vincule-o e cole-o no navegador para abrir a interface do Brand Portal.

    Acessar o Brand Portal

Testar conexão

Execute as seguintes etapas para validar a conexão entre seu Experience Manager Assets as a Cloud Service instância e locatário do Brand Portal:

  1. Faça logon no Experience Manager Assets.

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

    Navegue até a opção de distribuição

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

    Criar agente de distribuição

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

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

    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.

    Fila de processamento para distribuição de ativos

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

    Verificar a conexão entre o AEM e o Brand Portal

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

    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 o Experience Manager Assets as a Cloud Service instância e o locatário do Brand Portal, publique um ativo do Experience Manager Assets na Brand Portal. Se a conexão for bem-sucedida, o ativo publicado ficará visível na interface do Brand Portal.

Agora você pode:

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

Registros de distribuição

É possível monitorar os logs do agente de distribuição para o fluxo de trabalho de publicação de ativos.

Vamos publicar um ativo do Experience Manager Assets no Brand Portal e ver os logs.

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

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

    Processamento e logs de erros

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

  • INFO: é um registro gerado pelo sistema que é acionado na 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 Experience Manager 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 do Experience Manager Assets (que contém 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 Experience Manager Assets.

Juntamente com o fluxo de trabalho de automação para ativar o Brand Portal no Experience Manager Assets as a Cloud Service, existe outro método para configurar manualmente o Experience Manager Assets as a Cloud Service com o Brand Portal usando o Adobe Developer Console, o que não é mais recomendado.

OBSERVAÇÃO

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

Configuração manual usando o console do Adobe Developer

A seção a seguir descreve como configurar manualmente o Experience Manager Assets as a Cloud Service com o Brand Portal usando o Adobe Developer Console.

Anteriormente, o Experience Manager Assets as a Cloud Service O foi configurado manualmente com o Brand Portal por meio do 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. Ele requer configurações no Experience Manager Assets e no Adobe Developer Console.

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

Um Experience Manager Assets as a Cloud Service instância só deve ser configurada com um locatário do Brand Portal.

Pré-requisitos

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

  • Um Experience Manager Assets as a Cloud Service instância
  • 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 seguintes etapas na sequência especificada para configurar o Experience Manager 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 seu Experience Manager Assets as a Cloud Service instância 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 no Experience Manager Assets.

  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 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 é usada posteriormente para configurar a API do locatário do Brand Portal e gerar credenciais de 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 Experience Manager Assets com o Brand Portal, você deve gerar uma chave pública (certificado) no Experience Manager 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 Experience Manager Assets. Depois que a conta IMS é configurada, você pode configurar o serviço de nuvem da Brand Portal no Experience Manager 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 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 Experience Manager 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 Experience Manager 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.

    As configurações do Adobe IMS verificam a integridade.

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 outra configuração válida.

Configurar o serviço em nuvem

Execute as seguintes etapas para configurar o Brand Portal Cloud Service:

  1. Faça logon no Experience Manager Assets.

  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.

    caixa de diálogo Configuração do Brand Portal.

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

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

Agora você pode testar a configuração verificando o agente de distribuição e publicando ativos no Brand Portal.

➡ Incluir na lista de permissões IPs de saída em SPS se a visualização segura estiver ativada
Se estiver usando o Dynamic Media-Scene7 com visualização segura ativada para uma empresa), recomenda-se que o administrador da empresa do Scene7 incluir na lista de permissões os IPs de saída públicos para as respectivas regiões usando a interface flash do SPS (Scene7 Publishing System).
Os IPs de saída são os seguintes:

Região IP de saída
ND 130.248.160.68, 20.94.203.130
EMEA 51.132.146.75, 130.248.244.202, 130.248.244.203, 130.248.244.204, 130.248.244.210, 130.248.244.211, 130.248.244.212
APAC 63.140.44.54

Consulte também

Nesta página