Fehlerbehebung bei deiner Magento-2-Integration

Übersicht

Erfahre, wie du Probleme mit deiner Magento 2 OAuth-Einrichtung beheben kannst, indem du die unten beschriebenen Schritte zur Fehlerbehebung befolgst. Wenn du nach dem Durchlaufen dieser Schritte immer noch Probleme hast, melde dich bitte in unserer Community oder bei unserem Support-Team.

Bevor du anfängst

Falls du das noch nicht getan hast, lies unseren Leitfaden zu Erste Schritte mit Magento 2, um Schritt-für-Schritt-Anleitungen zum Einrichten deiner Magento 2-Integrationen zu erhalten.

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

Allgemeine Schritte zur Fehlerbehebung

Stelle sicher, dass deine Website öffentlich zugänglich ist und über ein gültiges SSL-Zertifikat verfügt

Klaviyos OAuth-Verfahren setzt voraus, dass deine Website öffentlich zugänglich ist, da andernfalls die erforderlichen API-Aufrufe zum Generieren der Zugriffstoken fehlschlagen.

1. Stelle sicher, dass du den Zugriff auf deinen Shop nicht per Passwort geschützt oder per IP eingeschränkt hast.
2. Stelle sicher, dass dein Shop über HTTPS mit einem gültigen SSL-Zertifikat erreichbar ist. Du kannst dein Zertifikat hier testen.

Stell sicher, dass deine Firewall Klaviyo’s Anfragen nicht blockiert

Der gesamte ausgehende Klaviyo-Integrationen-Traffic läuft über eine Reihe vorhersehbarer, statischer IP-Adressen, sodass du ein hohes Maß an Sicherheit hast, dass dieser Traffic von Klaviyo stammt. Lies unseren Artikel, um zu erfahren, wie du IP-Adressen für Klaviyo-Integrationen-Traffic auf die Whitelist setzt.

Prüfe deine Magento 2- und Klaviyo-Erweiterungsversionen

1. Wenn du Magento v2.2.0 verwendest, musst du OAuth manuell aktivieren.
2. Stelle sicher, dass du die richtige Klaviyo-Erweiterung installiert hast (möglicherweise musst du ein Upgrade durchführen).

Stelle sicher, dass OAuth-Endpunkte erreichbar sind

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

Stelle sicher, dass die untenstehenden URLs für deinen Shop zugänglich sind:

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

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

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

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 solltest mit einer Antwort rechnen, die der folgenden ähnelt. Es ist normal, bei einer Anfrage auf diese Weise einen Fehler zu sehen, und das bestätigt, dass die Endpunkte korrekt reagieren.
   

2. Wenn du keine OAuth-bezogene Antwort erhältst, solltest du prüfen, ob keine Weiterleitungen, ungültigen Rewrite-Regeln oder internen Serverfehler den Zugriff auf diese URLs verhindern.

Das kann durch einen Store-Unterpfad in deiner URL verursacht werden. Teste auf ein Problem mit einem Store-Unterpfad, indem du die Endpunkte unter folgender Adresse aufrufst:

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

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

Wenn diese Endpunkte aufgelöst werden, füge dann die folgenden Rewrite-Regeln in deine .htaccess ein. Datei, um das Problem zu beheben.

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]

Lösche die Integration und erstelle sie neu

Wenn du nach einem vorherigen fehlgeschlagenen Integrationsversuch Änderungen vorgenommen hast, ist es eine gute Idee, die ursprüngliche OAuth-Integration zu löschen. Die verwendeten Schlüssel sind möglicherweise ungültig und müssen neu generiert werden.

1. Navigiere in Magento zu Systeme
2. Select Integrationen
3. Such den Klaviyo-Integrationsdatensatz und lösch ihn.

Sobald der Integrationen-Datensatz gelöscht wurde, folge den Schritten in unserer Anleitung So integrierst du Magento 2, um einen neuen Integrationen-Datensatz zu erstellen und es erneut zu versuchen.

Magento-versionsspezifische Probleme

Fehler speziell 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 Integrationen aktivierst, siehst du möglicherweise eine Fehlermeldung wie die unten gezeigte. Auch wenn du den Fehler nicht erhältst, ist die OAuth-Aktivierung möglicherweise fehlgeschlagen. Normalerweise findest du den Fehler in deinen Magento-Protokollen.

Um diesen Fehler zu beheben, musst du entweder:

• Führe ein Upgrade auf Magento 2.4.3 durch. Sieh dir die Dokumentation von Magento 2 an, um ein Upgrade deiner Version durchzuführen.
• Wende einen Patch wie beschrieben im github-Repository von Klaviyo für Magento 2 an.

Authentifizierungsfehler speziell für Magento 2.4.6

Nutzt du Magento 2.4.6 und tritt nach der Integration mit Klaviyo ein 401-Authentifizierungsfehler auf? Das kann an einem bekannten Magento-Bug liegen, der die Magento-Version 2.4.6 betrifft. Um das zu beheben, musst du die Bearer-Token-Authentifizierung aktivieren, damit Klaviyo damit Anfragen stellen kann (anstelle von OAuth 1.0). So aktivierst du die Bearer-Token-Authentifizierung:

1. Navigiere in deiner Magento-Admin-Oberfläche zu Stores > Configuration > Services > OAuth > Consumer Settings.
2. Wähle für die Einstellung Allow OAuth Access Tokens to be used as stand-alone Bearer tokens Ja aus.
3. Klicke auf Konfiguration speichern.
   

Nach diesem Update sollten sich deine bisherigen Authentifizierungsfehler beheben und die Synchronisierung der Integrationen wird fortgesetzt.