Configuration de l’authentification pour les API Adobe Target

Dans le 🔗, vérifiez que votre compte utilisateur Adobe a reçu l’accès de niveau Administrateur de produit et Développeur à Target.

Dans 🔗, sélectionnez l’organisation Experience Cloud pour laquelle vous souhaitez créer cette intégration. (Notez qu’il est probable que vous n’ayez accès qu’à une seule organisation Experience Cloud.)

Cliquez sur Créer un projet.

Cliquez sur Ajouter une API pour ajouter une API REST à votre projet afin d’accéder aux services et produits Adobe.

Sélectionnez Adobe Target comme service de Adobe auquel vous souhaitez intégrer. Cliquez sur le bouton Suivant qui s’affiche.

Sélectionnez une option pour associer des clés publiques et privées à l’intégration de compte de service que vous créez pour Target. Pour cet exemple, sélectionnez Option 1 : générer une paire de clés et cliquez sur Générer la paire de clés.

Comme indiqué, notez le fichier de configuration téléchargé automatiquement (config), qui contient votre clé privée. Cliquez sur Suivant.

Dans votre système de fichiers, vérifiez l’emplacement de config, qui est le fichier de configuration compressé créé à l’étape précédente. Là encore, ce fichier config contient votre clé privée, dont vous aurez besoin ultérieurement. L’emplacement exact au sein de votre système de fichiers peut différer de celui illustré ici.

De retour dans le Adobe Developer Console, sélectionnez le ou les profils de produit) correspondant aux propriétés dans lesquelles vous utilisez Adobe Recommendations. (Si vous n’utilisez pas de propriétés, sélectionnez l’option Workspace par défaut .) Cliquez sur Enregistrer l’API configurée.

Cliquez sur Créer une intégration. Vous devriez recevoir un message temporaire indiquant que votre API a bien été configurée.

Pour terminer, renommez votre projet avec un nom plus significatif que le Project 1 d’origine. Pour ce faire, accédez au projet à l’aide du chemin de navigation comme illustré, cliquez sur Modifier le projet pour accéder à la fenêtre modale Modifier le projet et renommez le projet.

Toujours dans le 🔗, accédez à pour afficher les informations d’identification du compte de service (JWT) de votre nouveau projet. Utilisez le volet de navigation de gauche ou la section Informations d’identification comme illustré.

Dans Informations d’identification, notez que vous pouvez afficher vos Clé(s) publique(s), ID client et d’autres informations relatives à votre compte de service.

Cliquez pour accéder aux informations sur l’API Adobe Target. Utilisez le volet de navigation de gauche ou la section Produits et services connectés comme illustré.

Cliquez sur Télécharger pour Postman > Compte de service (JWT) pour créer un fichier JSON capturant vos informations d’authentification pour un environnement Postman.

Notez le fichier JSON dans votre système de fichiers.

Dans Postman, cliquez sur l’icône d’engrenage pour gérer vos environnements, puis cliquez sur Importer pour importer le fichier JSON (environnement).

Choisissez votre fichier et cliquez sur Ouvrir.

Dans la boîte de dialogue modale Postman Gérer les environnements, cliquez sur le nom de l’environnement nouvellement importé pour l’examiner. (Le nom de votre environnement peut être différent de celui affiché ici. Modifiez le nom selon vos besoins. Il n’est pas nécessaire qu’il corresponde au nom du projet Adobe.)

Notez que les valeurs CLIENT_SECRET et API_KEY (ainsi que d’autres variables) sont pré-renseignées, à partir de votre intégration telle que définie dans le Adobe Developer Console. (La variable CLIENT_SECRET de Postman doit correspondre aux informations d’identification Adobe CLIENT SECRET affichées dans le Developer Console, et les API_KEY dans Postman doivent également correspondre aux CLIENT ID dans le Developer Console.) En revanche, les notes PRIVATE_KEY, JWT_TOKEN et ACCESS_TOKEN sont vides. Commençons par fournir la valeur PRIVATE_KEY.

À partir de votre système de fichiers, ouvrez votre fichier config, puis ouvrez le fichier de clé private.

Sélectionnez et copiez l’intégralité du contenu du fichier de clé private.

Dans Postman, collez la valeur de votre clé privée dans les champs VALEUR INITIALE et VALEUR ACTUELLE.

Cliquez sur Mettre à jour, puis fermez la boîte de dialogue modale Environnements.

Accédez aux exemples d’appels de l’API Adobe Identity Management Service.

Cliquez sur la collection Adobe I/O Postman de génération de jeton d’accès.

Obtenez le fichier JSON brut pour cette collection en cliquant sur Raw, puis copiez le fichier JSON obtenu dans le presse-papiers. (Vous pouvez également enregistrer le fichier JSON brut en tant que fichier .json.)

Dans Postman, importez la collection en collant et en envoyant le fichier JSON brut à partir du presse-papiers. (Vous pouvez également télécharger le fichier .json que vous avez enregistré.) Cliquez sur Continue (Continuer).

Sélectionnez la requête IMS : JWT Generate + Auth via Jeton utilisateur dans la collection Postman de génération de jeton d’accès Adobe I/O, vérifiez que votre environnement est sélectionné, puis cliquez sur Envoyer pour générer le jeton.

Ouvrez à nouveau la boîte de dialogue modale Gérer les environnements et sélectionnez votre environnement.

Notez que les valeurs ACCESS_TOKEN et JWT_TOKEN sont maintenant renseignées.

Importez la Adobe Target collection Postman des API d’administration. Suivez toutes les invites jusqu’à ce que la collection soit importée dans Postman.

Développez la collection et notez la requête Liste des activités.

Notez que les variables telles que {{access_token}} ne sont pas résolues au départ. Vous pouvez résoudre ce problème de différentes manières (par exemple, vous pouvez définir une nouvelle variable de collection appelée {{access_token}}), mais dans ce guide, vous allez plutôt modifier la requête API pour tirer parti de l’environnement Postman que vous utilisiez précédemment. Cela permettra à l’environnement de continuer à servir de consolidation unique et cohérente de toutes les variables communes à toutes les API d’Adobe.

Tapez pour remplacer {{access_token}} par {{ACCESS_TOKEN}}.

Tapez pour remplacer {{api_key}} par {{API_KEY}}.

Tapez pour remplacer {{tenant}} par {{TENANT_ID}}. La note {{TENANT_ID}} n’est pas encore reconnue.

Ouvrez la boîte de dialogue modale Gérer les environnements et sélectionnez votre environnement.

Saisissez pour ajouter une nouvelle variable d’environnement {{TENANT_ID}}. Copiez et collez votre valeur d’identifiant client dans les champs VALEUR INITIALE et VALEUR ACTUELLE pour votre nouvelle variable d’environnement TENANT_ID.

Envoyez votre demande, après vous être assuré d’avoir sélectionné l’environnement approprié. Vous devriez recevoir une réponse contenant votre liste d’activités.