Einrichten des AAM-API-Zugriffs
Erfahren Sie, wie Sie in der Entwicklerkonsole ein Projekt erstellen, um JWT-Anmeldeinformationen für die Audience Manager-API zu generieren.
Beschreibung description
Umgebung
Adobe Audience Manager
Problem/Symptome
Wie werden Anmeldeinformationen für die Audience Manager-API eingerichtet und generiert?
Auflösung resolution
Sie benötigen Systemadministrator-Berechtigungen in der Admin Console, um Anmeldeinformationen für die Audience Manager-API zu generieren. In den Schritten 1 und 2 wird beschrieben, wie Sie diese eskalierten Berechtigungen gewähren. Ihre aktuellen Systemadministratoren ziehen es möglicherweise vor, diese Schritte selbst auszuführen, anstatt einem zusätzlichen Benutzer eskalierte Administratorberechtigungen zu erteilen. Fahren Sie in diesem Fall direkt mit Schritt 3 fort.
- Navigieren Sie zur Admin Console 🔗 und wählen Sie im Menü „Schnelllinks“ die Option „Admins hinzufügen“ aus:
- Geben Sie die E-Mails für alle Benutzer ein, denen Sie Zugriff gewähren möchten. Wählen Sie auf der nächsten Seite „Systemadministrator“ für die Berechtigungsstufe aus:
- Navigieren Sie zu https://developer.adobe.com/console . Wenn Sie noch keinen Zugriff haben, obwohl Ihnen in den vorherigen Schritten Systemadministratorrechte gewährt wurden, versuchen Sie, Ihre Cookies/Ihren Cache zu aktualisieren.
- Erstellen Sie ein neues Projekt über das Schnellstartmenü (oder das Menü „Projekte“ in der oberen Navigationsleiste):
- Fügen Sie die Audience Manager-API zu Ihrem Projekt hinzu:
- Führen Sie die Schritte aus, um Ihre JWT-Anmeldeinformationen zu generieren (oder hochzuladen). Wenn Sie die Anmeldeinformationen über die Dev-Konsole generieren möchten, stellen Sie sicher, dass Sie den privaten Schlüssel sicher speichern. In späteren Schritten benötigen Sie Ihren privaten Schlüssel.
- Als Nächstes werden Sie aufgefordert, die Anmeldeinformationen relevanten Produktprofilen zuzuweisen. Wenn Ihr Unternehmen rollenbasierte Zugriffssteuerungen verwendet, müssen Sie die folgenden Schritte ausführen, um ein technisches Benutzerkonto zu erstellen und dieses Konto zur relevanten RBAC-Gruppe hinzuzufügen: https://experienceleague.adobe.com/docs/audience-manager/user-guide/api-and-sdk-code/rest-apis/aam-api-getting-started.html?lang=de#technical-account-rbac-permissions
- Sobald diese Schritte abgeschlossen sind, können Sie ein Zugriffstoken generieren, um Ihre erste API-Anfrage zu stellen. Klicken Sie zunächst in der Dev-Konsole auf die Seite mit der Übersicht über die Anmeldeinformationen:
- Klicken Sie oben auf der Seite auf die Registerkarte „JWT generieren“, fügen Sie den gesamten privaten Schlüssel aus der in Schritt 6 heruntergeladenen Datei ein und klicken Sie auf „Token generieren“:
Schließlich können Sie API-Anfragen mithilfe des im vorherigen Schritt abgerufenen Zugriffstokens stellen. Die Aufrufe können von jeder API-Plattform, z. B. Postman, direkt über cURL-Befehle oder sogar über unsere API-Dokumentationsseite erfolgen: https://bank.demdex.com/portal/swagger/index.html#/
Um Anrufe mit den Demo-Funktionen in unserer Dokumentation durchzuführen, führen Sie die oben genannten Schritte aus, um Ihr Token zu generieren, und klicken Sie dann auf „Autorisieren“ auf der rechten Seite der Seite und geben Sie Ihr Token ein:
Stellen Sie außerdem sicher, dass Sie den Server aam.adobe.io auswählen, wie im obigen Screenshot gezeigt. Jetzt können Sie die Demo-Funktion für jede API-Anfrage verwenden, indem Sie die entsprechenden Parameter eingeben und auf die Schaltfläche „Ausprobieren“ klicken:
Beachten Sie, dass dadurch eine echte API-Anfrage an Ihre Instanz gesendet wird. Wenn Sie eine DELETE-, PUT- oder POST-Anfrage verwenden, können Sie unbeabsichtigte Änderungen an Ihrer Instanz vornehmen. Lesen Sie immer die Dokumentation für jeden dieser API-Aufrufe, bevor Sie die Anfrage senden.