> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> このページでは、Login by Auth0 WordPress プラグインでよくあるトラブルシューティング上の問題について説明します

# Login by Auth0 WordPress Plugin のトラブルシューティング

以下は、よくあるトラブルシューティングに関する質問です。以下の項目で問題が解決しない場合は、次の方法をお試しください。

* プラグインを初めて設定する場合や、ユーザーのログインに問題がある場合は、[Configure Login by Auth0](/ja/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0) を参照してください。
* プラグインのコードでバグを見つけた場合は、GitHub で [issue を送信](https://github.com/auth0/wordpress/issues) するか、[pull request を作成](https://github.com/auth0/wordpress/pulls) してください。
* Auth0 またはプラグインの使い方について質問がある場合は、[コミュニティサイトに投稿](https://community.auth0.com/) するか、[プラグインの WordPress サポートフォーラムでリクエストを作成](https://wordpress.org/support/plugin/auth0/) してください。
* 追加のドキュメントを確認し、さらに回答を探すには、[サポートサイトを参照してください](https://support.auth0.com/center/s/)。有料の Auth0 プランをご利用のお客様は、迅速な回答を得るためにサポートチケットを送信できます。

<div id="im-seeing-the-error-message-invalid-state-that-prevents-me-from-logging-in">
  ## ログインできず、「Invalid state」というエラーメッセージが表示される
</div>

state の検証は、[version 3.6.0](https://github.com/auth0/wordpress/releases/tag/3.6.0) で追加されたセキュリティ機能です。通常、このエラーは callback URL がキャッシュされていることが原因で発生します (キャッシュしてはいけない callback URL については、Application Settings を参照してください) 。詳細については、[Troubleshoot WordPress Plugin Invalid State Errors](/ja/docs/customize/integrations/cms/wordpress-plugin/troubleshoot-wordpress-plugin-invalid-state-errors) を参照してください。

<div id="im-having-an-issue-logging-in-or-changing-emailpassword-using-a-custom-database">
  ## カスタムデータベースの使用時に、ログインやメールアドレス/パスワードの変更で問題が発生する
</div>

考えられる解決策については、[Login by Auth0 WordPress Plugin における User Migration](/ja/docs/customize/integrations/cms/wordpress-plugin/user-migration-in-login-by-auth0)を参照してください。

<div id="im-seeing-the-error-message-invalid-id-token-or-expired-id-token-that-prevents-me-from-logging-in">
  ## 「Invalid IDトークン」または「Expired IDトークン」というエラーメッセージが表示され、ログインできない
</div>

これは通常、サーバーの時刻設定が正しくないことが原因です。エラーメッセージに「used too early」と含まれている場合は、サーバー時刻が未来に設定されています。トークンの有効期限が切れていると表示される場合は、サーバー時刻が過去にずれすぎています。2 台のサーバー間で時刻に差が生じることは珍しくありません。サーバー上の PHP で `echo date(DateTime::ISO8601)` を出力し、秒単位まで含めて現在の UTC 時刻と比較してください。サーバー時刻が UTC 時刻から 60 秒 (デフォルトの許容幅) 以上ずれている場合は、サーバーのクロックスキューを考慮して、許容幅をより長く設定する必要があります。以下のコードは、プラグインの読み込み後かつログイン Hook の実行前に実行される場所であれば、テーマの `functions.php` またはその他の場所に貼り付けることができます。

```js wrap lines theme={null}
add_filter( 'auth0_jwt_leeway', function( $default_leeway ) { return 120; } );
```

これにより、120 秒の猶予が設けられます。サーバーの時刻がどの程度ずれているかに応じて、調整が必要になる場合があります。

<div id="i-see-the-error-message-this-account-does-not-have-an-email-associated-that-prevents-me-from-logging-in">
  ## 「このアカウントには関連付けられたメールアドレスがありません...」というエラーメッセージが表示されてログインできない
</div>

このエラーが表示される場合は、<Tooltip tip="Auth0 Dashboard: サービスを設定するための Auth0 の主要な製品です。" cta="用語集を見る" href="/ja/docs/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip> の **接続 > ソーシャル** で、各プロバイダーに対してメールアドレスを要求する設定になっていることを確認してください (各プロバイダーを展開してください) 。なお、すべてのプロバイダーがユーザーのメールアドレスを返すわけではありません (例: X) 。その場合は、Auth0 Dashboard (または API) から、ログイン済みの任意のユーザーにいつでもメールアドレスを追加できます。**ユーザー > 編集** を参照してください。

`email_verified` フラグを提供しない接続 (これを含まない Enterprise 接続もあります) 、または特定のソーシャル接続でこの検証をスキップするには、その接続の strategy を "Skip Strategies" フィールドに追加します。このフィールドは、**wp-admin** > **Auth0** > **Settings** > **Advanced** からアクセスできる **Require Verified Email** スイッチの下にあります。

**このフィールドは、Auth0 が推奨するセキュリティ対策を回避してしまうため、必要な場合にのみ使用してください。**

<div id="i-see-the-error-message-there-is-a-user-with-the-same-email-that-prevents-me-from-logging-in">
  ## ログインしようとすると、「There is a user with the same email」というエラーメッセージが表示される
</div>

これは、ログインに使用しているメールアドレスと同じメールアドレスを持つユーザーが WordPress に存在し、そのユーザーが別の Auth0 ユーザーに関連付けられていることを意味します。プラグインのテスト中である場合や、既存のユーザーを新しい Auth0 ユーザーに関連付けたい場合は、代わりに次の手順を実行してください。

1. 管理者としてログインします
2. **wp-admin > Users** に移動し、使用しているメールアドレスを検索します
3. ユーザーのユーザープロファイルを開き、一番下までスクロールします
4. **Delete Auth0 Data** をクリックして確認します

Auth0 に同じメールアドレスを持つユーザーアカウントが 2 つある場合、このエラーメッセージは解消されません。[ユーザーアカウントをリンクする](/ja/docs/manage-users/user-accounts/user-account-linking/link-user-accounts)ことをお勧めします。

<div id="i-see-the-error-message-failed-cross-origin-authentication-or-no-verifier-returned-from-client-in-my-browsers-console-logs-when-trying-to-log-in">
  ## ログインしようとすると、ブラウザーのコンソールログに「Failed cross origin authentication」または「No verifier returned from client」というエラーメッセージが表示される
</div>

[Auth0 Dashboard > Applications > Applications](https://manage.auth0.com/#/applications) に移動し、WordPress アプリケーションを選択して設定を表示します。**Allowed Callback URLs** と **Allowed Origins (CORS)** が WordPress サイトと一致していることを確認してください。

Chromium ベースのブラウザーを使用している場合は、サードパーティ Cookie が無効になっていないことを確認してください。詳細については、[Cross-Origin Authentication](/ja/docs/authenticate/login/cross-origin-authentication) を参照してください。

<div id="i-need-to-rerun-the-setup-wizard-but-i-dont-see-that-menu-option-anymore">
  ## Setup Wizard を再実行したいのですが、メニューオプションが表示されなくなりました。
</div>

これは、プラグインがすでにドメイン、<Tooltip tip="クライアントID: Auth0 から登録済みリソースに付与される識別値です。" cta="用語集を見る" href="/ja/docs/glossary?term=Client+ID">クライアントID</Tooltip>、および <Tooltip tip="クライアントID: Auth0 から登録済みリソースに付与される識別値です。" cta="用語集を見る" href="/ja/docs/glossary?term=Client+Secret">クライアントシークレット</Tooltip> で設定済みであることを意味します。Setup Wizard をもう一度実行すると、予期しない結果になる可能性があります。WordPress を初めて設定していて、まだ一度もログインしておらず、最初からやり直したい場合は、次の手順に従ってください。

1. **wp-admin** > **Auth0** > **Settings** > **Basic** に移動します。
2. ドメインとクライアントIDを削除します。下にスクロールして **Save Changes** をクリックします。
3. [Auth0 Dashboard > Applications > Applications](https://manage.auth0.com/#/applications) に移動します。
4. WordPress によって作成された Application を見つけます (名前は WordPress サイトのサイト名になっているはずです) 。
5. Application を選択して設定を表示します。下にスクロールして、**Delete Application** を選択します。
6. [Auth0 Dashboard > Authentication > Database](https://manage.auth0.com/#/connections/database) に移動します。
7. WordPress によって作成された接続を見つけます (名前は WordPress サイトのサイト名の先頭に "DB-" を付けたものになっているはずです) 。
8. 接続を選択して設定を表示します。下にスクロールして、**I Want To Delete This Connection.** を選択します。これにより、その接続と、その中で作成されたすべてのユーザーが削除される点に注意してください。
9. WordPress に戻ります。これで、管理メニューの Auth0 の下に Setup Wizard オプションが表示されます。

<div id="how-do-i-setup-passwordless-login">
  ## パスワードレスログインはどのように設定しますか？
</div>

<Tooltip tip="パスワードレス: 第1認証要素としてパスワードを使用しない認証方式。" cta="用語集を見る" href="/ja/docs/glossary?term=Passwordless">パスワードレス</Tooltip>ログインは、メールまたはSMSを使用して、Auth0対応のあらゆるWebサイトで利用できます。これをWordPressサイトで機能させるには:

1. プラグイン設定の **Features** ビューで **Passwordless Login** をオンにし、保存します。
2. [Auth0 Dashboard > Authentication > Passwordless](https://manage.auth0.com/#/connections/passwordless) に移動します。

* メールを使用するには、**Email** 接続をオンにし、必要に応じて設定を変更します。これにより、メールで送信されたcodeを使ったログインが有効になります (ユーザーにcodeがメールで送信され、その後サイトのログインフォームに入力されます) 。
* 「マジックリンク」 (メールで送信されたリンクを開くと自動的にログインされる方式) を使用するには、プラグイン設定の **Advanced** タブにある "Extra Settings" フィールドに `{passwordlessMethod: 'code'}` を追加します。
* SMSログインを使用するには、**SMS** 接続をオンにし、手順に従ってTwilio開発者アカウントを設定します (使用状況によっては有料のTwilioアカウントが必要になります) 。

Auth0のログインフォームは、上で有効にした接続に応じてパスワードレスの方式を選択します。両方の接続が有効な場合、デフォルトではメールが使用されます。この場合は、SMSを表示するためにメール接続をオフにするか、プラグイン設定の **Advanced** タブにある **Connections** フィールドに `sms` を追加します。

<div id="i-have-two-accounts-for-the-same-user-in-wordpress">
  ## WordPress で同じユーザーに 2 つのアカウントがある
</div>

状況によっては、同じユーザーに対して 2 つのアカウントが存在することがあります。WordPress では、いずれか一方のアカウントを削除し、そのアカウントのコンテンツを別のユーザーに引き継ぐことで、ユーザーを統合できます。wp-admin > Users に移動し、削除するアカウントを選択して、確認ダイアログでコンテンツの移行先となる別のユーザーを選択します。

<div id="my-configuration-is-wrong-and-i-cant-authenticate-using-auth0-is-there-another-way-to-access-the-plugin">
  ## 設定が誤っていて Auth0 を使用して認証できません。プラグインにアクセスする別の方法はありますか？
</div>

プラグインには、通常の WordPress ログインの URL に `?wle` を追加し、有効な WordPress の認証情報を使用してアクセスできます。例: `http://yourdomain.com/wp-login.php?wle`。

<div id="i-am-having-problems-when-a-user-logs-in-where-can-i-find-a-log-of-what-is-happening">
  ## ユーザーのログイン時に問題が発生しています。何が起きているかのログはどこで確認できますか？
</div>

このプラグインにはエラーログがあり、そこで何が起きたかを確認できます。**Auth0** プラグインメニューの **Error Log** サブ項目からアクセスしてください。追加情報は [Auth0 Dashboard > Monitoring > Logs](https://manage.auth0.com/#/logs) で確認できます。

<div id="how-can-i-show-the-widget-or-shortcode-in-signup-mode-by-default">
  ## ウィジェットまたはショートコードをデフォルトでサインアップモードで表示するにはどうすればよいですか？
</div>

ウィジェットの `Extra configuration` 設定 (またはショートコードの `extra_conf` 属性) を使用し、JSON `{"mode":"signup" }` を追加すると、プラグインをこのモードで表示するよう強制できます。

<div id="when-using-a-plugin-to-force-the-login-the-user-is-not-logged-in">
  ## プラグインを使用してログインを強制しても、ユーザーがログイン状態にならない
</div>

通常、これはログイン後のページがキャッシュされていることが原因です。これを軽減する方法についてホストに確認するか、URL にキャッシュ無効化用のパラメーターを追加してみてください。詳しくは、[GitHub のこの gist を参照してください](https://gist.github.com/joshcanhelp/e3eb693749f0fe66aad097c3bbb3b415)。

<div id="the-user-is-not-logged-in-when-using-the-force-login-plugin">
  ### "Force Login" プラグインを使用してもユーザーがログイン状態にならない
</div>

これは、callback URL が AllowList に追加されていないためです。`my_forcelogin_whitelist` フィルターに次のコードを追加してみてください。

```javascript lines theme={null}
function wp_auth0_forcelogin_whitelist( $whitelist ) {
  if ( ! empty( $_GET['auth0'] ) ) {
    $whitelist[] = site_url($_SERVER['REQUEST_URI']);
  }
  return $whitelist;
}
add_filter('v_forcelogin_whitelist', 'wp_auth0_forcelogin_whitelist', 10, 1);
```

<div id="how-can-i-redirect-the-users-to-a-specific-url-after-login">
  ## ログイン後にユーザーを特定のURLにリダイレクトするにはどうすればよいですか？
</div>

すべてのリダイレクトは、実行前に `wp_safe_redirect()` で検証されます。メインのドメイン以外のドメインにリダイレクトしようとしている場合は、WordPress コアの `allowed_redirect_hosts` フィルターを使用して、そのドメインを許可対象に追加してください。詳しくは、[wordpress.org の apply\_filters( 'allowed\_redirect\_hosts', string\[\] $hosts, string $host )](https://developer.wordpress.org/reference/hooks/allowed_redirect_hosts/) を参照してください。

<div id="on-the-login-page">
  ### ログインページで
</div>

このプラグインは、WordPress の機能を活用し、デフォルト設定のままシームレスに動作します。リダイレクトを追加するには、ユーザーをログインページに誘導する際に、URL に `redirect_to` クエリパラメーターを追加します。ログインに成功すると、プラグインはユーザーをこの URL にリダイレクトします。

Auth0 プラグインの設定ページにある **Login redirection URL** 設定を使用することもできます。`redirect_to` パラメーターが指定されていない場合は、この URL がユーザーのリダイレクト先として使用されます。

<div id="using-the-widget">
  ### ウィジェットを使用する
</div>

ウィジェットは、認証前にユーザーが表示していたページに自動的にリダイレクトします。これを変更するには、`Redirect after login:` 設定を使用します。

<div id="using-the-shortcode">
  ### ショートコードの使用
</div>

ショートコードは、認証前にユーザーがいたページと同じページに自動的にリダイレクトします。これを変更するには、`redirect_to` 属性を使用します。

<div id="how-can-i-migrate-my-wordpress-users-to-auth0">
  ## WordPress のユーザーを Auth0 に移行するにはどうすればよいですか？
</div>

現在のバージョンのプラグインでは、ユーザーを Auth0 に自動移行することはできませんが、いくつかの方法があります。

* このプラグインでは、カスタムデータベース接続を **Auth0 へのインポート** モードとしてマークするための 2 つのエンドポイントが提供されています。エンドポイントの詳細については、[データベースからの自動移行を構成する](/ja/docs/manage-users/user-migration/configure-automatic-migration-from-your-database)を参照してください。
* ユーザーデータを JSON ファイルにエクスポートし、Auth0 に一括インポートするためにアップロードします。移行時に Auth0 が WordPress のパスワードを復号することはできないため、ユーザーは最初に Auth0 を使用してログインする際、パスワードをリセットする必要があります。JSON ファイルの生成方法については、[ユーザーの一括インポート](/ja/docs/manage-users/user-migration/bulk-user-imports)を参照してください。次に、Auth0 <Tooltip tip="Management API: お客様が管理タスクを実行できるようにする製品です。" cta="用語集を見る" href="/ja/docs/glossary?term=Management+API">Management API</Tooltip> の [Import Users エンドポイント](https://auth0.com/docs/api/management/v2/jobs/post-users-imports)を使用してファイルをアップロードする必要があります。
* [このスクリプト](https://gist.github.com/glena/b31716e3c8fe48927be2)と WordPress XML-RPC エンドポイントを使用して、カスタムデータベース接続による移行フローを設定します。移行フローの設定の詳細については、[データベースからの自動移行を構成する](/ja/docs/manage-users/user-migration/configure-automatic-migration-from-your-database)を参照してください。WordPress XML-RPC エンドポイントの詳細については、[wordpress.org の XML-RPC サポート](https://codex.wordpress.org/XML-RPC_Support)を参照してください。

<div id="the-form_title-setting-is-ignored-when-i-set-up-the-dict-setting">
  ## dict 設定を行うと form\_title 設定は無視される
</div>

内部的には、このプラグインは dict 設定を使って Auth0 ウィジェットのタイトルを変更します。dict フィールドを設定すると、form\_title よりそちらが優先されます。

この場合に form\_title を変更するには、dict の JSON に次の属性を追加する必要があります。

```json lines theme={null}
{
    "signin": {
        "title": "The desired form title"
    }
}
```

<div id="how-can-i-modify-the-embedded-auth0-login-form">
  ## 埋め込みの Auth0 ログインフォームを変更するにはどうすればよいですか？
</div>

プラグイン設定ページの **Appearance** タブには、サイトに埋め込まれたログインフォーム (`wp-login/php` ページ、ショートコード、またはウィジェット) の見た目や使い勝手を変更できるオプションが多数あります。これらのオプションの詳細については、[Configure Login by Auth0](/ja/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0) を参照してください。これは、Auth0 でホストされる <Tooltip tip="Universal Login: アプリケーションは、ユーザーの本人確認を行うために、Auth0 の認可サーバーでホストされる Universal Login にリダイレクトされます。" cta="用語集を表示" href="/ja/docs/glossary?term=Universal+Login">Universal Login</Tooltip> ページのログインフォームには影響しません。

**Advanced** タブには "Extra Settings" というフィールドもあり、構成したいすべての設定を含む有効な JSON オブジェクトを指定できます。これにより、**Appearance** タブで行った変更はすべて上書きされます。使用可能なすべての設定オプションについては、[Lock Configuration Options](/ja/docs/libraries/lock/lock-configuration) を参照してください。

外部スタイルシートと JS ファイルは、ショートコードやウィジェットでは `wp_enqueue_scripts` フックを使用し、`wp-login.php` では `login_enqueue_scripts` フックを使用して、テーマ内で読み込む必要があります。詳細については、[wordpress.org の `do_action( 'wp_enqueue_scripts' )`](https://developer.wordpress.org/reference/hooks/wp_enqueue_scripts/) と [wordpress.org の `do_action( 'login_enqueue_scripts' )`](https://developer.wordpress.org/reference/hooks/login_enqueue_scripts/) を参照してください。

<div id="the-session-expires-too-soon">
  ## セッションの有効期限が短すぎる
</div>

Auth0 プラグインはセッションを管理せず、WordPress の設定を使用します。デフォルトでは、ユーザーセッションは 2 日間維持されます。セッションを最長 14 時間有効にしておくには、プラグイン設定の **Advanced** タブで `Remember users session` 設定を有効にできます。

<div id="how-do-i-implement-a-refresh-token">
  ## リフレッシュトークンを実装するにはどうすればよいですか？
</div>

プラグインが使用するログインメソッドに追加パラメーターを実装し、<Tooltip tip="リフレッシュトークン: ユーザーに再度ログインを求めることなく、新しいアクセストークンを取得するために使用されるトークンです。" cta="用語集を表示" href="/ja/docs/glossary?term=Refresh+Tokens">リフレッシュトークン</Tooltip>を利用できるようにしました。これを実現するには、`auth0_auth_scope` フィルターと `auth0_user_login` アクションを組み合わせて使用します。

<div id="profile-data-saved-in-wordpress-is-not-being-synced-to-the-auth0-user-account">
  ## WordPress に保存されたユーザープロファイルのデータは、Auth0 のユーザーアカウントに同期されません。
</div>

これは現時点でのプラグインの制限ですが、今後のリリースでの対応を検討しています。唯一の例外はユーザーのパスワードです。WordPress でパスワードが変更され、かつ使用しているデータベース接続に設定されたセキュリティポリシーを満たしている場合は、そのパスワードは Auth0 のユーザーにも反映されます。パスワードの強度が不十分な場合に処理を停止できるよう、今後のリリースでエラーメッセージを追加する予定です。

<div id="how-do-i-migrate-from-social-login-with-auth0-to-login-by-auth0">
  ## 「Social Login with Auth0」から「Login by Auth0」へ移行するにはどうすればよいですか？
</div>

これまで Auth0 は、2 つの WordPress プラグインを提供してきました。

* [Login by Auth0](https://wordpress.org/plugins/auth0/)
* [Social Login with Auth0](https://wordpress.org/plugins/social-login-with-auth0/)

この 2 つのプラグインは実質的に同じものですが、**Social Login with Auth0** はバージョン 3.7.0 (2018 年 8 月 13 日リリース) 以降は更新されません。**Social Login with Auth0** から **Login by Auth0** への移行は簡単で、Auth0 や WordPress のデータが失われることもありません。

**Social Login with Auth0** から **Login by Auth0** に移行すると、表示されるバージョン番号が変わります。そのため、まずはステージング環境または開発サーバーでこの変更をテストしてください (wp-admin でプラグインを更新する場合と同様です) 。また、移行中はログインが機能しない可能性があるため、メンテナンスモード用のプラグインを使用するか、アクセスの少ない時間帯に移行を実施してください。

最も簡単な移行方法は、(S)FTP を使用する方法です。

1. 管理者として WordPress サイトにログインします。
2. [Login by Auth0 をダウンロード](https://downloads.wordpress.org/plugin/auth0.zip) し、ローカルで展開します。
3. WordPress 管理画面の **Plugins** 画面で、**Social Login with Auth0** プラグインを無効化します。
4. 移行先のサーバーにログインし、`wp-content/plugins` に移動します。
5. 内容をバックアップするため、`social-login-with-auth0` フォルダーを plugins フォルダーの外に移動します。
6. 新しい `auth0` プラグインフォルダーを plugins ディレクトリーにアップロードします。
7. WordPress の **Admin** > **Plugins** 画面で、新しい「Login by Auth0」プラグインを有効化します。

FTP 経由でサイトにアクセスできない場合は、WordPress 管理画面から直接この手順を実行することもできます。

1. 管理者として WordPress サイトにログインします。
2. **Auth0** > **Import-Export Settings** に移動します。
3. **Export Settings** をクリックし、続けて **Export** をクリックします。
4. WordPress の **Admin** > **Plugins** 画面で、**Social Login with Auth0** プラグインを無効化します。
5. **Social Login with Auth0** プラグインを削除し、確認します。
6. **Plugins** > **Add New** に移動し、「Auth0」を検索します。
7. **Login by Auth0** プラグインで (必ず名前を確認してください) 、**Install Now** をクリックします。
8. 完了したら、**Activate** をクリックします。
9. **Auth0** > **Settings** を確認し、以前の設定がそのまま残っていることを確認します。残っていない場合は、次の手順を実行します。

   1. **Auth0** > **Import-Export Settings** に移動します。
   2. 先ほどエクスポートした設定 JSON を貼り付け、**Import** をクリックします。
10. 設定ファイルのエクスポート JSON は完全に削除してください (機密情報が含まれています) 。

これで新しいプラグインで想定どおりに動作するようになり、通常どおり更新も再開されます。

<div id="learn-more">
  ## 詳細情報
</div>

* [WordPressと統合する](/ja/docs/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress)
* [Login by Auth0 をインストールする](/ja/docs/customize/integrations/cms/wordpress-plugin/install-login-by-auth0)
* [Login by Auth0 を設定する](/ja/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0)
* [Login by Auth0 WordPress Plugin を拡張する](/ja/docs/customize/integrations/cms/wordpress-plugin/extend-login-by-auth0)
