Show Menu
THEMEN×

Konfigurieren von AEM Assets mit Brand Portal

Adobe Experience Manager (AEM) Assets wird über die Adobe Developer Console mit Brand Portal konfiguriert. Dadurch wird ein IMS-Token zur Autorisierung Ihres Brand Portal-Mandanten abgerufen.
Wie funktioniert die Konfiguration?
Zum Konfigurieren der AEM Assets-Cloud-Instanz mit einem Brand Portal-Mandanten (Unternehmen) sind Konfigurationen sowohl in der AEM Assets-Cloud-Instanz als auch in der Adobe Developer Console erforderlich.
  1. Erstellen Sie in der AEM Assets-Cloud-Instanz ein IMS-Konto und in öffentliches Zertifikat (einen öffentlichen 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 der AEM Assets-Cloud-Instanz das IMS-Konto mit den Anmeldedaten für das Dienstkonto und die JWT-Payload.
  6. Konfigurieren Sie in der AEM Assets-Cloud-Instanz den Brand Portal-Cloud Service mit dem IMS-Konto und dem Brand Portal-Endpunkt (Organisations-URL).
  7. Testen Sie die Konfiguration, indem Sie ein Asset aus der AEM Assets-Cloud-Instanz in Brand Portal veröffentlichen.
Ein Brand Portal-Mandant darf nur mit einer AEM Assets-Cloud-Instanz konfiguriert werden.
Konfigurieren Sie keinen Brand Portal-Mandanten mit mehreren AEM Assets-Cloud-Instanzen.

Voraussetzungen

Sie benötigen Folgendes, um AEM Assets mit Brand Portal zu konfigurieren:
  • Eine AEM Assets-Cloud-Instanz, die ausgeführt wird.
  • Brand Portal-Mandanten-URL
  • Ein Benutzer mit Systemadministrator-Berechtigungen für die IMS-Organisation des Brand Portal-Mandanten
Wenden Sie sich mit weiteren Fragen an die Kundenunterstützung .

Erstellen der Konfiguration

Führen Sie die folgenden Schritte in der angegebenen Reihenfolge aus, um die AEM Assets-Cloud-Instanz mit Brand Portal zu konfigurieren.

Erstellen der IMS-Konfiguration

Die IMS-Konfiguration authentifiziert Ihren Brand Portal-Mandanten bei der Cloud-Instanz von AEM Assets.
Die IMS-Konfiguration umfasst zwei Schritte:

Abrufen eines öffentlichen Zertifikats

Ein öffentliches Zertifikat ermöglicht Ihnen die Authentifizierung Ihres Profils in der Adobe Developer Console.
  1. Melden Sie sich bei Ihrer AEM Assets-Cloud-Instanz an.
  2. Navigieren Sie im Bedienfeld Tools zu Sicherheit > Adobe IMS-Konfigurationen .
  3. Klicken Sie auf der Seite mit den Adobe IMS-Konfigurationen auf Erstellen .
  4. Sie gelangen auf die Seite für die Konfiguration des technischen Adobe IMS-Kontos . Standardmäßig wird die Registerkarte Zertifikat geöffnet.
    Wählen Sie die Cloud-Lösung 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 . Klicken Sie dann im Dialogfeld auf OK , um das öffentliche Zertifikat zu generieren.
  7. Klicken Sie auf Öffentlichen Schlüssel herunterladen und speichern Sie die Zertifikatdatei (.crt) auf Ihrem Computer.
    Die Zertifikatdatei wird in weiteren Schritten zum Konfigurieren der API für Ihren Brand Portal-Mandanten und zum Generieren von Anmeldedaten für Dienstkonten in der Adobe Developer Console verwendet.
  8. Klicken Sie auf Weiter .
    Erstellen Sie auf der Registerkarte Konto das Adobe IMS-Konto. Dafür benötigen Sie jedoch die Anmeldedaten für Dienstkonten, 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 Unternehmensebene (Brand Portal-Mandant) konfiguriert. Beim Konfigurieren einer API wird eine JWT-Verbindung (Dienstkonto) in der Adobe Developer Console 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 die AEM Assets-Cloud-Instanz mit Brand Portal zu konfigurieren, müssen Sie ein öffentliches Zertifikat (öffentlichen Schlüssel) in der AEM Assets-Cloud-Instanz generieren und Anmeldedaten in der Adobe Developer Console erstellen, indem Sie den öffentlichen Schlüssel hochladen. Dieser öffentliche Schlüssel wird zum Konfigurieren der API für das ausgewählte Brand Portal-Unternehmen verwendet und generiert die Anmeldedaten und die JWT-Payload für das Dienstkonto. Diese Anmeldedaten werden außerdem zum Konfigurieren des IMS-Kontos in der AEM Assets-Cloud-Instanz verwendet. Sobald das IMS-Konto konfiguriert ist, können Sie den Brand Portal-Cloud Service in der Cloud-Instanz von 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
    Vergewissern Sie sich, dass Sie die richtige IMS-Organisation (Brand Portal-Mandant) aus der Dropdown-Liste (Organisationsliste) oben rechts ausgewählt haben.
  2. Klicken Sie auf Neues Projekt erstellen . Für Ihre Organisation wird ein leeres Projekt erstellt.
    Klicken Sie auf Projekt bearbeiten , um den Projekttitel und die Projektbeschreibung zu aktualisieren, und klicken Sie auf Speichern .
  3. Klicken Sie auf der Registerkarte mit der Projektübersicht auf API hinzufügen .
  4. Wählen Sie im Fenster „API hinzufügen“ die Option AEM Brand Portal aus und klicken Sie auf Weiter .
    Stellen Sie sicher, dass Sie Zugriff auf den AEM Brand Portal-Dienst haben.
  5. Klicken Sie im Fenster „API konfigurieren“ auf Öffentlichen Schlüssel hochladen . Klicken Sie dann auf Datei auswählen und laden Sie das öffentliche Zertifikat (.crt-Datei) hoch, das Sie im Abschnitt zum Abrufen des öffentlichen Zertifikats heruntergeladen haben.
    Klicken Sie auf Weiter .
  6. Überprüfen Sie das öffentliche Zertifikat und klicken Sie auf Weiter .
  7. Wählen Sie das Standardproduktprofil Assets Brand Portal aus und klicken Sie auf Konfiguration speichern .
  8. Sobald die API konfiguriert ist, werden Sie zur API-Übersicht weitergeleitet. Klicken Sie in der linken Navigation unter Anmeldedaten auf Dienstkonto (JWT) .
    Sie können die Anmeldedaten einsehen und bei Bedarf weitere Aktionen durchführen (JWT-Token generieren, Anmeldedaten kopieren, Client-Geheimnisse abrufen usw.).
  9. Kopieren Sie auf der Registerkarte Client-Anmeldedaten die Client-ID .
    Klicken Sie auf Client-Geheimnis abrufen und kopieren Sie das Client-Geheimnis .
  10. Navigieren Sie zur Registerkarte JWT generieren und kopieren Sie die JWT-Payload .
Sie können jetzt die Client-ID (API-Schlüssel), das Client-Geheimnis und die JWT-Payload verwenden, um das IMS-Konto in der AEM Assets Cloud-Instanz zu konfigurieren .

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, das Sie unter Abrufen des öffentlichen Zertifikats erstellt haben.
  1. Öffnen Sie die IMS-Konfiguration und navigieren Sie zur Registerkarte Konten . Sie haben die Seite offen gelassen, während Sie das öffentliche Zertifikat abgerufen haben.
  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 die Client-ID in den API-Schlüssel, das Client-Geheimnis und die JWT-Payload ein, die Sie beim Erstellen der JWT-Verbindung (Dienstkonto) kopiert haben.
    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. 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 den Brand Portal-Cloud Service zu konfigurieren:
  1. Melden Sie sich bei Ihrer AEM Assets-Cloud-Instanz 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.
    Geben Sie in Dienst-URL Ihre Brand Portal-Mandanten (Organisations)-URL ein.
  5. Klicken Sie auf Speichern und schließen . Die Cloud-Konfiguration wird erstellt. Ihre AEM Assets-Cloud-Instanz ist jetzt mit dem Brand Portal-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. Navigieren Sie im Bedienfeld Tool zu Bereitstellung > Verteilung .
  3. Auf der Seite „Verteilung“ können Sie sehen, dass ein Brand Portal-Verteilungsagent bpdistributionagent0 für die Veröffentlichung in Brand Portal erstellt wurde.
    Klicken Sie auf In Brand Portal veröffentlichen .
    Standardmäßig wird für einen Brand Portal-Mandanten ein Verteilungsagent erstellt.
  4. Auf der Seite des Verteilungsagenten werden die Verteilungswarteschlangen auf der Registerkarte Status angezeigt.
    Ein Verteilungsagent enthält zwei Warteschlangen:
    • Verarbeitungswarteschlange (processing-queue) : für die Verteilung von Assets an Brand Portal.
    • Fehlerwarteschlange (error-queue) : für die Assets, bei denen die Verteilung fehlgeschlagen ist.
    Es wird empfohlen, die Fehler zu überprüfen und die Fehlerwarteschlange regelmäßig zu löschen.
  5. Um die Verbindung zwischen AEM Assets und Brand Portal zu überprüfen, klicken Sie auf Verbindung testen .
    Unten auf der Seite wird eine Meldung angezeigt, dass Ihr Testpaket erfolgreich bereitgestellt wurde.
    Vermeiden Sie das Deaktivieren des Verteilungsagenten, da dies dazu führen kann, dass die Verteilung der Assets (in der Warteschlange) fehlschlägt.
Ihre AEM Assets-Cloud-Instanz wurde erfolgreich mit Brand Portal konfiguriert. Jetzt können Sie Folgendes ausführen:
Darüber hinaus können Sie Metadatenschemata, Bildvorgaben, Suchfacetten und Tags von AEM Assets in Brand Portal veröffentlichen.
Weitere Informationen finden Sie in der Dokumentation zu Brand Portal .

Verteilungsprotokolle

In den Protokollen finden Sie detaillierte Informationen zu den Aktionen, die durch den Verteilungsagenten ausgeführt werden.
Beispielsweise haben wir ein Asset aus AEM Assets in Brand Portal veröffentlicht, um die Konfiguration zu validieren.
  1. Führen Sie die Schritte (1–4) aus, wie im Abschnitt Konfiguration testen gezeigt, und navigieren Sie zur Seite des Verteilungsagenten.
  2. Klicken Sie auf Protokolle , um die Verteilungsprotokolle anzuzeigen. Hier können Sie die Verarbeitungs- und Fehlerprotokolle sehen.
Der Verteilungsagenten generiert die folgenden Protokolle:
  • INFO: Dies ist ein vom System erstelltes Protokoll, das bei einer erfolgreichen Konfiguration ausgelöst wird, die den Verteilungsagenten aktiviert.
  • DSTRQ1 (Anfrage 1): Wird bei der Testverbindung ausgelöst.
Beim Veröffentlichen des Assets werden die folgenden Anfrage- und Antwortprotokolle generiert:
Anfrage des Verteilungsagenten :
  • DSTRQ2 (Anfrage 2): Die Anfrage zur Veröffentlichung des Assets wird ausgelöst.
  • DSTRQ3 (Anfrage 3): Das System löst eine weitere Anfrage zum Veröffentlichen des Ordners aus, in dem sich das Asset befindet, und repliziert den Ordner in Brand Portal.
Antwort des Verteilungsagenten :
  • queue-bpdistributionagent0 (DSTRQ2): Das Asset wird in Brand Portal veröffentlicht.
  • queue-bpdistributionagent0 (DSTRQ3): Das System repliziert den Ordner, der das Asset enthält, in Brand Portal.
Im obigen Beispiel werden eine zusätzliche Anfrage und Antwort ausgelöst. Das System konnte den übergeordneten Ordner (auch als Hinzufügen-Pfad bezeichnet) in Brand Portal nicht finden, da das Asset zum ersten Mal veröffentlicht wurde. Daher wird eine zusätzliche Anfrage ausgelöst, einen übergeordneten Ordner mit demselben Namen in Brand Portal zu erstellen, in dem das Asset veröffentlicht wird.
Es wird eine zusätzliche Anfrage generiert, wenn der übergeordnete Ordner nicht in Brand Portal vorhanden ist (im oben stehenden Beispiel) oder der übergeordnete Ordner in AEM Assets geändert wurde.