Prise en main

Présentation

Cette page décrit comment vous authentifier et commencer à utiliser Adobe Experience Platform Destination SDK. Elle comprend des instructions sur la manière d’obtenir des informations d’authentification d’Adobe I/O, un nom d’environnement de test et l’autorisation de contrôle d’accès de création de destination.

Terminologie

Ce guide utilise des concepts spécifiques à Platform, tels que l’organisation IMS et les environnements de test. Consultez la Glossaire Experience Platform pour connaître la définition de ces termes et d’autres termes.

Obtention des informations d’authentification requises

Destination SDK utilise la variable Adobe I/O passerelle pour l’authentification. Pour effectuer des appels API vers des points de terminaison Destination SDK, vous devez fournir certains en-têtes dans vos appels API. Collaborez avec l’équipe Adobe Exchange pour configurer l’authentification pour vous au Adobe Developer Console.

Pour passer avec succès des appels aux points de terminaison de l’API Destination SDK, suivez la Tutoriel sur l’authentification des Experience Platform. Démarrez le tutoriel à partir duGénération d’une clé API, d’un identifiant de l’organisation IMS et d’un secret client". L’équipe Adobe Exchange se chargera des étapes précédentes. Le tutoriel sur l’authentification indique les valeurs de chacun des en-têtes requis dans les appels d’API Destination SDK, comme illustré ci-dessous :

  • x-api-key: {API_KEY}, également appelé ID client
  • x-gw-ims-org-id: {IMS_ORG}, également appelé ID d’organisation
  • Authorization: Bearer {ACCESS_TOKEN}. Le jeton d’accès a un délai d’expiration de 24 heures, exprimé en millisecondes, vous devrez donc l’actualiser. Pour actualiser le jeton d’accès, répétez les étapes décrites dans le tutoriel sur l’authentification.

Propriété de destination et environnements de test

Dans Experience Platform, toutes les ressources sont isolées dans des environnements de test virtuels spécifiques. Les requêtes envoyées à Destination SDK nécessitent des en-têtes qui spécifient le nom de l’environnement de test dans lequel l’opération a lieu :

  • x-sandbox-name: {SANDBOX_NAME}

L’équipe Adobe Exchange vous fournit votre nom d’environnement de test, que vous devez utiliser dans les appels aux points de terminaison de l’API Destination SDK.

Contrôle d’accès en fonction du rôle (RBAC)

Pour utiliser les points d’entrée de l’API Destination SDK décrits dans la section documentation de référence, vous avez besoin de la fonction Création de destination autorisation de contrôle d’accès. Collaborez avec l’équipe Adobe Exchange pour que cette autorisation vous soit affectée dans Adobe Admin Console.

Autorisation de création de destination

Pour plus d’informations, consultez les documents de contrôle d’accès Experience Platform suivants :

Remarques complémentaires

  • Toute modification apportée aux configurations de destination, que vous créiez ou modifiez une configuration de destination, doit être examinée et approuvée par Adobe. Vos modifications ne sont répercutées dans vos destinations qu’une fois la révision terminée.
  • Seuls les utilisateurs appartenant à la même organisation et ayant accès à l’environnement de test peuvent modifier la configuration de destination.

Étapes suivantes

En suivant les étapes décrites dans cet article, vous obteniez des informations d’authentification pour Adobe I/O, un nom d’environnement de test et l’autorisation de contrôle d’accès de création de destination. Vous pouvez ensuite configurer une destination à l’aide de Destination SDK.

Sur cette page