Configurar o AEM Assets com o Brand Portal

O Adobe Experience Manager (AEM) Assets é configurado com o Brand Portal por meio de Adobe I/O, que obtém um token IMS para autorização do locatário do Brand Portal.

OBSERVAÇÃO

A configuração do AEM Assets com o Brand Portal via Adobe I/O é compatível com o AEM 6.4.8.0 e superior.

Anteriormente, o Brand Portal era configurado na interface clássica por meio do Gateway OAuth herdado, que usa a troca de token JWT para obter um token de acesso IMS para autorização.

DICA

Somente para clientes existentes

É recomendável continuar usando a configuração existente do Gateway OAuth. Caso encontre problemas com a configuração herdada do Gateway OAuth, exclua a configuração existente e crie uma nova configuração por meio de Adobe I/O.

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 a instância de autor do AEM Assets com o Brand Portal, poderá criar uma nova configuração no Adobe I/O.
  • Atualizar configuração: Se você for um usuário existente do Brand Portal com sua instância de autor do AEM Assets configurada com o Brand Portal no Gateway OAuth herdado, é recomendável excluir as configurações existentes e criar nova configuração no Adobe I/O.

As informações fornecidas baseiam-se no pressuposto 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

  • Usando sistemas operacionais Linux e Microsoft Windows

Pré-requisitos

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

  • Uma instância de autor do AEM Assets ativa e em execução com o Service Pack mais recente.
  • URL do 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.4

Baixe e instale o AEM Service Pack mais recente

Baixe e instale o AEM 6.4

É recomendável ter o AEM 6.4 para configurar uma instância de autor AEM. Se você não tiver o AEM ativado e 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 de AEM, consulte implantar e manter.

Baixe e instale AEM Service Pack mais recente

Para obter instruções detalhadas, consulte

Entre em contato com o Atendimento ao cliente se não conseguir encontrar o pacote de AEM ou o Service Pack mais recente.

Criar configuração

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

  1. Obter certificado público
  2. Adobe I/O Criar integração
  3. Criar configuração de conta IMS
  4. Configurar o serviço em nuvem
  5. Testar configuração
OBSERVAÇÃO

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

Criar configuração IMS

A configuração IMS autentica seu locatário do Brand Portal com a instância do autor do AEM Assets.

A configuração IMS inclui duas etapas:

Obter certificado público

O certificado público permite autenticar seu perfil em Adobe I/O.

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

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

    Interface do usuário de configuração de conta do Adobe IMS

  3. A página Configurações do Adobe IMS é aberta.

    Clique em Criar.

    Isso o levará à página Configuração técnica de conta do Adobe IMS.

  4. Por padrão, a guia Certificado é aberta.

    Em Solução da nuvem, selecione Adobe Brand Portal.

  5. Marque a caixa de seleção Criar novo certificado e especifique um alias para o certificado. O alias atua como nome da caixa de diálogo.

  6. Clique em Criar certificado. Uma caixa de diálogo é exibida. Clique em OK para gerar o certificado público.

    Criar certificado

  7. Clique em Baixar chave pública e salve o arquivo de certificado AEM-Adobe-IMS.crt no computador. O arquivo de certificado é usado para criar Adobe I/O integração.

    Baixar certificado

  8. Clique em Avançar.

    Na guia Conta, crie a conta do Adobe IMS, mas para isso você precisará dos detalhes de integração. Mantenha esta página aberta por enquanto.

    Abra uma nova guia e Create Adobe I/O integration para obter os detalhes de integração das configurações da conta IMS.

Criar Adobe I/O integração

Adobe I/OA integração do gera a chave da API, o segredo do cliente e a carga (JWT), que são necessários para configurar as configurações da conta do IMS.

  1. Faça logon no Console Adobe I/O com privilégios de administrador de sistema na organização IMS do locatário do Brand Portal.

    URL padrão: https://console.adobe.io/

  2. Clique em Criar integração.

  3. Selecione Acessar uma API e clique em Continuar.

    Criar nova integração

  4. Uma nova página de integração é exibida.

    Selecione sua organização na lista suspensa.

    Em Experience Cloud, selecione AEM Brand Portal e clique em Continuar.

    Se a opção Brand Portal estiver desativada para você, verifique se selecionou a organização correta na caixa suspensa acima da opção Serviços da Adobe. Se não souber sua organização, entre em contato com o administrador.

    Criar integração

  5. Especifique um nome e uma descrição para a integração. Clique em Selecionar um arquivo do seu computador e faça upload do arquivo AEM-Adobe-IMS.crt baixado na seção obter certificados públicos.

  6. Selecione o perfil da organização.

    Ou selecione o Assets Brand Portal e clique em Criar integração. A integração é criada.

  7. Clique em Continuar para obter detalhes de integração para visualizar as informações de integração.

    Copie a chave da API

    Clique em Recuperar segredo do cliente e copie a chave Segredo do cliente.

    Chave da API, segredo do cliente e informações de carga de uma integração

  8. Navegue até a guia JWT e copie a carga JWT.

    As informações da chave da API, da chave Segredo do cliente e da carga JWT serão usadas para criar a configuração da conta do IMS.

Criar configuração de conta IMS

Verifique se você executou as seguintes etapas:

Etapas para criar a configuração da conta IMS:

  1. Abra a página Configuração IMS, guia Contas. Você manteve a página aberta no final da seção, Obter certificado público.

  2. Especifique um Título para a conta IMS.

    No Servidor de autorização, insira o URL: https://ims-na1.adobelogin.com/

    Cole a chave da API, o segredo do cliente e a carga JWT copiados no final de Create Adobe I/O integration.

    Clique em Criar.

    A integração é criada.

    Configurar a conta IMS

  3. Selecione a configuração IMS e clique em Verificar integridade. Uma caixa de diálogo é exibida.

    Clique em Verificar. Ao se conectar com êxito, a mensagem Token recuperado com êxito é exibida.

CUIDADO

Você deve ter apenas uma configuração IMS. Não crie várias configurações 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 criar a configuração do serviço em nuvem do Brand Portal:

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

    URL padrão: http:// localhost:4502/aem/start.html

  2. No painel Ferramentas Ferramentas, navegue até Cloud Services > AEM Brand Portal.

    A página Configurações do Brand Portal é aberta.

  3. Clique em Criar.

  4. Especifique um Título para a configuração.

    Selecione a Configuração IMS criada na etapa e crie a configuração da conta IMS.

    No URL de serviço, insira o URL do locatário do Brand Portal.

  5. Clique em Salvar e fechar. A configuração da nuvem é criada. A instância do autor do AEM Assets agora está integrada ao locatário do Brand Portal.

Testar configuração

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

    URL padrão: http:// localhost:4502/aem/start.html

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

  3. A página Replicação é aberta.

    Clique em Agentes no autor.

  4. Quatro agentes de replicação são criados para cada locatário.

    Localize os agentes de replicação do locatário do Brand Portal.

    Clique no URL do agente de replicação.

    OBSERVAÇÃO

    Os agentes de replicação trabalham em paralelo e compartilham a distribuição de tarefas igualmente, aumentando assim a velocidade de publicação em quatro vezes a velocidade original. Depois que o serviço de nuvem é configurado, não é necessária configuração adicional para habilitar os agentes de replicação que são ativados por padrão para habilitar a publicação paralela de vários ativos.

  5. Para verificar a conexão entre o autor do AEM Assets e o Brand Portal, clique em Testar Conexão.

  6. Examine a parte inferior dos resultados do teste para verificar se a replicação foi bem-sucedida.

  7. Verifique os resultados do teste em todos os quatro agentes de replicação um por um.

    OBSERVAÇÃO

    Evite desativar qualquer um dos agentes de replicação, pois isso pode causar falha na replicação de alguns ativos.

    Certifique-se de que todos os quatro agentes de replicação estejam configurados para evitar o erro de tempo limite. Consulte solucionar problemas na publicação paralela no Brand Portal.

O Brand Portal foi configurado com êxito com a instância do autor do AEM Assets. Agora você pode:

Atualizar configuração

Execute as seguintes etapas na sequência listada para atualizar as configurações existentes:

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

Verificar tarefas 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 qualquer modificação. Para isso, você pode verificar todos os quatro agentes de replicação e garantir que a fila seja ideal/vazia.

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

    URL padrão: http:// localhost:4502/aem/start.html

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

  3. A página Replicação é aberta.

    Clique em Agentes no autor.

  4. Localize os agentes de replicação do locatário do Brand Portal.

    Certifique-se de que a Fila esteja inativa para todos os agentes de replicação, nenhum trabalho de publicação está ativo.

Excluir configurações existentes

Você deve executar a seguinte lista de verificação ao excluir a configuração existente.

  • Excluir todos os quatro agentes de replicação
  • Excluir serviço em nuvem
  • Excluir usuário MAC

Execute as seguintes etapas para excluir a configuração existente:

  1. Faça logon na instância de autor do AEM Assets e abra o CRX Lite como administrador.

    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 locatário do Brand Portal.

  3. Navegue até /etc/cloudservices/mediaportal e exclua a configuração do Cloud Service.

  4. Navegue até /home/users/mac e exclua o usuário MAC do locatário do Brand Portal.

Agora você pode criar configuração na instância do autor do AEM 6.4 em Adobe I/O.

Depois que a replicação for bem-sucedida, você poderá publicar ativos, pastas e coleções no Brand Portal. Para obter detalhes, consulte:

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now