IMS-Konfiguration zur Verwendung bei der Integration mit Adobe Target ims-configuration-for-integration-with-adobe-target

Die Integration von AEM mit Adobe Target über die Target Standard-API erfordert die Konfiguration von Adobe IMS (Identity Management System). Die Konfiguration wird mit der Adobe-Entwicklerkonsole durchgeführt.

NOTE
Die Unterstützung für die Adobe Target Standard-API ist in AEMaaCS neu. Die Target Standard-API verwendet die IMS-Authentifizierung.
Die API-Auswahl wird von der Authentifizierungsmethode gesteuert, die für die AEM/Target-Integration verwendet wird.

Voraussetzungen prerequisites

Bevor Sie mit diesem Verfahren beginnen:

  • Der Adobe-Support muss Ihr Konto für Folgendes bereitstellen:

    • Adobe Console
    • Adobe-Entwicklerkonsole
    • Adobe Target und
    • Adobe IMS (Identity Management System)
  • Der Systemadministrator Ihres Unternehmens sollte die Admin Console verwenden, um die erforderlichen Entwickler in Ihrem Unternehmen den relevanten Produktprofilen hinzuzufügen.

    • Dadurch erhalten bestimmte Entwickler Berechtigungen, Integrationen mithilfe der Adobe-Entwicklerkonsole zu ermöglichen.
    • Siehe Verwalten von Entwickelnden.

Konfigurieren einer IMS-Konfiguration – Generieren eines öffentlichen Schlüssels configuring-an-ims-configuration-generating-a-public-key

Der erste Schritt der Konfiguration besteht darin, in AEM eine IMS-Konfiguration zu erstellen und den öffentlichen Schlüssel zu generieren.

  1. Öffnen Sie in AEM das Menü Tools.

  2. Wählen Sie im Abschnitt Sicherheit die Option Adobe IMS-Konfigurationen aus.

  3. Wählen Sie Erstellen aus, um Technische Kontokonfiguration für Adobe IMS zu öffnen.

  4. Wählen Sie in der Dropdown-Liste unter Cloud-Konfiguration die Option Adobe Target aus.

  5. Aktivieren Sie Neues Zertifikat erstellen und geben Sie einen neuen Alias ein.

  6. Bestätigen Sie mit Zertifikat erstellen.

    Zertifikat erstellen

  7. Wählen Sie Herunterladen (oder Öffentlichen Schlüssel herunterladen), um die Datei auf Ihr lokales Laufwerk herunterzuladen, sodass sie bei der Konfiguration von IMS für die Integration von Adobe Target mit AEM zur Verfügung steht.

    note caution
    CAUTION
    Lassen Sie diese Konfiguration geöffnet, denn wird beim Abschließen der IMS-Konfiguration in AEM wieder benötigt.

    Zertifikat herunterladen

Konfigurieren des IMS für die Integration von Adobe Target mit AEM configuring-ims-adobe-target-integration-with-aem

Adobe-Entwicklerkonsolen-Projekt (Integration) mit Adobe Target, das AEM verwenden wird, dann Zuweisung der erforderlichen Berechtigungen.

Erstellen des Projekts creating-the-project

Öffnen Sie die Adobe-Entwicklerkonsole, um ein Projekt mit Adobe Target zu erstellen, das AEM verwenden wird:

CAUTION
Derzeit unterstützen wir nur den Anmeldedatentyp Service-Konto (JWT) der Adobe Developer Console.
Verwenden Sie nicht den Anmeldedatentyp OAuth-Server-zu-Server, der erst in Zukunft unterstützt wird.
  1. Öffnen Sie die Adobe-Entwicklerkonsole für Projekte:

    https://developer.adobe.com/console/projects

  2. Alle vorhandenen Projekte werden angezeigt. Wählen Sie Neues Projekt erstellen aus. Position und Verwendung hängen von Folgendem ab:

    • Wenn Sie noch kein Projekt haben, befindet sich Neues Projekt erstellen unten in der Mitte.
      Neues Projekt erstellen – Erstes Projekt
    • Wenn Sie bereits über vorhandene Projekte verfügen, werden diese aufgelistet und Neues Projekt erstellen wird oben rechts angezeigt.
      Neues Projekt erstellen – Mehrere Projekte
  3. Wählen Sie Zu Projekt hinzufügen und dann API aus:

    Zu Projekt hinzufügen

  4. Wählen Sie Adobe Target aus und klicken Sie dann auf Weiter:

    note note
    NOTE
    Wenn Sie Adobe Target abonniert haben, es jedoch nicht aufgeführt sehen, sollten Sie die Voraussetzungen überprüfen.

    Wählen Sie Adobe Target aus

  5. Laden Sie Ihren öffentlichen Schlüssel hoch und setzen Sie den Vorgang anschließend mit Weiter fort:

    Öffentlichen Schlüssel hochladen

  6. Überprüfen Sie die Anmeldeinformationen und setzen Sie den Vorgang mit Weiter fort:

    Anmeldeinformationen überprüfen

  7. Wählen Sie die erforderlichen Produktprofile aus und fahren Sie mit Konfigurierte API speichern fort:

    note note
    NOTE
    Welche Produktprofile angezeigt werden, hängt von folgenden Voraussetzungen ab:
    • Adobe Target Standard – nur Standardarbeitsbereich ist verfügbar
    • Adobe Target Premium – alle verfügbaren Arbeitsbereiche werden aufgelistet, wie unten dargestellt

    Auswahl von Produktprofilen und Speichern der konfigurierten API

  8. Die Erstellung wird bestätigt.

Zuweisen von Berechtigungen zur Integration assigning-privileges-to-the-integration

Sie müssen der Integration jetzt die erforderlichen Berechtigungen zuweisen:

  1. Öffnen Sie die Adobe Admin Console:

  2. Navigieren Sie zu Produkte (obere Symbolleiste) und wählen Sie Adobe Target - <Ihre-Mandanten-ID> (im linken Bereich) aus.

  3. Wählen Sie Produktprofile und dann den gewünschten Arbeitsbereich aus der angezeigten Liste aus. Beispielsweise den Standardarbeitsbereich.

  4. Wählen Sie API-Anmeldeinformationen und dann die erforderliche Integrationskonfiguration aus.

  5. Wählen Sie Editor als Produktrolle aus anstelle von Beobachter.

Für das Adobe-Entwicklerkonsolen-Integrationsprojekt gespeicherte Details details-stored-for-the-ims-integration-project

In der Adobe-Entwicklerkonsole wird in der Konsole „Projekte“ eine Liste aller Integrationsprojekte angezeigt:

Wählen Sie Anzeigen (rechts neben einem bestimmten Projekteintrag) aus, um weitere Details zur Konfiguration anzuzeigen. Dazu gehören:

  • Projektübersicht

  • Insights

  • Berechtigungen

    • Dienstkonto (JWT)

      • Details zu Anmeldedaten
      • JWT generieren
  • APIs

    • Beispiel: Adobe Target

Bei einigen davon müssen Sie die Integration von Adobe Target in AEM mithilfe von IMS abschließen.

Abschließen der IMS-Konfiguration in AEM completing-the-ims-configuration-in-aem

Wenn Sie zu AEM zurückkehren, können Sie die IMS-Konfiguration abschließen, indem Sie die erforderlichen Werte aus der IMS-Integration für Target hinzufügen:

  1. Kehren Sie zur in AEM geöffneten IMS-Konfiguration zurück.

  2. Wählen Sie Weiter aus.

  3. Hier können Sie die Details aus der Projektkonfiguration in der Adobe-Entwicklerkonsole verwenden:

    • Titel: Ihr Text.
    • Autorisierungs-Server: Übernehmen Sie diese Angabe per Kopieren und Einfügen aus der aud-Zeile im Abschnitt Payload unten, z. B. https://ims-na1.adobelogin.com im nachstehenden Beispiel.
    • API-Schlüssel: Kopieren Sie diesen aus dem Projektabbschnitt Übersicht
    • Client-Geheimnis: Generieren Sie dies im Projektabschnitt Übersicht und kopieren Sie es
    • Payload: Kopieren Sie diese aus dem Abschnitt JWT generieren

    Konfiguration des technischen Adobe IMS-Kontos

  4. Bestätigen Sie mit Erstellen.

  5. Ihre Adobe Target-Konfiguration wird in der AEM-Konsole angezeigt.

    IMS-Konfiguration

Bestätigen der IMS-Konfiguration confirming-the-ims-configuration

So überprüfen Sie, ob die Konfiguration erwartungsgemäß funktioniert:

  1. Öffnen Sie:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    Beispiel:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. Wählen Sie Ihre Konfiguration aus.

  3. Wählen Sie auf der Symbolleiste Zustand überprüfen und dann Überprüfen aus.

    Konsistenz prüfen

  4. Bei erfolgreicher Ausführung wird eine Bestätigungsmeldung angezeigt.

Abschließen der Integration mit Adobe Target complete-the-integration-with-adobe-target

Sie können jetzt diese IMS-Konfiguration verwenden, um die Integration mit Adobe Target abzuschließen.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab