Magento 2 との連携に関するトラブルシューティング

このページで学べること

以下に記載されたトラブルシューティング手順に従って、Magento 2 OAuth の設定に関する問題を解決する方法をご紹介します。これらの手順を実行しても問題が解決しない場合は、コミュニティまたはサポートチームまでご連絡ください。

始める前に

まだの場合は、Magento 2 外部連携を設定するための手順を段階的に説明した Magento 2 のスタートガイドをお読みください。

Klaviyo は OAuth プロトコルを使用してアクセス トークンを生成し、Magento 2 ストアからデータを取得します。Magento 2 のインストールをカスタマイズしている場合、Klaviyo の OAuth 手順が失敗することがあります。この記事では、障害が発生している箇所を特定するためのトラブルシューティング手順を順に説明します。

一般的なトラブルシューティング手順

有効な SSL 証明書を使用して、サイトに公開アクセスできるようにしてください。

Klaviyo の OAuth 手順では、ウェブサイトが一般公開されている必要があります。公開されていない場合、アクセストークンを生成するために必要な API 呼び出しが失敗します。

1. ストアへのアクセスがパスワードで保護されていないこと、または IP 制限されていないことを確認してください。
2. 有効な SSL 証明書を使用して、ストアが HTTPS 経由でアクセスできるようにしてください。証明書は こちら でテストできます。

ファイアウォールが Klaviyo のリクエストをブロックしていないことを確認してください

すべての送信 Klaviyo 外部連携トラフィックは、予測可能な固定 IP アドレスのセットの背後にあるため、このトラフィックが Klaviyo からのものであることを高い確度で信頼できます。記事を読んで、Klaviyo 外部連携トラフィックの IP アドレスを許可リストに登録する方法をご確認ください。

Magento 2 と Klaviyo 拡張機能のバージョンを確認してください

1. Magento v2.2.0 を使用している場合、OAuth を手動で有効化する必要があります。
2. 正しい Klaviyo 拡張機能がインストールされていることを確認してください（アップグレードが必要な場合があります）。

OAuth エンドポイントにアクセスできることを確認してください。

書き換えルールが余分にある、または不足している可能性があり、その結果、デフォルトの Magento 2 OAuth エンドポイントにアクセスできなくなる場合があります。Klaviyo は、認可プロセスに必要な認証情報を生成するために、これらのエンドポイントにアクセスする必要があります。

以下の URL にストアからアクセスできることを確認してください。

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

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

1. 次のように POST リクエストを行うことで、アクセス可能であることを検証できます。

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. 次のような応答が返ってくるはずです。この方法でリクエストを行うとエラーが表示されるのは正常であり、エンドポイントが正しく応答していることを検証できます。
   

2. OAuth に関連する応答がない場合、これらの URL へのアクセスを妨げているリダイレクト、無効な書き換えルール、または内部サーバーエラーがないことを確認してください。

これは、URL のストアサブパスが原因で発生する場合があります。次にアクセスして、ストアサブパスの問題をテストしてください：

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

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

これらのエンドポイントが解決される場合は、以下の書き換えルールを .htaccess に含めてください。問題を解決するためのファイル。

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]

外部連携を削除して、再作成する

以前に外部連携が失敗してから変更を加えた場合は、元の OAuth 外部連携を削除することをおすすめします。使用されているキーが無効である可能性があるため、再生成する必要があります。

1. Magento 内で、Systems に移動します。
2. [外部連携] を選択します。
3. Klaviyo の外部連携レコードを見つけて削除する

外部連携レコードを削除したら、ガイドの Magento 2 と外部連携する方法 の手順に従って新しい外部連携レコードを作成し、もう一度お試しください。

Magento のバージョン固有の問題

Magento 2.4.2 固有の失敗

Magento 2.4.2 を使用している場合、OAuth の有効化が失敗する既知の問題があります。外部連携を有効化すると、以下に示すようなエラーメッセージが表示されることがあります。エラーが表示されない場合でも、OAuth の有効化に失敗している可能性があります。通常、エラーは Magento のログで確認できます。

このエラーを解決するには、次のいずれかを行う必要があります：

• Magento 2.4.3 にアップグレードします。Magento 2 のドキュメントを参照して、バージョンをアップグレードしてください。
• Magento 2 については、Klaviyo の github リポジトリに記載されているとおりにパッチを適用してください。

Magento 2.4.6 に固有の認証失敗

Magento 2.4.6 を使用していて、Klaviyo と外部連携した後に 401 認証エラーが発生していますか？これは、Magento バージョン 2.4.6 に影響する既知の Magento のバグが原因である可能性があります。これを解決するには、ベアラー トークン認証を有効にして、Klaviyo がそれを使用してリクエストを行えるようにする必要があります（OAuth 1.0 の代わりに）。ベアラートークン認証を有効にするには：

1. Magento 管理画面で、Stores > Configuration > Services > OAuth > Consumer Settings に移動します。
2. Allow OAuth Access Tokens to be used as stand-alone Bearer tokens の設定では、Yes を選択してください。
3. [設定を保存] をクリックします。
   

この更新を行うと、以前の認証エラーは解消され、外部連携の同期が再開されます。

その他のリソース