Konfigurieren von AEM Assets mit Brand Portal

Adobe Experience Manager (AEM) Assets wird über Adobe I/O in Brand Portal konfiguriert. Dadurch wird ein IMS-Token zur Autorisierung Ihres Brand Portal-Mandanten abgerufen.

Hinweis

Die Konfiguration von AEM Assets mit Brand Portal über Adobe I/O wird auf 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 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 eine neue Konfiguration auf Adobe I/O erstellen.
  • Upgrade-Konfiguration: Wenn Sie bereits mit Ihrer AEM Assets-Autoreninstanz, die mit Brand Portal auf dem alten OAuth Gateway konfiguriert wurde, arbeiten, sollten Sie die vorhandenen Konfigurationen löschen und eine neue Adobe auf der E/A-Mail-Benutzeroberfläche 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

Herunterladen und Installieren des neuesten AEM Service Packs

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

Ausführliche Anweisungen finden Sie unter

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

Erstellen der Konfiguration

Führen Sie die folgenden Schritte in der aufgeführten Reihenfolge durch, wenn Sie AEM Assets zum ersten Mal mit dem Markenportal konfigurieren:

  1. Abrufen eines öffentlichen Zertifikats
  2. Erstellen der 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 Markenportal-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

Ein öffentliches Zertifikat ermöglicht Ihnen die Authentifizierung Ihres Profils in Adobe I/O.

  1. Anmelden bei Ihrer AEM Assets-AutoreninstanzStandard-URL: http:// localhost:4502/aem/start.html

  2. From Tools Tools panel, navigate to Security >> Adobe IMS Configurations.

    Benutzeroberfläche der Adobe IMS-Kontokonfiguration

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

    Klicken Sie auf Erstellen.

    This will take you to the Adobe IMS Technical Account Configuration page.

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

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

  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. 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 die Adobe I/O-Integration zu erstellen.

    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.

    Open a new tab and Create Adobe I/O integration to get the integration details for IMS Account configurations.

Erstellen der Adobe I/O-Integration

Die Adobe-I/O-Integration generiert API-Schlüssel, Client-Geheimnis 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, den Client-Geheimnisschlüssel und die JWT-Payload ein, die Sie am Ende von Erstellen der 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.

ACHTUNG

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. Bei Ihrer AEM Assets-Autoreninstanz anmelden

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

  2. From Tools Tools panel, navigate to 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 Markenportal-Mandanten integriert.

Testen der Konfiguration

  1. Bei Ihrer AEM Assets-Autoreninstanz anmelden

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

  2. From Tools Tools panel, navigate to Deployment >> Replication.

  3. Die Replikationsseite wird geöffnet.

    Klicken Sie auf Agenten beim Autor.

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

    Suchen Sie die Replizierungsagenten Ihres Markenportal-Mandanten.

    Klicken Sie auf die Replizierungsagenten-URL.

    Hinweis

    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. To verify the connection between AEM Assets author and Brand Portal, click Test Connection.

  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 Replizierungsagenten 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 Replizierungsagenten so konfiguriert sind, dass kein Timeout-Fehler auftritt. See troubleshoot issues in parallel publishing to Brand Portal.

Markenportal wurde erfolgreich mit Ihrer AEM Assets-Autoreninstanz konfiguriert. Sie können jetzt:

Upgrade der Konfiguration

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

  1. Ausführen von Aufträgen überprüfen
  2. Vorhandene Konfigurationen löschen
  3. Konfiguration erstellen

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 alle vier Replizierungsagenten überprüfen und sicherstellen, dass die Warteschlange ideal/leer ist.

  1. Bei Ihrer AEM Assets-Autoreninstanz anmelden

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

  2. From Tools Tools panel, navigate to Deployment >> Replication.

  3. Die Replikationsseite wird geöffnet.

    Klicken Sie auf Agenten beim 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 Liste die folgende Prüfung ausführen.

  • Alle vier Replizierungsagenten 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 allen vier Replizierungsagenten Ihres Markenportal-Mandanten /etc/replications/agents.author und löschen Sie sie.

  3. Navigieren Sie zur Konfiguration /etc/cloudservices/mediaportal des Cloud Service 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 für Ihre AEM 6.4 Autoreninstanz auf der 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