Konfigurieren von AEM Assets mit Brand Portal

Letzte Aktualisierung: 2023-05-04
  • Erstellt für:
  • Admin
VORSICHT

AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Adobe Experience Manager Assets wird mit Brand Portal über konfiguriert. Adobe I/O, wodurch ein IMS-Token zur Autorisierung Ihres Brand Portal-Mandanten abgerufen wird.

HINWEIS

Konfigurieren von AEM Assets mit Brand Portal über Adobe I/O wird in AEM 6.4.8.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.

TIPP

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 I/O.

In diesem Hilfeartikel werden die folgenden beiden 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 eine neue Konfiguration in Adobe I/O.
  • Upgrade der Konfiguration: Wenn Sie bereits ein Brand Portal-Benutzer sind und Ihre AEM Assets-Autoreninstanz mit Brand Portal auf dem alten OAuth Gateway konfiguriert ist, wird empfohlen, die vorhandenen Konfigurationen zu löschen und eine neue Konfiguration auf Adobe I/O.

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.4

Laden Sie das aktuelle AEM Service Pack herunter und installieren Sie es

Herunterladen und Installieren von AEM 6.4

Es wird empfohlen, AEM 6.4 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

Detaillierte Anweisungen finden Sie unter

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

Erstellen einer Konfiguration

Führen Sie die folgenden Schritte in der angegebenen Reihenfolge aus, wenn Sie AEM Assets zum ersten Mal mit Brand Portal konfigurieren:

  1. Abrufen eines öffentlichen Zertifikats
  2. Erstellen Adobe I/O Integration
  3. Erstellen der Konfiguration des IMS-Kontos
  4. Konfigurieren von Cloud Service
  5. Testen der Konfiguration
HINWEIS

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

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 bei Adobe I/O.

  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an. Standard-URL: http:// localhost:4502/aem/start.html

  2. Von Instrumente Instrumente Bedienfeld, navigieren Sie zu Sicherheit >> Adobe IMS-Konfigurationen.

    Benutzeroberfläche der Adobe IMS-Kontokonfiguration

  3. Die Seite für Adobe IMS-Konfigurationen wird geöffnet.

    Klicken Sie auf Erstellen.

    Dadurch gelangen Sie zum Technische Kontokonfiguration für Adobe IMS Seite.

  4. Standardmäßig wird die Registerkarte Zertifikat geöffnet.

    Wählen Sie in Cloud-Lösung die Option Adobe Brand Portal aus.

  5. Markieren Sie das Kontrollkästchen Neues Zertifikat erstellen und geben Sie eine alias für das Zertifikat. Der Alias dient als Name des Dialogfelds.

  6. Klicken Sie auf Zertifikat erstellen. Ein Dialogfeld wird angezeigt. Klicken Sie auf OK, um das öffentliche Zertifikat zu generieren.

    Zertifikat erstellen

  7. Klicken Sie auf Öffentlichen Schlüssel herunterladen und speichern Sie die Zertifikatdatei AEM-Adobe-IMS.crt auf Ihrem Computer. Die Zertifikatdatei wird verwendet, um erstellen Adobe I/O Integration.

    Zertifikat herunterladen

  8. Klicken Sie auf Weiter.

    Um auf der Registerkarte Konto das Adobe IMS-Konto zu erstellen, benötigen Sie die Integrationsdetails. Lassen Sie diese Seite vorerst offen.

    Öffnen Sie eine neue Registerkarte und Erstellen Adobe I/O Integration um die Integrationsdetails für IMS-Kontokonfigurationen abzurufen.

Erstellen Adobe I/O Integration

Adobe I/O -Integration generiert API-Schlüssel, Client Secret und Payload (JWT), die zum Einrichten der IMS-Kontokonfigurationen erforderlich sind.

  1. Anmelden bei Adobe I/O Konsole mit Systemadministrator-Berechtigungen für die IMS-Organisation des Brand Portal-Mandanten.

    Standard-URL: https://console.adobe.io/

  2. Klicken Sie auf Integration erstellen.

  3. Wählen Sie Auf API zugreifen aus und klicken Sie auf Weiter.

    Neue Integration erstellen

  4. Eine neue Integrationsseite wird geöffnet.

    Wählen Sie Ihre Organisation aus der Dropdown-Liste aus.

    Wählen Sie in Experience Cloud den Eintrag AEM Brand Portal aus und klicken Sie auf Weiter.

    Wenn die Option „Brand Portal“ für Sie deaktiviert ist, stellen Sie sicher, dass Sie die richtige Organisation aus dem Dropdown-Feld über der Option Adobe Services ausgewählt haben. Wenn Sie Ihre Organisation nicht kennen, wenden Sie sich an Ihren Administrator.

    Integration erstellen

  5. Geben Sie einen Namen und eine Beschreibung für die Integration an. Klicken Sie auf Eine Datei von Ihrem Computer auswählen und laden Sie die AEM-Adobe-IMS.crt-Datei hoch, die im Abschnitt Öffentliche Zertifikate erhalten heruntergeladen wurde.

  6. Wählen Sie das Profil Ihrer Organisation aus.

    Sie können auch das Standardprofil Assets Brand Portal auswählen und auf Integration erstellen klicken. Die Integration wird erstellt.

  7. Klicken Sie auf Weiter zu Integrationsdetails, um die Integrationsinformationen anzuzeigen.

    Kopieren Sie den API-Schlüssel.

    Klicken Sie auf Client-Geheimnis abrufen und kopieren Sie den Client-Geheimnisschlüssel.

    API-Schlüssel, Client-Geheimnis und Payload-Daten einer Integration

  8. Navigieren Sie zur Registerkarte JWT und kopieren Sie die JWT-Payload.

    API-Schlüssel, Client-Geheimnisschlüssel und JWT-Payload-Informationen werden verwendet, um eine IMS-Kontokonfiguration zu erstellen.

Erstellen der Konfiguration des IMS-Kontos

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

Schritte zum Erstellen der Konfiguration des IMS-Kontos:

  1. Öffnen Sie die Seite „IMS-Konfiguration“, Registerkarte Konten. Sie haben die Seite am Ende des Abschnitts Abrufen eines öffentlichen Zertifikats geöffnet gelassen.

  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, das Client Secret und die JWT-Payload ein, die Sie am Ende von Erstellen Adobe I/O Integration.

    Klicken Sie auf Erstellen.

    Die Integration wird erstellt.

    IMS-Kontokonfiguration

  3. Wählen Sie die IMS-Konfiguration aus und klicken Sie auf Systemdiagnose. Das folgende Dialogfeld wird angezeigt.

    Klicken Sie auf Prüfen. Bei erfolgreicher Verbindung wird die Meldung Token erfolgreich abgerufen angezeigt.

VORSICHT

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 eine Cloud Service-Konfiguration für Brand Portal zu erstellen:

  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an

    Standard-URL: http:// localhost:4502/aem/start.html

  2. Von Instrumente Instrumente Bedienfeld, navigieren Sie zu Cloud Services > > AEM Brand Portal.

    Die Seite zur Brand Portal-Konfiguration wird geöffnet.

  3. Klicken Sie auf Erstellen.

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

    Wählen Sie die im Schritt erstellte IMS-Konfiguration aus und erstellen Sie die IMS-Kontokonfiguration.

    Geben Sie in Dienst-URL Ihre Brand Portal-Mandanten-URL ein.

  5. Klicken Sie auf Speichern und schließen. Die Cloud-Konfiguration wird erstellt. Ihre AEM Assets-Autoreninstanz ist jetzt mit dem Brand Portal-Mandanten integriert.

Testen der Konfiguration

  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an

    Standard-URL: http:// localhost:4502/aem/start.html

  2. Von Instrumente Instrumente Bedienfeld, navigieren Sie zu Bereitstellung > Replikation.

  3. Die Replikationsseite wird geöffnet.

    Klicken Agenten für Autor.

  4. Für jeden Mandanten werden vier Replikationsagenten erstellt.

    Suchen Sie die Replikationsagenten Ihres Brand Portal-Mandanten.

    Klicken Sie auf die Replikationsagenten-URL.

    HINWEIS

    Die Replikationsagenten funktionieren parallel und teilen die Auftragsverteilung gleichmäßig auf, wodurch die Veröffentlichungsgeschwindigkeit im Vergleich zur ursprünglichen Geschwindigkeit vervierfacht wird. 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 Author und Brand Portal zu überprüfen, klicken Sie auf Verbindung testen.

  6. Überprüfen Sie am Ende der Testergebnisse, ob die Replikation erfolgreich war.

  7. Überprüfen Sie die Testergebnisse für alle vier Replikationsagenten einzeln.

    HINWEIS

    Vermeiden Sie das Deaktivieren von Replikationsagenten, da dies dazu führen kann, dass die Replikation einiger Assets fehlschlägt.

    Stellen Sie sicher, dass alle vier Replikationsagenten so konfiguriert sind, dass Zeitüberschreitungsfehler vermieden werden. Siehe Beheben von Problemen beim parallelen Veröffentlichen in Brand Portal.

Brand Portal wurde erfolgreich mit Ihrer AEM Assets-Autoreninstanz konfiguriert. Sie haben nun die folgenden Möglichkeiten:

Upgrade der Konfiguration

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

  1. Überprüfen von laufenden Aufträgen
  2. Löschen von vorhandenen Konfigurationen
  3. Erstellen einer Konfiguration

Überprüfen von laufenden Aufträgen

Stellen Sie sicher, dass in Ihrer AEM Assets-Autoreninstanz kein Veröffentlichungsauftrag ausgeführt wird, bevor Sie Änderungen vornehmen. Dazu können Sie alle vier Replikationsagenten überprüfen und sicherstellen, dass die Warteschlange ideal/leer ist.

  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an

    Standard-URL: http:// localhost:4502/aem/start.html

  2. Von Instrumente Instrumente Bedienfeld, navigieren Sie zu Bereitstellung > Replikation.

  3. Die Replikationsseite wird geöffnet.

    Klicken Agenten für Autor.

  4. Suchen Sie die Replikationsagenten Ihres Brand Portal-Mandanten.

    Stellen Sie sicher, dass für alle Replikationsagenten die Warteschlange im Leerlauf ist und kein Veröffentlichungsauftrag aktiv ist.

Löschen von vorhandenen Konfigurationen

Sie müssen beim Löschen der vorhandenen Konfiguration die folgende Checkliste ausführen.

  • Alle vier Replikationsagenten löschen
  • Cloud-Dienst löschen
  • Mac-Benutzer löschen

Führen Sie die folgenden Schritte aus, um die vorhandene Konfiguration zu löschen:

  1. Melden Sie sich bei Ihrer AEM Assets-Autoreninstanz an und öffnen Sie CRX Lite als Administrator.

    Standard-URL: http:// localhost:4502/crx/de/index.jsp

  2. Navigieren Sie zu /etc/replications/agents.author und löschen Sie alle vier Replikationsagenten Ihres Brand Portal-Mandanten.

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

  4. Navigieren Sie zu /home/users/mac und löschen Sie die Mac-Benutzer Ihres Brand Portal-Mandanten.

Sie können jetzt Konfiguration erstellen auf Ihrer AEM 6.4-Autoreninstanz in Adobe I/O.

Nach erfolgreicher Replikation können Sie Assets, Ordner und Sammlungen in Brand Portal veröffentlichen. Weitere Informationen finden Sie unter:

Auf dieser Seite