プラグインをインストールまたはカスタマイズするには、セルフホスト型の WordPress.org サイトを使用する必要があります。WordPress.com サイトではプラグインをインストールできません。違いについて詳しくは、wordpress.com の WordPress.com と WordPress.orgを参照してください。
GitHub からインストールする (推奨)
プラグインの最新版をインストールするには:- Login by Auth0 GitHub リリースページから
.zipファイルをダウンロードします。 - WordPress サイトに管理者としてログインします。
- プラグイン > 新規追加 > プラグインのアップロードに移動します。
- ダウンロードした
.zipファイルを選択し、今すぐインストールをクリックします。 - プラグインを有効化を選択します。
WordPress.org からインストールする
このプラグインは wp-admin の プラグイン 画面からも追加できますが、この方法では古いバージョンがインストールされます。- 既存の WordPress サイトに管理者としてログインします。
- 左側の管理メニューで プラグイン > Add New に移動します。
- 「Login by Auth0」を検索します。
- Login by Auth0 プラグインの Install Now をクリックし、続けて Activate をクリックします。
設定ページの Basic タブに Domain、Client ID、Client Secret を追加するまで、Auth0 はログインフォームを置き換えません。
マルチサイトの設定
Login by Auth0 プラグインは、WordPress のマルチサイトネットワークに対応しています。このプラグインはネットワーク全体で有効化して、ネットワーク内のサイトを自動的に保護することも (設定完了後) 、ネットワーク内の一部のサイトでのみ有効化することもできます。 Auth0 でサイトネットワークを設定する方法はいくつかあります。-
すべてのサイトで 1 つのアプリケーションと 1 つのデータベース接続を共有する
- メインサイトで Setup Wizard の手順を最後まで実行します。
- そのほかのすべてのサイトは、Auth0 の設定ページの Basic タブで、メインサイトの Domain、Client ID、Client Secret を使用して手動で設定します。
- アプリケーションの Allowed Callback URLs、Allowed Web Origins、Allowed Logout URLs を更新して各サイトを含めます (ネットワークでサブドメインを使用している場合は、ワイルドカードを使用できます) 。
-
各サイトが独自のアプリケーションを持ち、1 つのデータベース接続を共有する
- メインサイトで Setup Wizard の手順を最後まで実行します。
- 次に、各サイト用のアプリケーションを手動で作成し、それぞれを先ほど作成したデータベース接続に追加します。
- 各サイトの Auth0 設定ページの Basic タブに、Domain、Client ID、Client Secret の値を追加します。
- 各サイトが独自のアプリケーションと独自のデータベース接続を持つこともできます。 この場合は、各サイトで Setup Wizard の手順を最後まで実行します。
Setup Wizard
Setup Wizardは、WordPress サイトで Auth0 を使用するために必要なコンポーネントを一通り作成します。既存のアプリケーションまたはデータベース接続を使用する場合は、以下の手動設定の手順をご覧ください。オプション 1: 標準設定
これにより、このサイト用のアプリケーションとデータベース接続が作成および設定されます。 まず、Management API トークンを生成します。トークンを生成したら、設定 タブの Identifier フィールドで使用されているドメイン名を控えておいてください。たとえば、Identifier がhttps://tenant-name.auth0.com/api/v2/ の場合、テナントドメインは tenant-name.auth0.com です。テナントドメインの詳細については、テナントを作成するを参照してください。
WordPress 管理画面の Setup Wizard に戻り、Standard をクリックします。表示されたモーダルで、Start Standard Setup をクリックします。
上記のテナントドメインと API トークンを入力します。このトークンは設定処理でのみ使用され、データベースには保存されません。
設定の最初の部分が正常に完了すると、「ソーシャル接続を設定する」画面が表示されます。Next をクリックして設定を続行し、管理者アカウントを移行します。
この手順では、WordPress ユーザーを、ログインを認可する Auth0 ユーザーに関連付けます。管理者アカウントと同じパスワードを使用することも、別のパスワードを使用することもできますが、使用するデータベース接続のパスワード強度ポリシーに準拠していることを確認してください。詳細については、Auth0データベース接続の Password Strength: パスワードポリシーを参照してください。
サイトが正しく設定されるようにするには、Setup Wizard を最後まで完了する必要があります。「setup successful」画面が表示される前に何らかの理由で Wizard が失敗した場合は、wp-admin > Auth0 > Error Log のプラグインエラーログと以下の手順を確認し、原因を特定してください。
完全に最初からやり直すには、 で作成されたアプリケーションまたはデータベース接続を削除します。WordPress では、Auth0 > Settings > Basic に移動し、Domain、、および の各フィールドを削除して、Save をクリックします。次に、管理メニューの Setup Wizard をクリックして、もう一度最初からやり直します。
それでもインストールできない場合は、Community にスレッドを投稿して、Error Log に表示されているエラーメッセージを共有してください。喜んでお手伝いします。
オプション 2: ユーザー移行の設定
これにより、WordPress データベースからのデータ移行とあわせて、アプリケーションとデータベース接続が作成・設定されます。これには Auth0 サーバーからの受信接続が必要で、後から変更するとデータが失われるため変更できません。詳しくは、Login by Auth0 WordPress Plugin のユーザー移行を参照してください。 ::: warning Auth0 に複数のカスタムデータベース接続がある場合は、競合を避けるため、user ID が名前空間付きになっていることを確認する必要があります。これは、バージョン 3.11.0 以降をインストールするサイトでは自動的に行われます。接続がそれ以前のバージョンで作成されている、または作成されていた場合は、Login by Auth0 WordPress Plugin のユーザー移行のトラブルシューティング手順を参照してください。 ::: 設定が完了したら、WordPress サイトからログアウトし、Auth0 のログインフォームで既存の WordPress 資格情報を使って再度ログインしてみてください。これにより、WordPress アカウントにリンクされた Auth0 ユーザーが作成されます。オプション 3: 手動設定
自動設定をスキップして、ご自身でアプリケーションとデータベース接続を作成・設定できます (以下を参照) 。このサイトで既存のアプリケーションまたはデータベース接続を使いたい場合は、こちらを使用してください。オプション4: 設定をインポート
別のサイトから設定をインポートして、このサイトをセットアップすることもできます。環境間で移行する場合や、すでに設定済みの類似したWordPressサイトがある場合に便利です。設定完了
「Done」画面が表示されたら、Auth0 は有効化され、ログインと、設定されていればサインアップを受け付ける準備が整っています。 既定の設定を変更する前に、サイトの基本的な動作を確認するのにちょうどよいタイミングです。- WordPress からログアウトし、
/wp-login.phpに Auth0 のフォームが表示されることを確認します。 - 上で作成した Auth0 ユーザーでログインします。
- ログアウトし、別のメールアドレスでアカウントを作成してみます (WordPress の一般設定で「Anyone can register」を有効にしている場合) 。
- ソーシャル接続を使ったログインも試します (有効にしている場合) 。
手動設定
プラグインは、組み込みの Setup Wizard (以下で説明) を使用するか、アプリケーションを作成して接続を割り当てることで手動で設定できます。完全に手動で設定する方法は、ウィザードで問題が発生している場合、以前に設定を行ったことがある場合、またはアプリケーション間でデータベース接続を共有したい場合に利用できます。- Auth0 Dashboard > アプリケーション > アプリケーション に移動し、Create を選択します。
- アプリケーションにわかりやすい名前を付け、従来型Webアプリケーション を選択してから、Create を選択します。
- WordPress インストール用にアプリケーションを設定します。設定方法については、Configure Login by Auth0 を参照し、「WordPress で Auth0 設定を更新する」まですべてのセクションの手順に従ってください。