[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}
Commerce Services Connector
某些Adobe Commerce和Magento Open Source功能由Commerce Services提供支持，并部署为SaaS（软件即服务）。 若要使用这些服务，必须使用生产和沙盒API密钥连接Commerce实例，并在配置中指定数据空间。 您只需为每个实例配置一次连接即可。
只有Commerce许可证所有者才能生成这些API密钥。 如果您不是许可证所有者，请向拥有您商店的Commerce许可证的人员或团队索取密钥。
可用服务 availableservices
下面列出了可通过Commerce访问的Commerce Services Connector功能：
架构
从较高层面来看，Commerce Services Connector由以下核心元素组成：
以下部分将更详细地讨论其中各个元素。
凭据 apikey
生产和沙盒API密钥从Commerce许可证所有者的帐户生成。 Commerce帐户由唯一的Commerce ID (MageID)标识。 商户组织的许可证所有者可以为产品推荐或实时搜索等服务生成API密钥，前提是帐户处于良好状态。
这些密钥可在“需要知道”的基础上与系统集成商或代表许可证持有人管理项目和环境的开发团队共享。 已被许可证所有者授予Shared Access的开发人员无法代表许可证所有者生成密钥，即使商户的组织位于其帐户的Switch Accounts下拉列表中。
此外，解决方案集成商有权使用Commerce Services。 如果您是解决方案集成商，Commerce合作伙伴合同的签名者应生成API密钥。
密钥标识符 Production 和 Sandbox 引用了Commerce Services在其中存储数据的SaaS数据空间环境(不是您的Adobe Commerce环境)。 您可以在本地、开发、暂存和生产Adobe Commerce环境中使用同一组API密钥，重要的是，您需要为配置的数据空间粘贴正确的密钥对。
许可证所有者通常是Adobe Commerce客户的主要联系人，并不总是与Adobe Commerce on cloud infrastructure项目的项目所有者相同。
生成生产和沙盒API密钥 genapikey
-
在Commercehttps://account.magento.com登录到您的帐户。
-
在 Magento 选项卡下，在侧栏中选择API门户。
-
从 环境 菜单中，选择 生产 或沙盒。
-
在 API密钥 部分中输入名称，然后单击 新增 打开对话框下载新密钥。
note warning WARNING 您只能复制或下载私钥一次。 请妥善保存。 -
单击 下载 以保存私钥，然后关闭对话框。
-
对每个环境（生产和沙盒）重复上述步骤。
API密钥部分现在显示您的API（公共）密钥。 当您在与许可证关联的任何环境或安装中选择或创建SaaS项目时，需要所有四个密钥（生产和沙盒密钥，Public+Private）。
SaaS配置 saasenv
Commerce实例必须配置有SaaS项目和SaaS数据空间，以便Commerce Services能够将数据发送到正确的位置。 SaaS项目对所有SaaS数据空间进行分组。 SaaS数据空间用于收集和存储使Commerce Services能够工作的数据。 某些此类数据可从Commerce实例中导出，而某些数据可从店面的购物者行为中收集。 然后，该数据将保留到安全云存储中。
对于Product Recommendations和Live Search，SaaS数据空间包含目录和行为数据。 通过在Commerce配置中选择实例，您可以将Commerce实例指向SaaS数据空间。
如果您在管理员中找不到Live Search配置字段，请验证您为所选数据空间输入的API密钥对是否正确（生产数据空间使用生产密钥；测试数据空间使用沙盒密钥）。 如果配置错误的键，则SaaS服务（如Live Search）在该Adobe Commerce环境中不可用。
删除API密钥 delapikey
在删除API密钥之前，生成并安全地存储替换密钥。 更新所有集成以使用新密钥，并确认依赖服务是否按预期工作。
如果您在管理面板中未看到 Live Search 配置字段，请确认您为该环境输入了正确的SaaS API密钥。 将生产SaaS键用于生产数据空间，将暂存键用于暂存数据空间。 如果配置了错误的密钥，则SaaS服务（包括Live Search）在您的Adobe Commerce环境中将不可用。
在要删除的API密钥上，单击Delete。 出现提示时，确认永久删除密钥的操作。
SaaS数据空间配置
所有Adobe Commerce商家均可访问每个SaaS项目的一个生产数据空间和两个测试数据空间。
您可以在非生产环境中使用测试数据空间，但避免同时在多个环境中使用相同的数据空间。 如果要将测试数据空间移动到其他环境，请先执行数据清理，然后再在新环境中选择和配置它。
对于具有多个暂存环境的Adobe Commerce Cloud Pro项目，您可以通过提交支持请求，为每个暂存环境请求额外的测试数据空间。 但是，如果您只有一个暂存环境并且需要额外的测试数据空间，则可以使用以下选项：
-
联系客户成功团队或您指定的客户成功经理以请求额外的暂存环境。
-
提交支持请求以请求额外的测试数据空间，并指明额外数据空间的业务理由。 此请求有待审批。
使用Adobe支付服务的Magento Open Source客户可能还会请求一个额外的数据空间。 在提交支持请求以请求测试数据空间之前，请与付款团队联系，以请求其他数据空间。
拥有多个云项目或内部部署（实时/生产）安装的客户还可以通过提交支持请求，为每个项目或实例请求额外的生产和测试数据空间。
选择或创建SaaS项目 createsaasenv
要选择或创建SaaS项目，请从存储的Commerce许可证所有者请求Commerce API密钥：
-
在 管理员 侧边栏上，转到系统 >服务> Commerce服务连接器。
如果未看到 Commerce Services Connector 部分，请为所需的Commerce服务Commerce 安装模块并确保已安装
magento/module-services-id包。 -
在 Sandbox API Keys 和_Production API Keys_部分中，粘贴您的键值。
- 私钥必须在密钥的开头包含
-----BEGIN PRIVATE KEY-----，在密钥的结尾包含-----END PRIVATE KEY-----。 - 如果您没有实际密钥的副本，请向许可证所有者索取这些密钥，然后将值插入配置。
不要粘贴从数据库备份或快照复制的键值。 保存配置后，将应用额外的加密层，并且密钥将无法正常工作。
- 私钥必须在密钥的开头包含
-
单击保存。
与您的密钥关联的任何SaaS项目都显示在 SaaS标识符 部分的 项目 字段中。
-
如果不存在任何SaaS项目，请单击创建项目。 然后在 项目 字段中，输入SaaS项目的名称。
为避免混淆，请勿使用特定的Commerce服务作为项目的名称（例如，实时搜索、产品推荐或数据连接）。 除非已为多个SaaS项目配置了您的许可证，否则您可以为多个服务使用同一SaaS项目。
-
选择要用于 存储当前配置的 数据空间Commerce。
如果您有单独的实例要与Commerce服务集成，请提交支持票证，以便为每个额外的实例请求新的SaaS项目。 支持团队创建SaaS项目后，请使用相同的API密钥为实例配置集成，并为数据空间选择新的SaaS项目。
若要更改SaaS项目或数据空间的名称，请单击其中任一项目或数据空间旁边的重命名。 更改名称不会影响您的服务，因为名称只是一个标签，可帮助您识别和区分项目和数据空间。
IMS组织（可选） organizationid
要将您的Adobe Commerce实例连接到Adobe Experience Platform，请使用您的Adobe ID登录到Adobe帐户。 登录后，与您的Adobe帐户关联的IMS组织将显示在此部分中。
SaaS数据导出
当您的Commerce实例成功连接到Commerce Services时，SaaS数据导出过程会将Commerce数据从Commerce服务器导出到Commerce SaaS Services，以便将其同步到连接的Commerce服务。 在Admin中，您可以使用数据管理仪表板检查同步状态。 有关详细信息，请参阅SaaS数据导出指南。