Configuração do IMS para uso na integração com o Adobe Target

A integração do AEM com o Adobe Target por meio da API do Target Standard requer a configuração do Adobe IMS (Identity Management System). A configuração é realizada com o Adobe Developer Console.

OBSERVAÇÃO

A compatibilidade com a API do Target Standard da Adobe é novidade no AEMaaCS. A API do Target Standard usa autenticação IMS.

A seleção da API é orientada pelo método de autenticação usado para a integração do AEM/Target.

Pré-requisitos

Antes de iniciar este procedimento:

  • O Suporte da Adobe precisa provisionar sua conta com:

    • Adobe Console
    • Console do desenvolvedor da Adobe
    • Adobe Target e
    • Adobe IMS (Identity Management System)
  • O administrador de sistemas da sua organização deve usar o Admin Console para adicionar os desenvolvedores necessários em sua organização aos perfis de produto relevantes.

    • Isso fornece aos desenvolvedores específicos permissões para ativar integrações usando o Adobe Developer Console.
    • Para obter mais detalhes, consulte Gerenciar desenvolvedores.

Configuração de IMS - Geração de uma Chave pública

O primeiro estágio da configuração é criar uma configuração do IMS no AEM e gerar a Chave pública.

  1. No AEM, abra o menu Ferramentas.

  2. Na seção Segurança, selecione Configurações do Adobe IMS.

  3. Selecione Criar para abrir a Configuração de contas técnicas do Adobe IMS.

  4. Usando a lista suspensa em Configuração na nuvem, selecione Adobe Target.

  5. Ative Criar novo certificado e insira um novo alias.

  6. Confirme com Criar certificado.

    Criar certificado

  7. Selecione Baixar (ou Baixar Chave pública) para baixar o arquivo na unidade local, de modo que ele esteja pronto para uso ao configurar o IMS para integração do Adobe Target com o AEM.

    ATENÇÃO

    Mantenha essa configuração aberta; ela será necessária novamente para Concluir a configuração do IMS no AEM.

    Baixar certificado

Configuração do IMS para integração do Adobe Target com o AEM

O projeto da integração do Adobe Developer Console com o Adobe Target que o AEM usará e, em seguida, atribuirá os privilégios necessários.

Criação do projeto

Abra o Adobe Developer Console para criar um Projeto com o Adobe Target que o AEM usará:

  1. Abra os projetos do Adobe Developer Console:

    https://developer.adobe.com/console/projects

  2. Quaisquer projetos que você tiver serão mostrados. Selecione Criar novo projeto - a localização e utilização dependerão:

    • Se você ainda não tiver um projeto, Criar novo projeto estará no centro, na parte inferior.
      Criar novo projeto - Primeiro projeto
    • Caso já tenha projetos existentes, eles serão listados e Criar novo projeto estará no canto superior direito.
      Criar novo projeto - Vários projetos
  3. Selecione Adicionar ao projeto e, em seguida, API:

    Adicionar ao projeto

  4. Selecione Adobe Target e, em seguida, Próximo:

    OBSERVAÇÃO

    Se estiver inscrito no Adobe Target, mas ele não estiver listado, verifique os Pré-requisitos.

  5. Fazer upload de sua chave pública, e quando terminar, continue com Próximo:

    Selecione Fazer upload da sua chave pública

  6. Revise as credenciais e continue com Próximo:

    Revisar credenciais

  7. Selecione os perfis de produto necessários e continue com Salvar API configurada:

    OBSERVAÇÃO

    Os perfis de produto que são exibidos dependem se você:

    • Adobe Target Standard - somente o Espaço de trabalho padrão está disponível
    • Adobe Target Premium - todos os espaços de trabalho disponíveis são listados, conforme mostrado abaixo

    Selecione perfis de produto e salve a API configurada

  8. A criação será confirmada.

Atribuir privilégios à integração

Agora, você deve atribuir os privilégios necessários à integração:

  1. Abra o Adobe Admin Console:

  2. Navegue até Produtos (barra de ferramentas superior) e, em seguida, selecione Adobe Target - <seu-id-de-locatário> (no painel esquerdo).

  3. Selecione Perfis de produto e, em seguida, o espaço de trabalho necessário. Por exemplo, Espaço de trabalho padrão.

  4. Selecione Credenciais da API e, em seguida, a configuração de integração necessária.

  5. Selecione Editor como Função do produto, em vez de Observador.

Detalhes armazenados para o projeto de integração do Adobe Developer Console

No console de Projetos do Adobe Developer Console, é possível ver uma lista de todos os projetos de integração:

Selecione Exibir (à direita de uma entrada de projeto específica) para mostrar mais detalhes sobre a configuração. Dentre elas:

  • Visão geral do projeto
  • Insights
  • Credenciais
    • Conta de serviço (JWT)
      • Detalhes da credencial
      • Gerar JWT
  • APIS
    • Por exemplo, Adobe Target

Em alguns desses, você precisará concluir a integração do Adobe Target no AEM com base no IMS.

Concluir a configuração do IMS no AEM

Ao retornar para o AEM, é possível concluir a configuração do IMS adicionando valores necessários da integração do IMS com o Target:

  1. Retorne à configuração do IMS aberta no AEM.

  2. Selecione Próximo.

  3. Aqui você pode usar os detalhes da configuração do projeto no Adobe Developer Console:

    • Título: seu texto.
    • Servidor de autorização: copie/cole essa informação da linha aud da seção Carga abaixo; por exemplo, https://ims-na1.adobelogin.com no exemplo abaixo
    • Chave da API: copie isso da seção Visão geral do projeto
    • Segredo do cliente: gere isso na seção Visão geral do projeto e copie
    • Carga: copie isso da seção Gerar JWT

    Configurações da conta técnica do Adobe IMS

  4. Confirme com Criar.

  5. Sua configuração do Adobe Target será exibida no console do AEM.

    Configuração do IMS

Confirmação da configuração do IMS

Para confirmar que a configuração está funcionando como esperado:

  1. Abrir:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    Por exemplo:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. Selecione sua configuração.

  3. Selecione Verificar integridade na barra de ferramentas, seguido por Verificar.

    Verificar integridade

  4. Se for bem-sucedido, você verá uma mensagem de confirmação.

Concluir a integração com o Adobe Target

Agora é possível usar essa configuração do IMS para concluir a integração com o Adobe Target.

Nesta página