Problemen oplossen met je Magento 2 integraties

Wat je leert

Leer hoe je problemen met je Magento 2 OAuth installatie kunt oplossen door de hieronder beschreven stappen voor probleemoplossing te volgen. Als je na het doorlopen van deze stappen nog steeds problemen ondervindt, bereik dan onze community of ons supportteam. 

Voordat je van start gaat

Als je dit nog niet hebt gedaan, lees dan onze gids over Aan de slag met Magento 2 voor stapsgewijze instructies om je Magento 2 integraties in te stellen.

Klaviyo gebruikt het OAuth protocol om een toegangstoken te genereren en gegevens op te halen van je Magento 2 zaak. Als je je Magento 2 installatie hebt aangepast, kan dit ervoor zorgen dat de OAuth procedure van Klaviyo mislukt. Dit artikel leidt je door een reeks stappen voor probleemoplossing om vast te stellen waar de storing optreedt.

Algemene stappen voor probleemoplossing

Zorg ervoor dat je site publiek toegankelijk is met een geldig SSL-certificaat

Klaviyo's OAuth procedure vereist dat je website publiek toegankelijk is, anders zullen de benodigde API-aanroepen om de toegangstokens te genereren mislukken. 

1. Zorg ervoor dat je de toegang tot je zaak niet met een wachtwoord of IP hebt beveiligd.
2. Zorg ervoor dat je zaak toegankelijk is via HTTPS met een geldig SSL-certificaat. Je kunt je certificaat hier testen.

Zorg ervoor dat uw firewall de verzoeken van Klaviyo niet blokkeert

Al het uitgaande verkeer van Klaviyo integraties zit achter een reeks voorspelbare, statische IP-adressen, zodat je een hoge mate van vertrouwen kunt hebben dat dit verkeer afkomstig is van Klaviyo. Lees ons artikel om te leren hoe je positieve lijst Klaviyo integraties IP-adressen voor verkeer. 

Controleer de versies van je Magento 2 en Klaviyo extensies

1. Als je Magento v2.2.0 gebruikt, moet je OAuth handmatig inschakelen.
2. Zorg ervoor dat je de juiste Klaviyo extensie hebt geïnstalleerd (mogelijk moet je upgraden).

Zorg ervoor dat OAuth eindpunten toegankelijk zijn

Het kan zijn dat je extra of ontbrekende herschrijfregels hebt waardoor het standaard Magento 2 OAuth eindpunt ontoegankelijk wordt. Klaviyo moet toegang krijgen tot dit eindpunt om de benodigde referenties voor het autorisatieproces te genereren.

Zorg ervoor dat onderstaande URL's toegankelijk zijn voor je zaak:

https://[URL van de winkel]/oauth/token/request

https://[URL van de winkel]/oauth/token/access

1. Je kunt valideren dat ze toegankelijk zijn door een POST-verzoek als dit te doen:

   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. Je kunt een antwoord verwachten dat lijkt op het volgende. Het is normaal om een foutmelding te zien als je op deze manier een verzoek doet, en het valideert dat het eindpunt correct reageert. 
   
3. Als je geen antwoord ontvangt met betrekking tot OAuth, moet je controleren of er geen omleidingen, ongeldige herschrijfregels of interne serverfouten zijn die de toegang tot deze URL's verhinderen.

Dit kan worden veroorzaakt door een zaak subpad in je URL. Test op een probleem met het subpad van de zaak door het eindpunt te openen op:

https://[zaak URL]/[zaak Pad]/oauth/token/request

https://[zaak URL]/[zaak Pad]/oauth/token/access

Als deze eindpunten worden opgelost, neem dan de volgende herschrijfregels op in je .htaccess bestand om het probleem op te lossen.

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

Verwijder de integraties en maak ze opnieuw aan

Als je wijzigingen hebt aangebracht na een eerdere mislukte poging tot integratie, is het een goed idee om de oorspronkelijke OAuth-integratie te verwijderen. De gebruikte sleutels kunnen ongeldig zijn en moeten opnieuw worden gegenereerd.

1. Navigeer binnen Magento naar Systemen
2. Selecteer integraties
3. Zoek het record Klaviyo integraties en verwijder het.

Als het integratierecord is verwijderd, volg dan de stappen in onze gids Hoe integreren met Magento 2 om een nieuw integratierecord aan te maken en probeer het opnieuw.

Magento versie-specifieke problemen

Storing specifiek voor Magento 2.4.2

Als je Magento 2.4.2 gebruikt, is er een bekend probleem waarbij OAuth-activeringen mislukken. Bij het activeren van de integraties kun je een foutmelding zien zoals hieronder. Zelfs als je de foutmelding niet krijgt, kan de OAuth activering zijn mislukt. Normaal gesproken is de fout te vinden in je Magento logboeken.

Om deze foutmelding op te lossen, moet je ofwel:

• Upgrade naar Magento 2.4.3. Bekijk de documentatie van Magento 2 om je versie te upgraden. 
• Pas een patch toe zoals beschreven op Klaviyo's github repository voor Magento 2.

verificatiefout specifiek voor Magento 2.4.6

Gebruik je Magento 2.4.6 en ervaar je een 401 verificatiefout na de integratie met Klaviyo? Dit kan het gevolg zijn van een bekende Magento-bug in Magento-versie 2.4.6. Om dit op te lossen, moet je bear token verificatie inschakelen zodat Klaviyo verzoeken kan doen met behulp hiervan (in plaats van OAuth 1.0). Toon token verificatie inschakelen:

1. Navigeer in je Magento admin naar zaak > Configuratie > Diensten > OAuth > Consumenteninstellingen.
2. Selecteer Ja voor de instelling Sta toe dat OAuth toegangstokens worden gebruikt als op zichzelf staande Bearer tokens.
3. Klik op Configuratie opslaan.
   

Na het maken van deze update zouden je eerdere verificatiefouten moeten verdwijnen en zullen de integratiesynchronisaties worden hervat.

Extra hulpbronnen

Magento 2 gegevens referentie
Gids voor ondersteuning van meerdere Magento zaken (voor Magento 2.x)