Commerce Services Connector
Algunas características de Adobe Commerce y Magento Open Source utilizan Commerce Services y se implementan como SaaS (software como servicio). Para utilizar estos servicios, debe conectar su instancia de Commerce mediante las claves de API de producción y de zona protegida, y especificar el espacio de datos en la configuración. Solo es necesario configurar la conexión una vez para cada instancia.
Solamente el propietario de la licencia Commerce puede generar estas claves API. Si no es el propietario de la licencia, solicite las claves a la persona o al equipo propietario de la licencia de Commerce para su tienda.
Servicios disponibles availableservices
A continuación se enumeran las características de Commerce a las que puede tener acceso a través de Commerce Services Connector:
Arquitectura
En un nivel superior, Commerce Services Connector se compone de los siguientes elementos principales:
En las secciones siguientes se analiza cada uno de estos elementos con más detalle.
Credenciales apikey
Las claves API de producción y de zona protegida se generan a partir de la cuenta Commerce del propietario de la licencia. La cuenta de Commerce está identificada por un ID único de Commerce (MageID). El propietario de la licencia de la organización del comerciante puede generar claves de API para servicios como Product Recommendations o Live Search, siempre y cuando la cuenta esté al día.
Las claves se pueden compartir según sea necesario con el integrador de sistemas o el equipo de desarrollo que gestiona los proyectos y entornos en nombre del titular de la licencia. Los desarrolladores a los que el propietario de la licencia ha concedido Shared Access no pueden generar las claves en nombre del propietario de la licencia aunque la organización del comerciante esté presente en el menú desplegable Switch Accounts de su cuenta.
Además, los integradores de soluciones tienen derecho a utilizar Commerce Services. Si usted es un integrador de soluciones, el firmante del contrato del socio Commerce debe generar las claves de API.
Los identificadores clave Production y Sandbox hacen referencia a entornos de espacio de datos SaaS donde Commerce Services almacenan datos (no en los entornos de Adobe Commerce). Puede utilizar el mismo conjunto de claves API en los entornos local, de desarrollo, de ensayo y de producción de Adobe Commerce; lo que importa es que pegue el par de claves correcto para el espacio de datos que configure.
El propietario de la licencia suele ser el contacto principal de la cuenta de Adobe Commerce y no siempre es el mismo que el propietario del proyecto de Adobe Commerce en el proyecto de infraestructura en la nube.
Generar las claves API de producción y de zona protegida genapikey
-
Inicie sesión en su cuenta de Commerce en https://account.magento.com.
-
En la ficha Magento, seleccione Portal de API en la barra lateral.
-
En el menú Entorno, seleccione Producción o Espacio aislado.
-
Escriba un nombre en la sección Claves de API y haga clic en Agregar nueva para abrir el cuadro de diálogo y descargar la clave nueva.
note warning WARNING Puede copiar o descargar la clave privada solo una vez. Guárdelo en un lugar seguro. -
Haga clic en Descargar para guardar la clave privada y cierre el cuadro de diálogo.
-
Repita los pasos anteriores para cada entorno (producción y zona protegida).
La sección Claves de API ahora muestra sus claves de API (públicas). Necesita las cuatro claves (tanto la de producción como la de zona protegida, Pública+Privada) al seleccionar o crear un proyecto SaaS en cualquiera de los entornos o instalaciones asociados con la licencia.
Configuración de SaaS saasenv
Las instancias de Commerce deben configurarse con un proyecto SaaS y un espacio de datos SaaS para que Commerce Services pueda enviar datos a la ubicación correcta. Un proyecto SaaS agrupa todos los espacios de datos SaaS. Los espacios de datos SaaS se utilizan para recopilar y almacenar datos que permiten que Commerce Services funcione. Algunos de estos datos pueden exportarse desde la instancia Commerce y otros pueden recopilarse a partir del comportamiento del comprador en la tienda. Estos datos se conservan para proteger el almacenamiento en la nube.
Para Product Recommendations y Live Search, el espacio de datos de SaaS contiene datos de catálogo y de comportamiento. Puede apuntar una instancia de Commerce a un espacio de datos SaaS seleccionándola en la configuración de Commerce.
Si no encuentra los campos de configuración de Live Search en el Administrador, compruebe que ha introducido el par de claves de API correcto para el espacio de datos seleccionado (los espacios de datos de producción utilizan claves de producción; los espacios de datos de prueba utilizan claves de zona protegida). Si configura claves incorrectas, los servicios SaaS como Live Search no están disponibles en ese entorno de Adobe Commerce.
Eliminación de una clave API delapikey
Antes de eliminar una clave API, genere y almacene de forma segura una clave de reemplazo. Actualice todas las integraciones para utilizar la nueva clave y confirme que los servicios dependientes funcionan según lo esperado.
Si no ve Live Search campos de configuración en el panel de administración, confirme que ha introducido la clave de API de SaaS correcta para ese entorno. Utilice la clave SaaS de producción para el espacio de datos de producción y la clave de ensayo para el espacio de datos de ensayo. Si se configura una clave incorrecta, los servicios SaaS (incluido Live Search) no estarán disponibles en su entorno de Adobe Commerce.
En la clave de API que desea quitar, haga clic en Delete. Cuando se le solicite, confirme la operación para quitar la clave de forma permanente.
Aprovisionamiento de espacio de datos SaaS
Todos los comerciantes de Adobe Commerce pueden acceder a un espacio de datos de producción y a dos espacios de datos de prueba por proyecto de SaaS.
Puede utilizar los espacios de datos de prueba en entornos que no sean de producción, pero evite utilizar el mismo espacio de datos en varios entornos al mismo tiempo. Si desea mover un espacio de datos de prueba a un entorno diferente, realice una limpieza de datos antes de seleccionarlo y configurarlo en el entorno nuevo.
Para los proyectos de Adobe Commerce Cloud Pro con varios entornos de ensayo, puede solicitar espacios de datos de prueba adicionales para cada entorno de ensayo enviando una solicitud de asistencia. Sin embargo, si solo tiene un entorno de ensayo y necesita espacios de datos de prueba adicionales, tiene las siguientes opciones:
-
Póngase en contacto con el equipo de éxito del cliente o con el administrador de éxito del cliente designado para solicitar un entorno de ensayo adicional.
-
Envíe una solicitud de soporte técnico para solicitar el espacio de datos de prueba adicional e indicar la justificación comercial del espacio de datos adicional. Esta solicitud está sujeta a aprobación.
Los clientes de Magento Open Source que utilicen Adobe Payment Services también pueden solicitar un espacio de datos adicional. Póngase en contacto con el equipo de pagos para obtener la aprobación previa de los espacios de datos adicionales antes de enviar una solicitud de soporte para solicitar el espacio de datos de prueba.
Los clientes que sean propietarios de varios proyectos en la nube o instalaciones locales (activas/de producción) también pueden solicitar espacios de datos de producción y prueba adicionales para cada proyecto o instancia enviando una solicitud de soporte.
Seleccionar o crear un proyecto SaaS createsaasenv
Para seleccionar o crear un proyecto SaaS, solicite las claves de API Commerce al propietario de la licencia Commerce de su tienda:
-
En la barra lateral Admin, vaya a Sistema > Servicios > Conector de servicios de Commerce.
Si no ve la sección Commerce Services Connector, instale los módulos Commerce para el Commerce servicio deseado y asegúrese de que el paquete
magento/module-services-idesté instalado. -
En las secciones Sandbox API Keysy_Production API Keys_, pegue los valores de clave.
- Las claves privadas deben incluir
-----BEGIN PRIVATE KEY-----al principio de la clave y-----END PRIVATE KEY-----al final de la clave. - Si no dispone de una copia de las claves reales, solicítelas al propietario de la licencia y, a continuación, introduzca los valores en la configuración.
No pegue los valores clave copiados de una copia de seguridad o instantánea de la base de datos. Cuando se guarda la configuración, se aplica una capa adicional de cifrado y las claves no funcionan.
- Las claves privadas deben incluir
-
Haga clic en Guardar.
Cualquier proyecto SaaS asociado con sus claves aparecerá en el campo Proyecto de la sección Identificador SaaS.
-
Si no existen proyectos SaaS, haga clic en Crear proyecto. A continuación, en el campo Proyecto, escriba un nombre para su proyecto SaaS.
Para evitar confusiones, no use un servicio Commerce específico como nombre para el proyecto (por ejemplo, Live Search, Product Recommendations o Conexión de datos). A menos que la licencia se haya aprovisionado para varios proyectos SaaS, puede utilizar el mismo proyecto SaaS para varios servicios.
-
Seleccione el espacio de datos que se usará para la configuración actual de su almacén de Commerce.
Si tiene instancias independientes para integrar con los servicios de Commerce, envíe un vale de soporte técnico para solicitar un nuevo proyecto de SaaS para cada instancia adicional. Una vez que el servicio de asistencia haya creado el proyecto de SaaS, configure la integración de la instancia con las mismas claves de API y seleccione el nuevo proyecto de SaaS para el espacio de datos.
Para cambiar los nombres de tu proyecto SaaS o espacio de datos, haz clic en Cambiar nombre junto a uno de ellos. Cambiar el nombre no afecta al servicio porque el nombre es sólo una etiqueta para ayudarle a identificar y diferenciar entre proyectos y espacios de datos.
Organización de IMS (opcional) organizationid
Para conectar la instancia de Adobe Commerce a Adobe Experience Platform, inicie sesión en la cuenta de Adobe con el Adobe ID. Después de iniciar sesión, la organización de IMS asociada a su cuenta de Adobe se muestra en esta sección.
Exportación de datos SaaS
Cuando la instancia de Commerce se conecta correctamente a Commerce Services, el proceso de exportación de datos de SaaS exporta los datos de Commerce del servidor Commerce a Commerce SaaS Services para que se puedan sincronizar con los servicios de Commerce conectados. En el Administrador, puede comprobar el estado de sincronización mediante el panel de administración de datos. Para obtener más información, consulte la Guía de exportación de datos SaaS.