Commerce Services Connector
Alcune funzionalità di Adobe Commerce e Magento Open Source sono basate su Commerce Services e distribuite come SaaS (software as a service). Per utilizzare questi servizi, è necessario connettere l'istanza Commerce utilizzando le chiavi API di produzione e sandbox e specificare lo spazio dati nella configurazione. È sufficiente configurare la connessione una sola volta per ogni istanza.
Solo il proprietario della licenza Commerce può generare queste chiavi API. Se non sei il proprietario della licenza, richiedi le chiavi alla persona o al team proprietario della licenza Commerce per il tuo negozio.
Servizi disponibili availableservices
Di seguito sono elencate le funzionalità di Commerce a cui è possibile accedere tramite Commerce Services Connector:
Architettura
A un livello avanzato, Commerce Services Connector è costituito dai seguenti elementi principali:
Le sezioni seguenti descrivono ciascuno di questi elementi in modo più dettagliato.
Credenziali apikey
Le chiavi API di produzione e sandbox sono generate dall'account Commerce del proprietario licenza. L'account Commerce è identificato da un ID Commerce univoco (MageID). Il proprietario della licenza per l’organizzazione del commerciante può generare chiavi API per servizi come Product Recommendations o Live Search, purché l’account sia in buono stato.
Le chiavi possono essere condivise in base alla necessità di sapere con l'integratore di sistemi o il team di sviluppo che gestisce progetti e ambienti per conto del titolare della licenza. Gli sviluppatori a cui il proprietario della licenza ha concesso Shared Access non possono generare le chiavi per conto del proprietario della licenza anche se l'organizzazione del commerciante è presente nel menu a discesa Switch Accounts sul loro account.
Inoltre, gli integratori di soluzioni sono autorizzati a utilizzare Commerce Services. Se sei un integratore di soluzioni, il firmatario del contratto partner Commerce deve generare le chiavi API.
Gli identificatori chiave Produzione e Sandbox fanno riferimento agli ambienti di spazio dei dati SaaS in cui Commerce Services memorizza i dati (non agli ambienti Adobe Commerce). Puoi utilizzare lo stesso set di chiavi API negli ambienti Adobe Commerce locali, di sviluppo, di staging e di produzione; ciò che conta è incollare la coppia di chiavi corretta per lo spazio dati configurato.
Il proprietario della licenza è in genere il contatto principale sull’account Adobe Commerce e non è sempre lo stesso del proprietario del progetto di infrastruttura cloud Adobe Commerce on.
Generare le chiavi API di produzione e sandbox genapikey
-
Accedi al tuo account Commerce all'indirizzo https://account.magento.com.
-
Nella scheda Magento, seleziona API Portal nella barra laterale.
-
Dal menu Ambiente, seleziona Produzione o Sandbox.
-
Immetti un nome nella sezione Chiavi API e fai clic su Aggiungi nuovo per aprire la finestra di dialogo e scaricare la nuova chiave.
note warning WARNING Puoi copiare o scaricare la chiave privata una sola volta. Conservarlo in modo sicuro. -
Fai clic su Scarica per salvare la chiave privata, quindi chiudi la finestra di dialogo.
-
Ripeti i passaggi precedenti per ogni ambiente (produzione e sandbox).
Nella sezione Chiavi API sono ora visualizzate le chiavi API (pubbliche). Sono necessarie tutte e quattro le chiavi (sia quelle di produzione che quelle di sandbox, Public+Private) quando si seleziona o si crea un progetto SaaS in uno qualsiasi degli ambienti o delle installazioni associati alla licenza.
Configurazione SaaS saasenv
Commerce istanze devono essere configurate con un progetto SaaS e uno spazio dati SaaS in modo che Commerce Services possa inviare dati alla posizione giusta. Un progetto SaaS raggruppa tutti gli spazi di dati SaaS. Gli spazi di dati SaaS vengono utilizzati per raccogliere e archiviare dati che consentono il funzionamento di Commerce Services. Alcuni di questi dati possono essere esportati dall'istanza Commerce e altri possono essere raccolti dal comportamento dell'acquirente nella vetrina. Tali dati vengono quindi salvati in modo permanente nell’archiviazione cloud protetta.
Per Product Recommendations e Live Search, lo spazio dati SaaS contiene dati di catalogo e comportamentali. È possibile indirizzare un'istanza Commerce a uno spazio dati SaaS selezionandola nella configurazione Commerce.
Se non riesci a trovare i campi di configurazione Live Search nell’amministratore, verifica di aver inserito la coppia di chiavi API corretta per lo spazio di dati selezionato (gli spazi di dati di produzione utilizzano le chiavi di produzione; i test degli spazi di dati utilizzano le chiavi sandbox). Se configuri chiavi non corrette, i servizi SaaS come Live Search non sono disponibili in tale ambiente Adobe Commerce.
Eliminare una chiave API delapikey
Prima di eliminare una chiave API, genera e memorizza in modo sicuro una chiave sostitutiva. Aggiorna tutte le integrazioni per utilizzare la nuova chiave e verifica che i servizi dipendenti funzionino come previsto.
Se non trovi i campi di configurazione Live Search nel pannello di amministrazione, conferma di aver immesso la chiave API SaaS corretta per tale ambiente. Utilizza la chiave SaaS di produzione per lo spazio di dati di produzione e la chiave di staging per lo spazio di dati di staging. Se viene configurata la chiave errata, i servizi SaaS (incluso Live Search) non saranno disponibili nell'ambiente Adobe Commerce.
Nella chiave API da rimuovere, fare clic su Delete. Quando richiesto, confermare l'operazione per rimuovere definitivamente la chiave.
Provisioning dello spazio dati SaaS
Tutti i commercianti di Adobe Commerce possono accedere a uno spazio di dati di produzione e due spazi di dati di test per ciascun progetto SaaS.
Puoi utilizzare gli spazi di dati di test in ambienti non di produzione, ma evita di utilizzare lo stesso spazio di dati in più ambienti contemporaneamente. Se desideri spostare uno spazio di dati di test in un ambiente diverso, esegui una pulizia dei dati prima di selezionarlo e configurarlo nel nuovo ambiente.
Per i progetti Adobe Commerce Cloud Pro con più ambienti di staging, puoi richiedere spazi di dati di test aggiuntivi per ogni ambiente di staging inviando una richiesta di supporto. Tuttavia, se disponi di un solo ambiente di staging e richiedi spazi di dati di test aggiuntivi, disponi delle seguenti opzioni:
-
Contatta il team Customer Success o il Customer Success Manager designato per richiedere un ambiente di staging aggiuntivo.
-
Inviare una richiesta di supporto per richiedere spazio dati di test aggiuntivo e indicare la giustificazione aziendale per tale spazio. Questa richiesta è soggetta ad approvazione.
I clienti Magento Open Source che utilizzano Adobe Payment Services possono richiedere anche uno spazio di dati aggiuntivo. Contatta il team dei pagamenti per ottenere l'approvazione preventiva degli spazi di dati aggiuntivi prima di inviare una richiesta di supporto per richiedere lo spazio di dati di prova.
I clienti che possiedono più progetti Cloud o installazioni on-premise (live/production) possono anche richiedere spazi di dati aggiuntivi per la produzione e il test per ciascun progetto o istanza inviando una richiesta di supporto.
Selezionare o creare un progetto SaaS createsaasenv
Per selezionare o creare un progetto SaaS, richiedere le chiavi API Commerce al proprietario della licenza Commerce per l'archivio:
-
Nella barra laterale Admin, vai a Sistema > Servizi > Connettore servizi Commerce.
Se non vedi la sezione Commerce Services Connector, installa i moduli Commerce per il Commerce servizio desiderato e assicurati che il pacchetto
magento/module-services-idsia installato. -
Nelle sezioni Sandbox API Keyse_Production API Keys_, incolla i valori chiave.
- Le chiavi private devono includere
-----BEGIN PRIVATE KEY-----all'inizio della chiave e-----END PRIVATE KEY-----alla fine. - Se non disponi di una copia delle chiavi effettive, chiedi al proprietario della licenza di inserirle, quindi collega i valori nella configurazione.
Non incollare i valori chiave copiati da un backup o da uno snapshot del database. Quando la configurazione viene salvata, viene applicato un ulteriore livello di crittografia e le chiavi non funzioneranno.
- Le chiavi private devono includere
-
Fai clic su Salva.
Tutti i progetti SaaS associati alle chiavi vengono visualizzati nel campo Progetto della sezione Identificatore SaaS.
-
Se non esistono progetti SaaS, fare clic su Crea progetto. Quindi nel campo Progetto, inserisci un nome per il progetto SaaS.
Per evitare confusione, non utilizzare un servizio Commerce specifico come nome del progetto (ad esempio, Live Search, Consigli di prodotto o Connessione dati). A meno che la licenza non sia stata fornita per più progetti SaaS, è possibile utilizzare lo stesso progetto SaaS per più servizi.
-
Seleziona lo Spazio dati da utilizzare per la configurazione corrente dell'archivio Commerce.
Se si dispone di istanze separate da integrare con Commerce Services, inviare un ticket di supporto per richiedere un nuovo progetto SaaS per ogni istanza aggiuntiva. Dopo aver creato il progetto SaaS, configura l’integrazione per l’istanza utilizzando le stesse chiavi API e selezionando il nuovo progetto SaaS per lo spazio dati.
Per modificare i nomi del progetto SaaS o dello spazio dati, fare clic su Rinomina accanto a uno dei due. La modifica del nome non influisce sul servizio, in quanto il nome è solo un’etichetta per identificare e distinguere tra progetti e spazi di dati.
Organizzazione IMS (opzionale) organizationid
Per collegare la tua istanza di Adobe Commerce a Adobe Experience Platform, accedi al tuo account di Adobe utilizzando il tuo Adobe ID. Dopo l’accesso, l’organizzazione IMS associata al tuo account Adobe viene visualizzata in questa sezione.
Esportazione dati SaaS
Quando l'istanza Commerce si connette a Commerce Services, il processo di esportazione dei dati SaaS esporta i dati Commerce dal server Commerce in Commerce SaaS Services in modo che possano essere sincronizzati con i servizi Commerce connessi. In Admin, puoi controllare lo stato di sincronizzazione utilizzando Data Management dashboard. Per informazioni dettagliate, vedere la Guida all'esportazione dei dati SaaS.