Show Menu
THEMEN×

Konfigurieren von AEM Assets mit Brand Portal

Adobe Experience Manager (AEM)-Assets werden über die Adobe Developer Console mit dem Markenportal konfiguriert, wodurch ein IMS-Token zur Autorisierung Ihres Markenportal-Mandanten abgerufen wird.
Wie funktioniert die Konfiguration?
Zum Konfigurieren der AEM Assets-Cloud-Instanz mit einem Markenportal-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 erstellen Sie ein öffentliches Zertifikat (öffentlicher Schlüssel).
  2. Erstellen Sie in Adobe Developer Console ein Projekt für Ihren Markenportal-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 Anmeldeinformationen für das Dienstkonto und die JWT-Nutzdaten ab.
  5. Konfigurieren Sie in der AEM Assets-Cloud-Instanz das IMS-Konto mit den Dienstkontoanmeldeinformationen und der JWT-Payload.
  6. Konfigurieren Sie in der AEM Assets-Cloud-Instanz den Markenportal-Cloud-Dienst mit dem IMS-Konto und dem Markenportal-Endpunkt (Organisations-URL).
  7. Testen Sie die Konfiguration, indem Sie ein Asset aus der AEM Assets-Cloud-Instanz in Brand Portal veröffentlichen.
Ein Markenportal-Mieter darf nur mit einer AEM Assets-Cloud-Instanz konfiguriert werden.
Konfigurieren Sie keinen Markenportal-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 für weitere Abfragen an den Kundendienst .

Erstellen der Konfiguration

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

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 in der Adobe Developer Console authentifizieren.
  1. Melden Sie sich bei Ihrer AEM Assets-Cloud-Instanz an.
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. Klicken Sie auf der Seite "Adobe IMS-Konfigurationen"auf Erstellen .
  4. Sie werden zur Seite "Konfiguration des technischen Adobe IMS-Kontos "weitergeleitet. By default, the Certificate tab opens.
    Wählen Sie die Cloud-Lösung Adobe Brand Portal .
  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. Click Download Public Key and save the certificate (.crt) file on your machine.
    Die Zertifikatdatei wird in weiteren Schritten zum Konfigurieren der API für Ihren Markenportal-Mandanten und zum Generieren von Dienstkontoanmeldeinformationen in der Adobe Developer Console verwendet.
  8. Klicken Sie auf Weiter .
    Auf der Registerkarte " Konto "erstellen Sie das Adobe IMS-Konto, dafür benötigen Sie jedoch die Dienstkontoanmeldeinformationen, die in der Adobe Developer Console generiert werden. Lassen Sie diese Seite vorerst offen.
    Öffnen Sie eine neue Registerkarte und erstellen Sie eine JWT-Verbindung (Dienstkonto) in Adobe Developer Console , um die Anmeldeinformationen und die JWT-Nutzlast zum Konfigurieren des IMS-Kontos abzurufen.

Verbindung zum Erstellen eines Dienstkontos (JWT)

In der Adobe Developer Console werden Projekte und APIs auf Unternehmensebene (Pächter des Markenportals) konfiguriert. Beim Konfigurieren einer API wird eine JWT-Verbindung (Service Account) in der Adobe Developer Console erstellt. Es gibt zwei Methoden zum Konfigurieren der API, indem ein Schlüsselpaar (private und öffentliche Schlüssel) generiert oder ein öffentlicher Schlüssel hochgeladen wird. Um die AEM Assets-Cloud-Instanz mit dem Markenportal zu konfigurieren, müssen Sie ein öffentliches Zertifikat (öffentlichen Schlüssel) in der AEM Assets-Cloud-Instanz generieren und Anmeldeinformationen in 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 Markenportal-Unternehmen verwendet und generiert die Anmeldeinformationen und die JWT-Nutzlast für das Dienstkonto. Diese Anmeldeinformationen werden außerdem zum Konfigurieren des IMS-Kontos in der AEM Assets-Cloud-Instanz verwendet. Nachdem das IMS-Konto konfiguriert wurde, können Sie den Markenportal-Cloud-Dienst in der AEM Assets-Cloud-Instanz konfigurieren.
Führen Sie die folgenden Schritte aus, um die Dienstkontoberechtigungen und die JWT-Nutzlast zu generieren:
  1. Melden Sie sich bei der Adobe Developer Console mit Systemadministrator-Berechtigungen für die IMS-Organisation (Brand Portal-Mandant) an. Die Standardeinstellung ist
    Vergewissern Sie sich, dass Sie die richtige IMS-Organisation (Markenportal-Mieter) aus der Dropdown-Liste (Organisations-Liste) oben rechts ausgewählt haben.
  2. Click Create new project . Ein leeres Projekt wird für Ihre Organisation 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 Projektübersicht auf Hinzufügen API .
  4. Wählen Sie im Fenster Hinzufügen API die Option AEM Brand Portal 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 Ihren ö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 Standardprodukt- Asset-Markenportal aus und klicken Sie auf Speicherkonfiguration .
  8. Wenn die API konfiguriert ist, werden Sie zur API-Übersicht weitergeleitet. Klicken Sie in der linken Navigation unter Berechtigungen auf Dienstkonto (JWT) .
    Sie können die Anmeldeinformationen nach Bedarf Ansicht und andere Aktionen ausführen (JWT-Token generieren, Berechtigungsdetails kopieren, Clientgeheimnis abrufen usw.).
  9. Kopieren Sie auf der Registerkarte " Clientanmeldeinformationen "die Client-ID .
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload .
Sie können jetzt die Client-ID (API-Schlüssel), das Clientgeheimnis und die JWT-Nutzlast verwenden, um das IMS-Konto in der AEM Assets-Cloud-Instanz zu konfigurieren.

IMS-Konto konfigurieren

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 im Abrufen des öffentlichen Zertifikats erstellt haben.
  1. Öffnen Sie die IMS-Konfiguration und navigieren Sie zur Registerkarte " Konten ". Sie haben die Seite geöffnet, während Sie das öffentliche Zertifikat erhalten 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, den Clientschlüssel und die JWT-Nutzlast ein, die Sie beim Erstellen der JWT-Verbindung kopiert haben.
    Klicken Sie auf Erstellen .
    Das IMS-Konto ist konfiguriert.
  3. Select the IMS account configuration and click Check Health .
    Klicken Sie im Dialogfeld auf Aktivieren . 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 Markenportal-Cloud-Dienst zu konfigurieren:
  1. Melden Sie sich bei Ihrer AEM Assets-Cloud-Instanz an.
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. Klicken Sie auf der Seite "Markenportal-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.
    In the Service URL , enter your Brand Portal tenant (organization URL).
  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 die folgenden Schritte aus, um die Konfiguration zu validieren:
  1. Melden Sie sich bei Ihrer AEM Assets-Cloud-Instanz an.
  2. From the Tools panel, navigate to Deployment > Distribution .
  3. Auf der Seite "Distribution"können Sie sehen, dass ein Distributionsagent für das Markenportal bpdistributionagent0 für die Veröffentlichung im Markenportal 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 "Distribution Agent"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 des Distributionsagenten.
Beispielsweise haben wir ein Asset aus AEM Assets in Brand Portal veröffentlicht, um die Konfiguration zu validieren.
  1. Follow the steps (from 1 to 4) as shown in the test connection section and navigate to the distribution agent page.
  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.