Show Menu
THEMEN×

Authentifizierung und Zugriff auf Experience Platform APIs

Dieses Dokument bietet eine schrittweise Anleitung zum Zugriff auf ein Adobe Experience Platform-Entwicklerkonto, um Aufrufe an Experience Platform-APIs durchzuführen.

Authentifizierung für API-Aufrufe

Um die Sicherheit Ihrer Anwendungen und Benutzer zu gewährleisten, müssen alle Anforderungen an Adobe I/O-APIs mit Standards wie OAuth und JSON Web Tokens (JWT) authentifiziert und autorisiert werden. Die JWT wird dann zusammen mit kundenspezifischen Informationen verwendet, um Ihr persönliches Zugriffstoken zu generieren.
Dieses Lernprogramm beschreibt die Authentifizierungsschritte durch die Erstellung eines Zugriffstokens, das im folgenden Flussdiagramm dargestellt wird:

Voraussetzungen

Für die erfolgreiche Ausführung von Aufrufen an Experience Platform-APIs benötigen Sie Folgendes:
  • Eine IMS-Organisation mit Zugriff auf die Adobe Experience Platform
  • Ein registriertes Adobe ID-Konto
  • Administrator der Admin-Konsole, um Sie als Entwickler und als Benutzer für ein Produkt hinzuzufügen.
In den folgenden Abschnitten werden die Schritte zum Erstellen einer Adobe-ID und zum Erstellen eines Entwicklers und Benutzers für ein Unternehmen erläutert.

Erstellen einer Adobe ID

Wenn Sie keine Adobe-ID haben, können Sie eine wie folgt erstellen:
  1. Klicken Sie auf Neues Konto erstellen
  2. Anmeldevorgang abschließen

Werden Sie Entwickler und Benutzer von Experience Platform für eine Organisation

Vor der Erstellung von Integrationen auf Adobe I/O muss Ihr Konto über Entwicklerberechtigungen für ein Produkt in einer IMS-Organisation verfügen. Ausführliche Informationen zu Entwicklerkonten in der Admin-Konsole finden Sie im Support-Dokument für die Verwaltung von Entwicklern.
Entwicklerzugriff erlangen
Wenden Sie sich an einen Administrator der Admin-Konsole in Ihrer Organisation, um Sie als Entwickler für eines der Produkte Ihrer Organisation mithilfe der Admin-Konsole hinzuzufügen.
Der Administrator muss Sie als Entwickler mindestens einem Produkt-Profil zuweisen, um fortfahren zu können.
Nachdem Sie als Entwickler zugewiesen wurden, haben Sie Zugriffsrechte, um Integrationen auf Adobe I/O zu erstellen. Bei diesen Integrationen handelt es sich um eine Pipeline von externen Apps und Diensten zur Adobe API.
Benutzerzugriff sichern
Der Administrator der Admin-Konsole muss Sie auch als Benutzer zum Produkt hinzufügen.
Ähnlich wie beim Hinzufügen eines Entwicklers muss der Administrator Sie mindestens einem Profil zuweisen, um fortfahren zu können.

Erstellen von Zugriffsberechtigungen in der Adobe Developer Console

Mit Adobe Developer Console müssen Sie die folgenden drei Zugriffsberechtigungen generieren:
  • {IMS_ORG}
  • {API_KEY}
  • {ACCESS_TOKEN}
Ihre {IMS_ORG} und {API_KEY} nur einmal generiert werden müssen und können in zukünftigen Plattform-API-Aufrufen wiederverwendet werden. Ihre {ACCESS_TOKEN} Daten sind jedoch nur vorübergehend und müssen alle 24 Stunden neu generiert werden.
Die Schritte werden nachfolgend detailliert beschrieben.

Einmalige Einrichtung

Wechseln Sie zur Adobe Developer Console und melden Sie sich mit Ihrer Adobe ID an. Führen Sie anschließend die Schritte aus, die im Lernprogramm zum Erstellen eines leeren Projekts in der Dokumentation zur Adobe Developer Console beschrieben sind.
Nachdem Sie ein neues Projekt erstellt haben, klicken Sie im Bildschirm " Projektübersicht "auf Hinzufügen API .
Der Hinzufügen eines API -Bildschirms wird angezeigt. Klicken Sie auf das Produktsymbol für Adobe Experience Platform und wählen Sie dann Experience Platform API , bevor Sie auf Weiter klicken.
Nachdem Sie Experience Platform als API ausgewählt haben, die dem Projekt hinzugefügt werden soll, führen Sie die Schritte aus, die im Lernprogramm zum Hinzufügen einer API zu einem Projekt mithilfe eines Dienstkontos (JWT) (beginnend mit dem Schritt "API konfigurieren") beschrieben sind, um den Prozess abzuschließen.
Nachdem die API zum Projekt hinzugefügt wurde, zeigt die Seite " Projektübersicht "die folgenden Anmeldeinformationen an, die für alle Aufrufe der Experience Platform-APIs erforderlich sind:
  • {API_KEY} (Client-ID)
  • {IMS_ORG} (Organisations-ID)

Authentifizierung für jede Sitzung

Die letzte erforderliche Berechtigung, die Sie erfassen müssen, ist Ihre {ACCESS_TOKEN} . Im Gegensatz zu den Werten für {API_KEY} und {IMS_ORG} muss alle 24 Stunden ein neues Token generiert werden, um weiterhin Plattform-APIs verwenden zu können.
Um ein neues zu erstellen, führen Sie die Schritte {ACCESS_TOKEN} zum Generieren eines JWT-Tokens im Handbuch mit den Anmeldeinformationen für die Developer Console aus.

Zugriffsberechtigungen testen

Nachdem Sie alle drei erforderlichen Anmeldeinformationen gesammelt haben, können Sie versuchen, den folgenden API-Aufruf durchzuführen. Dieser Aufruf Liste alle Erlebnisdatenmodellklassen (XDM) innerhalb des global Containers der Schema-Registrierung:
API-Format
GET /global/classes

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: {IMS_ORG}'

Antwort
Wenn Ihre Antwort der unten stehenden ähnelt, sind Ihre Anmeldeinformationen 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 für JWT-Authentifizierung und API-Aufrufe

Postman ist ein beliebtes Werkzeug, um mit RESTful APIs zu arbeiten. In diesem Beitrag "Mittel"wird beschrieben, wie Sie Postman so einrichten können, dass eine JWT-Authentifizierung automatisch durchgeführt und Adobe Experience Platform-APIs verwendet werden.

Nächste Schritte

Durch Lesen dieses Dokuments haben Sie Ihre Zugriffsberechtigungen für Plattform-APIs gesammelt und erfolgreich getestet. Sie können nun die in der gesamten Dokumentation bereitgestellten Beispiel-API-Aufrufe verwenden.
Zusätzlich zu den Authentifizierungswerten, die Sie in diesem Lernprogramm gesammelt haben, benötigen viele Plattform-APIs auch eine gültige Kopfzeile {SANDBOX_NAME} als Kopfzeile. See the sandboxes overview for more information.