Konfigurieren von AEM Assets mit Brand Portal

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

HINWEIS

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

In dieser Hilfe 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 erstellen 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 für Adobe I/Ozu 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.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

Wenden Sie sich an den Support, wenn Sie das neueste AEM oder Service Pack nicht finden können.

Konfiguration erstellen

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. Adobe I/O Integration erstellen
  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 auf Adobe I/O authentifizieren.

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

  2. Navigieren Sie im Bedienfeld Tools Tools 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 zur Seite Technische Kontokonfiguration für Adobe IMS.

  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 einen Alias für das Zertifikat an. 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 für create Adobe I/O integration verwendet.

    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.

Integration von Adobe I/O erstellen

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

  1. Melden Sie sich bei der Adobe I/O-Konsole mit Systemadministrator-Berechtigungen für die IMS-Organisation des Brand Portal-Mandanten an.

    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 Create Adobe I/O integration kopiert haben.

    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. Navigieren Sie im Bedienfeld Tools Tools 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. Navigieren Sie im Bedienfeld Tools Tools zu Bereitstellung >> Replikation.

  3. Die Replikationsseite wird geöffnet.

    Klicken Sie auf 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 arbeiten parallel und teilen die Auftragsverteilung gleichmäßig, wodurch die Veröffentlichungsgeschwindigkeit um das Vierfache der ursprünglichen Geschwindigkeit gesteigert 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. Sehen Sie sich den unteren Bereich der Testergebnisse an, um zu prüfen, ob die Replikation erfolgreich war.

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

    HINWEIS

    Vermeiden Sie es, einen der Replikationsagenten zu deaktivieren, da dies dazu führen kann, dass die Replikation einiger Assets fehlschlägt.

    Stellen Sie sicher, dass alle vier Replikationsagenten konfiguriert sind, um Timeout-Fehler zu vermeiden. Siehe Fehlerbehebung bei 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. Ausführungsaufträge überprüfen
  2. Vorhandene Konfigurationen löschen
  3. Konfiguration erstellen

Ausführungsaufträge überprüfen

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. Navigieren Sie im Bedienfeld Tools Tools zu Bereitstellung >> Replikation.

  3. Die Replikationsseite wird geöffnet.

    Klicken Sie auf Agenten für Autor.

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

    Stellen Sie sicher, dass die Warteschlange für alle Replikationsagenten Idle lautet. Es ist kein Veröffentlichungsauftrag aktiv.

Vorhandene Konfigurationen löschen

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 den MAC-Benutzer Ihres Brand Portal-Mandanten.

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

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

Auf dieser Seite