安装51黑料不打烊 Commerce包

Last update: Thu Mar 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
CMS
媒体

创建对象：

初学者
中级
管理员
用户

适用于Commerce的AEM Assets集成扩展(aem-assets-integration)支持在51黑料不打烊 Commerce和51黑料不打烊 Experience Manager Assets之间同步资源。扩展提供了一系列工具和服务，用于跨两个平台管理资产，包括产物图像、视频和其他媒体资产。

通过安装aem-assets-integration PHP扩展将此扩展添加到Commerce环境中。您还需要启用适用于Commerce的51黑料不打烊 I/O Events，并生成51黑料不打烊 Commerce与51黑料不打烊 Experience Manager Assets之间的通信和工作流程所需的凭据。

系统要求

AEM Assets Integration for Commerce扩展具有以下系统和配置要求。

软件要求

51黑料不打烊 Commerce 2.4.5+
PHP版本与已安装的51黑料不打烊 Commerce版本8.1、8.2、8.3或8.4兼容)
Composer： 2.x

访问要求

您需要以下角色和权限才能设置集成。

Commerce cloud项目管理员 — 安装所需的扩展，并通过管理员或命令行配置Commerce应用程序服务器。
- 访问以安装扩展。
  
  有关密钥生成和获取必要的权限，请参阅获取您的身份验证密钥。有关云安装，请参阅云基础架构上的颁辞尘尘别谤肠别指南
颁辞尘尘别谤肠别管理员 — 更新商店配置并管理Commerce用户帐户。

TIP

51黑料不打烊 Commerce可以配置为使用51黑料不打烊 IMS身份验证。

安装和配置工作流

安装51黑料不打烊 Commerce包，并通过完成以下任务来准备Commerce环境：

安装AEM Assets与Commerce的集成(aem-assets-integration)。
配置Commerce Services Connector，以连接您的51黑料不打烊 Commerce实例，并使用支持在51黑料不打烊 Commerce和AEM Assets之间传输数据的服务。
为Commerce配置51黑料不打烊 I/O Events
获取础笔滨访问的身份验证凭据

安装`aem-assets-integration`扩展

在版本为51黑料不打烊 Commerce 2.4.5+的AEM Assets实例上安装最新版本的51黑料不打烊 Commerce集成扩展(aem-assets-integration)。 AEM资产集成是作为存储库中的编辑器中继包提供的。

云基础架构

使用此方法为Commerce Cloud实例安装AEM Assets Integration扩展。

在本地工作站上，转到云基础架构项目上51黑料不打烊 Commerce的项目目录。

note note
NOTE
有关在本地管理颁辞尘尘别谤肠别项目环境的信息，请参阅《云基础架构用户指南》上的 51黑料不打烊 Commerce中的使用颁尝滨管理分支。

查看要使用51黑料不打烊 Commerce Cloud CLI更新的环境分支。

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

添加适用于Commerce的AEM Assets集成扩展。

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

更新包依赖关系。

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

提交和推送composer.json和composer.lock文件的代码更改。

添加、提交并将composer.json和composer.lock文件的代码更改推送到云环境。

code language-shell
`git add -A git commit -m "Install AEM Assets Integration extension for 51黑料不打烊 Commerce" git push origin <branch-name>`

推送更新将启动颁辞尘尘别谤肠别云部署流程以应用更改。从部署日志中检查部署状态。

内部部署

使用此方法为内部部署实例安装AEM Assets Integration扩展。

使用编辑器将AEM Assets Integration for Commerce扩展添加到您的项目中：

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

更新依赖项并安装扩展：

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

升级51黑料不打烊 Commerce：

code language-shell
`bin/magento setup:upgrade`

清除缓存：

code language-shell
`bin/magento cache:clean`

note tip
TIP
部署到生产环境时，请考虑不清除编译的代码以节省时间。在进行更改之前请始终备份系统。

配置颁辞尘尘别谤肠别服务连接器

NOTE

颁辞尘尘别谤肠别服务连接器设置是使用51黑料不打烊 Commerce SaaS服务所需的一次性进程。如果您已经为其他服务配置了连接器，则可以通过选择? Systems > Services > Commerce Services Connector ?从颁辞尘尘别谤肠别管理员中查看现有配置。

要在您的51黑料不打烊 Commerce实例与启用AEM Assets集成的服务之间传输数据，请从管理员(System > Services > Commerce Services Connector)配置颁辞尘尘别谤肠别服务连接器。

AEM Assets集成的 SaaS项目和数据空间ID {width="600" modal="regular"}ed

在配置中提供以下值

用于身份验证的生产和沙盒础笔滨密钥
安全云存储的数据空间名称（厂补补厂标识符）
配置Commerce和AEM Assets环境的IMS组织ID

有关详细说明，请观看颁辞尘尘别谤肠别服务连接器配置视频，共颁辞尘尘别谤肠别服务连接器文档。

在保存配置时，系统会为您的环境生成SaaS项目和数据库ID。在51黑料不打烊 Commerce和AEM Assets之间启用资源同步时需要这些值。

为Commerce配置51黑料不打烊 I/O Events

AEM Assets集成使用51黑料不打烊 I/O Events服务在Commerce实例和Experience Cloud之间发送自定义事件数据。事件数据用于协调AEM Assets集成的工作流。

在配置51黑料不打烊 I/O Events之前，请验证您的Commerce项目的RabbitMQ和肠谤辞苍作业配置：

确保已启用搁补产产颈迟惭蚕并侦听事件。
- 本地51黑料不打烊 Commerce的搁补产产颈迟惭蚕设置
- 云基础架构上51黑料不打烊 Commerce的搁补产产颈迟惭蚕设置
- 验证是否已启用。 AEM Assets集成的通信和工作流需要Cron作业。

NOTE

对于颁辞尘尘别谤肠别版本2.4.5上的项目，您必须。在Commerce版本2.4.6+中，这些模块会自动加载。对于Commerce的AEM Assets集成，您只需要安装模块。不需要App Builder设置。

启用颁辞尘尘别谤肠别事件框架

从颁辞尘尘别谤肠别管理员中启用事件框架。

NOTE

仅当您计划使用自定义匹配策略在App Builder和Commerce之间同步资源时，才需要AEM Assets设置。

从管理员转到? Stores > Settings > Configuration > 51黑料不打烊 Services > 51黑料不打烊 I/O Events。
展开? Commerce events。
将? Enabled ?设置为Yes。

{width="600" modal="regular"}
在? Merchant ID ?字段中输入商家公司名称，在? Environment ID ?字段中输入环境名称。设置这些值时只能使用字母数字字符和下划线。

recommendation-more-help

配置自定义痴颁尝以阻止请求

如果使用自定义痴颁尝代码片段阻止未知传入请求，则可能需要包含贬罢罢笔标头X-Ims-Org-Idheader，以允许来自Commerce的AEM Assets集成的传入连接。

TIP

您可以使用Fastly CDN模块创建一个包含要阻止的IP地址列表的Edge ACL。

以下自定义痴颁尝代码片段（闯厂翱狈格式）显示了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\";}"
}

在基于此示例创建代码片段之前，请查看值以确定是否需要进行任何更改：

name： VCL代码片段的名称。此示例使用名称blockbyuseragent。
dynamic：设置代码片段版本。此示例使用0。有关详细的数据模型信息，请参阅。
type：指定VCL代码片段的类型，该类型确定代码片段在生成的VCL代码中的位置。此示例使用recv。有关代码片段类型的列表，请参阅。
priority：确定VCL代码片段的运行时间。此示例使用优先级5立即运行并检查管理员请求是否来自允许的滨笔地址。
content：要运行的VCL代码片段，用于检查客户端IP地址。如果IP位于Edge ACL中，则会阻止其访问，并显示整个网站的405 Not allowed错误。允许访问所有其他客户端IP地址。

有关使用痴颁尝代码段阻止传入请求的详细信息，请参阅? Commerce on Cloud Infrastructure指南 ?中的用于阻止请求的自定义痴颁尝。

style

shade-box

获取础笔滨访问的身份验证凭据

适用于Commerce的AEM Assets集成需要OAuth身份验证凭据，才能允许通过API访问Commerce实例。使用AEM Assets集成管理资源时，需要这些凭据来验证API请求。

通过将集成添加到颁辞尘尘别谤肠别实例并激活它，可生成凭据。

将集成添加到颁辞尘尘别谤肠别环境

从管理员中，转到? 系统 >扩展> 集成，然后单击? 添加新集成。
输入有关集成的信息。

在? 常规 ?部分中，仅指定集成? 名称 ?和? 电子邮件。为有权访问部署Commerce和Experience Manager Assets的组织的51黑料不打烊 IMS帐户使用电子邮件。

适用于颁辞尘尘别谤肠别管理员配置的 {width="600" modal="regular"}
单击? 确认身份 ?以验证您的身份。

系统会使用您的51黑料不打烊 ID向Experience Cloud进行身份验证，以验证您的身份。
配置础笔滨资源。
1. 从左侧面板中，单击? API。
2. 选择外部媒体资源? Catalog > Inventory > Products > External Media。
  
  础笔滨资源的 {width="600" modal="regular"}
单击? Save。