DokumentationCommerceAEM Assets Integrationshandbuch

[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur) und lokale Projekte."}

Installieren von Adobe Commerce-Paketen

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende

Diese Integration für Commerce ermöglicht die Synchronisierung von Assets zwischen Adobe Commerce und Adobe Experience Manager Assets (AEM Assets). Die Erweiterung bietet eine Reihe von Tools und Services zum Verwalten von Produktbildern, Videos und anderen Medien-Assets auf beiden Plattformen.

Fügen Sie diese Erweiterung der Commerce-Umgebung hinzu, indem Sie die aem-assets-integration PHP-Erweiterung installieren. Sie müssen außerdem Adobe I/O Events für Commerce aktivieren und die Anmeldeinformationen generieren, die für die Kommunikation und Workflows zwischen Adobe Commerce und Adobe Experience Manager Assets erforderlich sind.

Zugriffsanforderungen

Sie benötigen die folgenden Rollen und Berechtigungen, um die Integration von Commerce mit AEM Assets zu aktivieren.

TIP
Adobe Commerce kann für die Verwendung von Adobe IMS-Authentifizierung konfiguriert werden.

Installations- und Konfigurationsablauf

Installieren Sie das Adobe Commerce-Paket und bereiten Sie die Commerce-Umgebung vor, indem Sie die folgenden Schritte ausführen:

  1. Installieren Sie die Erweiterung AEM Assets Integration for Commerce (aem-assets-integration).

  2. Konfigurieren Sie den Commerce Services Connector, um Ihre Adobe Commerce-Instanz und mit den Services zu verbinden, die die Übertragung von Daten zwischen Adobe Commerce und AEM Assets ermöglichen.

  3. Konfigurieren von Adobe I/O Events für Commerce

  4. Abrufen von Authentifizierungsdaten für API-Zugriff

Installieren der aem-assets-integration

Installieren Sie die neueste Version der AEM Assets-Integrationserweiterung (aem-assets-integration) auf einer Adobe Commerce-Instanz mit Version Adobe Commerce 2.4.5+. Die Erweiterung wird als Composer-Metapaket aus dem Repository repo.magento.com bereitgestellt.

Cloud-Infrastruktur

Verwenden Sie diese Methode, um die AEM Assets Integration-Erweiterung auf einer Commerce Cloud-Instanz zu installieren.

  1. Wechseln Sie auf Ihrer lokalen Workstation in das Projektverzeichnis für Ihr Adobe Commerce on Cloud-Infrastrukturprojekt.

    note note
    NOTE
    Informationen zur lokalen Verwaltung von Commerce-Projektumgebungen finden Sie unter Verwalten von Verzweigungen mit der CLI im Benutzerhandbuch für Adobe Commerce auf Cloud-Infrastruktur.

  2. Checken Sie die Umgebungsverzweigung aus, um sie mithilfe der Adobe Commerce Cloud-CLI zu aktualisieren.

    code language-shell 
    magento-cloud environment:checkout <environment-id>

  3. Fügen Sie die Erweiterung AEM Assets Integration for Commerce hinzu.

    code language-shell 
    composer require "magento/aem-assets-integration" "<version-tbd>" --no-update

  4. Paketabhängigkeiten aktualisieren.

    code language-shell 
    composer update "magento/aem-assets-integration"

  5. Code-Änderungen für composer.json und composer.lock übertragen und übertragen.

  6. Fügen Sie die Code-Änderungen für die composer.json- und composer.lock-Dateien hinzu, übertragen Sie sie und übertragen Sie sie in die Cloud-Umgebung.

    code language-shell 
    git add -A
git commit -m "Install AEM Assets Integration extension for Adobe Commerce"
git push origin <branch-name>

    Durch das Pushen der Aktualisierungen wird der Commerce-Cloud-Bereitstellungsprozess zum Anwenden der Änderungen initiiert. Überprüfen Sie den Bereitstellungsstatus im Bereitstellungsprotokoll.

On-Premises

Verwenden Sie diese Methode, um die AEM Assets Integration-Erweiterung für eine lokale Instanz zu installieren.

  1. Verwenden Sie Composer, um Ihrem Projekt die Erweiterung AEM Assets Integration for Commerce hinzuzufügen:

    code language-shell 
    composer require "magento/aem-assets-integration" --no-update

  2. Aktualisieren Sie die Abhängigkeiten und installieren Sie die Erweiterung:

    code language-shell 
    composer update  "magento/aem-assets-integration"

  3. Adobe Commerce aktualisieren:

    code language-shell 
    bin/magento setup:upgrade

  4. Löschen Sie den Cache:

    code language-shell 
    bin/magento cache:clean
note tip
TIP
Wenn Sie in der Produktion bereitstellen, sollten Sie den kompilierten Code nicht löschen, um Zeit zu sparen. Erstellen Sie immer eine Systemsicherung, bevor Sie Änderungen vornehmen.

Konfigurieren des Commerce Services-Connectors

NOTE
Die Einrichtung des Commerce Services-Connectors ist ein einmaliger Prozess, der für die Verwendung von Adobe Commerce SaaS-Services erforderlich. Wenn Sie den Connector bereits für einen anderen Service konfiguriert haben, können Sie die vorhandene Konfiguration über den Commerce-Admin anzeigen, indem Sie Systems > Services > Commerce Services Connector auswählen.

Um Daten zwischen Ihrer Adobe Commerce-Instanz und den Services zu übertragen, die die AEM Assets-Integration aktivieren, konfigurieren Sie den Commerce Services Connector über die Admin Console (System > Services > Commerce Services Connector).

SaaS-Projekt- und Datenspeicher-IDs für die AEM Assets-Integration {width="600" modal="regular"}

Geben Sie in der Konfiguration die folgenden Werte an

  • Produktions- und Sandbox-API-Schlüssel für die Authentifizierung
  • Name des Datenspeichers (SaaS-Kennung) für sicheren Cloud-Speicher
  • IMS-Organisations-ID, unter der Ihre Commerce- und AEM Assets-Umgebungen bereitgestellt werden

Detaillierte Anweisungen finden Sie im Video zur Konfiguration von Commerce Services Connector in der Dokumentation zu Commerce Services Connector.

Wenn Sie die Konfiguration speichern, generiert das System die SaaS-Projekt- und Datenbank-IDs für Ihre Umgebung. Diese Werte sind erforderlich, um die Synchronisierung von Assets zwischen Adobe Commerce und AEM Assets zu aktivieren.

Konfigurieren von Adobe I/O Events für Commerce

Die AEM Assets-Integration verwendet den Adobe I/O Events-Service zum Senden benutzerdefinierter Ereignisdaten zwischen der Commerce-Instanz und Experience Cloud. Die Ereignisdaten werden zur Koordinierung von Workflows für die AEM Assets-Integration verwendet.

Bevor Sie Adobe I/O Events konfigurieren, überprüfen Sie die RabbitMQ- und Cron-Auftragskonfiguration für Ihr Commerce-Projekt:

NOTE
Für Projekte mit Commerce Version 2.4.5 müssen Sie die Adobe I/O-Module installieren. In Commerce ab Version 2.4.6 werden diese Module automatisch geladen. Für die AEM Assets-Integration für Commerce müssen Sie nur die -Module installieren. App Builder-Setup ist nicht erforderlich.

Aktivieren des Commerce Eventing-Frameworks

Aktivieren Sie das Ereignis-Framework über den Commerce-Administrator.

NOTE
Die App Builder-Einrichtung ist nur erforderlich, wenn Sie eine benutzerdefinierte Abgleichstrategie zum Synchronisieren von Assets zwischen Commerce und AEM Assets verwenden möchten.

  1. Navigieren Sie vom Administrator aus zu Stores > Settings > Configuration > Adobe Services > Adobe I/O Events.

  2. Erweitern Sie Commerce events.

  3. Legen Sie Enabled auf Yes fest.

    Adobe I/O Events Commerce-Admin-Konfiguration - Commerce-Ereignisse aktivieren {width="600" modal="regular"}

  4. Geben Sie den Namen des Händlerunternehmens in die Merchant ID und den Umgebungsnamen in die Environment ID Felder ein. Verwenden Sie beim Festlegen dieser Werte nur alphanumerische Zeichen und Unterstriche.

recommendation-more-help

Benutzerdefinierte VCL für Blockierungsanfragen konfigurieren

Wenn Sie ein benutzerdefiniertes VCL-Fragment verwenden, um unbekannte eingehende Anfragen zu blockieren, müssen Sie möglicherweise den HTTP-Header X-Ims-Org-Idheader einbeziehen, um eingehende Verbindungen vom AEM Assets Integration for Commerce-Service zuzulassen.

TIP
Sie können das Fastly CDN-Modul verwenden, um eine Edge-ACL mit einer Liste von IP-Adressen zu erstellen, die Sie blockieren möchten.

Der folgende benutzerdefinierte VCL-Code-Ausschnitt (JSON-Format) zeigt ein Beispiel mit einer X-Ims-Org-Id-Anfragekopfzeile.

{
  "name": "blockbyuseragent",
  "dynamic": "0",
  "type": "recv",
  "priority": "5",
  "content": "if ( req.http.X-ims-org ~ \"<YOUR-IMS-ORG>\" ) {error 405 \"Not allowed\";}"
}

Bevor Sie einen Ausschnitt basierend auf diesem Beispiel erstellen, überprüfen Sie die Werte, um festzustellen, ob Sie Änderungen vornehmen müssen:

  • name: Name für den VCL-Code-Ausschnitt. In diesem Beispiel wird der Name blockbyuseragent verwendet.

  • dynamic: Legt die Ausschnittversion fest. Dieses Beispiel verwendet 0. Detaillierte Informationen zu Datenmodellen finden Sie Fastly VCLSnippets).

  • type: Gibt den Typ des VCL-Ausschnitts an, der die Position des Ausschnitts im generierten VCL-Code bestimmt. Dieses Beispiel verwendet recv. Eine Liste der SnippetTypen finden Sieder Snippet-Referenz Fastly VCL .

  • priority: Bestimmt, wann der VCL-Snippet ausgeführt wird. In diesem Beispiel wird die 5 verwendet, um sofort auszuführen und zu überprüfen, ob eine Admin-Anfrage von einer zulässigen IP-Adresse stammt.

  • content: Der auszuführende VCL-Code-Ausschnitt, der die Client-IP-Adresse prüft. Wenn sich die IP in der Edge-ACL befindet, wird der Zugriff für die gesamte Website mit einem 405 Not allowed blockiert. Alle anderen Client-IP-Adressen erhalten Zugriff.

Ausführliche Informationen zur Verwendung von VCL-Snippets zum Blockieren eingehender Anfragen finden Sie unter Benutzerdefiniertes VCL für Blockieranfragen im Handbuch zu Commerce in Cloud Infrastructure.

style
shade-box

Abrufen von Authentifizierungsdaten für API-Zugriff

Die AEM Assets-Integration für Commerce erfordert OAuth-Authentifizierungsberechtigungen, um API-Zugriff auf die Commerce-Instanz zu ermöglichen. Diese Anmeldeinformationen sind erforderlich, um API-Anfragen zu authentifizieren, wenn Sie Assets mit der AEM Assets-Integration verwalten.

Sie generieren die Anmeldeinformationen, indem Sie die Integration zur Commerce-Instanz hinzufügen und aktivieren.

Integration zur Commerce-Umgebung hinzufügen

  1. Gehen Sie von der Admin aus zu System > Erweiterungen > Integrationen und klicken Sie dann auf Neue Integration hinzufügen.

  2. Geben Sie Informationen zur Integration ein.

    Geben Sie im Abschnitt Allgemein nur die Integration Name und Email an. Verwenden Sie die E-Mail-Adresse für ein Adobe IMS-Konto mit Zugriff auf das Unternehmen, in dem Commerce und Experience Manager Assets bereitgestellt werden.

    AEM Assets-Integration für Commerce-Admin-Konfiguration {width="600" modal="regular"}

  3. Überprüfen Sie Ihre Identität, indem Sie auf Identität bestätigen klicken.

    Das System überprüft Ihre Identität, indem es sich mit Ihrer Adobe-ID bei Experience Cloud authentifiziert.

  4. Konfigurieren von API-Ressourcen.

    1. Klicken Sie im linken Bedienfeld auf API.

    2. Wählen Sie die Catalog > Inventory > Products > External Media Externe Medienressource aus.

      Admin-Integrationskonfiguration für API-Ressourcen {width="600" modal="regular"}

  5. Klicken Sie auf Save.

OAuth-Anmeldeinformationen generieren

Generieren Sie auf der Seite Integrationen die OAuth-Authentifizierungsberechtigungen, indem Sie für Assets-Integration auf Aktivieren“ klicken. Sie benötigen diese Anmeldeinformationen, um das Commerce-Projekt beim Assets Rule Engine Service zu registrieren und API-Anfragen zum Verwalten von Assets zwischen Adobe Commerce und AEM Assets zu senden.

  1. Generieren Sie auf der Seite Integrationen die Anmeldeinformationen, indem Sie auf Activate klicken.

    Aktivieren der Commerce-Konfiguration für die Assets-Integration {width="600" modal="regular"}

  2. Wenn Sie die API verwenden möchten, speichern Sie die Anmeldeinformationen für den Consumer-Schlüssel und das Zugriffstoken, um die Authentifizierung in Ihrem API-Client zu konfigurieren.

    OAuth-Anmeldeinformationen zum Authentifizieren von API-Anfragen {width="600" modal="regular"}

  3. Klicken Sie auf Done.

NOTE
Sie können Authentifizierungsdaten auch mithilfe der Adobe Commerce-APIs generieren. Weitere Informationen zu diesem Prozess und weitere Informationen zur OAuth-basierten Authentifizierung für Adobe Commerce finden Sie unter OAuth-basierte Authentifizierung in der Dokumentation zu Adobe Developer.

Nächster Schritt

7d6707fb-4d59-44b9-ab2a-b69de39eb44d