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.
Como a configuração funciona?
A configuração da instância da nuvem do AEM Assets com um locatário do Brand Portal (organização) requer configurações tanto na instância da nuvem do AEM Assets quanto no Adobe Developer Console.
  1. Na instância da nuvem 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 da nuvem do AEM Assets, configure a conta IMS usando as credenciais da conta de serviço e a carga JWT.
  6. Na instância da nuvem 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 de nuvem do AEM Assets no Brand Portal.
Um locatário do Brand Portal só deve ser configurado com uma instância da nuvem do AEM Assets.
Não configure um locatário do Brand Portal com várias instâncias da nuvem do AEM Assets.

Pré-requisitos

Você precisa do seguinte para configurar o AEM Assets com o Brand Portal:
  • Uma instância da nuvem ativa e em execução do AEM Assets.
  • 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.
Entre em contato com o Atendimento ao cliente para obter mais query.

Criar configuração

Execute as seguintes etapas na sequência especificada para configurar a instância da nuvem do AEM Assets com o 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 no Adobe Developer Console.
  1. Faça logon na instância da nuvem do AEM Assets.
  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 da nuvem do AEM Assets com o Brand Portal, você deve gerar um certificado público (chave pública) na instância da nuvem 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 da nuvem do AEM Assets. Depois que a conta IMS for configurada, você poderá configurar o serviço em nuvem do Brand Portal na instância em nuvem 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 marcas 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.

Configurar 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 enquanto obtinha o 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. Select the IMS account configuration and click Check Health .
    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 configurar o serviço em nuvem do Brand Portal:
  1. Faça logon na instância da nuvem 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 da nuvem 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 > Distribution .
  3. Na página Distribuição, você pode ver que um agente de distribuição do Brand Portal bpdistributionagent0 é criado para Publicar no Brand Portal .
    Clique em Publicar no Brand Portal
    Por padrão, um agente de distribuição é criado para um locatário do Brand Portal.
  4. Na página do agente de distribuição, você pode ver as filas de distribuição na guia Status .
    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.
    É recomendável analisar as falhas e limpar a fila de erros periodicamente.
  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.
    Evite desativar o agente de distribuição, pois isso pode causar falha na distribuição dos ativos (em execução na fila).
A instância da nuvem do AEM Assets foi configurada com êxito com o Brand Portal, agora é possível:
Além do que foi descrito acima, você também pode publicar esquemas de metadados, predefinições de imagens, aspectos de pesquisa e tags do AEM Assets para o Brand Portal.
Consulte a documentação do Brand Portal para obter mais informações.

Registros de distribuição

Você pode verificar os registros para obter informações detalhadas sobre as ações executadas pelo agente de distribuição.
Por exemplo, publicamos um ativo do AEM Assets para o Brand Portal para validar a configuração.
  1. Follow the steps (from 1 to 4) as shown in the test connection section and navigate to the distribution agent page.
  2. Clique em Registros para exibir os registros de distribuição. Você pode ver o processamento e os registros de erros aqui.
O agente de distribuição gera os seguintes registros:
  • INFO: esse é um registro gerado pelo sistema acionado na configuração bem-sucedida que habilita o 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 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 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 (ou seja, Adicionar caminho) no Brand Portal porque o ativo foi publicado pela primeira vez. Portanto, aciona uma solicitação adicional para criar uma pasta principal com o mesmo nome no Brand Portal onde o ativo é publicado.
A solicitação adicional é gerada caso a pasta principal não exista no Brand Portal (no exemplo acima) ou a pasta principal tenha sido modificada no AEM Assets.