Risoluzione dei problemi dell'integrazione con Magento 2

Imparerà

Scopra come risolvere i problemi con la configurazione di Magento 2 OAuth seguendo i passaggi di risoluzione dei problemi descritti di seguito. Se, dopo aver eseguito questi passaggi, riscontra ancora dei problemi, si rivolga alla nostra Community o al nostro Team di assistenza. 

Prima di iniziare

Se non l'ha ancora fatto, legga la nostra guida su Come iniziare con Magento 2 per le istruzioni passo-passo per impostare la sua integrazione con Magento 2.

Klaviyo utilizza il protocollo OAuth per generare un token d'accesso e recuperare i dati dal suo negozio Magento 2. Se ha personalizzato la sua installazione di Magento 2, può far fallire la procedura OAuth di Klaviyo. Questo articolo la guiderà attraverso una serie di passaggi di risoluzione dei problemi per identificare il punto in cui si verifica il guasto.

Passi generali per la risoluzione dei problemi

Si assicuri che il suo sito sia accessibile pubblicamente con un certificato SSL valido.

La procedura OAuth di Klaviyo richiede che il suo sito web sia accessibile pubblicamente, altrimenti le chiamate all'API necessarie per generare i token di accesso falliranno. 

1. Si assicuri di non aver protetto con password o IP l'accesso al suo negozio.
2. Si assicuri che il suo negozio sia accessibile via HTTPS con un certificato SSL valido. Può testare il suo certificato qui.

Si assicuri che il suo firewall non stia bloccando le richieste di Klaviyo.

Tutto il traffico di integrazione di Klaviyo in uscita si trova dietro una serie di indirizzi IP statici e prevedibili, in modo da poter avere un alto livello di sicurezza che questo traffico provenga da Klaviyo. Legga il nostro articolo per sapere come consentire gli indirizzi IP del traffico dell'integrazione di Klaviyo. 

Controlli le versioni di Magento 2 e dell'estensione Klaviyo

1. Se utilizza Magento v2.2.0, dovrà abilitare manualmente OAuth.
2. Si assicuri di aver installato l'estensione Klaviyo corretta (potrebbe essere necessario un aggiornamento).

Assicurarsi che gli endpoint OAuth siano accessibili

Potreste avere delle regole di riscrittura in più o in meno, che possono rendere inaccessibili gli endpoint OAuth predefiniti di Magento 2. Klaviyo deve accedere a questi endpoint per generare le credenziali necessarie per il processo di autorizzazione.

Si assicuri che gli URL sottostanti siano accessibili per il suo negozio:

https://[URL del negozio]/oauth/token/richiesta

https://[URL del negozio]/oauth/token/accesso

1. Può convalidare che siano accessibili facendo una richiesta POST come questa:

   curl --location --url 'https://[Store URL]/oauth/token/request' --request 'POST' -v

   curl --location --url 'https://[Store URL]/oauth/token/access' --request 'POST' -v

2. Si aspetti una risposta simile alla seguente. È normale vedere un errore quando si effettua una richiesta in questo modo, e convalida che gli endpoint rispondano correttamente. 
   
3. Se non riceve una risposta relativa a OAuth, deve verificare che non ci siano reindirizzamenti, regole di riscrittura non valide o errori interni del server che impediscono l'accesso a questi URL.

Questo può essere causato da un sottopercorso del negozio nell'URL. Verifichi la presenza di un problema di sottopercorso del negozio accedendo agli endpoint a:

https://[URL negozio]/[Percorso negozio]/oauth/token/richiesta

https://[URL negozio]/[Percorso negozio]/oauth/token/accesso

Se questi endpoint si risolvono, includa le seguenti regole di riscrittura nel suo .htaccess per risolvere il problema.

RewriteEngine on
RewriteRule /oauth/token/request$ https://%{HTTP_HOST}/[Store Path]/oauth/token/request [L,R=301]
RewriteRule /oauth/token/access$ https://%{HTTP_HOST}/[Store Path]/oauth/token/access [L,R=301]

Cancelli l'integrazione e la ricrei

Se ha apportato delle modifiche dopo un precedente tentativo di integrazione fallito, è una buona idea eliminare l'integrazione OAuth originale. Le chiavi utilizzate potrebbero essere non valide e dovranno essere rigenerate.

1. All'interno di Magento, vada su Sistemi
2. Selezionare le integrazioni
3. Individui il record di integrazione di Klaviyo e lo elimini.

Una volta eliminato il record di integrazione, segua i passi della nostra guida su come integrare con Magento 2 per creare un nuovo record di integrazione e riprovare.

Problemi specifici della versione di Magento

Fallimento specifico di Magento 2.4.2

Se sta utilizzando Magento 2.4.2, c'è un problema noto in cui le attivazioni OAuth falliscono. Dopo aver attivato l'integrazione, potrebbe visualizzare un messaggio di errore come quello mostrato di seguito. Anche se non riceve l'errore, l'attivazione di OAuth potrebbe essere fallita. Normalmente, l'errore si trova nei log di Magento.

Per risolvere questo errore, dovrà o..:

• Aggiornare a Magento 2.4.3. Consulti la documentazione di Magento 2 per aggiornare la sua versione. 
• Applichi una patch come descritto nel repository github di Klaviyo per Magento 2.

Fallimento dell'autenticazione specifico di Magento 2.4.6

Sta utilizzando Magento 2.4.6 e sta riscontrando un errore di autenticazione 401 dopo l'integrazione con Klaviyo? Questo potrebbe essere dovuto a un bug noto di Magento che riguarda la versione 2.4.6 di Magento. Per risolvere questo problema, dovrà abilitare l'autenticazione con token del portatore, in modo che Klaviyo possa effettuare richieste utilizzando questo (invece di OAuth 1.0). Per abilitare l'autenticazione con token portatore:

1. Nell'amministrazione di Magento, si rechi in Negozi > Configurazione > Servizi > OAuth > Impostazioni del consumatore.
2. Per l'impostazione Consenti l'utilizzo dei token di accesso OAuth come token Bearer autonomi, selezioni Sì.
3. Clicchi su Salva configurazione.
   

Dopo aver effettuato questo aggiornamento, gli errori di autenticazione precedenti dovrebbero risolversi e le sincronizzazioni di integrazione riprenderanno.

Risorse aggiuntive

Riferimento dati Magento 2
Guida al supporto di più negozi Magento (per Magento 2.x)