Configurar autenticação para Adobe Target APIs

No Adobe Admin Console, verifique se a sua conta de usuário Adobe recebeu acesso de nível de Administrador de Produto e Desenvolvedor ao Target.

No Adobe Developer Console, selecione o Experience Cloud Organization para o qual deseja criar essa integração. (Observe que é provável que você só tenha acesso a um único Experience Cloud Organization.)

Clique em Create new project.

Clique em Add API para adicionar uma REST API ao seu projeto para acessar serviços e produtos do Adobe.

Selecione Adobe Target como o serviço Adobe ao qual você deseja integrar. Clique no botão Next que aparece.

Selecione uma opção para associar chaves públicas e privadas à integração de conta de serviço que você está criando para Target. Para este exemplo, selecione Option 1: Generate a key pair e clique em Generate keypair.

Conforme instruído, anote o arquivo de configuração baixado automaticamente (config), que contém sua chave privada. Clique em Next.

Em seu sistema de arquivos, verifique o local de config, que é o arquivo de configuração compactado criado na etapa anterior. Novamente, esse arquivo config contém sua chave privada, que será necessária posteriormente. O local exato em seu sistema de arquivos pode ser diferente do mostrado aqui.

De volta à Adobe Developer Console, selecione o(s) perfil(is) de produto correspondente(s) às propriedades nas quais você está usando o Adobe Recommendations. (Se você não estiver usando propriedades do, selecione a opção Workspace padrão.) Clique em Save configured API.

Clique em Create Integration. Você deve receber uma mensagem temporária indicando que sua API foi configurada com êxito.

Como etapa final, renomeie seu projeto com um nome mais significativo que o Project 1 original. Para fazer isso, navegue até o projeto usando o caminho de navegação como mostrar, clique em Edit project para acessar o modal Edit Project e renomeie o projeto.

Ainda no Adobe Developer Console, navegue para exibir as credenciais Service Account (JWT) do novo projeto. Use a navegação à esquerda ou a seção Credentials, como mostrado.

Em Credential details, observe que você pode visualizar Public key(s), Client ID e outras informações relacionadas à sua conta de serviço.

Clique para acessar as informações sobre a API Adobe Target. Use a navegação à esquerda ou a seção Produtos e serviços conectados como mostrado.

Clique em Download for Postman > Service Account (JWT) para criar um arquivo JSON capturando suas informações de autenticação para um ambiente Postman.

Observe o arquivo JSON no seu sistema de arquivos.

No Postman, clique no ícone de engrenagem para gerenciar seus ambientes, em seguida, clique em Import para importar o arquivo JSON (ambiente).

Escolha seu arquivo e clique em Open.

No modal Gerenciar ambientes do Postman, clique no nome do ambiente recém-importado para inspecioná-lo. (O nome do ambiente pode ser diferente do mostrado aqui. Edite o nome conforme desejado. Ele não precisa necessariamente corresponder ao nome do projeto Adobe.)

Os valores de CLIENT_SECRET e API_KEY (juntamente com outras variáveis) foram preenchidos previamente a partir da sua integração, conforme definido na Adobe Developer Console. (A variável CLIENT_SECRET do Postman deve corresponder à credencial de Adobe CLIENT SECRET conforme exibida no Developer Console, e API_KEY no Postman também deve corresponder a CLIENT ID no Developer Console.) Por outro lado, a observação PRIVATE_KEY, JWT_TOKEN e ACCESS_TOKEN estão em branco. Vamos começar fornecendo o valor PRIVATE_KEY.

Em seu sistema de arquivos, abra o arquivo config e abra o arquivo de chave private.

Selecione e copie todo o conteúdo do arquivo de chave private.

No Postman, cole seu valor de chave privada nos campos INITIAL VALUE e CURRENT VALUE.

Clique em Update e feche o modal Ambientes.

Navegue até o Adobe Chamadas de amostra da API de serviço do Identity Management.

Clique no Adobe I/O Access Token Generation Postman collection.

Obtenha o JSON bruto para esta coleção clicando em Raw e copiando o JSON resultante para a área de transferência. (Como alternativa, você pode salvar o JSON bruto como um arquivo .json.)

No Postman, importe a coleção colando e enviando o JSON bruto da área de transferência. (Como alternativa, você pode fazer upload do arquivo .json salvo.) Clique em Continue.

Selecione a solicitação IMS: JWT Generate + Auth via User Token na coleção Adobe I/O Access Token Generation Postman, verifique se o ambiente está selecionado e clique em Send para gerar o token.

Abra o modal Gerenciar ambientes novamente e selecione seu ambiente.

Observe que os valores ACCESS_TOKEN e JWT_TOKEN agora estão preenchidos.

Importe a Adobe Target Coleção de Postman de APIs de administrador. Siga todos os prompts até que a coleção seja importada no Postman.

Expanda a coleção e observe a solicitação List activities.

Observe que variáveis como {{access_token}} não são resolvidas inicialmente. Você poderia resolver isso de várias maneiras diferentes, por exemplo, você poderia definir uma nova variável de coleção chamada {{access_token}}, mas neste guia, você alterará a solicitação da API para aproveitar o ambiente do Postman que estava usando anteriormente. Isso permitirá que o ambiente continue a servir como uma consolidação única e consistente de todas as variáveis comuns nas APIs do Adobe.

Digite para substituir {{access_token}} por {{ACCESS_TOKEN}}.

Digite para substituir {{api_key}} por {{API_KEY}}.

Digite para substituir {{tenant}} por {{TENANT_ID}}. A nota {{TENANT_ID}} ainda não foi reconhecida.

Abra o modal Gerenciar ambientes e selecione seu ambiente.

Digite para adicionar uma nova variável de ambiente {{TENANT_ID}}. Copie e cole seu valor de ID de locatário nos campos INITIAL VALUE e CURRENT VALUE para sua nova variável de ambiente TENANT_ID.

Envie sua solicitação depois de verificar se você selecionou o ambiente correto. Você deve receber uma resposta contendo sua lista de atividades.