Prise en main

Présentation

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

Terminologie

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

Obtenir les informations d’authentification requises

Destination SDK utilise la passerelle Adobe I/O pour l’authentification. Pour effectuer des appels API vers des points d’entrée de Destination SDK, vous devez fournir certains en-têtes dans vos appels API. Demandez à l’équipe dʼAdobe Exchange de configurer votre authentification dans Adobe Developer Console.

Pour réaliser des appels aux points d’entrée de l’API Destination SDK, suivez le tutoriel sur l’authentification Experience Platform. Démarrez le tutoriel à partir de l’étape « Générer une clé API, un identifiant d’organisation IMS et un secret client ». L’équipe dʼAdobe Exchange effectuera les étapes précédentes à votre place. Le tutoriel d’authentification fournit les valeurs de chacun des en-têtes requis dans les appels à l’API Destination SDK, tel qu’indiqué ci-dessous :

  • x-api-key: {API_KEY}, également appelé identifiant client.
  • x-gw-ims-org-id: {ORG_ID}, également appelé identifiant 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 la destination et de la sandbox

Dans Experience Platform, toutes les ressources sont isolées dans des sandbox virtuelles spécifiques. Les requêtes vers Destination SDK nécessitent des en-têtes qui spécifient le nom de la sandbox dans laquelle l’opération a lieu :

  • x-sandbox-name: {SANDBOX_NAME}

L’équipe dʼAdobe Exchange fournit votre nom de sandbox, que vous devez utiliser dans les appels aux points d’entrée 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 l’autorisation de contrôle d’accès de création de destinations. Demandez à l’équipe dʼAdobe Exchange de vous lʼaccorder dans Adobe Admin Console.

Autorisation de création de destinations

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

Remarques complémentaires

  • Toute modification apportée aux configurations de destination, quʼil sʼagisse de créer ou de modifier une configuration de destination, doit être examinée et approuvée par Adobe. Vos modifications ne sont appliquées dans vos destinations qu’une fois la révision terminée.
  • Seuls les utilisateurs appartenant à la même organisation et ayant accès à la sandbox peuvent modifier la configuration de destination.

Étapes suivantes

En suivant les étapes décrites dans cet article, vous avez obtenu des informations d’authentification pour Adobe I/O, un nom de sandbox et l’autorisation de contrôle d’accès de création de destinations. Lʼétape suivante consiste à configurer une destination à l’aide de Destination SDK.

Sur cette page