Felsökning av din Magento 2-integrerare

Du kommer att lära dig

Lär dig hur du löser problem med din Magento 2 OAuth-installation genom att följa felsökningsstegen som beskrivs nedan. Om du fortfarande stöter på problem efter att ha gått igenom dessa steg, vänligen kontakta vår community eller 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 för att ställa in din Magento 2-integrerare.

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 leda till att Klaviyo:s OAuth-procedur 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 tillgänglig för allmänheten med ett giltigt SSL-certifikat

KlaviyoOAuth-proceduren kräver att din webbplats är tillgänglig för allmänheten, annars kommer de nödvändiga API -anropen för att generera åtkomsttoken att misslyckas. 

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

Kontrollera att din brandvägg inte blockerar Klaviyo:s förfrågningar

All utgående Klaviyo integrationer-trafik ligger bakom en uppsättning förutsägbara, statiska IP-adresser så att du kan ha en hög grad av förtroende för att denna trafik kommer från Klaviyo. Läs vår artikel för att lära dig hur du godkännandelista Klaviyo integrationer trafik IP-adresser. 

Kontrollera dina Magento 2- och Klaviyo-tilläggsversioner

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

Säkerställ att OAuth slutpunkt är tillgänglig

Du kanske har extra eller saknade omskrivningsregler som kan göra standard Magento 2 OAuth slutpunkt otillgänglig. Klaviyo behöver komma åt dessa slutpunkter för att generera de nödvändiga inloggningsuppgifterna för auktoriseringsprocessen.

Se till att webbadresserna nedan är tillgängliga för din butik:

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

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

1. Du kan bekräfta 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

2. Du bör förvänta dig ett svar som liknar följande. Det är normalt att se ett fel när man gör en förfrågan på det här sättet, och det validerar att slutpunkt svarar korrekt. 
   
3. Om du inte får något svar relaterat till OAuth bör du kontrollera att det inte finns några omdirigeringar, ogiltiga omskrivningsregler eller interna serverfel som förhindrar åtkomst till dessa webbadresser.

Detta kan orsakas av en butikssubväg i din URL. Testa om det finns ett problem med butikens underväg genom att gå till slutpunkten på:

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

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

Om dessa slutpunkt löser sig, inkludera sedan nedanstående omskrivningsregler i din .htaccess filen för att lösa problemet.

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

Ta bort integreraren och skapa den på nytt

Om du har gjort ändringar efter ett tidigare misslyckat integrationsförsök är det en god idé att ta bort den ursprungliga OAuth-integrationen. De nycklar som används kan vara ogiltiga och måste återskapas.

1. I Magento, navigera till System
2. Välj integrationer
3. Leta reda på posten Klaviyo integrationer och ta bort den

När integrationsposten har tagits bort följer du stegen i vår guide om hur du integrerar med Magento 2 för att skapa en ny integrationspost och försöker 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 integrationsprogrammet kan det hända att du får ett felmeddelande som det som visas nedan. Även om du inte får felmeddelandet kan OAuth-aktiveringen ha misslyckats. Normalt kan felet hittas i dina Magento-loggar.

För att lösa detta fel måste du antingen:

• Uppgradera till Magento 2.4.3. Se Magento 2:s dokumentation för att uppgradera din version. 
• Tillämpa en patch enligt beskrivningen i Klaviyo:s github-repository för Magento 2.

autentiseringsfel specifikt för Magento 2.4.6

Är du på Magento 2.4.6 och upplever ett 401 autentiseringsfel efter integrering med Klaviyo? Detta kan bero på en känd Magento-bugg som påverkar Magento version 2.4.6. För att lösa detta måste du aktivera autentisering av bearer token så att Klaviyo kan göra förfrågningar med hjälp av det (istället för OAuth 1.0). Så här aktiverar du autentisering med bearer token:

1. I din Magento admin, navigera till butik > Konfiguration > Tjänster > OAuth > Konsumentinställningar.
2. För inställningen Allow OAuth Access Tokens to be used as stand-alone Bearer tokens (Tillåt att OAuth Access Tokens används som fristående Bearer-tokens) väljer du Yes.
3. Klicka på Spara konfig.
   

När du har gjort denna uppdatering bör dina tidigare autentiseringsfel lösas och synkroniseringen av integrationer återupptas.

Ytterligare resurser

Magento 2 data referens
Guide för att stödja flera Magento butiker (för Magento 2.x)