Show Menu
THEMEN×

Konfigurieren von AEM Assets mit Brand Portal

Adobe Experience Manager (AEM)-Assets werden über die Adobe Developer Console mit dem Markenportal konfiguriert, wodurch ein IMS-Token zur Autorisierung Ihres Markenportal-Mandanten abgerufen wird.
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 alte OAuth-Gateway in der klassischen Benutzeroberfläche konfiguriert. Das Gateway ruft mithilfe des JWT-Token-Austauschs ein IMS-Zugriffstoken zur Autorisierung ab.
Die Konfiguration über Legacy-OAuth wird ab dem 6. April 2020 nicht mehr unterstützt. Die Konfiguration erfolgt nun über die Adobe Developer Console.
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 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 dem Markenportal konfigurieren möchten, können Sie eine neue Konfiguration in der Adobe Developer Console erstellen.
  • Upgrade-Konfiguration : Wenn Sie ein bestehender Brand Portal-Benutzer mit Ihrer AEM Assets-Autoreninstanz sind, die mit Brand Portal auf dem alten OAuth Gateway konfiguriert wurde, sollten Sie die vorhandenen Konfigurationen löschen und eine neue Konfiguration in der Adobe Developer Console erstellen.
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 betriebsbereite AEM Assets-Autoreninstanz mit dem neuesten Service Pack.
  • Brand Portal-Mandanten-URL
  • 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 zum Einrichten einer AEM-Autoreninstanz zu verwenden. 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-Paket oder Service Pack nicht finden können.

Erstellen der Konfiguration

Zum Konfigurieren von AEM Assets mit dem Markenportal sind Konfigurationen sowohl in der Autoreninstanz von AEM Assets als auch in der Adobe Developer Console erforderlich.
  1. Erstellen Sie in der Autoreninstanz von AEM Assets ein IMS-Konto und generieren Sie ein öffentliches Zertifikat (öffentlicher Schlüssel).
  2. Erstellen Sie in Adobe Developer Console ein Projekt für Ihren Markenportal-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 Anmeldeinformationen für das Dienstkonto und die JWT-Nutzdaten ab.
  5. Konfigurieren Sie in der Autoreninstanz von AEM Assets das IMS-Konto unter Verwendung der Dienstkontoberechtigungen und der JWT-Payload.
  6. Konfigurieren Sie in der Autoreninstanz von AEM Assets den Markenportal-Cloud-Dienst mit dem IMS-Konto und dem Markenportal-Endpunkt (Organisations-URL).
  7. Testen Sie die Konfiguration, indem Sie ein Asset aus der Autoreninstanz von AEM Assets in Brand Portal veröffentlichen.
Ein Markenportal-Mandant darf nur mit einer AEM Assets-Autoreninstanz konfiguriert werden.
Konfigurieren Sie keinen Markenportal-Mandanten mit mehreren AEM Assets-Autoreninstanzen.
Führen Sie die folgenden Schritte in der aufgeführten Reihenfolge durch, wenn Sie AEM Assets mit Markenportal zum ersten Mal 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

Mit dem öffentlichen Zertifikat können Sie Ihr Profil in der Adobe Developer Console authentifizieren.
  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an. Die Standardeinstellung ist http:// localhost:4502/aem/start.html
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Klicken Sie auf der Seite "Adobe IMS-Konfigurationen"auf Erstellen .
  4. Sie werden zur Seite "Konfiguration des technischen Adobe IMS-Kontos "weitergeleitet. By default, the Certificate tab opens.
    Wählen Sie die Cloud-Lösung Adobe Brand Portal .
  5. Mark the checkbox Create new certificate 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. Click Download Public Key and save the certificate (.crt) file on your machine.
    Die Zertifikatdatei wird in weiteren Schritten zum Konfigurieren der API für Ihren Markenportal-Mandanten und zum Generieren von Dienstkontoanmeldeinformationen in der Adobe Developer Console verwendet.
  8. Klicken Sie auf Weiter .
    Auf der Registerkarte " Konto "erstellen Sie das Adobe IMS-Konto, dafür benötigen Sie jedoch die Dienstkontoanmeldeinformationen, die in der Adobe Developer Console generiert werden. Lassen Sie diese Seite vorerst offen.
    Öffnen Sie eine neue Registerkarte und erstellen Sie eine JWT-Verbindung (Dienstkonto) in Adobe Developer Console , um die Anmeldeinformationen und die JWT-Nutzlast zum Konfigurieren des IMS-Kontos abzurufen.

Verbindung zum Erstellen eines Dienstkontos (JWT)

In der Adobe Developer Console werden Projekte und APIs auf Unternehmensebene (Pächter des Markenportals) konfiguriert. Beim Konfigurieren einer API wird eine JWT-Verbindung (Service Account) in der Adobe Developer Console erstellt. Es gibt zwei Methoden zum Konfigurieren der API, indem ein Schlüsselpaar (private und öffentliche Schlüssel) generiert oder ein öffentlicher Schlüssel hochgeladen wird. Um die Autoreninstanz von AEM Assets mit dem Markenportal zu konfigurieren, müssen Sie ein öffentliches Zertifikat (öffentlicher Schlüssel) in der Autoreninstanz von AEM Assets generieren und Anmeldeinformationen in Adobe Developer Console erstellen, indem Sie den öffentlichen Schlüssel hochladen. Dieser öffentliche Schlüssel wird zum Konfigurieren der API für das ausgewählte Markenportal-Unternehmen verwendet und generiert die Anmeldeinformationen und die JWT-Nutzlast für das Dienstkonto. Diese Anmeldeinformationen werden außerdem zum Konfigurieren des IMS-Kontos in der Autoreninstanz von AEM Assets verwendet. Nachdem das IMS-Konto konfiguriert wurde, können Sie den Markenportal-Cloud-Dienst in der Autoreninstanz von AEM Assets konfigurieren.
Führen Sie die folgenden Schritte aus, um die Dienstkontoberechtigungen und die JWT-Nutzlast zu generieren:
  1. Melden Sie sich bei der Adobe Developer Console mit Systemadministrator-Berechtigungen für die IMS-Organisation (Brand Portal-Mandant) an. Die Standardeinstellung ist
    Vergewissern Sie sich, dass Sie die richtige IMS-Organisation (Markenportal-Mieter) aus der Dropdown-Liste (Organisations-Liste) oben rechts ausgewählt haben.
  2. Click Create new project . Ein leeres Projekt wird für Ihre Organisation 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 Projektübersicht auf Hinzufügen API .
  4. Wählen Sie im Fenster Hinzufügen API die Option AEM Brand Portal und klicken Sie auf Weiter .
    Stellen Sie sicher, dass Sie Zugriff auf den AEM Brand Portal-Dienst haben.
  5. Klicken Sie im Fenster "API konfigurieren"auf Ihren öffentlichen Schlüssel hochladen . 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. Wählen Sie das Standardprodukt- Asset-Markenportal aus und klicken Sie auf Speicherkonfiguration .
  8. Wenn die API konfiguriert ist, werden Sie zur API-Übersicht weitergeleitet. Klicken Sie in der linken Navigation unter Berechtigungen auf Dienstkonto (JWT) .
    Sie können die Anmeldeinformationen nach Bedarf Ansicht und andere Aktionen ausführen (JWT-Token generieren, Berechtigungsdetails kopieren, Clientgeheimnis abrufen usw.).
  9. Kopieren Sie auf der Registerkarte " Clientanmeldeinformationen "die Client-ID .
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload .
Sie können jetzt die Client-ID (API-Schlüssel), das Clientgeheimnis und die JWT-Nutzlast verwenden, um das IMS-Konto in der AEM Assets-Cloud-Instanz zu konfigurieren.

Erstellen der Konfiguration 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, das Sie im Abrufen des öffentlichen Zertifikats erstellt haben.
  1. Öffnen Sie die IMS-Konfiguration und navigieren Sie zur Registerkarte " Konten ". Sie haben die Seite geöffnet, während Sie ein öffentliches Zertifikat erhalten haben .
  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 die Client-ID in den API-Schlüssel, den Clientschlüssel und die 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-Konfiguration aus und klicken Sie auf Systemdiagnose .
    Klicken Sie im Dialogfeld auf Aktivieren . Bei erfolgreicher Konfiguration wird eine Meldung angezeigt, dass das Token erfolgreich abgerufen wurde.
Sie dürfen nur eine IMS-Konfiguration haben. Erstellen Sie nicht mehrere IMS-Konfigurationen.
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-Dienst zu erstellen:
  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an.
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. Klicken Sie auf der Seite "Markenportal-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.
    In the Service URL , enter your Brand Portal tenant (organization) URL.
  5. Klicken Sie auf Speichern und schließen . Die Cloud-Konfiguration wird erstellt. Ihre Autoreninstanz für AEM Assets ist jetzt mit dem Markenportal-Mandanten konfiguriert.

Testen der Konfiguration

Führen Sie die folgenden Schritte aus, um die Konfiguration zu validieren:
  1. Melden Sie sich bei Ihrer AEM Assets-Cloud-Instanz an.
  2. Navigieren Sie im Bereich Tools zu Bereitstellung > Replikation .
  3. In the Replication page, click Agents on author .
  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 .
    Unten auf der Seite wird eine Meldung angezeigt, dass Ihr Testpaket erfolgreich bereitgestellt wurde.
  6. Überprüfen Sie die Testergebnisse für alle vier Replizierungsagenten einzeln.
    Vermeiden Sie es, einen der Replikationsagenten zu deaktivieren, da dies dazu führen kann, dass die Replikation einiger Assets fehlschlägt.
Ihre Autoreninstanz für AEM Assets wurde erfolgreich mit dem Markenportal konfiguriert. Jetzt können Sie:

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

Vergewissern Sie sich, dass in 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 Warteschlange ideal/leer ist.
  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an.
  2. Navigieren Sie im Bereich Tools zu Bereitstellung > Deployment Replication .
  3. In the Replication page, click Agents on author .
  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 Liste ausführen.
  • Alle vier Replizierungsagenten löschen
  • Cloud-Dienst löschen
  • MAC-Benutzer löschen
  1. Melden Sie sich bei Ihrer Autoreninstanz für AEM Assets 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 /etc/cloudservices/mediaportal Cloud-Dienstkonfiguration und löschen Sie sie .
  4. Navigieren Sie zum /home/users/mac MAC-Benutzer Ihres Markenportals-Mandanten und löschen Sie ihn.
Sie können jetzt eine Konfiguration in Ihrer AEM 6.5-Autoreninstanz erstellen.
Nach erfolgreicher Replikation können Sie Assets, Ordner und Sammlungen in Brand Portal veröffentlichen. Weitere Details finden Sie unter: