Configurar autenticação para Adobe Target APIs

No Adobe Admin Console, garanta o seu Adobe a conta do usuário foi concedida Administrador do produto e Desenvolvedor nível de acesso a Target.

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

Clique em Criar novo projeto.

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

Selecionar Adobe Target como o Adobe com o qual você deseja integrar. Clique em Próxima que aparece.

Selecione uma opção para associar chaves públicas e privadas à integração de conta de serviço para a qual você está criando Target. Para este exemplo, selecione Opção 1: gerar um par de chaves e clique em Gerar par de chaves.

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

Em seu sistema de arquivos, verifique o local de config, que é o arquivo de configuração compactado criado na etapa anterior. Novamente, isso config O arquivo 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 ao Console do Adobe Developer, selecione a perfil(is) de produto correspondente às propriedades nas quais você está usando o Adobe Recommendations. (Se não estiver usando propriedades, selecione a opção Espaço de trabalho padrão.) Clique em Salvar API configurada.

Clique em Criar integração. 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 do que o original Project 1. Para fazer isso, navegue até o projeto usando o caminho de navegação como mostrar, clique em Editar projeto para acessar o Editar Projeto e renomeie o projeto.

Ainda no Console do Adobe Developer, navegue para visualizar as configurações do novo Conta de serviço (JWT) credenciais. Use a navegação à esquerda ou a Credenciais conforme mostrado.

Entrada Detalhes da credencial, observe que você pode visualizar suas Chave(s) pública(s), ID do cliente e outras informações relacionadas à sua conta de serviço.

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

Clique em Baixar para Postman > Conta de serviço (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 os ambientes e clique em Importar para importar o arquivo JSON (ambiente).

Escolha o arquivo e clique em Abertura.

No Postman Gerenciar ambientes , 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. Não é necessário necessariamente corresponder ao nome do Adobe projeto.)

Nota CLIENT_SECRET e API_KEY (juntamente com outras variáveis) têm seus valores pré-preenchidos, obtidos da sua integração, conforme definido no Console do Adobe Developer. (O Postman CLIENT_SECRET deve corresponder ao CLIENT SECRET a credencial do Adobe conforme exibida no Console do desenvolvedor e API_KEY no Postman também devem corresponder CLIENT ID no Console do desenvolvedor.) Em contrapartida, PRIVATE_KEY, JWT_TOKEN, e ACCESS_TOKEN estão em branco. Vamos começar fornecendo o PRIVATE_KEY valor.

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

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

No Postman, cole seu valor de chave privada no VALOR INICIAL e VALOR ATUAL campos.

Clique em Atualizar e feche o modal Ambientes.

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

Clique em Coleção Adobe I/O Access Token Generation Postman.

Obtenha o JSON bruto para esta coleção clicando em Brutos, 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 Continuar.

Selecione o IMS: Geração JWT + autenticação via token de usuário na coleção Adobe I/O Access Token Generation Postman, certifique-se de que seu ambiente está selecionado e clique em Enviar para gerar o token.

Abra o modal Gerenciar ambientes novamente e selecione seu ambiente.

Observe que ACCESS_TOKEN e JWT_TOKEN Os valores de agora são preenchidos.

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

Expanda a coleção e observe o Listar atividades solicitação.

Observe que variáveis como {{access_token}} não são resolvidos inicialmente. Isso pode ser resolvido de várias maneiras diferentes, por exemplo, você pode 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}} com {{ACCESS_TOKEN}}.

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

Digite para substituir {{tenant}} com {{TENANT_ID}}. Nota {{TENANT_ID}} ainda não foi reconhecido.

Abra o modal Gerenciar ambientes e selecione seu ambiente.

Digite para adicionar um novo {{TENANT_ID}} variável de ambiente. Copie e cole seu valor de ID de locatário no VALOR INICIAL e VALOR ATUAL campos para o novo TENANT_ID variável de ambiente.

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