Felsöka din Magento 2-integration

Du kommer att lära dig

Lär dig hur du löser problem med din Magento 2 OAuth-konfiguration genom att följa felsökningsstegen nedan. Om du fortfarande stöter på problem efter att du har gått igenom de här stegen kan du höra av dig i vår Community eller till vårt supportteam.

Innan du börjar

Om du inte redan har gjort det, läs vår guide om Komma igång med Magento 2 för steg-för-steg-instruktioner om hur du konfigurerar din Magento 2-integration.

Klaviyo använder OAuth-protokollet för att generera en åtkomsttoken och hämta data från din Magento 2-butik. Om du har anpassat din Magento 2-installation kan det göra att Klaviyos OAuth-process misslyckas. Den här artikeln guidar dig genom en serie felsökningssteg för att identifiera var felet uppstår.

Allmänna felsökningssteg

Se till att din webbplats är offentligt tillgänglig med ett giltigt SSL-certifikat

Klaviyos OAuth-procedur kräver att din webbplats är offentligt tillgänglig, annars misslyckas de nödvändiga API-anropen för att generera åtkomsttoken.

1. Se till att du inte har lösenordsskyddat eller IP-begränsat åtkomst till din butik.
2. Se till att din butik är åtkomlig via HTTPS med ett giltigt SSL-certifikat. Du kan testa ditt certifikat här.

Se till att din brandvägg inte blockerar Klaviyos förfrågningar

All utgående Klaviyo-integrationstrafik ligger bakom en uppsättning förutsägbara, statiska IP-adresser så att du kan känna dig trygg med att den här trafiken kommer från Klaviyo. Läs vår artikel och lär dig hur du lägger till IP-adresser för Klaviyo-integrationstrafik i godkännandelistan.

Kontrollera dina Magento 2- och Klaviyo-tilläggsversioner

1. Om du använder Magento v2.2.0 behöver du aktivera OAuth manuellt.
2. Se till att du har installerat rätt Klaviyo-tillägg (du kan behöva uppgradera).

Se till att OAuth-slutpunkter är tillgängliga

Du kan ha extra eller saknade omskrivningsregler, vilket kan göra standard-slutpunkterna för Magento 2 OAuth otillgängliga. Klaviyo måste ha åtkomst till dessa slutpunkter för att generera de nödvändiga autentiseringsuppgifterna för auktoriseringsprocessen.

Se till att webbadresserna nedan är åtkomliga för din butik:

https://[Store URL]/oauth/token/request

https://[Store URL]/oauth/token/access

1. Du kan validera att de är tillgängliga genom att göra en POST-begäran så här:

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

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

1. Du bör förvänta dig ett svar som liknar följande. Det är normalt att se ett fel när du gör en begäran på det här sättet, och det bekräftar att slutpunkterna svarar korrekt.
   

2. Om du inte får något svar som rör OAuth bör du kontrollera att det inte finns några omdirigeringar, ogiltiga omskrivningsregler eller interna serverfel som hindrar åtkomst till dessa webbadresser.

Detta kan orsakas av en butikens undersökväg i din URL. Testa om det finns ett problem med butikens undersökväg genom att öppna slutpunkterna på:

https://[Store URL]/[Store Path]/oauth/token/request

https://[Store URL]/[Store Path]/oauth/token/access

Om dessa slutpunkter löser problemet kan du lägga till omskrivningsreglerna nedan i din .htaccess -fil för att lösa problemet.

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]

Ta bort integrationen och skapa den igen

Om du har gjort ändringar efter ett tidigare misslyckat integrationsförsök är det en bra idé att ta bort den ursprungliga OAuth-integrationen. Nycklarna som används kan vara ogiltiga och behöver genereras på nytt.

1. I Magento navigerar du till Systems
2. Select integrationer
3. Leta upp integrationsposten för Klaviyo och ta bort den

När integrationsposten har tagits bort följer du stegen i vår guide hur du integrerar med Magento 2 för att skapa en ny integrationspost och försöka igen.

Magento: versionsspecifika problem

Fel som är specifikt för Magento 2.4.2

Om du använder Magento 2.4.2 finns det ett känt problem där OAuth-aktiveringar misslyckas. När du aktiverar integrationen kan du se ett felmeddelande som det som visas nedan. Även om du inte får felet kan OAuth-aktiveringen ha misslyckats. Normalt hittar du felet i dina Magento-loggar.

För att lösa det här felet behöver du antingen:

• Uppgradera till Magento 2.4.3. Se Magentos 2 dokumentation för att uppgradera din version.
• Applicera en patch enligt beskrivningen i Klaviyos github-repository för Magento 2.

Autentiseringsfel som är specifikt för Magento 2.4.6

Använder du Magento 2.4.6 och får ett 401-autentiseringsfel efter integreringen med Klaviyo? Det kan bero på en känd Magento-bugg som påverkar Magento version 2.4.6. För att lösa detta behöver du aktivera bearer token-autentisering så att Klaviyo kan göra förfrågningar med den (i stället för OAuth 1.0). Så här aktiverar du bearer token-autentisering:

1. I din Magento-administratör går du till Stores > Configuration > Services > OAuth > Consumer Settings.
2. För inställningen Tillåt att OAuth-åtkomsttoken används som fristående Bearer-token väljer du Ja.
3. Klicka på Spara konfiguration.
   

När du har gjort den här uppdateringen bör dina tidigare autentiseringsfel lösas och integrationer synkroniseringar återupptas.

Ytterligare resurser