DocumentatieCommerceAEM Assets integratiehandleiding

[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Adobe Commerce-pakketten installeren

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

Gemaakt voor:

  • Gebruiker

Deze integratie voor Commerce maakt synchronisatie van middelen tussen Adobe Commerce en Adobe Experience Manager Assets (AEM Assets) mogelijk. De extensie biedt een set gereedschappen en services voor het beheren van productafbeeldingen, video en andere media-elementen op beide platforms.

Voeg deze extensie toe aan de Commerce-omgeving door de aem-assets-integration PHP-extensie te installeren. U moet Adobe I/O Events for Commerce ook inschakelen en de vereiste gegevens voor communicatie en workflows tussen Adobe Commerce en Adobe Experience Manager Assets genereren.

de vereisten van de Toegang

U hebt de volgende rollen en toestemmingen nodig om de integratie van Commerce met AEM Assets toe te laten.

TIP
Adobe Commerce kan worden gevormd om authentificatie van Adobe te gebruiken IMS.

Workflow voor installatie en configuratie

Installeer het Adobe Commerce-pakket en maak de Commerce-omgeving gereed door de volgende taken uit te voeren:

  1. installeer de Integratie van AEM Assets voor de uitbreiding van Commerce (aem-assets-integration).

  2. vorm de Schakelaar van de Diensten van Commerceom uw instantie van Adobe Commerce en met de diensten te verbinden die gegevens toelaten om tussen Adobe Commerce en AEM Assets worden overgebracht.

  3. Adobe I/O Events voor Commerce configureren

  4. Verificatiegegevens ophalen voor API-toegang

De extensie aem-assets-integration installeren

Installeer de nieuwste versie van de extensie AEM Assets Integration (aem-assets-integration) op een Adobe Commerce-instantie met versie Adobe Commerce 2.4.5+. De uitbreiding wordt geleverd als composer metapack van de { bewaarplaats 0} repo.magento.com.

de infrastructuur van de Wolk

Gebruik deze methode om de extensie AEM Assets Integration te installeren op een Commerce Cloud-instantie.

  1. Schakel op uw lokale werkstation de projectmap voor uw Adobe Commerce over het infrastructuurproject voor de cloud in.

    note note
    NOTE
    Voor informatie over het beheren van het projectmilieu's van Commerce plaatselijk, zie het Leiden takken met CLIin Adobe Commerce op de Gids van de Gebruiker van de Infrastructuur van de Wolk.

  2. Bekijk de omgevingsvertakking voor update met de Adobe Commerce Cloud CLI.

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

  3. Voeg de extensie AEM Assets Integration voor Commerce toe.

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

  4. Pakketafhankelijkheden bijwerken.

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

  5. Wijzigingen in de code voor de bestanden composer.json en composer.lock doorvoeren en uitvoeren.

  6. Voeg de codewijzigingen voor de composer.json - en composer.lock -bestanden toe, wijs deze toe en duw ze naar de cloudomgeving.

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

    Het duwen van de updates stelt het proces van de de wolkenplaatsing van Commercein werking om de veranderingen toe te passen. Controleer de plaatsingsstatus van opstellen logboek.

op-gebouw

Gebruik deze methode om de extensie AEM Assets Integration te installeren voor een instantie op locatie.

  1. Gebruik Composer om de extensie AEM Assets Integration for Commerce toe te voegen aan uw project:

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

  2. Afhankelijkheden bijwerken en de extensie installeren:

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

  3. Upgrade Adobe Commerce:

    code language-shell 
    bin/magento setup:upgrade

  4. Cache wissen:

    code language-shell 
    bin/magento cache:clean
note tip
TIP
Wanneer het opstellen aan productie, overweeg geen gecompileerde code om tijd te besparen. Maak altijd een back-up van uw systeem voordat u wijzigingen aanbrengt.

De Commerce Services Connector configureren

NOTE
De opstelling van de Verbinding van de Diensten van Commerce is een eenmalig proces dat wordt vereist om de diensten van Adobe Commerce SaaSte gebruiken. Als u de connector voor een andere service al hebt geconfigureerd, kunt u de bestaande configuratie weergeven via Commerce Admin door Systems > Services > Commerce Services Connector te selecteren.

Als u gegevens wilt verzenden tussen uw Adobe Commerce-instantie en de services die AEM Assets Integration inschakelen, configureert u de Commerce Services-connector via de beheerfunctie ( System > Services > Commerce Services Connector ).

project SaaS en gegevensruimte ids voor de integratie van AEM Assets {width="600" modal="regular"}

Geef de volgende waarden op in de configuratie

  • API-sleutels voor productie en sandbox voor verificatie
  • Naam gegevensruimte (SaaS-id) voor beveiligde cloudopslag
  • IMS-organisatie-id waar uw Commerce- en AEM Assets-omgevingen zijn ingericht

Voor gedetailleerde instructies, bekijk de de configuratievideo van de Verbinding van de Diensten van Commerce, van zie de 3} documentatie van de Schakelaar van de Diensten van Commerce {.

Wanneer u sparen de configuratie, produceert het systeem SaaS project en gegevensbestand IDs voor uw milieu. Deze waarden zijn vereist om de synchronisatie van bedrijfsmiddelen tussen Adobe Commerce en AEM Assets in te schakelen.

Adobe I/O Events voor Commerce configureren

De integratie van AEM Assets gebruikt de dienst van Adobe I/O Events om de gegevens van de douanegebeurtenis tussen de instantie van Commerce en Experience Cloud te verzenden. De gebeurtenisgegevens worden gebruikt om workflows voor AEM Assets-integratie te coördineren.

Controleer voordat u Adobe I/O Events configureert de configuratie van de RabbitMQ- en Cron-taak voor uw Commerce-project:

NOTE
Voor projecten op versie 2.4.5 van Commerce, moet u de modules van Adobe I/Oinstalleren. In Commerce versie 2.4.6+, worden deze modules automatisch geladen. Voor de AEM Assets-integratie voor Commerce hoeft u alleen de modules te installeren. App Builder-instelling is niet vereist.

Commerce Event-framework inschakelen

Schakel het gebeurtenisframework in via Commerce Admin.

NOTE
App Builder-instellingen zijn alleen vereist als u een aangepaste matching-strategie wilt gebruiken om elementen tussen Commerce en AEM Assets te synchroniseren.

  1. Van Admin, ga Stores > Settings > Configuration > Adobe Services > Adobe I/O Events.

  2. Vouw Commerce events uit.

  3. Stel Enabled in op Yes .

    Adobe I/O Events Commerce Admin configuratie - laat de gebeurtenissen van Commerce {width="600" modal="regular"} toe

  4. Voer de bedrijfsnaam van de handelaar in Merchant ID en de omgevingsnaam in de Environment ID gebieden in. Gebruik bij het instellen van deze waarden alleen alfanumerieke tekens en onderstrepingstekens.

recommendation-more-help

vorm Douane VCL voor het blokkeren van verzoeken

Als u een aangepast VCL-fragment gebruikt om onbekende binnenkomende aanvragen te blokkeren, moet u mogelijk de HTTP-header X-Ims-Org-Idheader opnemen om binnenkomende verbindingen van de AEM Assets Integration for Commerce-service toe te staan.

TIP
U kunt de Fastly CDN module gebruiken om Edge ACL met een lijst van IP adressen tot stand te brengen die u wilt blokkeren.

De volgende aangepaste VCL-fragmentcode (JSON-indeling) toont een voorbeeld met een X-Ims-Org-Id aanvraagkoptekst.

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

Voordat u een op dit voorbeeld gebaseerd fragment maakt, controleert u de waarden om te bepalen of u wijzigingen wilt aanbrengen:

  • name: naam voor het VCL-fragment. In dit voorbeeld wordt de naam blockbyuseragent gebruikt.

  • dynamic : stelt de fragmentversie in. In dit voorbeeld wordt 0 gebruikt. Zie de Snelle fragmenten VCLvoor gedetailleerde informatie van het gegevensmodel.

  • type - Geeft het type VCL-fragment op, dat de locatie van het fragment in de gegenereerde VCL-code bepaalt. In dit voorbeeld wordt recv gebruikt. Zie de Snelle VCL fragmentverwijzingvoor de lijst van fragmenttypes.

  • priority: hiermee wordt bepaald wanneer het VCL-fragment wordt uitgevoerd. In dit voorbeeld wordt prioriteit 5 gebruikt om direct te worden uitgevoerd en te controleren of een beheerdersverzoek afkomstig is van een toegestaan IP-adres.

  • content: Het fragment van VCL-code dat moet worden uitgevoerd, dat het client-IP-adres controleert. Als IP in ACL van Edge is, wordt het geblokkeerd van toegang met een 405 Not allowed fout voor de volledige website. Alle andere client-IP-adressen hebben toegang.

Voor gedetailleerde informatie over het gebruiken van fragmenten VCL om inkomende verzoeken te blokkeren, zie Douane VCL voor het blokkeren van verzoekenin Commerce op de Gids van de Infrastructuur van de Wolk.

style
shade-box

Verificatiegegevens ophalen voor API-toegang

Voor AEM Assets Integration for Commerce zijn OAuth-verificatiereferenties vereist om API-toegang tot de Commerce-instantie te verlenen. Deze gegevens zijn vereist voor het verifiëren van API-aanvragen bij het beheer van middelen met de AEM Assets-integratie.

U genereert de referenties door de integratie aan de Commerce-instantie toe te voegen en deze te activeren.

Integratie toevoegen aan de Commerce-omgeving

  1. Van Admin, ga naar Systeem > Uitbreidingen > Integraties, dan klik Nieuwe Integratie toevoegen.

  2. Voer informatie in over de integratie.

    In de Algemene sectie, specificeer slechts de integratie Naam en E-mail. Gebruik de e-mail voor een Adobe IMS-account met toegang tot de organisatie waar Commerce en Experience Manager Assets zijn geïmplementeerd.

    Integratie van AEM Assets voor de configuratie van Admin van Commerce {width="600" modal="regular"}

  3. Verifieer uw identiteit door te klikken bevestigt Identiteit.

    Het systeem verifieert uw identiteit door verificatie aan Experience Cloud met uw Adobe-id.

  4. API-bronnen configureren.

    1. Klik in het linkerdeelvenster op API .

    2. Selecteer de externe mediabron Catalog > Inventory > Products > External Media .

      Configuratie van de Integratie Admin voor API middelen {width="600" modal="regular"}

  5. Klik op Save.

OAuth-referenties genereren

Voor de pagina van Integraties, produceer de OAuth authentificatiegeloofsbrieven door te klikken activeer voor de integratie van Assets. U hebt deze gegevens nodig om het Commerce-project te registreren bij de Assets Rule Engine-service en om API-aanvragen in te dienen voor het beheer van middelen tussen Adobe Commerce en AEM Assets.

  1. Genereer de referenties op de pagina Integraties door op Activate te klikken.

    activeer de configuratie van Commerce voor de integratie van Assets {width="600" modal="regular"}

  2. Als u de API wilt gebruiken, slaat u de referenties voor de consumentensleutel en het toegangstoken op om verificatie in uw API-client te configureren.

    OAuth geloofsbrieven om API verzoeken {width="600" modal="regular"} voor authentiek te verklaren

  3. Klik op Done.

NOTE
U kunt ook verificatiegegevens genereren met de Adobe Commerce API's. Voor details over dit proces en meer informatie over op OAuth-Gebaseerde authentificatie voor Adobe Commerce, zie op OAuth-Gebaseerde authentificatiein de documentatie van Adobe Developer.

Volgende stap

9c0cde36-aee3-4e49-8ba1-e9342e3cf211