Comment configurer AAM accès aux API

Dernière mise à jour : 2022-11-15

Description

Cet article explique comment créer un projet dans la console de développement pour générer des informations d’identification JWT sur l’API d’Audience Manager.

Résolution

Vous aurez besoin des autorisations d’administrateur système dans le Admin Console afin de générer les informations d’identification pour l’API d’Audience Manager. Les étapes 1 et 2 indiquent comment accorder ces autorisations réaffectées. Les administrateurs système actuels préfèrent peut-être suivre ces étapes eux-mêmes plutôt que d’accorder des autorisations d’administrateur réaffectées à un utilisateur supplémentaire, auquel cas passer directement à l’étape 3.

  1. Accédez au Admin Console , puis sélectionnez Ajout d’administrateurs de la Liens rapides menu :

  2. Saisissez les courriers électroniques de tous les utilisateurs auxquels vous souhaitez accorder l’accès. Sur la page suivante, sélectionnez "Administrateur système" pour le niveau d’autorisation :

  3. Accédez à https://developer.adobe.com/console . Si vous n’y avez pas encore accès, alors que les droits d’administrateur système vous ont été accordés lors des étapes précédentes, essayez d’actualiser vos cookies/cache.

  4. Créez un projet à partir du Démarrage rapide (ou la fonction Projets dans le volet de navigation supérieur) :

  5. Ajoutez l’API d’Audience Manager à votre projet :

  6. Suivez les étapes pour générer (ou charger) vos informations d’identification JWT. Si vous choisissez de générer les informations d’identification via la console de développement, assurez-vous de stocker la clé privée en toute sécurité. Vous aurez besoin de votre clé privée dans les étapes suivantes.

  7. Ensuite, vous serez invité à attribuer les informations d’identification aux profils de produit pertinents. Si votre entreprise utilise des contrôles d’accès basés sur les rôles, vous devez suivre ces étapes pour créer un compte d’utilisateur technique et ajouter ce compte au groupe RBAC approprié : https://experienceleague.adobe.com/docs/audience-manager/user-guide/api-and-sdk-code/rest-apis/aam-api-getting-started.html?lang=en#technical-account-rbac-permissions

  8. Une fois ces étapes terminées, vous pouvez générer un jeton d’accès pour effectuer votre première requête API. Cliquez tout d’abord sur la page d’aperçu de vos informations d’identification dans la console de développement :

  9. Cliquez sur l’onglet "Generate JWT" (Générer JWT) en haut de la page, collez la clé privée entière du fichier téléchargé à l’étape 6, puis cliquez sur "Generate Token" (Générer un jeton) :

Enfin, vous pouvez effectuer des demandes d’API à l’aide du jeton d’accès récupéré à l’étape précédente. Les appels peuvent être effectués à partir de n’importe quelle plateforme API, telle que Postman, directement via les commandes cURL, ou même à partir de notre page de documentation de l’API : https://bank.demdex.com/portal/swagger/index.html#/

Pour lancer des appels à l’aide des fonctionnalités de démonstration de notre documentation, suivez les étapes ci-dessus pour générer votre jeton, puis cliquez sur "Autoriser" sur le côté droit de la page et saisissez votre jeton :

Veillez également à sélectionner le serveur aam.adobe.io, comme indiqué dans la capture d’écran ci-dessus. Vous pouvez désormais utiliser la fonction de démonstration sur l’une des requêtes d’API en saisissant les paramètres appropriés et en cliquant sur le bouton Essayer d’extraire :

Gardez à l’esprit que cela enverra une requête API réelle à votre instance. Si vous utilisez une DELETE, PUTou POST , vous apportez peut-être des modifications involontaires à votre instance. Veillez toujours à lire attentivement la documentation de chacun de ces appels API avant d’envoyer la demande.

Sur cette page