Introdução
Visão geral overview
Esta página descreve como se autenticar e começar a usar o Adobe Experience Platform Destination SDK. Ele inclui instruções sobre como obter credenciais de autenticação da Adobe I/O, um nome de sandbox e a permissão de controle de acesso para criação de destino.
Terminologia terminology
Este guia usa conceitos específicos da Experience Platform, como organização e sandboxes. Consulte o glossário do Experience Platform para obter as definições desses termos. Consulte o glossário do Destination SDK para obter os termos relacionados diretamente a esta funcionalidade.
Obter as credenciais de autenticação necessárias obtain-authentication-credentials
O Destination SDK usa o gateway Adobe I/O para autenticação. Para fazer chamadas de API para endpoints do Destination SDK, você deve fornecer determinados cabeçalhos nas chamadas de API. Trabalhe com a equipe da Adobe Exchange para configurar a autenticação para você no Adobe Developer Console.
Para fazer chamadas com êxito para pontos de extremidade de API do Destination SDK, siga o tutorial de autenticação do Experience Platform. Inicie o tutorial da etapa "Gerar uma chave de API, ID da organização e segredo do cliente". A equipe do Adobe Exchange cuidará das etapas anteriores para você. Concluir o tutorial de autenticação fornece os valores de cada um dos cabeçalhos necessários nas chamadas de API do Destination SDK, conforme mostrado abaixo:
x-api-key: {API_KEY}, também conhecido como ID do clientex-gw-ims-org-id: {ORG_ID}, também conhecido como ID da organizaçãoAuthorization: Bearer {ACCESS_TOKEN}. O token de acesso tem um tempo de expiração de 24 horas, expresso em milissegundos, portanto, você terá que atualizá-lo. Para atualizar o token de acesso, repita as etapas descritas no tutorial de autenticação.
Propriedade de destino e sandboxes destination-ownership
Todos os recursos no Experience Platform são isolados em sandboxes virtuais específicas. As solicitações para o Destination SDK exigem cabeçalhos que especifiquem 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 você precisa usar em chamadas para os endpoints da API do Destination SDK.
Controle de acesso baseado em função (RBAC) rbac
Para usar os pontos de extremidade da API do Destination SDK descritos na documentação de referência, você precisa da permissão de controle de acesso Criação de Destino. Trabalhe com a equipe da Adobe Exchange para obter esta permissão atribuída a você no Adobe Admin Console.
Para obter mais informações, leia os seguintes documentos de Controle de acesso do Experience Platform:
Considerações adicionais additional-considerations
- Para destinos públicos/de produção, todas as alterações feitas nas configurações de destino, independentemente de você criar ou editar uma configuração de destino, precisam ser revisadas e aprovadas pela Adobe. As alterações são refletidas nos destinos somente após a revisão ser concluída. Isso não se aplica a destinos privados que só estão disponíveis para você.
- Somente os usuários que pertencem à mesma organização e têm acesso à sandbox podem editar a configuração de destino.
Próximas etapas next-steps
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.
-
Leia os seguintes guias de configuração, dependendo do tipo de destino:
-
Para todas as operações, consulte a documentação da API de criação de destino.
-
Use a coleção Postman da API de Criação de Destino para configurar seu destino usando os pontos de extremidade da API do Destination SDK. Para começar a usar o Postman, consulte as etapas para importar ambientes e coleções e o guia de vídeo para criar o ambiente do Postman.