DocumentazioneCommerceContenuto e design

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Installare pacchetti Adobe Commerce

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:
  • CMS

Creato per:

  • Principiante
  • Intermedio
  • Amministratore
  • Utente

L'estensione AEM Assets Integration for Commerce (aem-assets-integration) consente la sincronizzazione delle risorse tra Adobe Commerce e Adobe Experience Manager Assets. L’estensione fornisce una serie di strumenti e servizi per gestire le risorse, tra cui immagini di prodotti, video e altre risorse multimediali, su entrambe le piattaforme.

Aggiungere questa estensione all'ambiente Commerce installando l'estensione PHP aem-assets-integration. È inoltre necessario abilitare Adobe I/O Events per Commerce e generare le credenziali necessarie per la comunicazione e i flussi di lavoro tra Adobe Commerce e Adobe Experience Manager Assets.

Requisiti di sistema

L'estensione AEM Assets Integration for Commerce presenta i seguenti requisiti di sistema e configurazione.

Requisiti software

  • Adobe Commerce 2.4.5+
  • Versione PHP compatibile con la versione installata di Adobe Commerce-versione 8.1, 8.2, 8.3 o 8.4)
  • Compositore: 2.x

Requisiti di accesso

Per configurare l’integrazione sono necessari i ruoli e le autorizzazioni seguenti.

TIP
È possibile configurare Adobe Commerce per l'utilizzo dell'autenticazione Adobe IMS.

Flusso di lavoro di installazione e configurazione

Installa il pacchetto Adobe Commerce e prepara l’ambiente Commerce completando le seguenti attività:

  1. Installare l'estensione AEM Assets Integration for Commerce (aem-assets-integration).
  2. Configura Commerce Services Connector per connettere l'istanza Adobe Commerce e i servizi che consentono la trasmissione dei dati tra Adobe Commerce e AEM Assets.
  3. Configurare Adobe I/O Events per Commerce
  4. Ottenere le credenziali di autenticazione per l’accesso API

Installa l'estensione aem-assets-integration

Installa la versione più recente dell'estensione per l'integrazione di AEM Assets (aem-assets-integration) in un'istanza di Adobe Commerce con versione Adobe Commerce 2.4.5+. L'integrazione di AEM Asset viene distribuita come metapacchetto del compositore dall'archivio repo.magento.com.

Infrastruttura cloud

Utilizzare questo metodo per installare l'estensione AEM Assets Integration per un'istanza di Commerce Cloud.

  1. Sulla workstation locale, passa alla directory del progetto per il progetto Adobe Commerce su infrastruttura cloud.

    note note
    NOTE
    Per informazioni sulla gestione locale degli ambienti di progetto Commerce, vedere Gestione dei rami con CLI nella Guida utente di Adobe Commerce on Cloud Infrastructure.

  2. Consulta il ramo dell’ambiente da aggiornare utilizzando Adobe Commerce Cloud CLI.

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

  3. Aggiungi l’estensione AEM Assets Integration for Commerce.

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

  4. Aggiornare le dipendenze del pacchetto.

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

  5. Modifiche al codice di commit e push per i file composer.json e composer.lock.

  6. Aggiungere, eseguire il commit e inviare le modifiche al codice per i file composer.json e composer.lock all'ambiente cloud.

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

    Inviando gli aggiornamenti si avvia il processo di distribuzione cloud di Commerce per applicare le modifiche. Controllare lo stato della distribuzione dal registro distribuzione.

Locale

Utilizzare questo metodo per installare l'estensione AEM Assets Integration per un'istanza locale.

  1. Utilizza Composer per aggiungere al progetto l’estensione AEM Assets Integration for Commerce:

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

  2. Aggiorna le dipendenze e installa l’estensione:

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

  3. Aggiorna Adobe Commerce:

    code language-shell 
    bin/magento setup:upgrade

  4. Cancella la cache:

    code language-shell 
    bin/magento cache:clean
note tip
TIP
Durante la distribuzione in produzione, è consigliabile non cancellare il codice compilato per risparmiare tempo. Eseguire sempre il backup del sistema prima di apportare modifiche.

Configurare Commerce Services Connector

NOTE
L'installazione di Commerce Services Connector è un processo unico necessario per utilizzare i servizi SaaS di Adobe Commerce. Se il connettore è già stato configurato per un altro servizio, è possibile visualizzare la configurazione esistente dall'amministratore di Commerce selezionando Systems > Services > Commerce Services Connector.

Per trasmettere i dati tra l'istanza di Adobe Commerce e i servizi che abilitano l'integrazione di AEM Assets, configurare Commerce Services Connector dall'amministratore (System > Services > Commerce Services Connector).

ID progetto SaaS e spazio dati per integrazione AEM Assets {width="600" modal="regular"}ed

Immetti i seguenti valori nella configurazione

  • Chiavi API di produzione e sandbox per l’autenticazione
  • Nome dello spazio dati (identificatore SaaS) per l’archiviazione cloud sicura
  • ID organizzazione IMS in cui viene eseguito il provisioning degli ambienti Commerce e AEM Assets

Per istruzioni dettagliate, guarda il video sulla configurazione di Commerce Services Connector e la documentazione di Commerce Services Connector.

Quando salvi la configurazione, il sistema genera gli ID del progetto SaaS e del database per il tuo ambiente. Questi valori sono necessari per abilitare la sincronizzazione delle risorse tra Adobe Commerce e AEM Assets.

Configurare Adobe I/O Events per Commerce

L’integrazione di AEM Assets utilizza il servizio Adobe I/O Events per inviare dati evento personalizzati tra l’istanza di Commerce e Experience Cloud. I dati dell’evento vengono utilizzati per coordinare i flussi di lavoro per l’integrazione AEM Assets.

Prima di configurare Adobe I/O Events, verifica la configurazione del processo RabbitMQ e cron per il progetto Commerce:

NOTE
Per i progetti in Commerce versione 2.4.5, è necessario installare i moduli Adobe I/O. In Commerce versione 2.4.6+, questi moduli vengono caricati automaticamente. Per l’integrazione di AEM Assets per Commerce, è sufficiente installare i moduli. La configurazione di App Builder non è richiesta.

Abilita framework eventi Commerce

Abilita il framework degli eventi da Commerce Admin.

NOTE
La configurazione di App Builder è necessaria solo se prevedi di utilizzare una strategia di corrispondenza personalizzata per sincronizzare le risorse tra Commerce e AEM Assets.

  1. Dall'amministratore, passare a Stores > Settings > Configuration > Adobe Services > Adobe I/O Events.

  2. Espandere Commerce events.

  3. Imposta Enabled su Yes.

    Configurazione amministratore Commerce Adobe I/O Events - abilita eventi Commerce {width="600" modal="regular"}

  4. Immettere il nome della società esercente in Merchant ID e il nome dell'ambiente nei campi Environment ID. Utilizzare solo caratteri alfanumerici e trattini bassi per impostare questi valori.

recommendation-more-help

Configura VCL personalizzato per bloccare le richieste

Se si utilizza un frammento VCL personalizzato per bloccare richieste in ingresso sconosciute, potrebbe essere necessario includere l'intestazione HTTP X-Ims-Org-Idheader per consentire le connessioni in ingresso dal servizio AEM Assets Integration for Commerce.

TIP
Puoi utilizzare il modulo Fastly CDN per creare un ACL di Edge con un elenco di indirizzi IP che desideri bloccare.

Il seguente codice snippet VCL personalizzato (formato JSON) mostra un esempio con un'intestazione di richiesta X-Ims-Org-Id.

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

Prima di creare uno snippet basato su questo esempio, esaminare i valori per determinare se è necessario apportare modifiche:

  • name: nome dello snippet VCL. Questo esempio utilizza il nome blockbyuseragent.

  • dynamic: imposta la versione dello snippet. Questo esempio utilizza 0. Per informazioni dettagliate sul modello dati, vedere Frammenti VCL.

  • type: specifica il tipo di snippet VCL, che determina la posizione del snippet nel codice VCL generato. Questo esempio utilizza recv. Per l'elenco dei tipi di snippet, vedere Fastly VCL snippet reference

  • priority: determina quando viene eseguito lo snippet VCL. In questo esempio viene utilizzata la priorità 5 per eseguire immediatamente e verificare se una richiesta dell'amministratore proviene da un indirizzo IP consentito.

  • content: snippet di codice VCL da eseguire, che controlla l'indirizzo IP del client. Se l'IP si trova nell'ACL di Edge, l'accesso viene bloccato con un errore 405 Not allowed per l'intero sito Web. A tutti gli altri indirizzi IP client è consentito l'accesso.

Per informazioni dettagliate sull'utilizzo dei snippet VCL per bloccare le richieste in ingresso, vedere VCL personalizzato per bloccare le richieste nella Guida di Commerce sull'infrastruttura cloud.

style
shade-box

Ottenere le credenziali di autenticazione per l’accesso API

L’integrazione di AEM Assets per Commerce richiede le credenziali di autenticazione OAuth per consentire l’accesso API all’istanza di Commerce. Queste credenziali sono necessarie per autenticare le richieste API durante la gestione delle risorse tramite l’integrazione AEM Assets.

Per generare le credenziali, aggiungi l’integrazione all’istanza di Commerce e attivala.

Aggiungere l’integrazione all’ambiente Commerce

  1. Dall'amministratore, vai a Sistema > Estensioni > Integrazioni, quindi fai clic su Aggiungi nuova integrazione.

  2. Immetti informazioni sull’integrazione.

    Nella sezione General, specifica solo l'integrazione Name e Email. Utilizza l’e-mail per un account Adobe IMS con accesso all’organizzazione in cui vengono distribuiti Commerce e Experience Manager Assets.

    Integrazione di AEM Assets per la configurazione dell'amministratore di Commerce {width="600" modal="regular"}

  3. Verificare l'identità facendo clic su Conferma identità.

    Il sistema verifica la tua identità autenticandosi su Experience Cloud con il tuo Adobe Id.

  4. Configurare le risorse API.

    1. Nel pannello sinistro fare clic su API.

    2. Selezionare la risorsa multimediale esterna Catalog > Inventory > Products > External Media.

      Configurazione integrazione amministratore per risorse API {width="600" modal="regular"}

  5. Fare clic su Save.

Genera credenziali OAuth

Nella pagina Integrazioni, genera le credenziali di autenticazione OAuth facendo clic su Attiva per l'integrazione Assets. Queste credenziali sono necessarie per registrare il progetto Commerce con il servizio Motore regole di Assets e per inviare richieste API per gestire le risorse tra Adobe Commerce e AEM Assets.

  1. Dalla pagina Integrazioni, generare le credenziali facendo clic su Activate.

    Attiva la configurazione Commerce per l'integrazione Assets {width="600" modal="regular"}

  2. Se prevedi di utilizzare l’API, salva le credenziali per la chiave consumer e il token di accesso per configurare l’autenticazione nel client API.

    Credenziali OAuth per autenticare le richieste API {width="600" modal="regular"}

  3. Fare clic su Done.

NOTE
Puoi anche generare le credenziali di autenticazione utilizzando le API di Adobe Commerce. Per informazioni dettagliate su questo processo e ulteriori informazioni sull'autenticazione basata su OAuth per Adobe Commerce, vedi Autenticazione basata su OAuth nella documentazione di Adobe Developer.

Passaggio successivo

Connetti gli ambienti di progetto Adobe Commerce e AEM Assets e seleziona la strategia di corrispondenza per la sincronizzazione delle risorse

2b0136b4-ef75-405f-9734-60d741f198de