Show Menu
THEMEN×

Configure AEM Assets as a Cloud Service with Brand Portal

Durch die Konfiguration des Adobe Experience Manager Assets Brand Portal können Sie genehmigte Markenelemente aus Adobe Experience Manager Assets als Cloud Service-Instanz im Markenportal veröffentlichen und an die Markenportalbenutzer verteilen.
Konfigurationsarbeitsablauf
AEM Assets als Cloud Service wird über die Adobe Developer Console, die ein Adobe Identity Management Services (IMS)-Kontotoken zur Autorisierung des Markenportals-Mandanten erhält, mit dem Markenportal konfiguriert. Es sind Konfigurationen sowohl in AEM Assets als auch in der Adobe Developer Console erforderlich.
  1. Erstellen Sie in AEM Assets ein IMS-Konto und erstellen Sie einen öffentlichen Schlüssel (Zertifikat).
  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 mit dem öffentlichen Schlüssel, um eine Dienstkontenverbindung zu erstellen.
  4. Rufen Sie die Dienstkontoanmeldeinformationen und die JSON Web Token-(JWT-)Nutzlastinformationen ab.
  5. Konfigurieren Sie in AEM Assets das IMS-Konto mit den Dienstkontoanmeldeinformationen und der JWT-Payload.
  6. Konfigurieren Sie in AEM Assets den Markenportal-Cloud-Dienst mit dem IMS-Konto- und Markenportal-Endpunkt (Organisations-URL).
  7. Testen Sie Ihre Konfiguration, indem Sie ein Asset aus AEM Assets in das Markenportal veröffentlichen.
Ein AEM Assets als Cloud Service-Instanz darf nur mit einem Markenportal-Mandanten konfiguriert werden.

Voraussetzungen

Sie benötigen Folgendes, um AEM Assets mit Brand Portal zu konfigurieren:
  • Ein funktionsfähiges AEM Assets als Cloud Service-Instanz
  • URL eines Pächter-Portals
  • Ein Benutzer mit Systemadministrator-Berechtigungen für die IMS-Organisation des Markenportal-Mandanten

Erstellen der Konfiguration

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

Erstellen der IMS-Konfiguration

Die IMS-Konfiguration authentifiziert Ihr AEM Assets als Cloud Service-Instanz beim Markenportal-Mandanten.
Die IMS-Konfiguration umfasst zwei Schritte:

Abrufen eines öffentlichen Zertifikats

Der öffentliche Schlüssel (Zertifikat) authentifiziert Ihr Profil in der Adobe Developer Console.
  1. Melden Sie sich bei AEM Assets 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 . It will redirect to the Adobe IMS Technical Account Configuration page. Standardmäßig wird die Registerkarte Zertifikat geöffnet.
  4. Wählen Sie Adobe Brand Portal in der Dropdown-Liste Cloud-Lösung .
  5. Aktivieren Sie das Kontrollkästchen Neues Zertifikat ​erstellen und geben Sie einen Alias für den öffentlichen Schlüssel an. Der Alias dient als Name des öffentlichen Schlüssels.
  6. Klicken Sie auf Zertifikat erstellen . Then, click OK to generate the public key.
  7. Click the Download Public Key icon and save the public key (.crt) file on your machine.
    Der öffentliche Schlüssel wird später verwendet, um die API für Ihren Markenportal-Mandanten zu konfigurieren und Anmeldeinformationen für das Dienstkonto in der Adobe Developer Console zu generieren.
  8. Klicken Sie auf Weiter .
    Auf der Registerkarte " Konto "wird ein Adobe-IMS-Konto erstellt, für das die Anmeldeinformationen des Dienstkontos erforderlich sind, 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 der Ebene des Markenportals-Mandanten (der Organisation) konfiguriert. Beim Konfigurieren einer API wird eine JWT-Verbindung (Service Account) 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 AEM Assets mit dem Markenportal zu konfigurieren, müssen Sie einen öffentlichen Schlüssel (Zertifikat) in AEM Assets generieren und Anmeldeinformationen in der Adobe Developer Console erstellen, indem Sie den öffentlichen Schlüssel hochladen. Diese Anmeldeinformationen sind erforderlich, um das IMS-Konto in AEM Assets zu konfigurieren. Nachdem das IMS-Konto konfiguriert wurde, können Sie den Markenportal-Cloud-Dienst in 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 https://www.adobe.com/go/devs_console_ui .
    Vergewissern Sie sich, dass Sie die richtige IMS-Organisation (Markenportal-Mieter) aus der Dropdown-Liste (Unternehmen) oben rechts ausgewählt haben.
  2. Klicken Sie auf Neues Projekt erstellen . Für Ihr Unternehmen wird ein leeres Projekt mit einem systemgenerierten Namen erstellt.
    Klicken Sie auf Projekt bearbeiten , um den Projekttitel und die Projektbeschreibung zu aktualisieren, und klicken Sie auf Speichern .
  3. In the Project overview tab, click Add API .
  4. In the Add an API window , select AEM Brand Portal and click Next .
    Stellen Sie sicher, dass Sie Zugriff auf den AEM Brand Portal-Dienst haben.
  5. In the Configure API window, click Upload your public key . Then, click Select a File and upload the public key (.crt file) that you have downloaded in the obtain public certificate section.
    Klicken Sie auf Weiter .
  6. Verify the public key and click Next .
  7. Wählen Sie Assets Brand Portal als Standard-Profil aus und klicken Sie auf Save configuring API .
  8. Nach der Konfiguration der API werden Sie zur Übersichtsseite der API weitergeleitet. From the left navigation under Credentials , click on the Service Account (JWT) option.
    Sie können die Anmeldeinformationen Ansicht und Aktionen wie das Generieren von JWT-Token, das Kopieren von Berechtigungsdetails, das Abrufen des Clientgeheimnisses usw. durchführen.
  9. Kopieren Sie auf der Registerkarte Client-Anmeldedaten die Client-ID .
    Klicken Sie auf Client-Geheimnis abrufen und kopieren Sie das Client-Geheimnis .
  10. Navigate to the Generate JWT tab and copy the JWT Payload information.
You can now use the client ID (API key), client secret, and JWT payload to configure the IMS account in AEM Assets.

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.
  1. Open the IMS Configuration and navigate to the Account tab. You kept the page open while obtaining the public certificate .
  2. Geben Sie einen Titel für das IMS-Konto an.
    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/
    Specify client ID in the API key field, Client Secret , and Payload (JWT payload) that you have copied while creating the service account (JWT) connection .
    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.
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 AEM Assets 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.
    Select the IMS configuration that you created while configuring the IMS account .
    In the Service URL field, specify your Brand Portal tenant (organization) URL.
  5. Klicken Sie auf Speichern und schließen . Die Cloud-Konfiguration wird erstellt.
    Ihr AEM Assets als Cloud Service-Instanz ist jetzt mit dem Markenportal-Mandanten konfiguriert.

Testen der Konfiguration

Führen Sie zur Validierung der Konfiguration folgende Schritte aus:
  1. Melden Sie sich bei AEM Assets an.
  2. Navigieren Sie im Bedienfeld Tool zu Bereitstellung > Verteilung .
    A Brand Portal distribution agent ( bpdistributionagent0 ) is created under Publish to Brand Portal .
  3. Klicken Sie auf In Markenportal veröffentlichen , um den Verteilungsagenten zu öffnen.
    Die Verteilungswarteschlangen finden Sie auf der Registerkarte " Status ".
    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.
  4. Um die Verbindung zwischen AEM Assets als Cloud Service und Markenportal zu überprüfen, klicken Sie auf das Symbol Verbindung testen.
    Es 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.
Sie können jetzt:
See Brand Portal documentation for more information.

Verteilungsprotokolle

Sie können die Verteilungsagenten-Protokolle für den Asset-Veröffentlichungs-Workflow überwachen.
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 Verarbeitungs- und Fehlerprotokolle Ansicht.
Der Verteilungsagenten hat die folgenden Protokolle generiert:
  • INFO: Dies ist ein vom System erstelltes Protokoll, das bei einer erfolgreichen Konfiguration des Distributionsagenten ausgelöst wird.
  • 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 (Anforderung 3): Das System löst eine weitere Anforderung zum Veröffentlichen des AEM Assets-Ordners aus (in dem sich das Asset befindet) und repliziert den Ordner im Markenportal.
Antwort des Verteilungsagenten :
  • queue-bpdistributionagent0 (DSTRQ2): Das Asset wird in Brand Portal veröffentlicht.
  • queue-bpdistributionAgent0 (DSTRQ3): Das System repliziert den AEM Assets-Ordner (mit dem Asset) im Markenportal.
Im obigen Beispiel wird eine zusätzliche Anforderung und Antwort ausgelöst. Das System konnte den übergeordneten Ordner (Hinzufügen Pfad) im Markenportal nicht finden, da das Asset zum ersten Mal veröffentlicht wurde. Daher wurde eine zusätzliche Anforderung ausgelöst, einen übergeordneten Ordner mit demselben Namen im Markenportal zu erstellen, in dem das Asset veröffentlicht wird.
Zusätzliche Anforderungen werden generiert, wenn der übergeordnete Ordner nicht im Markenportal vorhanden ist oder in AEM Assets geändert wurde.