Como configurar o acesso à API do AAM
Saiba como criar um projeto no console do desenvolvedor para gerar credenciais JWT da API do Audience Manager.
Descrição description
Ambiente
Adobe Audience Manager
Problema/Sintomas
Como configurar e gerar credenciais para a API do Audience Manager?
Resolução resolution
Você precisará de permissões de administrador do sistema no Admin Console para gerar credenciais para a API Audience Manager. As etapas 1 e 2 descrevem como conceder essas permissões escaladas. Os administradores atuais do sistema podem preferir seguir essas etapas a si mesmos, em vez de conceder permissões de administrador escalonadas a um usuário adicional, nesse caso, pule diretamente para a etapa 3.
- Navegue até o Admin Console e selecione "Adicionar administradores" no menu "Links Rápidos":
- Insira os emails de todos os usuários aos quais você deseja conceder acesso. Na próxima página, selecione "Administrador do Sistema" para o nível de permissão:
- Navegue até https://developer.adobe.com/console. Se você ainda não tiver acesso, apesar de ter recebido direitos de administrador do sistema nas etapas anteriores, tente atualizar seus cookies/cache.
- Crie um novo projeto pelo menu de início rápido (ou pelo menu de projetos na navegação superior):
- Adicione a API Audience Manager ao seu projeto:
- Siga as etapas para gerar (ou fazer upload) suas credenciais JWT. Se optar por gerar as credenciais por meio do console dev, armazene com segurança a chave privada. Você precisará de sua chave privada em etapas posteriores.
- Em seguida, você será solicitado a atribuir as credenciais aos perfis de produto relevantes. Se sua organização utiliza controles de acesso com base em funções, você precisará seguir estas etapas para criar uma conta de usuário técnico e adicionar essa conta ao grupo RBAC relevante: https://experienceleague.adobe.com/docs/audience-manager/user-guide/api-and-sdk-code/rest-apis/aam-api-getting-started.html?lang=pt-BR#technical-account-rbac-permissions
- Depois que essas etapas forem concluídas, você poderá gerar um token de acesso para fazer sua primeira solicitação de API. Primeiro, clique em sua página de visão geral de credenciais no console dev:
- Clique na guia "Gerar JWT" na parte superior da página, cole toda a chave privada do arquivo baixado na etapa 6 e clique em "Gerar token":
Por fim, é possível fazer solicitações de API usando o token de acesso recuperado na etapa anterior. As chamadas podem ser feitas de qualquer plataforma de API, como Postman, diretamente por meio de comandos cURL ou até mesmo da nossa página de documentação de API: https://bank.demdex.com/portal/swagger/index.html#/
Para fazer chamadas usando os recursos de demonstração em nossa documentação, siga as etapas acima para gerar o token e clique em "Autorizar" no lado direito da página e insira o token:
Além disso, selecione o servidor aam.adobe.io, conforme indicado na captura de tela acima. Agora, é possível utilizar o recurso de demonstração em qualquer uma das solicitações da API inserindo os parâmetros relevantes e clicando no botão "Testar":
Lembre-se, isso enviará uma solicitação de API real para sua instância. Se você utilizar uma solicitação DELETE, PUT ou POST, poderá estar fazendo alterações não intencionais na sua instância. Leia sempre a documentação de cada uma dessas chamadas de API antes de enviar a solicitação.