Rozwiązywanie problemów z integracją Magento 2

Czego się dowiesz

Dowiedz się, jak rozwiązać problemy z konfiguracją Magento 2 OAuth, wykonując opisane poniżej kroki rozwiązywania problemów. Jeśli po wykonaniu tych kroków nadal napotykasz problemy, prosimy o kontakt z naszą społecznością lub z naszym zespołem ds. pomocy. 

Zanim zaczniesz

Jeśli jeszcze tego nie zrobiłeś, przeczytaj nasz przewodnik Pierwsze kroki z Magento 2, aby uzyskać instrukcje krok po kroku dotyczące konfiguracji integracji Magento 2.

Klaviyo wykorzystuje protokół OAuth do generowania tokenu dostępu i pobierania danych z Twojego sklepu Magento 2. Jeśli dostosowałeś swoją instalację Magento 2, może to spowodować niepowodzenie procedury OAuth Klaviyo. Ten artykuł poprowadzi Cię przez szereg kroków rozwiązywania problemów w celu zidentyfikowania miejsca wystąpienia awarii.

Ogólne kroki rozwiązywania problemów

Upewnij się, że Twoja witryna jest publicznie dostępna z ważnym certyfikatem SSL.

Procedura OAuth Klaviyo wymaga, aby Twoja witryna była publicznie dostępna, w przeciwnym razie wywołania API niezbędne do wygenerowania tokenów dostępu zakończą się niepowodzeniem. 

1. Upewnij się, że dostęp do Twojego sklepu nie jest chroniony hasłem lub ograniczony przez IP.
2. Upewnij się, że Twój sklep jest dostępny przez HTTPS z ważnym certyfikatem SSL. Możesz przetestować swój certyfikat tutaj.

Upewnij się, że zapora sieciowa nie blokuje żądań Klaviyo.

Cały ruch wychodzący z witryny Klaviyo integracje odbywa się za pośrednictwem zestawu przewidywalnych, statycznych adresów IP, dzięki czemu możesz mieć wysoki poziom pewności, że ruch ten pochodzi z witryny Klaviyo. Przeczytaj nasz artykuł, aby dowiedzieć się, jak biała lista Klaviyo integracje ruchu adresów IP. 

Sprawdź swoje wersje rozszerzeń Magento 2 i Klaviyo

1. Jeśli korzystasz z Magento v2.2.0, musisz ręcznie włączyć OAuth.
2. Upewnij się, że masz zainstalowane odpowiednie rozszerzenie Klaviyo (może być konieczna aktualizacja).

Upewnij się, że OAuth punkt końcowy jest dostępny

Możesz mieć dodatkowe lub brakujące reguły przepisywania, które mogą sprawić, że domyślny Magento 2 OAuth punkt końcowy będzie niedostępny. Klaviyo musi uzyskać dostęp do tych punktów końcowych, aby wygenerować niezbędne dane uwierzytelniające dla procesu autoryzacji.

Upewnij się, że poniższe adresy URL są dostępne dla Twojego sklepu:

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

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

1. Możesz sprawdzić, czy są one dostępne, wysyłając żądanie POST w następujący sposób:

   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. Powinieneś spodziewać się odpowiedzi podobnej do poniższej. To normalne, że podczas wysyłania żądania w ten sposób pojawia się błąd, który potwierdza, że punkt końcowy odpowiada prawidłowo. 
   
3. Jeśli nie otrzymasz odpowiedzi związanej z OAuth, powinieneś sprawdzić, czy nie ma przekierowań, nieprawidłowych reguł przepisywania lub wewnętrznych błędów serwera uniemożliwiających dostęp do tych adresów URL.

Może to być spowodowane podścieżką sklep w twoim adresie URL. Sprawdź, czy nie ma problemu z podścieżką sklepu, uzyskując dostęp do punktu końcowego pod adresem:

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

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

Jeśli ten punkt końcowy zostanie rozwiązany, uwzględnij poniższe reguły przepisywania w swoim .htaccess aby rozwiązać problem.

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

Usuń integracje i utwórz je ponownie

Jeśli wprowadziłeś zmiany po poprzedniej nieudanej próbie integracji, dobrym pomysłem jest usunięcie oryginalnej integracji OAuth. Użyte klucze mogą być nieprawidłowe i będą musiały zostać ponownie wygenerowane.

1. W Magento przejdź do sekcji Systemy
2. Wybierz integracje
3. Znajdź rekord Klaviyo integracje i usuń go

Po usunięciu rekordu integracji postępuj zgodnie z instrukcjami zawartymi w naszym przewodniku integracji z Magento 2, aby utworzyć nowy rekord integracji i spróbować ponownie.

Problemy specyficzne dla wersji Magento

Błąd specyficzny dla Magento 2.4.2

Jeśli korzystasz z Magento 2.4.2, istnieje znany problem, w którym aktywacje OAuth kończą się niepowodzeniem. Po aktywacji integracji możesz zobaczyć komunikat o błędzie, taki jak ten pokazany poniżej. Nawet jeśli nie otrzymasz błędu, aktywacja OAuth mogła się nie powieść. Zazwyczaj błąd można znaleźć w logach Magento.

Aby rozwiązać ten błąd, musisz wykonać następujące czynności

• Zaktualizuj Magento do wersji 2.4.3. Zapoznaj się z dokumentacją Magento 2, aby zaktualizować swoją wersję. 
• Zastosuj poprawkę zgodnie z opisem w repozytorium github Klaviyo dla Magento 2.

Uwierzytelnienie awarii specyficznej dla Magento 2.4.6

Czy korzystasz z Magento 2.4.6 i doświadczasz błędu 401 uwierzytelnienie po integracji z Klaviyo? Może to być spowodowane znanym błędem Magento wpływającym na Magento w wersji 2.4.6. Aby to rozwiązać, musisz włączyć uwierzytelnienie tokena na okaziciela, aby Klaviyo mógł wysyłać żądania za jego pomocą (zamiast OAuth 1.0). Aby włączyć token na okaziciela uwierzytelnienie:

1. W panelu administracyjnym Magento przejdź do sklepu > Konfiguracja > Usługi > OAuth > Ustawienia klienta.
2. Dla ustawienia Allow OAuth Access Tokens to be used as stand-alone Bearer tokens wybierz Yes.
3. Kliknij przycisk Zapisz konfigurację.
   

Po dokonaniu tej aktualizacji Twoje poprzednie błędy uwierzytelniania powinny zostać usunięte, a synchronizacja integracji zostanie wznowiona.

Dodatkowe źródła

Magento 2 dane referencyjne
Przewodnik po obsłudze wielu Magento sklep (dla Magento 2.x)