Configurar o AEM Assets as a Cloud Service com o Brand Portal

A configuração do Adobe Experience Manager Assets Brand Portal permite publicar ativos de marca aprovados do Adobe Experience Manager Assets como uma instância Cloud Service no Brand Portal e distribuí-los aos usuários do Brand Portal.

Fluxo de trabalho de configuração

O AEM Assets as a Cloud Service é configurado com o Brand Portal por meio do Console do desenvolvedor, que obtém um token de conta do Adobe Identity Management Services (IMS) para autorização do locatário do Brand Portal. Ela requer configurações no AEM Assets e no Console do desenvolvedor.

  1. No AEM Assets, crie uma conta IMS e gere uma chave pública (certificado).
  2. No Console do desenvolvedor da Adobe, crie um projeto para o 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.
  4. Obtenha as credenciais da conta de serviço e as informações de carga JSON Web Token (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 do Brand Portal usando a conta IMS e o terminal do Brand Portal (URL da organização).
  7. Teste sua configuração publicando um ativo do AEM Assets no Brand Portal.
OBSERVAÇÃO

Um AEM Assets como uma instância Cloud Service só deve ser configurado com um locatário do Brand Portal.

Pré-requisitos

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

  • Criar e executar o AEM Assets como uma instância Cloud Service
  • 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

Criar configuração

Execute as etapas a seguir na sequência especificada para configurar o AEM Assets com o Brand Portal.

  1. Obter certificado público
  2. Criar conexão de conta de serviço (JWT)
  3. Configurar conta IMS
  4. Configurar o serviço em nuvem
  5. Testar configuração

Criar configuração IMS

A configuração IMS autentica seu AEM Assets como uma instância Cloud Service com o locatário do Brand Portal.

A configuração IMS inclui duas etapas:

Obter certificado público

A chave pública (certificado) autentica seu perfil no Console do desenvolvedor.

  1. Faça logon nos ativos AEM.

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

  3. Na página Configurações do Adobe IMS , clique em Criar. Ele redirecionará para a página Configuração de conta técnica do Adobe IMS. Por padrão, a guia Certificate é aberta.

  4. Selecione Adobe Brand Portal na lista suspensa Cloud Solution.

  5. Marque a caixa de seleção Create new certificate e especifique um alias para a chave pública. O alias serve como 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 no ícone Baixar chave pública e salve o arquivo de chave pública (CRT) no computador.

    A chave pública será usada posteriormente para configurar a API para o locatário do Brand Portal e gerar credenciais de conta de serviço no Console do desenvolvedor.

    Baixar certificado

  8. Clique em Avançar.

    Na guia Account, é criada a conta do Adobe IMS que requer as credenciais da conta de serviço geradas no Console do desenvolvedor. Mantenha esta página aberta por enquanto.

    Abra uma nova guia e crie uma conexão de conta de serviço (JWT) no Console do desenvolvedor para obter as credenciais e a carga JWT para configurar a conta IMS.

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

No Console do desenvolvedor da Adobe, os projetos e as APIs são configurados no nível de locatário (organização) do Brand Portal. Configurar uma API cria uma conexão de conta de serviço (JWT). 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 o AEM Assets com o Brand Portal, você deve gerar uma chave pública (certificado) no AEM Assets e criar credenciais no Console do desenvolvedor, fazendo upload da chave pública. Essas credenciais são necessárias para configurar a conta IMS no AEM Assets. Depois que a conta IMS é configurada, você pode configurar o serviço em nuvem do Brand Portal no AEM Assets.

Execute as seguintes etapas para gerar as credenciais da conta de serviço e a carga JWT:

  1. Faça logon no Console do desenvolvedor da Adobe 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.

    OBSERVAÇÃO

    Certifique-se de ter selecionado a organização IMS correta (locatário do Brand Portal) na lista suspensa (organização) localizada 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 atualizar o Título do projeto e Descrição 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 Próximo.

    Certifique-se de ter acesso ao serviço AEM Brand Portal.

  5. Na janela Configure API, clique em Upload your public key. Em seguida, clique em Selecione um Arquivo e faça upload da chave pública (arquivo .crt) que você baixou na seção obter certificado público.

    Clique em Avançar.

    Fazer upload da chave pública

  6. Verifique a chave pública e clique em Next.

  7. Selecione Assets Brand Portal como o perfil de produto padrão e clique em Salvar API configurada.

    Selecionar Perfil de Produto

  8. Depois que a API for configurada, você será redirecionado para a página de visão geral da API. Na navegação à esquerda em Credentials, clique na opção Service Account (JWT).

    OBSERVAÇÃO

    Você pode exibir as credenciais e executar ações como gerar tokens JWT, copiar detalhes da credencial, recuperar o segredo do cliente e assim por diante.

  9. Na guia 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 guia Generate JWT e copie as informações JWT Payload.

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 conta IMS

Verifique se você executou as seguintes etapas:

Execute as etapas a seguir para configurar a conta IMS.

  1. Abra a Configuração IMS e navegue até a guia Account. Você manteve a página aberta enquanto obtinha o certificado público.

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

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

    Especifique a ID do cliente no campo Chave da API, Segredo do Cliente e Carga (Carga JWT) que copiou enquanto cria a 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, uma mensagem é exibida informando que o token foi recuperado com êxito.

CUIDADO

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. 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 nos ativos AEM.

  2. No painel Ferramentas, navegue até Serviços da nuvem > 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.

    No campo URL do serviço, especifique o URL do locatário do Brand Portal (organização).

  5. Clique em Salvar e fechar. A configuração da nuvem é criada.

    Seu AEM Assets as a Cloud Service instance agora está configurado com o locatário do Brand Portal.

Testar configuração

Execute as seguintes etapas para validar a configuração:

  1. Faça logon nos ativos AEM.

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

    Um agente de distribuição do Brand Portal (bpdistributionagent0) é criado em Publicar no Brand Portal.

  3. Clique em Publicar no Brand Portal para abrir o 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.

    OBSERVAÇÃO

    É recomendável analisar as falhas e limpar a fila de erros periodicamente.

  4. Para verificar a conexão entre o AEM Assets as a Cloud Service e o Brand Portal, clique no ícone Testar conexão.

    Aparece uma mensagem de que seu pacote de teste foi entregue com êxito.

    OBSERVAÇÃO

    Evite desativar o agente de distribuição, pois isso pode causar falha na distribuição dos ativos (em execução na fila).

Agora você pode:

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

Registros de distribuição

Você pode monitorar os registros do agente de distribuição para o fluxo de trabalho de publicação de ativos.

Por exemplo, publicamos um ativo do AEM Assets no Brand Portal para validar a configuração.

  1. Siga as etapas (de 1 a 4) conforme mostrado na seção Testar configuração e navegue até a página do agente de distribuição.

  2. Clique em Logs para visualizar o processamento e os logs de erro.

O agente de distribuição gerou os seguintes logs:

  • INFORMAÇÕES: Este é um registro gerado pelo sistema que dispara para uma configuração bem-sucedida do 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 AEM Assets (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 AEM Assets (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 (Adicionar caminho) no Brand Portal porque o ativo foi publicado pela primeira vez, portanto, acionou uma solicitação adicional para criar uma pasta principal com o mesmo nome no Brand Portal onde o ativo é publicado.

OBSERVAÇÃO

A solicitação adicional é gerada caso a pasta principal não exista no Brand Portal ou tenha sido modificada no AEM Assets.

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