Configuration de l’authentification pour les API Adobe Target

Les API d’administration Adobe Target, y compris les Recommendations API d’administration, sont sécurisées par l’authentification afin de garantir que seuls les utilisateurs autorisés les utilisent pour accéder à Adobe Target. Utilisez Adobe Developer Console pour gérer cette authentification pour toutes les solutions Adobe Experience Cloud, y compris Target.

Cette leçon décrit les étapes préliminaires nécessaires à la génération des jetons d’authentification nécessaires pour interagir avec les API Adobe Target. Dans les sections suivantes, vous allez :

  1. Créez un projet (précédemment appelé intégration) dans la console de développement des Adobes.
  2. Exportez les détails du projet vers Postman.
  3. Générez un jeton d'accès au porteur.
  4. Testez le jeton d'accès porteur.

Conditions préalables

Ressource Détails
Postman Pour réussir ces étapes, obtenez l'application Postman pour votre système d'exploitation. Postman basique est gratuit avec la création de compte. Bien qu'il ne soit pas nécessaire pour utiliser les API Adobe Target en général, Postman facilite les workflows d'API et Adobe Target fournit plusieurs collections Postman pour aider à exécuter ses API et apprendre comment elles fonctionnent. Le reste de ce tutoriel suppose une connaissance pratique de Postman. Pour obtenir de l'aide, veuillez consulter la documentation de Postman.
Références La connaissance des ressources suivantes est assurée tout au long du reste de ce didacticiel :

Création d’un projet d’Adobe I/O

Dans cette section, vous accéderez à la console de développement des Adobes et créerez un projet pour Adobe Target. Pour plus d'informations, consultez la documentation relative aux projets.

  1. Dans le Adobe Admin Console, assurez-vous que votre compte utilisateur d'Adobe a été autorisé à la fois à accéder au niveau Administrateur de produit et au niveau Développeur Target.

  2. Dans la Console développeur d'Adobes, 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.)

    configure-io-cible-create-project2.png

  3. Cliquez sur Créer un nouveau projet.

    configure-io-cible-create-project3.png

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

    API Ajoute

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

    configure-io-cible-create-project5

  6. 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 la Cible. Pour ce didacticiel, sélectionnez Option 1 : Générez une paire de clés et cliquez sur Générer la paire de clés.
    configure-io-cible-create-project6

  7. Notez les résultats ! Selon les instructions, notez le fichier de configuration automatiquement téléchargé (config), qui contient votre clé privée. Cliquez sur Suivant.
    configure-io-cible-createproject7

  8. 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. De nouveau, ce fichier config contient votre clé privée, dont vous aurez besoin ultérieurement. L'emplacement exact dans votre système de fichiers peut différer de celui qui est illustré ici.
    configure-io-cible-createproject8

  9. De retour dans la console de développement des Adobes, sélectionnez le profil(s) de produit correspondant aux propriétés dans lesquelles vous utilisez Recommendations. (Si vous n’utilisez pas de propriétés, sélectionnez l’option Espace de travail par défaut.) Cliquez sur Enregistrer l'API configurée.
    configure-io-cible-create-project9

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

  11. En guise de dernière étape, renommez votre projet en un nom plus significatif que le Project 1 original. Pour ce faire, accédez au projet à l’aide du chemin de navigation indiqué, cliquez sur Modifier le projet pour accéder au module **Modifier le projet, puis renommez le projet.

configure-io-cible-createproject11

REMARQUE

Dans ce didacticiel, nous nommons notre projet "Intégration de Cibles". Si vous prévoyez d’utiliser votre projet pour plus d’Adobe Target, vous pouvez lui attribuer un nom en conséquence. Par exemple, vous pouvez choisir de lui attribuer le nom "API Adobe" ou "API Experience Cloud", car il peut être utilisé avec d’autres solutions dans Adobe Experience Cloud.

Exporter les détails du projet

Maintenant que vous disposez d'un projet d'Adobe que vous pouvez utiliser pour accéder à Target, vous devez vous assurer d'envoyer les détails de ce projet avec vos demandes d'API d'Adobe. Ces détails sont nécessaires pour interagir avec plusieurs API d'Adobe, y compris plusieurs API Target. Par exemple, les détails de l’intégration incluent les informations d’autorisation et d’authentification requises par les API d’administration Target. Par conséquent, pour utiliser les API avec Postman, vous devez envoyer ces détails à Postman.

Il y a plusieurs façons de préciser les détails de votre projet dans Postman, mais dans cette section, nous profitons de certaines fonctionnalités et collections préétablies. D'abord (dans cette section), vous exporterez les détails de votre intégration dans un environnement Postman. Ensuite (dans la section suivante), vous allez générer un jeton d'accès au porteur pour vous accorder l'accès aux ressources d'Adobe nécessaires.

REMARQUE

Pour obtenir des instructions vidéo applicables à toute solution Experience Cloud, y compris Target, voir Utiliser Postman avec les API Experience Platform. Les sections suivantes concernent les API Target :

  1. Exporter les détails de l'intégration des Adobes I/O à Postman
  2. Générer un Jeton d'accès avec Postman

Ces étapes sont également décrites ci-dessous.

  1. Toujours dans la Console développeur d'Adobes, accédez à la vue des 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 indiqué.
    JWT1
    Dans les détails des informations d’ identification, notez que vous pouvez vue votre(s) clé(s) publique(s), votre ID de​client et d’autres informations relatives à votre compte de service.
    JWT1a

  2. Cliquez sur 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é.
    JWT2

  3. Cliquez sur Télécharger pour Postman > Compte de service (JWT) pour créer un fichier JSON qui capture vos informations d'authentification pour un environnement Postman.
    JWT3
    Notez le fichier JSON dans votre système de fichiers.
    JWT3a

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

  5. Choisissez votre fichier et cliquez sur Ouvrir.
    JWT5

  6. Dans le module postal Gérer les Environnements, cliquez sur le nom de l'environnement nouvellement importé pour l'inspecter. (Votre nom d'environnement peut être différent de celui indiqué ici. Modifiez le nom selon vos besoins. Il n’est pas nécessaire de faire correspondre le nom du projet d’Adobe.)
    JWT6

  7. Les valeurs des notes CLIENT_SECRET et API_KEY (ainsi que d'autres variables) sont prérenseignées, à partir de votre intégration telle que définie dans la console de développement des Adobes. (La variable Postman CLIENT_SECRET doit correspondre aux informations d’identification de l’Adobe CLIENT SECRET affichées dans la Console développeur et API_KEY dans Postman doit également correspondre à CLIENT ID dans la Console développeur.) Par contre, la note PRIVATE_KEY, JWT_TOKEN et ACCESS_TOKEN sont vides. Début en fournissant la valeur PRIVATE_KEY.
    JWT7

    REMARQUE

    Surprise !

    Quoique-nique ! Pouvez-vous vous souvenir où se trouve votre clé privée ?
    C'est exact, il se trouve dans le fichier config téléchargé plus tôt à partir de la Console développeur de l'Adobe !

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

  9. Sélectionnez et copiez l'intégralité du contenu du fichier de clés private.
    JWT9

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

  11. Cliquez sur Mettre à jour, puis fermez le mode Environnements.

Générer le jeton d'accès porteur

Dans cette section, vous générez votre jeton d'accès au porteur, qui est nécessaire pour authentifier votre interaction avec les API Adobe Target. Pour générer votre jeton d'accès porteur, vous devez envoyer vos détails d'intégration (établis dans les sections précédentes) au service Identity Management d'Adobe (IMS). Il existe plusieurs façons de le faire, mais dans ce tutoriel, vous avez créé une demande de POST sur mesure à l'API IMS. Je plaisante. Dans ce tutoriel, nous profitons d'une collection Postman contenant un appel IMS préconstruit qui rend le processus direct et facile. Une fois la collection importée, vous pouvez la réutiliser au besoin, afin de générer de nouveaux jetons non seulement pour Adobe Target, mais également pour d’autres API d’Adobe.

  1. Accédez à l'exemple d'appel Adobe Identity Management Service API .
    token1

  2. Cliquez sur Adobe I/O Jeton d'accès Generation Postman collection.
    token2

  3. Obtenez le fichier JSON brut pour cette collection en cliquant sur Brut, puis en copiant le fichier JSON résultant dans le Presse-papiers. (Vous pouvez également enregistrer le fichier JSON brut dans un fichier .json.)
    token3

  4. 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).
    jeton4

  5. Sélectionnez l'IMS IMS : JWT Generate + Auth via User Token requête dans la collection Postman de génération de Jetons d'accès d’Adobe I/O, assurez-vous que votre environnement est sélectionné, puis cliquez sur Envoyer pour générer le jeton.

    jeton5

    REMARQUE

    Ce jeton d'accès au porteur sera valable 24 heures. Envoyez de nouveau la demande chaque fois que vous devez générer un nouveau jeton.

  6. Ouvrez à nouveau le module Gérer les Environnements, puis sélectionnez votre environnement.
    token6

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

REMARQUE

Q : Dois-je utiliser la collection Postman de la génération de Jetons d'accès d'Adobe I/O pour générer le JSON Web Token (JWT) et le jeton d'accès porteur ?

A : Non ! La collection Postman de la génération de Jetons d'accès d'Adobe I/O est disponible pour faciliter la génération du jeton d'accès JWT et porteur dans Postman. Vous pouvez également utiliser les fonctionnalités de la console de développement Adobe pour générer manuellement le jeton d'accès porteur.

Testez le jeton d'accès porteur

Dans cet exercice, vous utiliserez votre nouveau jeton d'accès au porteur en envoyant une demande d'API qui récupère une liste d'activités de votre compte Target. Une réponse positive indique que votre projet d’Adobe et votre authentification fonctionnent comme prévu afin d’utiliser l’API.

  1. Importez les API d'administration Adobe Target Postman Collection. Suivez toutes les invites jusqu'à ce que la collection soit importée dans Postman.
    testtoken1

  2. Développez la collection et notez la demande Listes activités.
    testtoken1

  3. Notez que les variables telles que {{access_token}} ne sont pas résolues au départ. Vous pouvez résoudre ce problème de plusieurs manières différentes (par exemple, vous pouvez définir une nouvelle variable de collecte appelée {{access_token}}), mais dans ce didacticiel, vous allez plutôt modifier la demande d'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 aux API d’Adobe.
    testtoken2

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

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

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

  7. Ouvrez le module Gérer les Environnements, puis sélectionnez votre environnement.
    JWT11

  8. Tapez pour ajouter une nouvelle variable d'environnement {{TENANT_ID}}. Copiez et collez la valeur de votre ID de client dans les champs VALEUR INITIALE et VALEUR ACTUELLE de votre nouvelle variable d'environnement TENANT_ID.

    testtoken5

    REMARQUE

    L'ID de client est différent de votre Target clientcode. L'ID de client existe dans l'URL lorsque vous êtes connecté à Target. Pour obtenir votre ID de client, connectez-vous à Adobe Experience Cloud, ouvrez Target, puis cliquez sur la carte Target. Utilisez la valeur ID du client comme indiqué dans le sous-domaine URL.

    Par exemple, si votre URL lors de la connexion à Adobe Target est

    <https://mycompany.experiencecloud.adobe.com/...>

    votre ID de client est alors "mycompany".

  9. Envoyez votre demande, après avoir sélectionné l’environnement approprié. Vous devriez recevoir une réponse contenant votre liste d'activités.
    testtoken6

Félicitations ! Maintenant que vous avez vérifié votre authentification d'Adobe, vous pouvez l'utiliser pour interagir avec les API Adobe Target (ainsi qu'avec d'autres API d'Adobe). Par exemple, vous pouvez utiliser les API Recommendations pour créer ou gérer des recommandations.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now