Prise en main

Présentation overview

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 terminology

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

Obtenir les informations d’authentification requises obtain-authentication-credentials

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é d’API, un ID d’organisation 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 du sandbox destination-ownership

Dans Experience Platform, toutes les ressources sont isolées dans des sandbox virtuels spécifiques. Les requêtes vers Destination SDK nécessitent des en-têtes qui spécifient le nom du sandbox dans lequel 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) 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 additional-considerations

  • Pour les destinations productisées/publiques, toute modification que vous apportez aux configurations de destination, que vous créiez ou modifiez une configuration de destination, doit être révisée et approuvée par Adobe. Vos modifications ne sont répercutées dans vos destinations qu’une fois la révision terminée. Cela ne s’applique pas aux destinations privées qui ne sont disponibles que pour vous.
  • Seuls les utilisateurs appartenant à la même organisation et ayant accès au sandbox peuvent modifier la configuration de destination.

Étapes suivantes next-steps

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.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6