Configurar o Experience Manager Assets 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 as a Cloud Service para o Brand Portal e distribua-as para os 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 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 Experience Manager 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 no Experience Manager Assets as a Cloud Service instância:

  • Criar e executar o 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

Ativos do Experience Manager as a Cloud Service A instância tem direito para se conectar com apenas um locatário do Brand Portal. Você pode ter vários ambientes (desenvolvimento, produção e estágio) para seus Ativos do Experience Manager as a 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 os Ativos do Experience Manager as a 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.

    O 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 Informações sobre o ambiente.

    Depois de encontrar o ambiente associado ao Brand Portal, clique no link Ativar o 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 dos Ativos do Experience Manager como um Cloud Service instância.

Se você tiver uma configuração de nuvem Brand Portal existente (configurado manualmente usando o Console do Desenvolvedor do Adobe) para uma organização IMS (org1-existing) e seus Ativos Experience Manager as a Cloud Service está configurada para outra organização IMS (org2-new), ativar o Brand Portal no Cloud Manager redefine a organização do Brand Portal IMS para org2-new. Embora a configuração de nuvem configurada manualmente no org1-existing estarão visíveis na instância do autor do Experience Manager Assets, mas não estarão mais em uso após ativar o Brand Portal no Cloud Manager.

Se a configuração de nuvem existente do Brand Portal e do Experience Manager Assets as a Cloud Service As instâncias estão usando a mesma organização IMS (org1), você só precisa ativar o Brand Portal no Cloud Manager.

Não modifique configurações geradas 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, é 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 Ir para o Brand Portal para abrir diretamente o Brand Portal no navegador.

    Ou copie o URL do locatário do Brand Portal da Ir para o 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 os Ativos do Experience Manager como um 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.

    Um agente de distribuição da 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 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.

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

    Uma mensagem é exibida informando que o 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 os ativos do Experience Manager como um Cloud Service e o locatário do Brand Portal, publique um ativo do Experience Manager Assets no Brand Portal. Se a conexão for bem-sucedida, o ativo publicado estará 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

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 Experience Manager Assets no Brand Portal e ver os logs.

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

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

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 Ativos do Experience Manager (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 Ativos do Experience Manager (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.

Junto 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 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 Experience Manager Assets as a Cloud Service com o Brand Portal usando o Console do desenvolvedor do Adobe.

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. Ela 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 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 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 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 Experience Manager Assets no Brand Portal.
OBSERVAÇÃO

Ativos do Experience Manager as a Cloud Service A 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:

  • Criar e executar o 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 etapas a seguir na sequência especificada para configurar os Ativos do Experience Manager 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 do IMS autentica seus Ativos do Experience Manager as a 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 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 o Configuração de conta técnica do Adobe IMS página. Por padrão, a variável Certificado será aberta.

  4. Selecionar Adobe Brand Portal no Solução da nuvem lista suspensa.

  5. Selecione o Criar novo certificado e especifique uma 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 botão 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 Console do desenvolvedor do Adobe.

    Baixar certificado

  8. Clique em Avançar.

    No Conta , é 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 criar 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 Experience Manager Assets com o Brand Portal, você deve gerar uma chave pública (certificado) no Experience Manager 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 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 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. 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óximo.

    Certifique-se de ter acesso ao serviço Brand Portal do Experience Manager.

  5. No Configurar API , clique em Fazer upload de sua chave pública. Em seguida, clique em Selecionar um Arquivo e faça upload da chave pública (arquivo .crt) que você baixou no 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óximo.

  7. Selecionar 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 Credenciais, clique no botão 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, recuperar o segredo do cliente e assim por diante.

  9. No Credenciais do Cliente , copie a client ID.

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

    Credenciais da Conta de Serviço

  10. Navegue até o Gerar JWT e copie a 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 etapas a seguir 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 da 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 Verificar na caixa de diálogo. Na configuração bem-sucedida, uma mensagem aparece informando que a variável 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 Experience Manager Assets.

  2. No 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 configuração da conta IMS.

    No URL de 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.

    Seus ativos do Experience Manager as a Cloud Service A instância 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