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.
-
Administrateur de projet cloud Commerce: installez les extensions requises et configurez le serveur d’applications Commerce à partir de l’Administration ou de la ligne de commande.
-
Accédez à repo.magento.com pour installer l’extension.
Pour la génération des clés et l’obtention des droits nécessaires, voir Obtenir vos clés d’authentification. Pour les installations cloud, consultez le guide Commerce sur les infrastructures cloud
-
-
Commerce Admin—Mettez à jour la configuration du magasin et gérez les comptes utilisateur Commerce.
Workflow d’installation et de configuration
Installez le package Adobe Commerce et préparez l’environnement Commerce en effectuant les tâches suivantes :
-
Installez l’extension AEM Assets Integration for Commerce (
aem-assets-integration
). -
Configurez le connecteur de services Commerce pour connecter votre instance Adobe Commerce et aux services qui permettent la transmission de données entre Adobe Commerce et AEM Assets.
-
Obtention des informations d’authentification pour l’accès à l’API
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.
Utilisez cette méthode pour installer l’extension AEM Assets Integration sur une instance Commerce Cloud.
-
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. -
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>
-
Ajoutez l’extension AEM Assets Integration for Commerce .
code language-shell composer require "magento/aem-assets-integration" "<version-tbd>" --no-update
-
Mettez à jour les dépendances de package.
code language-shell composer update "magento/aem-assets-integration"
-
Validez et envoyez les modifications de code pour les fichiers
composer.json
etcomposer.lock
. -
Ajoutez, validez et envoyez les modifications de code des fichiers
composer.json
etcomposer.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.
Utilisez cette méthode pour installer l’extension AEM Assets Integration pour une instance locale.
-
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
-
Mettez à jour les dépendances et installez l’extension :
code language-shell composer update "magento/aem-assets-integration"
-
Mettre à niveau Adobe Commerce :
code language-shell bin/magento setup:upgrade
-
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
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).
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 :
-
Assurez-vous que RabbitMQ est activé et écoute les événements.
- Configuration de RabbitMQ pour Adobe Commerce on-premise
- Configuration de RabbitMQ pour Adobe Commerce sur l’infrastructure cloud
- Vérifiez que les tâches cron) sont activées. Des tâches cron sont nécessaires pour la communication et les workflows de l’intégration d’AEM Assets.
Activation de la structure d’événements Commerce
Activez la structure d’événements à partir de l’administration Commerce.
-
Depuis l’administration, accédez à Stores > Settings > Configuration > Adobe Services > Adobe I/O Events.
-
Développez Commerce events.
-
Définissez Enabled sur
Yes
. -
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.
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 .
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 nomblockbyuseragent
. -
dynamic
: permet de définir la version du fragment de code. Cet exemple utilise0
. 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 utiliserecv
. 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 de405 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
-
Dans l’administration, accédez à Système > Extensions > Intégrations, puis cliquez sur Ajouter une nouvelle intégration.
-
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.
-
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.
-
Configurez les ressources d’API.
-
Dans le panneau de gauche, cliquez sur API.
-
Sélectionnez le Catalog > Inventory > Products > External Media de ressource de média externe.
-
-
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.
-
Sur la page Intégrations , générez les informations d’identification en cliquant sur Activate.
-
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.
-
Cliquez sur Done.