Configuration de l’authentification pour les API Adobe Target

Dans Adobe Admin Console, assurez-vous que votre compte utilisateur Adobe a reçu à la fois l’accès de niveau Administrateur de produit et Développeur à Target.

Dans le Adobe Developer Console, sélectionnez le Experience Cloud Organization pour lequel vous souhaitez créer cette intégration. (Notez qu’il est probable que vous n’ayez accès qu’à un seul Experience Cloud Organization.)

Cliquez sur  Create new project.

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

Sélectionnez Adobe Target comme service Adobe avec lequel vous souhaitez intégrer. Cliquez sur le bouton Next qui s’affiche.

Sélectionnez une option pour associer des clés publiques et privées à l’intégration du compte de service que vous créez pour Target. Pour cet exemple, sélectionnez Option 1: Generate a key pair et cliquez sur Generate keypair.

Selon les instructions, prenez note du fichier de configuration automatiquement téléchargé (config), qui contient votre clé privée. Cliquez sur  Next.

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. Encore une fois, ce fichier config contient votre clé privée, dont vous aurez besoin plus tard. L’emplacement exact de votre système de fichiers peut différer de celui illustré ici.

De retour dans Adobe Developer Console, sélectionnez le profil(s) 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  Save configured API.

Cliquez sur Create Integration. Vous devriez recevoir un message temporaire indiquant que votre API a été correctement configurée.

Pour terminer, renommez votre projet en un nom plus significatif que le Project 1 d’origine. Pour ce faire, accédez au projet à l’aide du chemin de navigation affiché, cliquez sur Edit project pour accéder au modal Edit Project et renommez le projet.

Toujours dans le Adobe Developer Console, accédez aux Service Account (JWT) informations d’identification de votre nouveau projet. Utilisez le volet de navigation de gauche ou la section Credentials comme indiqué.

Dans Credential details, notez que vous pouvez afficher vos Public key(s), Client ID 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 indiqué.

Cliquez sur Download for Postman > Service Account (JWT) pour créer un fichier JSON qui capture 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 représentant un engrenage pour gérer vos environnements, puis cliquez sur Import pour importer le fichier JSON (environnement).

Sélectionnez votre fichier et cliquez sur Open.

Dans le modal Postman Gérer les environnements , cliquez sur le nom de l’environnement nouvellement importé pour l’inspecter. (Le nom de votre environnement peut être différent de celui illustré ici. Modifiez le nom suivant vos besoins. Il ne doit pas nécessairement correspondre au nom du projet Adobe.)

Remarque : CLIENT_SECRET et API_KEY (avec d’autres variables) ont leurs valeurs préremplies, issues de votre intégration, comme défini dans Adobe Developer Console. (La variable Postman CLIENT_SECRET doit correspondre aux informations d’identification de l’Adobe CLIENT SECRET affichées dans Developer Console, et API_KEY dans Postman doit également correspondre à CLIENT ID dans Developer Console.) En revanche, la note PRIVATE_KEY, JWT_TOKEN et ACCESS_TOKEN sont vides. Commençons par fournir la valeur PRIVATE_KEY.

Depuis votre système de fichiers, ouvrez votre fichier config et ouvrez le fichier de clé private.

Sélectionnez et copiez tout le contenu du fichier de clé private.

Dans Postman, collez votre valeur de clé privée dans les champs INITIAL VALUE et CURRENT VALUE .

Cliquez sur Update et fermez le modal Environnements .

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

Cliquez sur le Adobe I/O Access Token Generation Postman collection.

Obtenez le fichier JSON brut pour cette collection en cliquant sur Raw, puis en copiant le fichier JSON obtenu dans le presse-papiers. (Vous pouvez également enregistrer le fichier JSON brut sous la forme d’un fichier .json.)

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

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

Ouvrez à nouveau le modal Manage Environments (Gérer les environnements), puis sélectionnez votre environnement.

Notez que les valeurs ACCESS_TOKEN et JWT_TOKEN sont désormais 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 List activities.

Notez que les variables telles que {{access_token}} ne sont initialement pas résolues. Vous pouvez résoudre ce problème de plusieurs manières différentes (par exemple, vous pouvez définir une nouvelle variable de collection appelée {{access_token}}). Cependant, dans ce guide, vous allez modifier la requête d’API afin d’exploiter 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 Adobe.

Type à remplacer {{access_token}} par {{ACCESS_TOKEN}}.

Type à remplacer {{api_key}} par {{API_KEY}}.

Type à remplacer {{tenant}} par {{TENANT_ID}}. Remarque : {{TENANT_ID}} n'est pas encore reconnu.

Ouvrez le modal Manage Environments (Gérer les environnements), puis sélectionnez votre environnement.

Saisissez pour ajouter une nouvelle variable d'environnement {{TENANT_ID}}. Copiez et collez la valeur de votre ID de tenant dans les champs INITIAL VALUE et CURRENT VALUE de votre nouvelle variable d'environnement TENANT_ID.

Envoyez votre requête, après avoir vérifié que vous avez sélectionné l’environnement approprié. Vous devriez recevoir une réponse contenant votre liste d’activités.