Fehlerbehebung bei deiner Magento 2 Integration

Du wirst lernen

Erfahre, wie du Probleme mit deiner Magento 2 OAuth-Einrichtung lösen kannst, indem du die unten beschriebenen Schritte zur Fehlerbehebung befolgst. Wenn du nach dem Durchlaufen dieser Schritte immer noch Probleme hast, wende dich bitte an unsere Community oder an unser Support-Team. 

Bevor du beginnst

Falls du es noch nicht getan hast, lies unseren Leitfaden " Erste Schritte mit Magento 2 ", um eine Schritt-für-Schritt-Anleitung zur Einrichtung deiner Magento 2-Integration zu erhalten.

Klaviyo verwendet das OAuth-Protokoll, um ein Zugriffstoken zu generieren und Daten aus deinem Magento 2 Laden abzurufen. Wenn du deine Magento 2-Installation angepasst hast, kann dies dazu führen, dass das OAuth-Verfahren von Klaviyo fehlschlägt. Dieser Artikel führt dich durch eine Reihe von Schritten zur Fehlersuche, um herauszufinden, wo der Fehler auftritt.

Allgemeine Schritte zur Fehlerbehebung

Stelle sicher, dass deine Website mit einem gültigen SSL-Zertifikat öffentlich zugänglich ist

Das OAuth-Verfahren von Klaviyo setzt voraus, dass deine Website öffentlich zugänglich ist, da sonst die notwendigen API-Aufrufe zur Generierung der Zugriffstoken fehlschlagen. 

1. Vergewissere dich, dass du den Zugang zu deinem Laden nicht durch ein Passwort oder eine IP-Beschränkung geschützt hast.
2. Stelle sicher, dass dein Laden über HTTPS mit einem gültigen SSL-Zertifikat erreichbar ist. Du kannst dein Zertifikat hier testen.

Stelle sicher, dass deine Firewall die Anfragen von Klaviyo nicht blockiert

Der gesamte ausgehende Klaviyo-Integrationsverkehr läuft hinter einer Reihe von vorhersehbaren, statischen IP-Adressen, so dass du ein hohes Maß an Vertrauen haben kannst, dass dieser Verkehr von Klaviyo kommt. Lies unseren Artikel, um zu erfahren , wie du die IP-Adressen des Klaviyo Integrationsverkehrs auf eine Whitelist setzen kannst. 

Überprüfe die Versionen deiner Magento 2 und Klaviyo Erweiterung

1. Wenn du Magento v2.2.0 verwendest, musst du OAuth manuell aktivieren.
2. Vergewissere dich, dass du die richtige Klaviyo-Erweiterung installiert hast (eventuell musst du ein Upgrade durchführen).

Sicherstellen, dass OAuth-Endpunkte zugänglich sind

Möglicherweise hast du zusätzliche oder fehlende Rewrite-Regeln, die die Standard-OAuth-Endpunkte von Magento 2 unzugänglich machen. Klaviyo muss auf diese Endpunkte zugreifen, um die notwendigen Anmeldedaten für den Autorisierungsprozess zu generieren.

Stelle sicher, dass die folgenden URLs für deinen Laden zugänglich sind:

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

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

1. Du kannst überprüfen, ob sie zugänglich sind, indem du eine POST-Anfrage wie diese stellst:

   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 solltest eine ähnliche Antwort wie die folgende erwarten. Es ist normal, dass bei einer solchen Anfrage ein Fehler angezeigt wird, und es bestätigt, dass die Endpunkte richtig reagieren. 
   
3. Wenn du keine Antwort in Bezug auf OAuth erhältst, solltest du überprüfen, ob es keine Weiterleitungen, ungültige Rewrite-Regeln oder interne Serverfehler gibt, die den Zugriff auf diese URLs verhindern.

Dies kann durch einen Laden-Unterpfad in deiner URL verursacht werden. Teste, ob ein Problem mit dem Laden von Unterpfaden vorliegt, indem du auf die Endpunkte zugreifst:

https://[Laden URL]/[Laden Pfad]/oauth/token/request

https://[Laden URL]/[Laden Pfad]/oauth/token/access

Wenn diese Endpunkte funktionieren, dann füge die folgenden Rewrite-Regeln in deine .htaccess ein Datei, um das Problem zu lösen.

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

Lösche die Integration und erstelle sie neu

Wenn du nach einem gescheiterten Integrationsversuch Änderungen vorgenommen hast, ist es ratsam, die ursprüngliche OAuth-Integration zu löschen. Die verwendeten Schlüssel können ungültig sein und müssen neu generiert werden.

1. Navigieren Sie in Magento zu Systeme
2. Integrationenauswählen
3. Finde den Datensatz der Klaviyo-Integration und lösche ihn

Wenn der Integrationsdatensatz gelöscht wurde, befolge die Schritte in unserem Leitfaden zur Integration in Magento 2, um einen neuen Integrationsdatensatz zu erstellen und versuche es erneut.

Magento versionsspezifische Probleme

Fehler spezifisch für Magento 2.4.2

Wenn du Magento 2.4.2 verwendest, gibt es ein bekanntes Problem, bei dem OAuth-Aktivierungen fehlschlagen. Wenn du die Integration aktivierst, siehst du möglicherweise eine Fehlermeldung wie die unten abgebildete. Auch wenn du die Fehlermeldung nicht erhältst, kann die OAuth-Aktivierung fehlgeschlagen sein. Normalerweise kannst du den Fehler in deinen Magento-Logs finden.

Um diesen Fehler zu beheben, musst du entweder:

• Upgrade auf Magento 2.4.3. Schau in der Dokumentation von Magento 2 nach, um deine Version zu aktualisieren. 
• Wende einen Patch an, wie im Klaviyo-Github-Repository für Magento 2 beschrieben.

Authentifizierungsfehler spezifisch für Magento 2.4.6

Benutzt du Magento 2.4.6 und bekommst einen 401 Authentifizierungsfehler nach der Integration mit Klaviyo? Dies könnte auf einen bekannten Magento-Bug zurückzuführen sein, der die Magento-Version 2.4.6 betrifft. Um dieses Problem zu lösen, musst du die Bearer-Token-Authentifizierung aktivieren, damit Klaviyo Anfragen damit stellen kann (anstelle von OAuth 1.0). Um die Inhaber-Token-Authentifizierung zu aktivieren:

1. Navigiere in deinem Magento Admin zu Laden > Konfiguration > Dienste > OAuth > Consumer Settings.
2. Wähle für die Einstellung OAuth Access Tokens als eigenständige Bearer-Tokens zulassen die Option Ja.
3. Klicke auf Save Config.
   

Nachdem du dieses Update durchgeführt hast, sollten deine vorherigen Authentifizierungsfehler behoben sein und die Integration wird wieder synchronisiert.

Zusätzliche Ressourcen

Magento 2 Datenreferenz
Anleitung zur Unterstützung mehrerer Magento Laden (für Magento 2.x)