v7

Configuração do Adobe I/O para o Adobe Experience Cloud Triggers

Última atualização em 2023-11-27
  • Tópicos
  • Triggers
    Exibir mais informações sobre este tópico
ATENÇÃO

Se você estiver usando uma versão mais antiga da integração do Triggers por meio da autenticação oAuth, será necessário mudar para o Adobe I/O conforme descrito abaixo.
Observe que, durante a migração para o Adobe I/O, alguns acionadores de entrada podem ser perdidos.

O modo de autenticação oAuth herdado com o Campaign foi removido em 20 de agosto de 2021. Os ambientes hospedados se beneficiarão de uma extensão até 25 de maio de 2022. Como cliente no local ou híbrido, entre em contato com o Atendimento ao cliente da Adobe para estender o suporte até maio de 2022. Você deve fornecer o AppID do aplicativo OAuth para a Adobe.

Pré-requisitos

Essa integração se aplica somente a partir das versões 20.2.4 e posteriores do Campaign Classic, 19.1.8 e Gold Standard 11.

Antes de iniciar esta implementação, verifique se você tem:

  • um identificador de organização válido: o ID da organização é o identificador exclusivo da Adobe Experience Cloud, que é usado, por exemplo, para o serviço de VisitorID e para o Logon único (SSO) no IMS. Saiba mais
  • um Acesso de desenvolvedor para sua organização. O administrador de sistema da organização precisa seguir o procedimento Adicionar desenvolvedores a um único perfil de produto detalhado nesta página para fornecer acesso de desenvolvedor ao Analytics - {tenantID} do Perfil do produto do Adobe Analytics que está associado ao Triggers.

Etapa 1: criar/atualizar projeto do Adobe I/O

DISPONIBILIDADE

O JWT (Tokens JSON da Web) está atualmente no processo de descontinuação, sendo substituído pelo OAuth. A transição será realizada progressivamente nas próximas versões do Campaign e a documentação será atualizada para refletir essas atualizações.

  1. Acesse o Adobe I/O e faça logon com o acesso de desenvolvedor da sua organização. Verifique se você está conectado ao portal correto da organização.

  2. Extraia o identificador do cliente (ID do cliente) de integração existente do arquivo de configuração da instância ims/authIMSTAClientId. Um atributo não existente ou vazio indica que o identificador do cliente não está configurado.

    OBSERVAÇÃO

    Se o identificador do cliente estiver vazio, será possível Create a New project diretamente no Adobe I/O.

  3. Identifique o projeto existente usando o identificador do cliente extraído. Procure projetos existentes com o mesmo identificador do cliente que o extraído na etapa anterior.

  4. Selecione + Add to Project e escolha API.

  5. Na janela Add an API, selecione Adobe Analytics.

  6. Escolha Service Account (JWT) como o tipo de autenticação.

  7. Se a ID do cliente estiver vazia, selecione Generate a key pair para criar um par de chaves público e privado.

    As chaves serão baixadas automaticamente com uma data de expiração padrão de 365 dias. Depois de expirar, você precisará criar um novo par de chaves e atualizar a integração no arquivo de configuração. Usando a Opção 2, você pode optar por criar e fazer upload manualmente da Public key com uma data de expiração mais longa.

    Para obter um guia passo a passo sobre como substituir pares de chaves de certificado que estão expirando, consulte esta página.

    ATENÇÃO

    Você deverá salvar o arquivo config.zip quando o prompt de download for exibido, pois não será possível baixá-lo novamente.

  8. Clique em Next.

  9. Escolha qualquer Product profile existente ou crie um novo, se necessário. Nenhuma permissão é necessária para este Product profile. Para obter mais informações sobre Analytics Product Profiles, consulte a documentação do Adobe Analytics.

    Em seguida, clique em Save configured API.

  10. Em seu projeto, selecione Adobe Analytics e copie as seguintes informações em Service Account (JWT):

    • Client ID
    • Client Secret
    • Technical account ID
    • Organization ID

ATENÇÃO

O certificado do Adobe I/O expirará após 12 meses. Você precisa gerar um novo par de chaves todo ano.

Etapa 2: adicionar as credenciais do projeto no Adobe Campaign

OBSERVAÇÃO

Esta etapa não será necessária se o identificador do cliente não estiver vazio na Etapa 1: criar/atualizar projeto do Adobe I/O.

A chave privada deve ser codificada no formato base64 UTF-8. Para fazer isso:

  1. Use a chave privada gerada na Etapa 1: criar/atualizar a seção Projeto do Adobe I/O. A chave privada precisa ser a mesma usada para criar a integração.

  2. Codifique a chave privada usando o seguinte comando: base64 ./private.key > private.key.base64. Isso salvará o conteúdo base64 em um novo arquivo private.key.base64.

    OBSERVAÇÃO

    Às vezes, uma linha extra pode ser adicionada automaticamente ao copiar/colar a chave privada. Lembre-se de removê-la antes de codificar sua chave privada.

  3. Copie o conteúdo do arquivo private.key.base64.

  4. Faça logon via SSH em cada container em que a instância do Adobe Campaign está instalada e adicione as credenciais do Projeto no Adobe Campaign executando o comando a seguir como usuárioneolane. Isso inserirá as credenciais Technical Account no arquivo de configuração da instância.

    nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>
    

Etapa 3: atualizar a tag de pipeline

OBSERVAÇÃO

Essa etapa não será necessária se o identificador do cliente não estiver vazio na Etapa 1: criar/atualizar projeto do Adobe I/O.

Para atualizar a tag pipelined, é necessário atualizar o tipo de autenticação para o projeto do Adobe I/O no arquivo de configuração config-< instance-name >.xml da seguinte maneira:

<pipelined ... authType="imsJwtToken"  ... />

Em seguida, execute um config -reload e uma reinicialização do pipelined para que as alterações sejam consideradas.

Nesta página