Configuration de l’accès AAM API
Découvrez 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.
Description description
Environnement
Adobe Audience Manager
Problème/Symptômes
Comment configurer et générer des informations d’identification pour l’API Audience Manager ?
Résolution resolution
Vous aurez besoin des autorisations d’administrateur système dans l’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.
- Accédez à Admin Console et sélectionnez "Ajouter des administrateurs" dans le menu "Liens rapides" :
- 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 :
- 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.
- Créez un projet à partir du menu de démarrage rapide (ou du menu des projets dans le volet de navigation supérieur) :
- Ajoutez l’API d’Audience Manager à votre projet :
- 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.
- Ensuite, vous serez invité à attribuer les informations d’identification aux profils de produit pertinents. Si votre organisation utilise des contrôles d’accès basés sur les rôles, vous devrez suivre ces étapes pour créer un compte 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
- 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 d’abord sur la page d’aperçu de vos informations d’identification dans la console de développement :
- 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":
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 des 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 demande de DELETE, de PUT ou de POST, vous apportez peut-être des modifications non voulues à votre instance. Veillez toujours à lire attentivement la documentation de chacun de ces appels API avant d’envoyer la demande.