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

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

O Adobe Experience Manager 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.

NOTE
Configuração do AEM Assets com Brand Portal via Adobe I/O é compatível com 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.
TIP
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 do autor do AEM Assets com o Brand Portal, poderá criar uma nova configuração em 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 Brand Portal no Gateway OAuth herdado, é recomendável excluir as configurações existentes e criar uma nova configuração em 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 prerequisites

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 aemquickstart

É 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 implantação e manutenção.

Baixe e instale AEM Service Pack mais recente servicepack

Para obter instruções detalhadas, consulte

Entre em contato com o Suporte ao cliente caso não consiga encontrar o pacote AEM ou o Service Pack mais recente.

Criar configuração configure-new-integration-64

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

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

Criar configuração IMS create-ims-configuration

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 public-certificate

O certificado público permite autenticar seu perfil no 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 Criar Adobe I/O integração para obter os detalhes de integração das configurações da conta IMS.

Criar Adobe I/O integração createnewintegration

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 em Adobe I/O Console com privilégios de administrador do 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 create-ims-account-configuration

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 Criar Adobe I/O integração.

    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.

CAUTION
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 configure-the-cloud-service

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 test-integration

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

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

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

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

    Clique em Agentes do autor.

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

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

    Clique no URL do agente de replicação.

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

    note note
    NOTE
    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 é configurado com êxito com a instância do autor do AEM Assets. Agora você pode:

Atualizar configuração upgrade-integration-64

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

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

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

    Clique em Agentes do autor.

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

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

Excluir configurações existentes delete-existing-configuration

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 do 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. Navegar para /etc/replications/agents.author e exclua todos os quatro agentes de replicação do seu locatário do Brand Portal.

  3. Navegar para /etc/cloudservices/mediaportal e exclua o Configuração do Cloud Service.

  4. Navegar para /home/users/mac e exclua o Usuário do Mac do seu 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:

recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad