Introdução

Visão geral

Esta página descreve como autenticar e começar a usar o Adobe Experience Platform Destination SDK. Ele inclui instruções sobre como obter credenciais de autenticação do Adobe I/O, um nome de sandbox e a permissão de controle de acesso de criação de destino.

Terminologia

Este guia usa conceitos específicos da plataforma, como Organização IMS e sandboxes. Consulte o Glossário de Experience Platform para as definições destes e outros termos.

Obter credenciais de autenticação necessárias

O Destination SDK usa a variável Adobe I/O gateway para autenticação. Para fazer chamadas de API para endpoints do Destination SDK, você deve fornecer determinados cabeçalhos em suas chamadas de API. Trabalhe com a equipe do Adobe Exchange para configurar a autenticação para você no Console do desenvolvedor do Adobe.

Para fazer chamadas com êxito para endpoints da API do Destination SDK, siga as Tutorial de autenticação de Experience Platform. Inicie o tutorial a partir do "Gerar uma chave de API, ID de organização IMS e segredo do cliente". A equipe do Adobe Exchange lidará com as etapas anteriores para você. A conclusão do tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em chamadas de API do Destination SDK, conforme mostrado abaixo:

  • x-api-key: {API_KEY}também chamada de ID do cliente
  • x-gw-ims-org-id: {ORG_ID}também conhecida como ID da organização
  • Authorization: Bearer {ACCESS_TOKEN}. O token de acesso tem um tempo de expiração de 24 horas, expresso em milissegundos, portanto, será necessário atualizá-lo. Para atualizar o token de acesso, repita as etapas descritas no tutorial de autenticação.

Propriedade de destino e sandboxes

Todos os recursos no Experience Platform são isolados para sandboxes virtuais específicas. As solicitações para Destination SDK exigem cabeçalhos que especificam o nome da sandbox em que a operação ocorre:

  • x-sandbox-name: {SANDBOX_NAME}

A equipe do Adobe Exchange fornece o nome da sandbox, que deve ser usado em chamadas para os pontos de extremidade da API do Destination SDK.

Controle de acesso baseado em funções (RBAC)

Para usar os endpoints da API do Destination SDK descritos na documentação de referência, você precisa do Criação de destinos permissão de controle de acesso. Trabalhe com a equipe do Adobe Exchange para obter essa permissão atribuída a você em Adobe Admin Console.

Permissão de criação de destino

Para obter mais informações, leia os seguintes documentos de Controle de Acesso ao Experience Platform:

Considerações adicionais

  • Quaisquer alterações feitas nas configurações de destino, sejam você criar ou editar uma configuração de destino, precisam ser revisadas e aprovadas pelo Adobe. Suas alterações são refletidas em seus destinos somente após a revisão ser feita.
  • Somente os usuários que pertencem à mesma organização e têm acesso à sandbox podem editar a configuração de destino.

Próximas etapas

Seguindo as etapas deste artigo, você obteve credenciais de autenticação para o Adobe I/O, um nome de sandbox e a permissão de controle de acesso de criação de destino. Em seguida, você pode configurar um destino usando o Destination SDK.

Nesta página