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. Consultez le glossaire des Destinations SDK pour connaître les termes liés directement à cette fonctionnalité.
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.
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.
-
Consultez les guides de configuration suivants, en fonction du type de destination :
-
Pour toutes les opérations, reportez-vous à la section Documentation de l’API de création de destinations.
-
Utilisez la Collection Postman de l’API de création de destinations pour configurer votre destination à l’aide des points d’entrée de l’API Destination SDK. Pour commencer à utiliser Postman, suivez les étapes dʼimportation des environnements et des collections et consultez le Guide vidéo de création de l’environnement Postman.