Show Menu
THEMEN×

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 dem Brand Portal konfiguriert, das ein Adobe Identity Management Services (IMS)-Kontotoken zur Autorisierung des Markenportal-Mieters abruft.
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.
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
  • URL eines Pächter-Portals
  • Ein Benutzer mit Systemadministrator-Berechtigungen für die IMS-Organisation des Markenportal-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 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 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 aus, wenn Sie AEM Assets mit Markenportal zum ersten Mal konfigurieren:

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 zu Sicherheit > Adobe IMS-Konfigurationen .
  3. Klicken Sie auf der Seite mit den Adobe IMS-Konfigurationen auf Erstellen . It will redirect to the Adobe IMS Technical Account Configuration page. Standardmäßig wird die Registerkarte Zertifikat geöffnet.
  4. Wählen Sie Adobe Brand Portal in der Dropdown-Liste Cloud-Lösung .
  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 . Then, click OK to generate the public key.
  7. Click the Download Public Key icon and save the public key (.crt) file on your machine.
    Der öffentliche Schlüssel 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 .
    Auf der Registerkarte " Konto "wird ein Adobe-IMS-Konto erstellt, für das die Anmeldeinformationen des Dienstkontos erforderlich sind, 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 (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 (Service Account) 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 einen öffentlichen Schlüssel (Zertifikat) in AEM Assets generieren und Anmeldeinformationen in der Adobe Developer Console erstellen, indem Sie den öffentlichen Schlüssel hochladen. Diese Anmeldeinformationen sind erforderlich, um das IMS-Konto in AEM Assets zu konfigurieren. 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 https://www.adobe.com/go/devs_console_ui .
    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 Ihr Unternehmen 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. 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 . Then, click Select a File and upload the public key (.crt file) that you have downloaded in the obtain public certificate section.
    Klicken Sie auf Weiter .
  6. Verify the public key and click Next .
  7. Wählen Sie Assets Brand Portal als Standard-Profil aus und klicken Sie auf Save configuring API .
  8. Nach der Konfiguration der API werden Sie zur Übersichtsseite der API weitergeleitet. From the left navigation under Credentials , click on the Service Account (JWT) option.
    Sie können die Anmeldeinformationen Ansicht und Aktionen wie das Generieren von JWT-Token, das Kopieren von Berechtigungsdetails, das Abrufen des Clientgeheimnisses usw. durchführen.
  9. Kopieren Sie auf der Registerkarte Client-Anmeldedaten die Client-ID .
    Klicken Sie auf Client-Geheimnis abrufen und kopieren Sie das Client-Geheimnis .
  10. Navigate to the Generate JWT tab and copy the JWT Payload information.
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.
    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/ .
    Specify client ID in the API key field, Client Secret , and Payload (JWT payload) that you have copied while creating the service account (JWT) connection .
    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.
    In the Service URL field, specify your Brand Portal tenant (organization) URL.
  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 .
    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.
    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. To verify the connection between AEM Assets and Brand Portal, click on the Test Connection icon.
    Es wird eine Meldung angezeigt, dass Ihr Testpaket erfolgreich bereitgestellt wurde .
  5. Überprüfen Sie die Testergebnisse für alle vier Replizierungsagenten.
    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. See troubleshoot issues in parallel publishing to Brand Portal .
Sie können jetzt:
See Brand Portal documentation for more information.

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:

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 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. 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 des Markenportal-Cloud-Dienstes /etc/cloudservices/mediaportal und löschen Sie sie.
  4. Navigieren Sie zum /home/users/mac MAC-Benutzer Ihres Markenportals-Mandanten und löschen Sie ihn.