Commerce Services Connector
Vissa Adobe Commerce- och Magento Open Source-funktioner drivs av Commerce Services och distribueras som SaaS (programvara som tjänst). Om du vill använda de här tjänsterna måste du ansluta Commerce-instansen med API-nycklar för produktion och sandlåda och ange datautrymmet i konfigurationen. Du behöver bara konfigurera anslutningen en gång för varje instans.
Endast Commerce-licensägaren kan generera dessa API-nycklar. Om du inte är licensägare kan du begära nycklarna från den person eller det team som äger Commerce-licensen för din butik.
Tillgängliga tjänster availableservices
I följande lista visas de Commerce-funktioner som du kan komma åt via Commerce Services Connector:
Arkitektur
På en hög nivå består Commerce Services Connector av följande kärnelement:
I följande avsnitt beskrivs dessa element mer ingående.
Referenser apikey
Produktions- och sandbox-API-nycklarna genereras från Commerce-kontot för licensägaren. Commerce-kontot identifieras av ett unikt Commerce-ID (MageID). Licensägaren för handlarens organisation kan generera API-nycklar för tjänster som produktrekommendationer eller Live Search så länge som kontot är i gott skick.
Nycklarna kan delas på behovsbasis med systemintegratören eller utvecklingsteamet som hanterar projekt och miljöer för licenshavarens räkning. Utvecklare som har beviljats Shared Access av licensägaren kan inte generera nycklarna för licensägarens räkning även om handlarens organisation finns i listrutan Switch Accounts för deras konto.
Dessutom är lösningsintegratörer berättigade att använda Commerce Services. Om du är en lösningsintegratör bör signeraren av partnerkontraktet Commerce generera API-nycklarna.
Nyckelidentifierarna Produktion och Sandbox avser SaaS-datautrymmesmiljöer där Commerce Services lagrar data (inte dina Adobe Commerce-miljöer). Du kan använda samma uppsättning API-nycklar i Adobe Commerce-miljöer för lokal utveckling, mellanlagring och produktion. Det viktiga är att du klistrar in rätt nyckelpar för den datamängd du konfigurerar.
Licensägaren är vanligtvis den primära kontakten på Adobe Commerce-kontot och är inte alltid densamma som Adobe Commerce projektägare i molninfrastrukturprojektet.
Generera API-nycklar för produktion och sandlåda genapikey
-
Logga in på ditt Commerce-konto på https://account.magento.com.
-
Under fliken Magento väljer du API-portal i sidofältet.
-
Välj Produktion eller Sandbox på menyn Miljö.
-
Ange ett namn i avsnittet API-nycklar och klicka på Lägg till ny för att öppna dialogrutan för att hämta den nya nyckeln.
note warning WARNING Du kan bara kopiera eller hämta den privata nyckeln en gång. Lagra den säkert. -
Klicka på Hämta för att spara den privata nyckeln och stäng sedan dialogrutan.
-
Upprepa stegen ovan för varje miljö (produktion och sandlåda).
Avsnittet API-nycklar visar nu dina API-nycklar (offentliga). Du behöver alla fyra nycklarna (både produktions- och sandlådenycklar, Public+Private) när du väljer eller skapar ett SaaS-projekt i någon av de miljöer eller installationer som är associerade med licensen.
SaaS-konfiguration saasenv
Commerce instanser måste konfigureras med ett SaaS-projekt och ett SaaS-datautrymme så att Commerce Services kan skicka data till rätt plats. Ett SaaS-projekt grupperar alla SaaS-datautrymmen. SaaS-datamallarna används för att samla in och lagra data som gör att Commerce Services kan arbeta. Vissa av dessa data kan exporteras från instansen Commerce och vissa kan samlas in från shoppingbeteendet i butiken. Dessa data lagras sedan för att skydda molnlagringen.
För Product Recommendations och Live Search innehåller SaaS-datautrymmet katalog- och beteendedata. Du kan peka en Commerce-instans mot ett SaaS-datautrymme genom att markera den i Commerce-konfigurationen.
Om du inte kan hitta konfigurationsfälten för Live Search i Admin kontrollerar du att du har angett rätt API-nyckelpar för den datamängd du har valt (produktionsdatamallar använder produktionsnycklar, medan testdatamallar använder sandlådenycklar). Om du konfigurerar felaktiga nycklar är inte SaaS-tjänster som Live Search tillgängliga i den Adobe Commerce-miljön.
Ta bort en API-nyckel delapikey
Generera och lagra en ersättningsnyckel på ett säkert sätt innan du tar bort en API-nyckel. Uppdatera alla integreringar så att de använder den nya nyckeln och bekräfta att beroende tjänster fungerar som förväntat.
Om du inte ser Live Search konfigurationsfält på Admin Panel kontrollerar du att du har angett rätt SaaS API-nyckel för den miljön. Använd SaaS-nyckeln för produktion för produktionsdatautrymmet och mellanlagringsnyckeln för mellanlagringsdatautrymmet. Om fel nyckel har konfigurerats är SaaS-tjänster (inklusive Live Search) inte tillgängliga i din Adobe Commerce-miljö.
Klicka på Delete på API-nyckeln som ska tas bort. Bekräfta åtgärden för att permanent ta bort nyckeln när du uppmanas till detta.
Etablering av SaaS-datautrymme
Alla Adobe Commerce-handlare har tillgång till ett produktionsdatautrymme och två testdatamallar per SaaS-projekt.
Du kan använda testdatamallarna i icke-produktionsmiljöer, men undvika att använda samma dataminne i flera miljöer samtidigt. Om du vill flytta ett testdatautrymme till en annan miljö utför du en datarensning innan du väljer och konfigurerar det i den nya miljön.
För Adobe Commerce Cloud Pro-projekt med flera mellanlagringsmiljöer kan du begära ytterligare testdatamallar för varje mellanlagringsmiljö genom att skicka en supportförfrågan. Om du bara har en mellanlagringsmiljö och behöver ytterligare testdatamallar har du följande alternativ:
-
Kontakta Customer Success-teamet eller en utsedd Customer Success Manager för att begära en extra staging-miljö.
-
Skicka en supportförfrågan om du vill begära ytterligare testdatautrymme och ange affärsjusteringen för det extra dataområdet. Denna begäran måste godkännas.
Magento Open Source-kunder som använder Adobe Payment Services kan också beställa ytterligare ett datautrymme. Kontakta betalningsteamet om du vill ha förhandsgodkännande av ytterligare datautrymme innan du skickar en supportförfrågan för att begära testdatautrymmet.
Kunder som äger flera Cloud-projekt eller lokala (live/produktion) installationer kan också begära ytterligare produktions- och testdatamallar för varje projekt eller instans genom att skicka en supportförfrågan.
Välja eller skapa ett SaaS-projekt createsaasenv
Om du vill välja eller skapa ett SaaS-projekt begär du API-nycklarna Commerce från Commerce-licensägaren för din butik:
-
Gå till System > Tjänster > Commerce Services Connector på sidofältet Admin.
Om du inte ser avsnittet Commerce Services Connector installerar du Commerce-modulerna för den Commerce tjänst som du vill använda och kontrollerar att paketet
magento/module-services-idär installerat. -
Klistra in dina nyckelvärden i avsnitten Sandbox API KeysochProduction API Keys.
- Privata nycklar måste innehålla
-----BEGIN PRIVATE KEY-----i början av nyckeln och-----END PRIVATE KEY-----i slutet av nyckeln. - Om du inte har någon kopia av de faktiska nycklarna ber du licensägaren om dem och kopplar sedan värdena till konfigurationen.
Klistra inte in nyckelvärden som kopierats från en säkerhetskopia eller ögonblicksbild av en databas. När konfigurationen sparas används ytterligare ett krypteringslager och nycklarna fungerar inte.
- Privata nycklar måste innehålla
-
Klicka på Spara.
Alla SaaS-projekt som är associerade med dina nycklar visas i fältet Projekt i avsnittet SaaS-identifierare .
-
Om det inte finns några SaaS-projekt klickar du på Skapa projekt. Ange sedan ett namn för SaaS-projektet i fältet Projekt .
Undvik förvirring genom att inte använda en specifik Commerce-tjänst som namn för ditt projekt (till exempel Live Search, Produktrekommendationer eller Dataanslutning). Om din licens inte har etablerats för flera SaaS-projekt kan du använda samma SaaS-projekt för flera tjänster.
-
Välj det datautrymme som ska användas för den aktuella konfigurationen av Commerce-arkivet.
Om du har olika instanser att integrera med Commerce Services skickar du en supportanmälan för att begära ett nytt SaaS-projekt för varje ytterligare instans. När supporten har skapat SaaS-projektet konfigurerar du integreringen för instansen med samma API-nycklar och väljer det nya SaaS-projektet för datamängden.
Om du vill ändra namn på ditt SaaS-projekt eller din datautrymme klickar du på Byt namn bredvid ett av dem. Om du ändrar namnet påverkas inte tjänsten eftersom namnet bara är en etikett som hjälper dig att identifiera och skilja mellan projekt och datautrymme.
IMS-organisation (valfritt) organizationid
Om du vill ansluta din Adobe Commerce-instans till Adobe Experience Platform loggar du in på ditt Adobe-konto med din Adobe ID. När du har loggat in visas den IMS-organisation som är kopplad till ditt Adobe-konto i det här avsnittet.
SaaS-dataexport
När din Commerce-instans har anslutit till Commerce Services exporterar SaaS-dataexportprocessen Commerce-data från din Commerce-server till Commerce SaaS Services så att den kan synkroniseras med anslutna Commerce-tjänster. I Admin kan du kontrollera synkroniseringsstatus med kontrollpanelen för datahantering. Mer information finns i Exportguiden för SaaS-data.