Show Menu
TÓPICOS×

Configure AEM Assets as a Cloud Service with Brand Portal

A configuração do Portal de marcas dos ativos Adobe Experience Manager permite que você publique ativos de marca aprovados dos ativos Adobe Experience Manager como uma instância Cloud Service para o Portal de marcas e distribua-os para os usuários do Portal de marcas.
Fluxo de trabalho de configuração
A AEM Assets como Cloud Service é configurada com o Brand Portal via Adobe Developer Console, que obtém um token de conta Adobe Identity Management Services (IMS) para autorização do locatário do Brand Portal. Requer configurações tanto no AEM Assets quanto no Adobe Developer Console.
  1. No AEM Assets, crie uma conta IMS e gere uma chave pública (certificado).
  2. No Console do desenvolvedor do Adobe, 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.
  4. Obtenha as credenciais da conta de serviço e as informações de carga do 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 para o Brand Portal.
Uma instância AEM Assets como Cloud Service só deve ser configurada com um locatário do Brand Portal.

Pré-requisitos

Você precisa do seguinte para configurar o AEM Assets com o Brand Portal:
  • Um AEM Assets ativo e em execução 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 seguintes etapas na sequência especificada para configurar o AEM Assets com o Brand Portal.

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 Adobe Developer Console.
  1. Faça logon no AEM Assets.
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Na página Configurações de Adobe IMS, clique em Criar . It will redirect to the Adobe IMS Technical Account Configuration page. By default, the Certificate tab opens.
  4. Selecione Adobe Brand Portal na lista suspensa Cloud Solution .
  5. Marque a caixa de seleção Criar novo certificado e especifique um alias para a chave pública. O alias serve como nome da chave pública.
  6. Clique em Criar certificado . Then, click OK to generate the public key.
  7. Clique no ícone Baixar chave pública e salve o arquivo de chave pública (.crt) em seu 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 do Adobe.
  8. Clique em Avançar .
    Na guia Conta , é criada uma conta Adobe IMS que requer as credenciais da conta de serviço geradas no Console do desenvolvedor do Adobe. 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 Console do desenvolvedor do Adobe, os projetos e as APIs são configurados no nível 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 Adobe Developer Console 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 for configurada, você poderá 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 Adobe Developer Console com privilégios de administrador do sistema na organização IMS (locatário do Brand Portal). O URL padrão é https://www.adobe.com/go/devs_console_ui .
    Verifique se você selecionou a organização IMS correta (locatário do Brand Portal) na lista suspensa (organização) localizada no canto superior direito.
  2. Click Create new project . Um projeto em branco com um nome gerado pelo sistema é 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 Portal de marca e clique em Avançar .
    Verifique se você tem acesso ao serviço Portal de marcas AEM.
  5. Na janela Configurar API , clique em Carregar sua chave pública. Em seguida, clique em Selecionar um arquivo e carregue a chave pública (arquivo .crt) que você baixou na seção obter certificado público.
    Clique em Avançar .
  6. Verifique a chave pública e clique em Avançar .
  7. Selecione Assets Brand Portal como o perfil de produto padrão e clique em Salvar API configurada.
  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 Credenciais , clique na opção Service Account (JWT) .
    Você pode visualização as credenciais e executar ações como gerar tokens JWT, copiar detalhes das credenciais, recuperar o segredo do cliente e assim por diante.
  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 information.
Agora você pode usar a ID do cliente (chave da 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 seguintes etapas para configurar a conta IMS.
  1. Abra a Configuração IMS e navegue até a guia Conta . Você manteve a página aberta ao obter o certificado público.
  2. Especifique um Título para a conta IMS.
    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/
    Especifique a ID do cliente no campo de 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.
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 no 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.
    No campo URL do serviço, especifique o URL do locatário (organização) do Brand Portal.
  5. Clique em Salvar e fechar . A configuração da nuvem é criada.
    Seu AEM Assets como uma instância Cloud Service 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 no AEM Assets.
  2. From the Tools panel, navigate to Deployment > Distribution .
    A Brand Portal distribution agent ( bpdistributionagent0 ) is created under Publish to 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.
    É recomendável analisar as falhas e limpar a fila de erros periodicamente.
  4. Para verificar a conexão entre o AEM Assets como Cloud Service e o Portal de marca, clique no ícone Testar conexão .
    Será exibida uma mensagem 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).
Agora você pode:
See Brand Portal documentation for more information.

Registros de distribuição

Você pode monitorar os logs do agente de distribuição para o fluxo de trabalho de publicação de ativos.
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 Configuration section and navigate to the distribution agent page.
  2. Clique em Logs para visualização nos registros de processamento e erro.
O agente de distribuição gerou os seguintes registros:
  • INFORMAÇÕES: Este é um log gerado pelo sistema que aciona 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 pai (Adicionar caminho) no Brand Portal porque o ativo foi publicado pela primeira vez, portanto, ele disparou uma solicitação adicional para criar uma pasta pai com o mesmo nome no Brand Portal onde o ativo é publicado.
Solicitação adicional é gerada caso a pasta pai não exista no Brand Portal ou tenha sido modificada no AEM Assets.