Show Menu
TÓPICOS×

Configurar o AEM Assets com o Brand Portal

Os ativos Adobe Experience Manager (AEM) são configurados com o Brand Portal por meio do Adobe Developer Console, que obtém um token IMS para autorização do locatário do Brand Portal.
A configuração dos ativos AEM com o portal de marcas por meio do Adobe Developer Console é compatível com o AEM 6.5.4.0 e superior.
Anteriormente, o Brand Portal estava configurado na interface clássica via Gateway OAuth herdado, que usa a troca de token JWT para obter um Token de acesso IMS para autorização.
A configuração por meio do Legacy OAuth não é mais compatível a partir de 6 de abril de 2020 e é alterada para configuração por meio do Adobe Developer Console.
Somente para clientes existentes
É recomendável continuar usando a configuração existente do gateway OAuth. Caso encontre problemas com a configuração herdada do OAuth Gateway, exclua a configuração existente e crie uma nova configuração por meio do Adobe Developer Console.
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 de autor do AEM Assets com o Brand Portal, poderá criar uma nova configuração no Adobe Developer Console.
  • Configuração de atualização: Se você for um usuário do Brand Portal com sua instância do autor AEM Assets configurada com o Brand Portal no gateway OAuth herdado, é recomendável excluir as configurações existentes e criar uma nova configuração no Adobe Developer Console.
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 do Adobe Experience Manager e do 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 do autor do AEM Assets em funcionamento 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.

Baixar e instalar o AEM 6.5

É recomendável ter o AEM 6.5 para configurar uma instância do autor de AEM. Se o AEM não estiver funcionando, baixe-o dos seguintes locais:
Depois de baixar o AEM, para obter instruções sobre como configurar uma instância do autor de AEM, consulte implantação e manutenção .

Baixar e instalar o Service Pack mais recente do AEM

Para obter instruções detalhadas, consulte
Entre em contato com o Atendimento ao cliente se não conseguir encontrar o pacote AEM ou o Service Pack mais recente.

Criar configuração

A configuração dos ativos AEM com o Brand Portal requer configurações tanto na instância do autor dos ativos AEM quanto no console do desenvolvedor da Adobe.
  1. Na instância do autor do AEM Assets, crie uma conta IMS e gere um certificado público (chave pública).
  2. No Adobe Developer Console, 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. Na instância do autor do AEM Assets, configure a conta IMS usando as credenciais da conta de serviço e a carga JWT.
  6. Na instância do autor do AEM Assets, configure o serviço em nuvem do Brand Portal usando a conta IMS e o terminal do Brand Portal (URL da organização).
  7. Teste a configuração publicando um ativo da instância do autor do AEM Assets no Brand Portal.
Um locatário do Brand Portal só deve ser configurado com uma instância do autor do AEM Assets.
Não configure um locatário do Brand Portal com várias instâncias do autor do AEM Assets.
Execute as seguintes etapas na sequência listada se você estiver configurando ativos AEM com o Portal de marca pela primeira vez:

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 no Adobe Developer Console.
  1. Faça logon na instância do autor do AEM Assets. O URL padrão é http:// localhost:4502/aem/start.html
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Na página Configurações do Adobe IMS, clique em Criar .
  4. Você é redirecionado para a página Configuração técnica da conta do Adobe IMS. By default, the Certificate tab opens.
    Selecione a solução em nuvem Portal da marca da Adobe.
  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 . Em seguida, clique em OK na caixa de diálogo para gerar o certificado público.
  7. Click Download Public Key and save the certificate (.crt) file on your machine.
    O arquivo de certificado será usado em outras etapas para configurar a API para o locatário do Brand Portal e gerar credenciais de conta de serviço no Adobe Developer Console.
  8. Clique em Avançar .
    Na guia Conta , crie a conta Adobe IMS, mas para isso você precisará das credenciais da conta de serviço geradas no Adobe Developer Console. Mantenha esta página aberta por enquanto.
    Abra uma nova guia e crie uma conexão de conta de serviço (JWT) no Adobe Developer Console para obter as credenciais e a carga JWT para configurar a conta IMS.

Criar conexão de conta de serviço (JWT)

No Adobe Developer Console, os projetos e as APIs são configurados no nível da organização (locatário do Brand Portal). Configurar uma API cria uma conexão de conta de serviço (JWT) no Adobe Developer Console. 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 a instância do autor do AEM Assets com o Brand Portal, você deve gerar um certificado público (chave pública) na instância do autor do AEM Assets e criar credenciais no Adobe Developer Console fazendo upload da chave pública. Essa chave pública é usada para configurar a API para a organização selecionada do Brand Portal e gera as credenciais e a carga JWT para a conta de serviço. Essas credenciais são usadas ainda mais para configurar a conta IMS na instância do autor do AEM Assets. Depois que a conta IMS for configurada, você poderá configurar o serviço em nuvem do Brand Portal na instância do autor do AEM 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 do sistema na organização IMS (locatário do Brand Portal). O URL padrão é
    Verifique se você selecionou a organização IMS correta (locatário do Brand Portal) na lista suspensa (lista da organização) localizada no canto superior direito.
  2. Click Create new project . Um projeto em branco é criado para sua organização.
    Clique em Editar projeto para atualizar o Título e a Descrição do projeto e clique em Salvar .
  3. Na guia Visão geral do projeto, clique em Adicionar API .
  4. Na janela Adicionar uma API, selecione AEM Brand Portal e clique em Avançar .
    Certifique-se de ter acesso ao serviço AEM Brand Portal.
  5. Na janela Configurar API, clique em Carregar sua chave pública. Em seguida, clique em Selecionar um arquivo e faça upload do certificado público (arquivo .crt) que você baixou na seção obter certificado público.
    Clique em Avançar .
  6. Verifique o certificado público e clique em Avançar .
  7. Selecione o perfil de produto padrão Portal de marca de Ativos de marca e clique em Salvar configuração .
  8. Com a API configurada, você é redirecionado para a visão geral da API. Na navegação à esquerda em Credenciais , clique em Service Account (JWT) .
    Você pode visualização as credenciais e executar outras ações (gerar tokens JWT, copiar detalhes das credenciais, recuperar o segredo do cliente e assim por diante) conforme necessário.
  9. Na guia Credenciais do cliente, copie a ID do cliente.
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload .
Agora você pode usar a ID do cliente (chave da API), o segredo do cliente e a carga JWT para configurar a conta IMS na instância da nuvem do AEM Assets.

Criar configuração de conta IMS

Verifique se você executou as seguintes etapas:
Execute as seguintes etapas para configurar a conta IMS que você criou na obtenção de um certificado público.
  1. Abra a Configuração IMS e navegue até a guia Contas . Você manteve a página aberta ao obter um 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 ID do cliente na chave da API, o segredo do cliente e a carga JWT que você copiou ao criar a conexão da conta de serviço (JWT).
    Clique em Criar .
    A conta IMS está configurada.
  3. Selecione a configuração IMS e clique em Verificar integridade .
    Clique em Verificar na caixa de diálogo. Na configuração bem-sucedida, será exibida uma mensagem informando que o Token foi recuperado com êxito .
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 o serviço em nuvem do Brand Portal:
  1. Faça logon na instância do autor do AEM Assets.
  2. From the Tools panel, navigate to 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 configurar a conta IMS.
    In the Service URL , enter your Brand Portal tenant (organization) URL.
  5. Clique em Salvar e fechar . A configuração da nuvem é criada. A instância do autor do AEM Assets agora está configurada com o locatário do Brand Portal.

Testar configuração

Execute as seguintes etapas para validar a configuração:
  1. Faça logon na instância da nuvem do AEM Assets.
  2. From the Tools panel, navigate to Deployment > Replication .
  3. Na página Replicação, 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 seu locatário do Brand Portal.
    Clique no URL do agente de replicaçã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 uma 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 AEM Assets e o Brand Portal, clique em Testar conexão .
    Uma mensagem é exibida na parte inferior da página informando que o pacote de teste foi entregue com êxito.
  6. Verifique os resultados do teste em todos os quatro agentes de replicação um por um.
    Evite desativar qualquer um dos agentes de replicação, pois isso pode causar falha na replicação de alguns ativos.
A instância do autor do AEM Assets foi configurada com êxito com o Brand Portal, agora você pode:

Atualizar configuração

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

Verificar trabalhos 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.
  2. No painel Ferramentas , navegue até Implantação > Replicação de implantação.
  3. Na página Replicação, clique em Agentes no autor .
  4. Localize os agentes de replicação do seu 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 as configurações existentes.
  • Excluir todos os quatro agentes de replicação
  • Excluir serviço em nuvem
  • Excluir usuário MAC
  1. Faça logon na instância do autor do AEM Assets 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.
  3. Navegue até /etc/cloudservices/mediaportal e exclua a configuração do Serviço Cloud.
  4. Navegue até /home/users/mac e exclua o usuário ​MAC do seu locatário do Brand Portal.
Agora você pode criar a configuração na sua instância do autor do AEM 6.5.
Depois que a replicação for bem-sucedida, você poderá publicar ativos, pastas e coleções no Brand Portal. Para obter detalhes, consulte: