Authentifizieren und Zugreifen auf Experience Platform-APIs

Dieses Dokument bietet eine schrittweise Anleitung für den Zugriff auf ein Adobe Experience Platform-Entwicklerkonto, damit Sie Aufrufe an Experience Platform-APIs durchführen können. Am Ende dieses Tutorials haben Sie die folgenden Anmeldeinformationen generiert, die für alle Platform-API-Aufrufe erforderlich sind:

• {ACCESS_TOKEN}
• {API_KEY}
• {ORG_ID}

Um die Sicherheit Ihrer Anwendungen und Benutzer zu gewährleisten, müssen alle Anfragen an Adobe I/O-APIs mit Standards wie OAuth und JSON Web Tokens (JWT) authentifiziert und autorisiert werden. Ein JWT wird zusammen mit clientspezifischen Informationen verwendet, um Ihr persönliches Zugriffstoken zu generieren.

In diesem Tutorial wird beschrieben, wie Sie die erforderlichen Anmeldeinformationen zum Authentifizieren von Platform-API-Aufrufen erfassen, wie im folgenden Flussdiagramm beschrieben:

Voraussetzungen

Um Experience Platform-APIs erfolgreich aufrufen zu können, benötigen Sie Folgendes:

• Eine Organisation mit Zugriff auf Adobe Experience Platform.
• Ein Admin Console-Administrator, der Sie als Entwickler und Anwender für ein Produktprofil hinzufügen kann.

Sie müssen auch über eine Adobe ID verfügen, um dieses Tutorial abzuschließen. Wenn Sie keine Adobe ID haben, können Sie wie folgt eine erstellen:

1. Navigieren Sie zu Adobe Developer-Konsole.
2. Auswählen Neues Konto erstellen.
3. Schließen Sie den Anmeldevorgang ab.

Entwickler- und Benutzerzugriff für Experience Platform erlangen

Vor der Erstellung von Integrationen in der Adobe Developer Console muss Ihr Konto über Entwickler- und Benutzerberechtigungen für ein Experience Platform-Produktprofil in Adobe Admin Console verfügen.

Entwicklerzugriff erlangen

Kontakt Admin Console Administrator in Ihrer Organisation, um Sie als Entwickler einem Experience Platform-Produktprofil mithilfe von Admin Console. Siehe Admin Console Dokumentation für spezifische Anweisungen zum Verwalten des Entwicklerzugriffs für Produktprofile.

Nachdem Sie als Entwickler zugewiesen wurden, können Sie mit der Erstellung von Integrationen in Adobe Developer-Konsole. Bei diesen Integrationen handelt es sich um eine Pipeline von externen Apps und Diensten zu Adobe-APIs.

Benutzerzugriff erlangen

Ihre Admin Console -Administrator muss Sie auch als Benutzer zum selben Produktprofil hinzufügen. Siehe Handbuch unter Verwalten von Benutzergruppen in Admin Console für weitere Informationen.

API-Schlüssel, Organisations-ID und Client-Geheimnis generieren

Nachdem Sie Entwicklern und Benutzern Zugriff auf Platform gewährt haben, über Admin Console, wird im nächsten Schritt die {ORG_ID} und {API_KEY} Anmeldedaten in der Adobe Developer Console. Diese Anmeldeinformationen müssen nur einmal generiert werden und können in zukünftigen Platform-API-Aufrufen wiederverwendet werden.

Experience Platform zu einem Projekt hinzufügen

Wechseln Sie zur Adobe-Entwicklerkonsole und melden Sie sich mit Ihrer Adobe ID an. Führen Sie anschließend die Schritte aus, die im Tutorial Erstellen eines leeren Projekts in der Dokumentation zu Adobe Developer Console beschrieben werden.

Nachdem Sie ein neues Projekt erstellt haben, wählen Sie API hinzufügen auf Projektübersicht angezeigt.

Der Bildschirm API hinzufügen wird angezeigt. Wählen Sie das Produktsymbol für Adobe Experience Platform und dann Experience Platform-API vor der Auswahl Nächste.

Folgen Sie hier den Schritten, die im Tutorial zu Hinzufügen einer API zu einem Projekt mithilfe eines Dienstkontos (JWT) (ab dem Schritt "API konfigurieren"), um den Prozess abzuschließen.

Sammeln von -Anmeldeinformationen

Nachdem die API zum Projekt hinzugefügt wurde, wird die Experience Platform-API -Seite für das Projekt werden die folgenden Anmeldeinformationen angezeigt, die für alle Aufrufe von Experience Platform-APIs erforderlich sind:

• {API_KEY} (Client-ID)
• {ORG_ID} (Organisations-ID)

Zusätzlich zu den oben genannten Anmeldedaten benötigen Sie auch die generierte Client Secret für einen künftigen Schritt. Auswählen Client-Geheimnis abrufen , um den Wert anzuzeigen, und kopieren Sie ihn zur späteren Verwendung.

JSON-Web-Token (JWT) generieren

Der nächste Schritt besteht darin, ein JSON Web Token (JWT) basierend auf Ihren Kontoanmeldeinformationen zu generieren. Mit diesem Wert wird Ihre {ACCESS_TOKEN} Berechtigung zur Verwendung in Platform-API-Aufrufen, die alle 24 Stunden neu generiert werden müssen.

Auswählen Dienstkonto (JWT) Wählen Sie im linken Navigationsbereich die Option JWT generieren.

In dem unter Benutzerdefiniertes JWT generieren Fügen Sie den Inhalt des privaten Schlüssels ein, den Sie zuvor beim Hinzufügen der Platform-API zu Ihrem Dienstkonto generiert haben. Wählen Sie anschließend Generate Token.

Die Seite wird aktualisiert und zeigt das generierte JWT sowie einen cURL-Beispielbefehl an, mit dem Sie ein Zugriffstoken generieren können. Wählen Sie für die Zwecke dieses Tutorials Kopieren neben Generiertes JWT , um das Token in die Zwischenablage zu kopieren.

Zugriffstoken generieren

Nachdem Sie ein JWT generiert haben, können Sie es in einem API-Aufruf verwenden, um Ihre {ACCESS_TOKEN}. Im Gegensatz zu den Werten für {API_KEY} und {ORG_ID}muss ein neues Token alle 24 Stunden generiert werden, damit Sie weiterhin Platform-APIs verwenden können.

Anfrage

Die folgende Anfrage generiert eine neue {ACCESS_TOKEN} basierend auf den in der Payload angegebenen Anmeldeinformationen. Dieser Endpunkt akzeptiert nur Formulardaten als Payload und muss daher eine Content-Type -Kopfzeile multipart/form-data.

curl -X POST https://ims-na1.adobelogin.com/ims/exchange/jwt \
  -H 'Content-Type: multipart/form-data' \
  -F 'client_id={API_KEY}' \
  -F 'client_secret={SECRET}' \
  -F 'jwt_token={JWT}'

Antwort

{
  "token_type": "bearer",
  "access_token": "{ACCESS_TOKEN}",
  "expires_in": 86399992
}

Zugriffsberechtigungen testen

Nachdem Sie alle drei erforderlichen Anmeldeinformationen gesammelt haben, können Sie versuchen, den folgenden API-Aufruf durchzuführen. Dieser Aufruf listet alle standardmäßigen Experience Data Model (XDM)-Klassen, die für Ihr Unternehmen verfügbar sind.

Anfrage

curl -X GET https://platform.adobe.io/data/foundation/schemaregistry/global/classes \
  -H 'Accept: application/vnd.adobe.xed-id+json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}'

Antwort

Wenn Ihre Antwort der unten gezeigten ähnelt, sind Ihre Anmeldedaten gültig und funktionieren. (Diese Antwort wurde aus Platzgründen abgeschnitten.)

{
  "results": [
    {
        "title": "XDM ExperienceEvent",
        "$id": "https://ns.adobe.com/xdm/context/experienceevent",
        "meta:altId": "_xdm.context.experienceevent",
        "version": "1"
    },
    {
        "title": "XDM Individual Profile",
        "$id": "https://ns.adobe.com/xdm/context/profile",
        "meta:altId": "_xdm.context.profile",
        "version": "1"
    }
  ]
}

Verwenden von Postman zum Authentifizieren und Testen von API-Aufrufen

Postman ist ein beliebtes Tool, mit dem Entwickler RESTful-APIs untersuchen und testen können. Diese Mittlerer Beitrag beschreibt, wie Sie Postman so einrichten können, dass automatisch eine JWT-Authentifizierung durchgeführt und Platform-APIs verwendet werden.

Entwickler- und API-Zugriffskontrolle mit Experience Platform-Berechtigungen

Vor der Erstellung von Integrationen in der Adobe Developer Console muss Ihr Konto über Entwickler- und Benutzerberechtigungen für ein Experience Platform-Produktprofil in Adobe Admin Console verfügen.

Hinzufügen von Entwicklern zum Produktprofil

Gehen Sie zu Admin Console und melden Sie sich mit Ihrer Adobe ID an.

Auswählen Produkte, wählen Sie Adobe Experience Platform aus der Liste der Erzeugnisse.

Aus dem Produktprofile Registerkarte, wählen Sie AEP-Default-All-Users. Alternativ können Sie über die Suchleiste nach dem Produktprofil suchen, indem Sie den Namen eingeben.

Wählen Sie die Entwickler Registerkarte und wählen Sie Entwickler hinzufügen.

Geben Sie die E-Mail- oder Benutzername. Eine gültige E-Mail- oder Benutzername zeigt die Entwicklerdetails an. Wählen Sie Speichern aus.

Der Entwickler wurde erfolgreich hinzugefügt und wird im Entwickler Registerkarte.

Einrichten einer API

Entwickler können in einem Projekt in der Adobe Developer-Konsole eine API hinzufügen und konfigurieren.

Wählen Sie Ihr Projekt aus und klicken Sie auf API hinzufügen.

Im API hinzufügen Dialogfeldauswahl Adobe Experience Platform, wählen Sie Experience Platform-API.

Im API konfigurieren Bildschirm, wählen Sie AEP-Default-All-Users.

Zuweisen der API zu einer Rolle

Ein Systemadministrator kann Rollen in der Experience Platform-Benutzeroberfläche APIs zuweisen.

Auswählen Berechtigungen und die Rolle, der Sie die API hinzufügen möchten. Wählen Sie die API-Anmeldeinformationen Registerkarte und wählen Sie API-Anmeldeinformationen hinzufügen.

Wählen Sie die API aus, die Sie der Rolle hinzufügen möchten, und wählen Sie dann Speichern.

Sie kehren zum API-Anmeldeinformationen -Tab, wo die neu hinzugefügte API aufgelistet ist.

Nächste Schritte

Durch Lesen dieses Dokuments haben Sie Ihre Zugangsdaten für Platform-APIs gesammelt und erfolgreich getestet. Sie können nun den Beispielaufrufen folgen, die im Abschnitt Dokumentation.

Zusätzlich zu den Authentifizierungswerten, die Sie in diesem Tutorial gesammelt haben, benötigen viele Platform-APIs auch eine gültige {SANDBOX_NAME} als Kopfzeile angegeben werden. Weiterführende Informationen dazu finden Sie unter Sandbox-Übersicht.

Ressourcen für Business.Adobe.com