Configurar o AEM Assets com o Brand Portal configure-integration-65

Versão
Link do artigo
AEM as a Cloud Service
Clique aqui
AEM 6.5
Este artigo

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.

NOTE
A configuração do AEM Assets com o Console do Adobe Developer AEM é compatível com o Brand Portal 6.5.4.0 e superior.
Anteriormente, o Brand Portal era configurado por meio do Gateway OAuth herdado, que usa a troca do JSON Web Token (JWT) para obter um token de acesso IMS para autorização.
A configuração por meio do gateway OAuth herdado não é mais compatível a partir de 6 de abril de 2020 e foi alterada para o Console do Adobe Developer.
TIP
Somente para clientes existentes
A Adobe recomenda que você continue a usar a configuração existente do gateway OAuth herdada. Se você encontrar problemas com a configuração herdada do Gateway OAuth, exclua a configuração existente e crie uma configuração por meio do Console do Adobe Developer.

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 prerequisites

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 aemquickstart

É 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:

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 servicepack

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 configure-new-integration-65

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.
NOTE
Uma instância de autor do AEM Assets só deve ser configurada com um locatário do Brand Portal.

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

Criar configuração IMS create-ims-configuration

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 certificado público public-certificate

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

    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 , 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) createnewintegration

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.

    note note
    NOTE
    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.

    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.

    note note
    NOTE
    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.

    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 AEM Assets.

Configurar a conta IMS create-ims-account-configuration

Verifique se você já executou 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.

    Caixa de diálogo de confirmação Configuração íntegra

CAUTION
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. Exclua-a e crie outra configuração válida.

Configurar o serviço em nuvem Brand Portal configure-the-cloud-service

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

  2. No Ferramentas 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.

    Janela Configuraçã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 test-integration

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

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

    O painel Ferramentas

  3. Na página Replicação, clique em Agentes sobre o autor.

    Página Replicação

    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.

    Configuração de replicação de ativos

    note note
    NOTE
    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.

    Verificar as configurações de replicação de ativos

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

    Saída de confirmação de teste

  5. Verifique os resultados do teste em todos os quatro agentes de replicação.

    note note
    NOTE
    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:

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

Configuração de atualização upgrade-integration-65

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

Verificar trabalhos em execução verify-jobs

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 Ferramentas , navegue até Implantação > Replicação de implantação.

  3. Na página Replicação, clique em Agentes sobre o autor.

    Agentes de replicação para ativos

  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.

    Configurações da fila de replicação

Excluir configurações existentes delete-existing-configuration

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.

    Agente de replicação no CRXDE

  3. Navegue até /etc/cloudservices/mediaportal e exclua a configuração do Brand Portal cloud service.

    Detalhes do agente de replicação no CRXDE

  4. Navegue até /home/users/mac e exclua a variável usuário do Mac do seu locatário do Brand Portal.

    Mais detalhes do agente de replicação no CRXDE

Agora você pode criar uma configuração por meio do Console do Adobe Developer na instância do autor do AEM 6.5.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2