Show Menu
THEMEN×

Konfigurieren von AEM Assets mit Brand Portal

Adobe Experience Manager (AEM) Assets wird über die Adobe Developer Console mit Brand Portal konfiguriert. Dadurch wird ein IMS-Token zur Autorisierung Ihres Brand Portal-Mandanten abgerufen.
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 Brand Portal über das veraltete OAuth Gateway konfiguriert, das den JWT-Token-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 wird in Adobe Developer Console geändert.
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 Markenportal-Benutzer sind und Ihre AEM Assets-Autoreninstanz mit Markenportal konfigurieren möchten, können Sie die Konfiguration in der Adobe Developer Console erstellen.
  • Upgrade-Konfiguration : Wenn Sie bereits mit Ihrer AEM Assets-Autoreninstanz, die mit Brand Portal auf dem alten OAuth Gateway konfiguriert wurde, arbeiten, löschen Sie die vorhandene Konfiguration und erstellen Sie eine neue Konfiguration in der 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 URL für den Markenportal-Mandanten.
  • Ein Benutzer mit Systemadministrator-Berechtigungen für die IMS-Organisation des Brand Portal-Mandanten

Herunterladen und Installieren von AEM 6.5

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 den Kundendienst , 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 Dienstkontoanmeldeinformationen und der JWT-Payload.
  6. Konfigurieren Sie in AEM Assets den Markenportal-Cloud-Dienst mit dem IMS-Konto- und Markenportal-Endpunkt (Organisations-URL).
  7. Testen Sie Ihre Konfiguration, indem Sie ein Asset aus AEM Assets in das Markenportal veröffentlichen.
Eine AEM Assets-Autoreninstanz darf nur mit einem Markenportal-Mandanten konfiguriert werden.
Führen Sie die folgenden Schritte in der aufgeführten Reihenfolge durch, wenn Sie AEM Assets zum ersten Mal mit dem Markenportal konfigurieren:

Erstellen der IMS-Konfiguration

Die IMS-Konfiguration authentifiziert Ihren Brand Portal-Mandanten mit der Autoreninstanz von AEM Assets.
Die IMS-Konfiguration umfasst zwei Schritte:

Abrufen eines öffentlichen Zertifikats

Ein öffentliches Zertifikat ermöglicht Ihnen die Authentifizierung Ihres Profils 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 zu Sicherheit > Adobe IMS-Konfigurationen .
  3. Klicken Sie auf der Seite mit den Adobe IMS-Konfigurationen auf Erstellen .
  4. Sie gelangen auf die Seite für die Konfiguration des technischen Adobe IMS-Kontos . Standardmäßig wird die Registerkarte Zertifikat geöffnet.
    Wählen Sie die Cloud-Lösung Adobe Brand Portal aus.
  5. Mark the Create new certificate checkbox and specify an alias for the certificate. Der Alias dient als Name des Dialogfelds.
  6. Klicken Sie auf Zertifikat erstellen . Klicken Sie dann im Dialogfeld auf OK , um das öffentliche Zertifikat zu generieren.
  7. Klicken Sie auf Öffentlichen Schlüssel herunterladen und speichern Sie die Zertifikatdatei (.crt) auf Ihrem Computer.
    Die Zertifikatdatei wird später verwendet, um die API für Ihren Markenportal-Mandanten zu konfigurieren und Anmeldeinformationen für das Dienstkonto in der Adobe Developer Console zu generieren.
  8. Klicken Sie auf Weiter .
    In the Account tab, the Adobe IMS account is created but for that you will need the service account credentials that are generated in Adobe Developer Console. Lassen Sie diese Seite vorerst offen.
    Öffnen Sie eine neue Registerkarte und erstellen Sie in der Adobe Developer Console eine JWT-Verbindung (Dienstkonto) , um die Anmeldedaten und die JWT-Payload für die Konfiguration des IMS-Kontos abzurufen.

Erstellen einer JWT-Verbindung (Dienstkonto)

In der Adobe Developer Console werden Projekte und APIs auf der Ebene des Markenportals-Mandanten (der Organisation) konfiguriert. Beim Konfigurieren einer API wird eine JWT-Verbindung (Dienstkonto) in der Adobe Developer Console erstellt. 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 dem Markenportal zu konfigurieren, müssen Sie ein öffentliches Zertifikat (öffentlichen Schlüssel) in AEM Assets generieren und Anmeldeinformationen in der Adobe Developer Console erstellen, indem Sie den öffentlichen Schlüssel hochladen. Dieser öffentliche Schlüssel wird zum Konfigurieren der API für den ausgewählten Markenportal-Mandanten verwendet und generiert die Anmeldeinformationen und die JWT-Nutzlast für das Dienstkonto. Diese Anmeldeinformationen werden auch zur Konfiguration des IMS-Kontos in AEM Assets verwendet. Nachdem das IMS-Konto konfiguriert wurde, können Sie den Markenportal-Cloud-Dienst in AEM Assets konfigurieren.
Führen Sie die folgenden Schritte aus, um die Anmeldedaten für das Dienstkonto 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
    Vergewissern Sie sich, dass Sie die richtige IMS-Organisation (Markenportal-Mieter) aus der Dropdown-Liste (Unternehmen) oben rechts ausgewählt haben.
  2. Klicken Sie auf Neues Projekt erstellen . Für Ihre Organisation wird ein leeres Projekt erstellt.
    Klicken Sie auf Projekt bearbeiten , um den Projekttitel und die Projektbeschreibung zu aktualisieren, und klicken Sie auf Speichern .
  3. In the Project overview tab, click Add API .
  4. In the Add an API window , select AEM Brand Portal and click Next .
    Stellen Sie sicher, dass Sie Zugriff auf den AEM Brand Portal-Dienst haben.
  5. In the Configure API window, click Upload your public key . Klicken Sie dann auf Datei auswählen und laden Sie das öffentliche Zertifikat (.crt-Datei) hoch, das Sie im Abschnitt zum Abrufen des öffentlichen Zertifikats heruntergeladen haben.
    Klicken Sie auf Weiter .
  6. Überprüfen Sie das öffentliche Zertifikat und klicken Sie auf Weiter .
  7. Select the default product profile Assets Brand Portal and click Save configured API .
  8. Sobald die API konfiguriert ist, werden Sie zur API-Übersicht weitergeleitet. Klicken Sie in der linken Navigation unter Anmeldedaten auf Dienstkonto (JWT) .
    Sie können die Anmeldedaten einsehen und bei Bedarf weitere Aktionen durchführen (JWT-Token generieren, Anmeldedaten kopieren, Client-Geheimnisse abrufen usw.).
  9. Kopieren Sie auf der Registerkarte Client-Anmeldedaten die Client-ID .
    Klicken Sie auf Client-Geheimnis abrufen und kopieren Sie das Client-Geheimnis .
  10. Navigieren Sie zur Registerkarte JWT generieren und kopieren Sie die JWT-Payload .
You can now use the client ID (API key), client secret, and JWT payload to configure the IMS account in AEM Assets.

Konfigurieren des IMS-Kontos

Stellen Sie sicher, dass Sie die folgenden Schritte ausgeführt haben:
Führen Sie die folgenden Schritte aus, um das IMS-Konto zu konfigurieren.
  1. Open the IMS Configuration and navigate to the Account tab. You kept the page open while obtaining the public certificate .
  2. Geben Sie einen Titel für das IMS-Konto an.
    Geben Sie in Autorisierungsserver die URL ein: https://ims-na1.adobelogin.com/
    Fügen Sie den API-Schlüssel (Client-ID), den geheimen Clientschlüssel und die Nutzlast (JWT-Nutzlast) ein, die Sie beim Erstellen der JWT-Verbindung kopiert haben.
    Klicken Sie auf Erstellen .
    Das IMS-Konto ist konfiguriert.
  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.
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 -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 in Dienst-URL Ihre Brand Portal-Mandanten (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. From the Tools panel, navigate to Deployment > Replication .
  3. Klicken Sie auf der Seite „Replikation“ auf Agenten für Autor .
  4. Für jeden Mandanten werden vier Replizierungsagenten erstellt.
    Suchen Sie die Replizierungsagenten Ihres Markenportal-Mandanten.
    Klicken Sie auf die Replizierungsagenten-URL.
    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.
  5. Um die Verbindung zwischen AEM Assets und Brand Portal zu überprüfen, klicken Sie auf Verbindung testen .
    Am unteren Rand der Seite wird eine Meldung angezeigt, dass Ihr *Test-Paket erfolgreich bereitgestellt wurde.
  6. Überprüfen Sie die Testergebnisse für alle vier Replizierungsagenten.
    Deaktivieren Sie keine Replizierungsagenten. Dies kann dazu führen, dass die Replizierung einiger Assets fehlschlägt.
    Stellen Sie sicher, dass alle vier Replizierungsagenten so konfiguriert sind, dass kein Timeout-Fehler auftritt. See troubleshoot issues in parallel publishing to Brand Portal .
Ihre AEM Assets-Autoreninstanz wurde erfolgreich mit dem Markenportal konfiguriert. Sie können jetzt:

Upgrade der Konfiguration

Führen Sie die folgenden Schritte in der aufgeführten Reihenfolge aus, um vorhandene Konfigurationen zu aktualisieren:

Ausführen von Aufträgen überprüfen

Stellen Sie sicher, dass auf Ihrer AEM Assets-Autoreninstanz kein Veröffentlichungsauftrag ausgeführt wird, bevor Sie Änderungen vornehmen. Dazu können Sie alle vier Replizierungsagenten überprüfen und sicherstellen, dass die Warteschlangen untätig sind.
  1. Melden Sie sich bei der AEM Assets-Autorenistanz an.
  2. From the Tools panel, navigate to Deployment > Deployment Replication .
  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 Konfigurationen lö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 allen vier Replizierungsagenten Ihres Markenportal-Mandanten /etc/replications/agents.author und löschen Sie sie.
  3. Navigieren Sie zur Konfiguration /etc/cloudservices/mediaportal des Cloud Service und löschen Sie sie .
  4. Navigieren Sie zum /home/users/mac MAC-Benutzer Ihres Markenportals-Mandanten und löschen Sie ihn.