[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Installation des packages Adobe Commerce

Cette intégration pour Commerce permet la synchronisation des ressources entre Adobe Commerce et Adobe Experience Manager Assets (AEM Assets). L’extension fournit un ensemble d’outils et de services permettant de gérer les images du produit, les vidéos et d’autres ressources multimédias sur les deux plateformes.

Ajoutez cette extension à l'environnement Commerce en installant l'extension PHP aem-assets-integration. Vous devez également activer Adobe I/O Events pour Commerce et générer les informations d’identification requises pour les communications et les workflows entre Adobe Commerce et Adobe Experience Manager Assets.

Conditions d’accès

Vous avez besoin des rôles et autorisations suivants pour activer l’intégration de Commerce à AEM Assets.

TIP
Adobe Commerce peut être configuré pour utiliser l’authentification Adobe IMS.

Workflow d’installation et de configuration

Installez le package Adobe Commerce et préparez l’environnement Commerce en effectuant les tâches suivantes :

Installation de l’extension aem-assets-integration

Installez la dernière version de l’extension d’intégration AEM Assets (aem-assets-integration) sur une instance Adobe Commerce avec la version Adobe Commerce 2.4.5+. L’extension est fournie en tant que métapaquet de compositeur à partir du référentiel repo.magento.com.

Infrastructure cloud

Utilisez cette méthode pour installer l’extension AEM Assets Integration sur une instance Commerce Cloud.

  1. Sur votre station de travail locale, accédez au répertoire du projet d’infrastructure cloud d’Adobe Commerce.

    note note
    NOTE
    Pour plus d’informations sur la gestion locale des environnements de projet Commerce, voir Gestion des branches avec l’interface de ligne de commande dans le Guide d’utilisation d’Adobe Commerce sur les infrastructures cloud.
  2. Consultez la branche d’environnement pour effectuer la mise à jour à l’aide de l’interface de ligne de commande Adobe Commerce Cloud.

    code language-shell
    magento-cloud environment:checkout <environment-id>
    
  3. Ajoutez l’extension AEM Assets Integration for Commerce .

    code language-shell
    composer require "magento/aem-assets-integration" "<version-tbd>" --no-update
    
  4. Mettez à jour les dépendances de package.

    code language-shell
    composer update "magento/aem-assets-integration"
    
  5. Validez et envoyez les modifications de code pour les fichiers composer.json et composer.lock.

  6. Ajoutez, validez et envoyez les modifications de code des fichiers composer.json et composer.lock à l’environnement cloud.

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

    L’envoi des mises à jour lance le processus de déploiement cloud de Commerce pour appliquer les modifications. Vérifiez le statut du déploiement dans le journal de déploiement.

Sur site

Utilisez cette méthode pour installer l’extension AEM Assets Integration pour une instance locale.

  1. Utilisez le compositeur pour ajouter l’extension AEM Assets Integration for Commerce à votre projet :

    code language-shell
    composer require "magento/aem-assets-integration" --no-update
    
  2. Mettez à jour les dépendances et installez l’extension :

    code language-shell
    composer update  "magento/aem-assets-integration"
    
  3. Mettre à niveau Adobe Commerce :

    code language-shell
    bin/magento setup:upgrade
    
  4. Effacez le cache :

    code language-shell
    bin/magento cache:clean
    
note tip
TIP
Lors d’un déploiement en production, pensez à ne pas effacer le code compilé pour gagner du temps. Sauvegardez toujours votre système avant d’apporter des modifications.

Configuration du connecteur de services Commerce

NOTE
La configuration du connecteur de services Commerce est un processus unique requis pour utiliser les services SaaS Adobe Commerce. Si vous avez déjà configuré le connecteur pour un autre service, vous pouvez afficher la configuration existante à partir de l’Administration Commerce en sélectionnant Systems > Services > Commerce Services Connector.

Pour transmettre des données entre votre instance Adobe Commerce et les services qui activent l'intégration AEM Assets, configurez le connecteur Commerce Services depuis l'Admin (System > Services > Commerce Services Connector).

Identifiants de projet SaaS et d’espace de données pour l’intégration d’AEM Assets {width="600" modal="regular"}

Fournissez les valeurs suivantes dans la configuration :

  • Clés API de production et sandbox pour l’authentification
  • Nom de l’espace de données (identifiant SaaS) pour un stockage dans le cloud sécurisé
  • Identifiant de l’organisation IMS dans lequel vos environnements Commerce et AEM Assets sont configurés

Pour obtenir des instructions détaillées, regardez la vidéo de configuration du connecteur de services Commerce 🔗 ou consultez la documentation du connecteur de services Commerce 🔗.

Lorsque vous enregistrez la configuration, le système génère les identifiants de projet SaaS et de base de données pour votre environnement. Ces valeurs sont requises pour activer la synchronisation des ressources entre Adobe Commerce et AEM Assets.

Configuration de Adobe I/O Events pour Commerce

L’intégration AEM Assets utilise le service Adobe I/O Events pour envoyer des données d’événement personnalisées entre l’instance Commerce et Experience Cloud. Les données d’événement sont utilisées pour coordonner les workflows pour l’intégration d’AEM Assets.

Avant de configurer Adobe I/O Events, vérifiez la configuration des tâches RabbitMQ et cron pour votre projet Commerce :

NOTE
Pour les projets sous Commerce version 2.4.5, vous devez installer les modules Adobe I/O. Dans la version 2.4.6 ou ultérieure de Commerce, ces modules sont chargés automatiquement. Pour l’intégration d’AEM Assets pour Commerce, il vous suffit d’installer les modules . La configuration d’App Builder n’est pas requise.

Activation de la structure d’événements Commerce

Activez la structure d’événements à partir de l’administration Commerce.

NOTE
La configuration d’App Builder n’est requise que si vous prévoyez d’utiliser une stratégie de correspondance personnalisée pour synchroniser les ressources entre Commerce et AEM Assets.
  1. Depuis l’administration, accédez à Stores > Settings > Configuration > Adobe Services > Adobe I/O Events.

  2. Développez Commerce events.

  3. Définissez Enabled sur Yes.

    Configuration d’administration de Adobe I/O Events Commerce - Activation des événements Commerce {width="600" modal="regular"}

  4. Saisissez le nom de la société marchande dans les champs Merchant ID et le nom de l’environnement dans les champs Environment ID . Utilisez uniquement des caractères alphanumériques et des traits de soulignement lors de la définition de ces valeurs.

recommendation-more-help

Configurer le VCL personnalisé pour bloquer les requêtes

Si vous utilisez un fragment de code VCL personnalisé pour bloquer les requêtes entrantes inconnues, vous devrez peut-être inclure le X-Ims-Org-Idheader d’en-tête HTTP pour autoriser les connexions entrantes à partir du service AEM Assets Integration for Commerce .

TIP
Vous pouvez utiliser le module Fast CDN pour créer une liste de contrôle d’accès Edge avec une liste d’adresses IP que vous souhaitez bloquer.

Le code de fragment de code VCL personnalisé suivant (format JSON) illustre un exemple avec un en-tête de requête 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\";}"
}

Avant de créer un fragment de code basé sur cet exemple, passez en revue les valeurs pour déterminer si vous devez apporter des modifications :

  • name : nom du fragment de code VCL. Cet exemple utilise le nom blockbyuseragent.

  • dynamic : permet de définir la version du fragment de code. Cet exemple utilise 0. Voir Fragments de code VCL Fastly pour obtenir des informations détaillées sur le modèle de données.

  • type : indique le type de fragment de code VCL qui détermine son emplacement dans le code VCL généré. Cet exemple utilise recv. Pour obtenir la liste des types de fragment de code, reportez-vous à la Référence de fragment de code VCL Fastly.

  • priority : détermine à quel moment le fragment de code VCL s'exécute. Cet exemple utilise la priorité 5 pour exécuter immédiatement et vérifier si une requête Admin provient d’une adresse IP autorisée.

  • content : fragment de code VCL à exécuter, qui vérifie l’adresse IP du client. Si l’adresse IP se trouve dans la liste de contrôle d’accès d’Edge, elle est bloquée avec une erreur de 405 Not allowed pour l’ensemble du site web. Toutes les autres adresses IP client sont autorisées à y accéder.

Pour plus d’informations sur l’utilisation de fragments de code VCL pour bloquer les requêtes entrantes, consultez Custom VCL for blocking requests dans le guide Commerce sur les infrastructures cloud.

Obtention des informations d’authentification pour l’accès à l’API

L’intégration d’AEM Assets pour Commerce nécessite des informations d’authentification OAuth pour autoriser l’accès de l’API à l’instance Commerce. Ces informations d’identification sont requises pour authentifier les requêtes d’API lors de la gestion des ressources à l’aide de l’intégration AEM Assets.

Vous générez les informations d’identification en ajoutant l’intégration à l’instance Commerce et en l’activant.

Ajouter l’intégration à l’environnement Commerce

  1. Dans l’administration, accédez à Système > Extensions > Intégrations, puis cliquez sur Ajouter une nouvelle intégration.

  2. Saisissez des informations sur l’intégration.

    Dans la section Général, spécifiez uniquement l’intégration Nom et E-mail. Utilisez l’adresse e-mail pour un compte Adobe IMS ayant accès à l’organisation dans laquelle Commerce et Experience Manager Assets sont déployés.

    Configuration de l’intégration AEM Assets pour l’administration de Commerce {width="600" modal="regular"}

  3. Vérifiez votre identité en cliquant sur Confirmer l’identité.

    Le système vérifie votre identité en s’authentifiant auprès d’Experience Cloud avec votre Adobe Id.

  4. Configurez les ressources d’API.

    1. Dans le panneau de gauche, cliquez sur API.

    2. Sélectionnez le Catalog > Inventory > Products > External Media de ressource de média externe.

      Configuration de l’intégration de l’administrateur pour les ressources de l’API {width="600" modal="regular"}

  5. Cliquez sur Save.

Générer des informations d’identification OAuth

Sur la page Intégrations , générez les informations d’identification d’authentification OAuth en cliquant sur Activer pour l’intégration Assets. Vous avez besoin de ces informations d’identification pour enregistrer le projet Commerce auprès du service Moteur de règles d’Assets et pour envoyer des demandes d’API afin de gérer les ressources entre Adobe Commerce et AEM Assets.

  1. Sur la page Intégrations , générez les informations d’identification en cliquant sur Activate.

    Activation de la configuration Commerce pour l’intégration d’Assets {width="600" modal="regular"}

  2. Si vous prévoyez d’utiliser l’API, enregistrez les informations d’identification de la clé du client et du jeton d’accès pour configurer l’authentification dans votre client API.

    Informations d’identification OAuth pour authentifier les requêtes API {width="600" modal="regular"}

  3. Cliquez sur Done.

NOTE
Vous pouvez également générer des informations d’authentification à l’aide des API Adobe Commerce. Pour plus d’informations sur ce processus et l’authentification basée sur OAuth pour Adobe Commerce, consultez la section Authentification basée sur OAuth dans la documentation d’Adobe Developer.

Étape suivante

1e1bf82b-b08f-47bf-a397-ef30dbe31665