DokumentationAEM 6.4Assets-Anleitung

Konfigurieren von AEM Assets mit Brand Portal configure-integration-64

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
CAUTION
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.

NOTE
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.
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 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 prerequisites

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 aemquickstart

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 servicepack

Detaillierte Anweisungen finden Sie unter

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

Erstellen einer Konfiguration configure-new-integration-64

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
NOTE
Eine AEM Assets-Autoreninstanz darf nur mit einem Brand Portal-Mandanten konfiguriert werden.

Erstellen der IMS-Konfiguration create-ims-configuration

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

Die IMS-Konfiguration umfasst zwei Schritte:

Abrufen eines öffentlichen Zertifikats public-certificate

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 createnewintegration

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 create-ims-account-configuration

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.

CAUTION
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 configure-the-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 test-integration

  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.

    note note
    NOTE
    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.

    note note
    NOTE
    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 upgrade-integration-64

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 verify-jobs

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 delete-existing-configuration

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:

recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad