Konfigurieren der Authentifizierung für Adobe Target APIs
Die Adobe Target Admin-APIs, einschließlich Recommendations Admin-APIs, werden durch Authentifizierung gesichert, um sicherzustellen, dass nur autorisierte Benutzer sie für den Zugriff auf Adobe Target verwenden. Verwenden Sie die Adobe Developer Console, um diese Authentifizierung für alle Adobe Experience Cloud solutions zu verwalten, einschließlich Adobe Target.
WICHTIGIm Folgenden finden Sie die ersten Schritte, die erforderlich sind, um die veralteten JWT-Authentifizierungstoken zu generieren, die für die erfolgreiche Interaktion mit Adobe Target-APIs erforderlich sind:
- Erstellen Sie ein Projekt (früher als Integration bezeichnet) in der Adobe Developer Console.
- Projektdetails nach Postman exportieren.
- Generieren Sie ein Bearer-Zugriffstoken.
- Testen Sie das Bearer-Zugriffstoken.
Voraussetzungen
| Ressource | Details |
|---|---|
| Postman | Um diese Schritte erfolgreich durchzuführen, rufen Sie die Postman-App für Ihr Betriebssystem ab. Postman Basic ist bei der Kontoerstellung kostenlos. Postman ist zwar nicht erforderlich, um Adobe Target-APIs im Allgemeinen zu verwenden, erleichtert aber API-Workflows und bietet Adobe Target mehrere Postman-Sammlungen, die die Ausführung der APIs und deren Funktionsweise erleichtern. Im weiteren Verlauf dieses Handbuchs werden Kenntnisse über Postman vorausgesetzt. Weitere Informationen finden Sie in der Dokumentation zu Postman. |
| Verweise |
Im weiteren Verlauf dieses Handbuchs wird von der Vertrautheit mit den folgenden Ressourcen ausgegangen: |
Erstellen eines Adobe I/O-Projekts
In diesem Abschnitt greifen Sie auf die Adobe Developer Console zu und erstellen ein Projekt für Adobe Target. Weitere Informationen finden Sie in der Dokumentation zu Projekten.
<!—(1) Generieren Sie Ihren privaten Schlüssel und Ihr öffentliches Zertifikat gemäß der Dokumentation zur Authentifizierung. // [//]: # (wie in Schritt 1 von Einrichten von Adobe-IO: Authentifizierung - Schritt für Schritt. Kehren Sie nach Abschluss von Schritt 1 zu diesem Handbuch zurück und setzen Sie den Vorgang mit Schritt 2 fort. // The result of this step should be the creation of a private.key file and a certificate_pub.crt file. Kehren Sie zu diesem Handbuch zurück, sobald Sie diese beiden Dateien generiert haben.)—>
-
Stellen Sie in der Adobe Admin Console sicher, dass Ihrem Adobe-Benutzerkonto sowohl Produktadministrator als auch Entwickler Zugriff auf Target gewährt wurde.
-
Wählen Sie in der Adobe Developer Console die Experience Cloud Organization aus, für die Sie diese Integration erstellen möchten. (Beachten Sie, dass Sie wahrscheinlich nur Zugriff auf eine einzige Experience Cloud Organization haben.)
-
Klicken Sie auf Create new project.
-
Klicken Sie auf Add API , um Ihrem Projekt eine REST-API für den Zugriff auf Adobe Services und Produkte hinzuzufügen.
-
Wählen Sie Adobe Target als den Adobe-Service aus, mit dem Sie eine Integration vornehmen möchten. Klicken Sie auf die Next.
-
Wählen Sie eine Option aus, um öffentliche und private Schlüssel mit der Service-Kontointegration zu verknüpfen, die Sie für Target erstellen. Wählen Sie für dieses Beispiel Option 1: Generate a key pair aus und klicken Sie auf Generate keypair.
-
Notieren Sie sich wie angewiesen die automatisch heruntergeladene Konfigurationsdatei (
config), die Ihren privaten Schlüssel enthält. Klicken Sie auf Next.
-
Überprüfen Sie in Ihrem Dateisystem den Speicherort von
config, bei dem es sich um die im vorherigen Schritt erstellte komprimierte Konfigurationsdatei handelt. Dieseconfigenthält Ihren privaten Schlüssel, den Sie später benötigen werden. Der genaue Speicherort in Ihrem Dateisystem kann von dem hier gezeigten abweichen.
-
Zurück in der Adobe Developer Console wählen Sie Produktprofil(e aus, die den Eigenschaften entsprechen, in denen Sie Adobe Recommendations verwenden. (Wenn Sie keine Eigenschaften verwenden, wählen Sie die Option Standard-Workspace aus.) Klicken Sie auf Save configured API.
-
Klicken Sie auf Create Integration. Sie sollten eine temporäre Meldung erhalten, die angibt, dass Ihre API erfolgreich konfiguriert wurde.
-
Benennen Sie in einem letzten Schritt Ihr Projekt um, sodass es einen aussagekräftigeren Namen hat als das ursprüngliche
Project 1. Navigieren Sie dazu mithilfe des angezeigten Navigationspfads zum Projekt, klicken Sie auf Edit project , um auf das Edit Project Modal zuzugreifen, und benennen Sie das Projekt um.
HINWEISProjektdetails exportieren
Nachdem Sie nun über ein Adobe-Projekt verfügen, mit dem Sie auf Target zugreifen können, müssen Sie sicherstellen, dass Sie Details zu diesem Projekt zusammen mit Ihren Adobe-API-Anfragen senden. Diese Details sind erforderlich, um mit mehreren Adobe-APIs, einschließlich mehrerer Target-APIs, zu interagieren. Die Integrationsdetails enthalten beispielsweise Autorisierungs- und Authentifizierungsinformationen, die für die Target Admin-APIs erforderlich sind. Um die APIs mit Postman verwenden zu können, müssen Sie diese Informationen daher in Postman importieren.
Es gibt viele Möglichkeiten, die Details Ihres Projekts in Postman anzugeben, aber in diesem Abschnitt nutzen wir einige vordefinierte Funktionen und Sammlungen. Zunächst (in diesem Abschnitt) exportieren Sie die Details Ihrer Integration in eine Postman-Umgebung. Als Nächstes generieren Sie (im folgenden Abschnitt) ein Bearer-Zugriffstoken, um Ihnen Zugriff auf die erforderlichen Adobe-Ressourcen zu gewähren.
HINWEIS-
Navigieren Sie noch in der {0🔗Adobe Developer Console}, um die Service Account (JWT) Anmeldedaten Ihres neuen Projekts anzuzeigen. Verwenden Sie entweder den linken Navigationsbereich oder den Credentials, wie abgebildet.
Beachten Sie Credential details, dass Sie Ihre Public key(s), Client ID und andere Informationen zu Ihrem Service-Konto anzeigen können.
-
Klicken Sie, um zu Informationen über die Adobe Target-API zu navigieren. Verwenden Sie entweder die linke Navigation oder den Abschnitt Verbundene Produkte und Services wie abgebildet.
-
Klicken Sie auf Download for Postman > Service Account (JWT) , um eine JSON-Datei zu erstellen, die Ihre Authentifizierungsinformationen für eine Postman-Umgebung erfasst.
Notieren Sie die JSON-Datei in Ihrem Dateisystem.
-
Klicken Sie in Postman auf das Zahnradsymbol, um Ihre Umgebungen zu verwalten, und klicken Sie dann auf Import , um die JSON-Datei (Umgebung) zu importieren.
-
Wählen Sie Ihre Datei aus und klicken Sie auf Open.
-
Postman Klicken Sie im „Umgebungen verwalten auf den Namen der neu importierten Umgebung, um sie zu überprüfen. (Ihr Umgebungsname kann von dem hier gezeigten abweichen. Bearbeiten Sie den Namen nach Bedarf. Es muss nicht unbedingt mit dem Namen des Adobe-Projekts übereinstimmen.)
-
Beachten Sie, dass
CLIENT_SECRETundAPI_KEY(zusammen mit anderen Variablen) ihre Werte vorab ausgefüllt haben und aus Ihrer Integration stammen, wie in der Adobe Developer Console definiert. (Die Postman-CLIENT_SECRET-Variable sollte mit denCLIENT SECRETAdobe-Anmeldeinformationen übereinstimmen, wie sie in der Developer Console angezeigt werden, undAPI_KEYin Postman sollten ebenfalls mit denCLIENT IDin der Developer Console übereinstimmen.) Beachten Sie dagegen, dassPRIVATE_KEY,JWT_TOKENundACCESS_TOKENleer sind. Beginnen wir mit der Angabe desPRIVATE_KEY.
-
Öffnen Sie in Ihrem Dateisystem die
config-Datei und öffnen Sie dieprivate.
-
Wählen Sie den gesamten Inhalt der
privateaus und kopieren Sie ihn.
-
Fügen Sie in Postman Ihren privaten Schlüsselwert in die Felder INITIAL VALUE und CURRENT VALUE ein.
-
Klicken Sie auf Update und schließen Sie das Modal Umgebungen .
Erzeugen des Bearer-Zugriffstoken
In diesem Abschnitt generieren Sie Ihr Bearer-Zugriffstoken, das zum Authentifizieren Ihrer Interaktion mit Adobe Target-APIs erforderlich ist. Um Ihr Bearer-Zugriffstoken zu generieren, müssen Sie Ihre Integrationsdetails (wie in den vorherigen Abschnitten festgelegt) an den Adobe Identity Management Service (IMS) senden. Es gibt verschiedene Möglichkeiten, dies zu tun, aber in diesem Handbuch nutzen wir eine Postman-Sammlung mit einem vorkonfigurierten IMS-Aufruf, der den Prozess direkt und einfach macht. Nachdem Sie die Sammlung importiert haben, können Sie sie bei Bedarf wiederverwenden, um neue Token nicht nur für Adobe Target, sondern auch für andere Adobe-APIs zu generieren.
-
Navigieren Sie zu den Beispielaufrufen zur Adobe Identity Management Service-API.
-
Klicken Sie auf die Adobe I/O Access Token Generation Postman collection.
-
Rufen Sie die rohe JSON für diese Sammlung ab, indem Sie auf Raw klicken und dann die resultierende JSON in Ihre Zwischenablage kopieren. (Sie können die rohe JSON auch als JSON-Datei speichern.)
-
Importieren Sie in Postman die Sammlung, indem Sie die rohe JSON aus der Zwischenablage einfügen und senden. (Sie können auch die JSON-Datei hochladen, die Sie gespeichert haben.) Klicken Sie auf Continue.
-
Wählen Sie die IMS: JWT Generate + Auth via User Token Anfrage in der Postman-Sammlung zur Erzeugung von Adobe I/O-Zugriffstoken aus, stellen Sie sicher, dass Ihre Umgebung ausgewählt ist, und klicken Sie auf Send , um das Token zu generieren.
HINWEISDieses Bearer-Zugriffstoken ist 24 Stunden lang gültig. Senden Sie die Anfrage erneut, wenn Sie ein neues Token generieren müssen. -
Öffnen Sie erneut das Modal Umgebungen verwalten und wählen Sie Ihre Umgebung aus.
-
Beachten Sie, dass die Werte für
ACCESS_TOKENundJWT_TOKENjetzt ausgefüllt sind.
Frage: Muss ich die Postman-Sammlung zur Erzeugung von Adobe I/O-Zugriffstoken verwenden, um das JSON-Web-Token (JWT) und das Bearer-Zugriffstoken zu generieren?
Antwort: Nein. Die Postman-Sammlung zur Erzeugung von Adobe I/O-Zugriffstoken ist als Komfort verfügbar, um das JWT- und Bearer-Zugriffstoken in Postman einfacher zu generieren. Alternativ können Sie Funktionen in der Adobe Developer Console verwenden, um das Bearer-Zugriffstoken manuell zu generieren.
