Konfigurieren von AEM Assets mit Brand Portal

Mit dem Markenportal für Adobe Experience Manager Assets können Sie genehmigte Markenelemente aus Adobe Experience Manager Assets im Markenportal veröffentlichen und an die Benutzer des Markenportals verteilen.

AEM Assets wird über die Adobe Developer Console mit Brand Portal konfiguriert. Dadurch wird ein Adobe Identity Management Services (IMS)-Token zur Autorisierung Ihres Brand Portal-Mandanten abgerufen.

NOTE

Die Konfiguration von AEM Assets mit dem Markenportal über die Adobe Developer Console wird auf AEM 6.5.4.0 und höher unterstützt.

Zuvor wurde das Markenportal über das alte OAuth Gateway konfiguriert, das den JSON Web Token (JWT) Austausch nutzt, um ein IMS-Zugriffstoken zur Autorisierung zu erhalten.

Die Konfiguration über veraltetes OAuth Gateway wird ab dem 6. April 2020 nicht mehr unterstützt und in Adobe Developer Console geändert.

TIP

Nur für Bestandskunden

Es wird empfohlen, weiterhin die vorhandene alte OAuth Gateway-Konfiguration zu verwenden. Falls Probleme mit der alten OAuth Gateway-Konfiguration auftreten, löschen Sie die vorhandene Konfiguration und erstellen Sie eine neue Konfiguration über die Adobe Developer Console.

In dieser Hilfe werden die folgenden zwei Anwendungsfälle beschrieben:

  • Neue Konfiguration: Wenn Sie ein neuer Brand Portal-Benutzer sind und Ihre AEM Assets-Autoreninstanz mit Brand Portal konfigurieren möchten, können Sie die Konfiguration über die Adobe Developer Console erstellen.
  • Upgrade-Konfiguration: Wenn Sie ein bestehender Brand Portal-Benutzer sind, der auf dem alten OAuth Gateway konfiguriert ist, löschen Sie die vorhandene Konfiguration und erstellen Sie eine neue Konfiguration über die Adobe Developer Console.

Benutzer dieser Hilfe sollten mit den folgenden Technologien vertraut sein:

  • Installieren, Konfigurieren und Verwalten von Adobe Experience Manager- und AEM-Paketen.

  • Verwenden von Linux- und Microsoft Windows-Betriebssystemen.

Voraussetzungen

Sie benötigen Folgendes, um AEM Assets mit Brand Portal zu konfigurieren:

  • Eine AEM Assets-Autoreninstanz mit dem neuesten Service Pack
  • Eine Brand Portal-Mandanten-URL
  • Ein Anwender mit Systemadministrator-Berechtigungen für die IMS-Organisation des Brand Portal-Mandanten

Herunterladen und Installieren von AEM 6.5

Herunterladen und Installieren des neuesten AEM Service Packs

Laden Sie AEM 6.5herunter und installieren Sie es

Es wird empfohlen, AEM 6.5 zu verwenden, um eine AEM Autoreninstanz einzurichten. Wenn Sie AEM nicht eingerichtet haben, laden Sie es von den folgenden Speicherorten herunter:

Anweisungen zum Einrichten einer AEM- Autoreninstanz finden Sie nach dem Herunterladen von AEM unter Bereitstellen und Verwalten.

Herunterladen und Installieren des neuesten AEM Service Packs

Ausführliche Anweisungen finden Sie unter

Wenden Sie sich an Support, wenn Sie das neueste AEM oder Service Pack nicht finden können.

Erstellen der Konfiguration

Zum Konfigurieren von AEM Assets mit dem Markenportal sind Konfigurationen sowohl in der AEM Assets-Autoreninstanz als auch in der Adobe Developer Console erforderlich.

  1. Erstellen Sie in AEM Assets ein IMS-Konto und erstellen Sie ein öffentliches Zertifikat (öffentlicher Schlüssel).
  2. Erstellen Sie in der Adobe Developer Console ein Projekt für Ihren Brand Portal-Mandanten (Unternehmen).
  3. Konfigurieren Sie unter dem Projekt eine API mithilfe des öffentlichen Schlüssels, um eine JWT-Verbindung (Dienstkonto) zu erstellen.
  4. Rufen Sie die Anmeldedaten für das Dienstkonto und die JWT-Payload-Informationen ab.
  5. Konfigurieren Sie in AEM Assets das IMS-Konto mit den Anmeldedaten für das Service-Konto und die JWT-Payload.
  6. Konfigurieren Sie in AEM Assets den Brand Portal-Cloud Service mit dem IMS-Konto und dem Brand Portal-Endpunkt (Organisations-URL).
  7. Testen Sie die Konfiguration, indem Sie ein Asset aus AEM Assets in Brand Portal veröffentlichen.
NOTE

Eine AEM Assets-Autoreninstanz darf nur mit einem Markenportal-Mandanten konfiguriert werden.

Führen Sie die folgenden Schritte in der aufgeführten Reihenfolge aus, wenn Sie AEM Assets mit Markenportal zum ersten Mal konfigurieren:

  1. Abrufen eines öffentlichen Zertifikats
  2. Erstellen einer JWT-Verbindung (Service-Konto)
  3. Konfigurieren des IMS-Kontos
  4. Konfigurieren von Cloud Service
  5. Testen der Konfiguration

Erstellen der IMS-Konfiguration

Die IMS-Konfiguration authentifiziert Ihre AEM Assets-Autoreninstanz mit dem Markenportal-Mandanten.

Die IMS-Konfiguration umfasst zwei Schritte:

Abrufen eines öffentlichen Zertifikats

Der öffentliche Schlüssel (Zertifikat) authentifiziert Ihr Profil in der Adobe Developer Console.

  1. Melden Sie sich bei der AEM Assets-Autorenistanz an. Die Standardeinstellung ist http://localhost:4502/aem/start.html.

  2. Navigieren Sie im Bedienfeld Tools Tools zu Sicherheit > Adobe IMS-Konfigurationen.

  3. Klicken Sie auf der Seite mit den Adobe IMS-Konfigurationen auf Erstellen. Sie werden zur Seite für die Konfiguration des technischen Adobe IMS-Kontos weitergeleitet. Standardmäßig wird die Registerkarte Zertifikat geöffnet.

  4. Wählen Sie Adobe Brand Portal in der Dropdown-Liste Cloud-Lösung aus.

  5. Aktivieren Sie das Kontrollkästchen Neues Zertifikat erstellen und geben Sie einen Alias für den öffentlichen Schlüssel an. Der Alias dient als Name des öffentlichen Schlüssels.

  6. Klicken Sie auf Zertifikat erstellen. Klicken Sie auf OK, um den öffentlichen Schlüssel zu generieren.

    Zertifikat erstellen

  7. Klicken Sie auf das Symbol Öffentlichen Schlüssel herunterladen und speichern Sie die Public-Key-Datei (.crt) auf Ihrem Computer.

    Der öffentliche Schlüssel wird später zum Konfigurieren der API für Ihren Brand Portal-Mandanten und zum Generieren von Anmeldedaten für Service-Konten in der Adobe Developer Console verwendet.

    Zertifikat herunterladen

  8. Klicken Sie auf Weiter.

    Auf der Registerkarte Konto wird das Adobe IMS-Konto erstellt. Dafür werden die Anmeldedaten für Service-Konten benötigt, die in der Adobe Developer Console generiert werden. Lassen Sie diese Seite vorerst offen.

    Öffnen Sie eine neue Registerkarte und erstellen Sie in der Adobe Developer Console eine JWT-Verbindung (Service-Konto), um die Anmeldedaten und die JWT-Payload für die Konfiguration des IMS-Kontos abzurufen.

Erstellen einer JWT-Verbindung (Service-Konto)

In der Adobe Developer Console werden Projekte und APIs auf Brand Portal-Mandantenebene (Organisationsebene) konfiguriert. Beim Konfigurieren einer API wird eine Service-Konto-Verbindung (JWT-Verbindung) hergestellt. Es gibt zwei Methoden zum Konfigurieren der API: Generieren eines Schlüsselpaars (privater und öffentlicher Schlüssel) oder Hochladen eines öffentlichen Schlüssels. Um AEM Assets mit Brand Portal zu konfigurieren, müssen Sie einen öffentlichen Schlüssel (Zertifikat) in AEM Assets generieren und Anmeldedaten in der Adobe Developer Console erstellen, indem Sie den öffentlichen Schlüssel hochladen. Diese Anmeldedaten werden zum Konfigurieren des IMS-Kontos in AEM Assets benötigt. Sobald das IMS-Konto konfiguriert ist, können Sie den Brand Portal-Cloud Service in AEM Assets konfigurieren.

Führen Sie die folgenden Schritte aus, um die Anmeldedaten für das Service-Konto und die JWT-Payload zu generieren:

  1. Melden Sie sich bei der Adobe Developer Console mit Systemadministratorrechten für die IMS-Organisation (den Brand Portal-Mandanten) an. Die Standardeinstellung ist https://www.adobe.com/go/devs_console_ui_de.

    NOTE

    Vergewissern Sie sich, dass Sie die richtige IMS-Organisation (Brand Portal-Mandant) aus der Dropdown-Liste (Organisation) oben rechts ausgewählt haben.

  2. Klicken Sie auf Neues Projekt erstellen. Für Ihre Organisation wird ein leeres Projekt mit einem systemgenerierten Namen erstellt.

    Klicken Sie auf Projekt bearbeiten, um den Projekttitel und die Projektbeschreibung zu aktualisieren, und klicken Sie auf Speichern.

  3. Klicken Sie auf der Registerkarte mit der Projektübersicht auf API hinzufügen.

  4. Wählen Sie im Fenster API hinzufügen die Option AEM Brand Portal aus und klicken Sie auf Weiter.

    Stellen Sie sicher, dass Sie Zugriff auf den AEM Brand Portal-Service haben.

  5. Klicken Sie im Fenster API konfigurieren auf Öffentlichen Schlüssel hochladen. Klicken Sie dann auf Datei auswählen und laden Sie den öffentlichen Schlüssel (.crt-Datei) hoch, den Sie im Abschnitt zum Abrufen des öffentlichen Zertifikats heruntergeladen haben.

    Klicken Sie auf Weiter.

    Öffentlichen Schlüssel hochladen

  6. Überprüfen Sie den öffentlichen Schlüssel und klicken Sie auf Weiter.

  7. Wählen Sie Assets Brand Portal als Standardproduktprofil aus und klicken Sie auf Konfigurierte API speichern.

    Profil auswählen

  8. Sobald die API konfiguriert ist, werden Sie zur Seite mit der API-Übersicht weitergeleitet. Klicken Sie in der linken Navigation unter Anmeldedaten auf die Option Service-Konto (JWT).

    NOTE

    Sie können die Anmeldedaten einsehen und weitere Aktionen durchführen, beispielsweise JWT-Token generieren, Anmeldedaten kopieren und Client-Geheimnisse abrufen.

  9. Kopieren Sie auf der Registerkarte Client-Anmeldedaten die Client-ID.

    Klicken Sie auf Client-Geheimnis abrufen und kopieren Sie das Client-Geheimnis.

    Service-Konto-Anmeldedaten

  10. Navigieren Sie zur Registerkarte JWT generieren und kopieren Sie die Informationen zur JWT-Payload.

Sie können jetzt die Client-ID (API-Schlüssel), das Client-Geheimnis und die JWT-Payload verwenden, um das IMS-Konto in AEM Assets zu konfigurieren.

Konfigurieren des IMS-Kontos

Stellen Sie sicher, dass Sie die folgenden Schritte ausgeführt haben:

Gehen Sie wie folgt vor, um das IMS-Konto zu konfigurieren.

  1. Öffnen Sie die IMS-Konfiguration und navigieren Sie zur Registerkarte Konto. Sie haben die Seite offen gelassen, während Sie das öffentliche Zertifikat abgerufen haben.

  2. Geben Sie einen Titel für das IMS-Konto an.

    Geben Sie im Feld Autorisierungsserver die URL ein: https://ims-na1.adobelogin.com/

    Fügen Sie die Client-ID im Feld API-Schlüssel sowie das Client-Geheimnis und die Payload (JWT-Payload) ein, die Sie beim Erstellen der JWT-Verbindung (Service-Konto) kopiert haben.

    Klicken Sie auf Erstellen.

    Das IMS-Konto ist konfiguriert.

    IMS-Kontokonfiguration

  3. Wählen Sie die IMS-Kontokonfiguration aus und klicken Sie auf Systemdiagnose.

    Klicken Sie im Dialogfeld auf Prüfen. Bei erfolgreicher Konfiguration wird eine Meldung angezeigt, dass das Token erfolgreich abgerufen wurde.

CAUTION

Sie dürfen nur eine IMS-Konfiguration haben.

Vergewissern Sie sich, dass die IMS-Konfiguration die Konsistenzprüfung besteht. Wenn die Konfiguration die Konsistenzprüfung nicht besteht, ist sie ungültig. Sie müssen sie löschen und eine neue gültige Konfiguration erstellen.

Konfigurieren von Cloud Service

Führen Sie die folgenden Schritte aus, um den Brand Portal-Cloud Service zu konfigurieren:

  1. Melden Sie sich bei der AEM Assets-Autorenistanz an.

  2. Navigieren Sie im Tool Tools-Bedienfeld zu Cloud Services > AEM Brand Portal.

  3. Klicken Sie auf der Seite mit den Brand Portal-Konfigurationen auf Erstellen.

  4. Geben Sie einen Titel für die Konfiguration ein.

    Wählen Sie die IMS-Konfiguration aus, die Sie beim Konfigurieren des IMS-Kontos erstellt haben.

    Geben Sie im Feld Dienst-URL Ihre Brand Portal-Mandanten-URL (Organisations-URL) ein.

  5. Klicken Sie auf Speichern und schließen. Die Cloud-Konfiguration wird erstellt.

    Ihre AEM Assets-Autoreninstanz ist jetzt mit dem Markenportal-Mandanten konfiguriert.

Testen der Konfiguration

Führen Sie zur Validierung der Konfiguration folgende Schritte aus:

  1. Melden Sie sich bei Ihrer AEM Assets-Cloud-Instanz an.

  2. Navigieren Sie im Bereich Tools Tools zu Bereitstellung > Replikation.

  3. Klicken Sie auf der Seite „Replikation“ auf Agenten für Autor.

    Sie können die vier Replizierungsagenten sehen, die für Ihren Markenportal-Mandanten erstellt wurden.

    Suchen Sie die Replizierungsagenten Ihres Markenportal-Mandanten und klicken Sie auf die Replizierungsagenten-URL.

    NOTE

    Die Replizierungsagenten arbeiten parallel und teilen die Auftragsverteilung gleichmäßig, wodurch die Veröffentlichungsgeschwindigkeit um das Vierfache der Originalgeschwindigkeit steigt. Wenn der Cloud-Service konfiguriert wurde, sind keine zusätzlichen Konfigurationsschritte erforderlich, um die Replikationsagenten zu aktivieren. Sie werden standardmäßig aktiviert, um die parallele Veröffentlichung mehrerer Assets zu ermöglichen.

  4. Um die Verbindung zwischen AEM Assets und Brand Portal zu überprüfen, klicken Sie auf das Symbol Verbindung testen.

    Ihnen wird eine Meldung angezeigt, dass Ihr Testpaket erfolgreich bereitgestellt wurde.

  5. Überprüfen Sie die Testergebnisse für alle vier Replizierungsagenten.

    NOTE

    Deaktivieren Sie keine Replizierungsagenten, da dies dazu führen kann, dass die Replizierung der Assets (die in der Warteschlange ausgeführt werden) fehlschlägt.

    Stellen Sie sicher, dass alle vier Replizierungsagenten so konfiguriert sind, dass kein Timeout-Fehler auftritt. Siehe Fehlerbehebung bei Problemen beim parallelen Veröffentlichen im Markenportal.

Sie haben nun die folgenden Möglichkeiten:

Weitere Informationen finden Sie in der Dokumentation zu Brand Portal.

Upgrade der Konfiguration

Führen Sie die folgenden Schritte in der aufgeführten Reihenfolge aus, um Ihre vorhandenen Konfigurationen auf Adobe Developer Console zu aktualisieren:

  1. Ausführen von Aufträgen überprüfen
  2. Vorhandene Konfigurationen löschen
  3. Konfiguration erstellen

Überprüfen laufender Aufträge

Stellen Sie sicher, dass auf Ihrer AEM Assets-Autoreninstanz kein Veröffentlichungsauftrag ausgeführt wird, bevor Sie Änderungen vornehmen. Dazu können Sie den Status aktiver Aufträge auf allen vier Replizierungsagenten überprüfen und sicherstellen, dass die Warteschlangen untätig sind.

  1. Melden Sie sich bei der AEM Assets-Autorenistanz an.

  2. Navigieren Sie im Bereich Tools Tools zu Bereitstellung > Replikation der Bereitstellung.

  3. Klicken Sie auf der Seite „Replikation“ auf Agenten für Autor.

  4. Suchen Sie die Replizierungsagenten Ihres Markenportal-Mandanten.

    Stellen Sie sicher, dass die Warteschlange für alle Replizierungsagenten Idle lautet. Es ist kein Veröffentlichungsauftrag aktiv.

Vorhandene Konfigurationenlöschen

Sie müssen beim Löschen der vorhandenen Konfigurationen die folgende Checkliste ausführen:

  • Alle vier Replizierungsagenten löschen
  • Markenportal-Cloud-Dienst löschen
  • MAC-Benutzer löschen
  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an und öffnen Sie CRX Lite als Administrator. Die Standardeinstellung ist http://localhost:4502/crx/de/index.jsp.

  2. Navigieren Sie zu /etc/replications/agents.author und löschen Sie alle vier Replizierungsagenten Ihres Markenportal-Mandanten.

  3. Navigieren Sie zu /etc/cloudservices/mediaportal und löschen Sie die Konfiguration des Markenportal-Cloud-Dienstes.

  4. Navigieren Sie zu /home/users/mac und löschen Sie den MAC-Benutzer Ihres Markenportal-Mieters.

Sie können die Konfigurationsdatei jetzt über die Adobe Developer Console in Ihrer AEM 6.5 Autoreninstanz erstellen.

Auf dieser Seite