One-click login
NexraOneからWordPress管理画面へワンクリックでログインする
サイト詳細とサイト一覧の「WP管理画面にログイン」を押すと、パスワードを入力せずにそのサイトのWordPress管理画面へ入れます。使うにはNexraOne Agent 0.8.0以上と、WordPress側での許可が必要です。設定の手順、ログインできないときの原因、2段階認証への影響をまとめています。
このページで分かること
設定前に確認すること、操作手順、運用時に注意したいポイントを順番に確認できます。
対象サイトのURLがhttpsで、NexraOne Agent 0.8.0以上が接続されていること
WordPress管理画面で、サイトの管理者がワンクリックログインを許可していること
NexraOneでOwnerまたはMemberの役割があること(Viewerはボタンが表示されません)
NexraOne Agentを0.8.0以上に更新する
この機能はNexraOne Agent 0.8.0で加わりました。それより前のAgentが入っているサイトでは、サイト詳細の「WP管理画面」はこれまでどおりWordPressのログイン画面を開くリンクのままです。WordPressの「プラグイン」画面でNexraOne Agentを更新してください。
WordPress管理画面で、ワンクリックログインを許可する
WordPress管理画面の「設定」からNexraOne Agentの設定画面を開き、「ワンクリックログイン」の欄で「NexraOneからのワンクリックログインを許可する」にチェックを入れます。「ログインに使うWordPressユーザー」を選び、「ワンクリックログインの設定を保存」を押します。ユーザーの候補は管理者権限(manage_options)を持つ人です。最初は誰も選ばれていないので、必ず1人選んでください。選ばずに保存するとエラーになります。保存すると、Agentがすぐ状態をNexraOneへ知らせるので、数分待たずにボタンが使えるようになります。許可は初期状態ではオフで、サイトの管理者が自分で入れたときだけ有効になります。
サイト詳細かサイト一覧で「WP管理画面にログイン」を押す
NexraOneのサイト詳細、またはサイト一覧の各行にある「WP管理画面にログイン」を押します。新しいタブが開いて「ログインしています…」と表示され、1〜2秒ほどでWordPressの管理画面に切り替わります。ログインするのは、手順2で選んだWordPressユーザーです。ポップアップがブロックされたときは、いま開いているタブがそのまま管理画面に切り替わります。
押せないとき、ログインできないときの原因を確かめる
ワンクリックログインが使えないサイトでは、ボタンの代わりに、これまでどおりWordPressのログイン画面を開く「WP管理画面」のリンクが表示されます。許可がまだのサイトでは、そのリンクの下に「Agent の設定画面で許可してください」と出ます。サイトのURLがhttpのサイトも同じ表示で、HTTPSでのみ使えるという案内が出ます。Agentが0.8.0より古いサイトでは、案内は出ず、リンクだけが表示されます。許可は、サイトを別のチームへ接続し直したときや、Agentの接続をいったん切ったときに消えるので、もう一度手順2を行ってください。ボタンを押したあとに失敗するときは、次の原因を順に見てください。
- ログインの直後に管理画面がwp-login.phpへ戻される。ロードバランサーやリバースプロキシでHTTPSを終端しているサイトで起こりやすく、wp-config.phpでX-Forwarded-Protoを見てHTTPS扱いにする設定が要ります。
- WordPressアドレスとサイトアドレスのホストが違い、ログインのCookieを受け取れない。2つのホストをそろえるか、COOKIE_DOMAINを設定します。
- セキュリティプラグインやWAFが、ログインしていない状態でのREST APIへのPOSTを止めている。/wp-json/nexraone-agent/v1/login を除外してください。
- サイトにBasic認証がかかっていて、ブラウザがユーザー名とパスワードを聞いてくる。ブラウザで一度認証を通してから、もう一度押します。
- 短い時間に何度も押して、回数の制限にかかった。表示のとおり、1分ほど待てばまた押せます。
2段階認証と、誰が使えるのかを知っておく
この方法でのログインは、WordPress側のパスワード認証を通りません。そのため、サイトに2段階認証のプラグインを入れていても、ワンクリックログインでは2段階認証の入力が求められません。そのぶん、NexraOneのアカウントを2段階認証などで守ってください。使えるのは、そのサイトを担当するチームのOwnerとMemberです。Viewerにはボタンが表示されません。許可の欄で選んだユーザーの権限でログインするので、誰が押しても入る先は同じ管理者アカウントです。
ログインの記録を確かめる
NexraOne側では、設定の「セキュリティ」にある監査ログに、ボタンが押された記録と、WordPress側でログインが使われた記録が残ります。見られるのはOwnerだけです。WordPress側では、NexraOne Agentの設定画面の「最近のワンクリックログイン」に、直近の結果が日時(UTC)、成功か失敗か、WordPressユーザーとともに最大10件並びます。許可をやめたいときは、同じ画面でチェックを外して保存します。Agentの接続を切ったときも、許可は自動で消えます。
ログインに使うトークンは、押した時点で1つずつ作られ、60秒以内に1回だけ使えます。URLには載らず、ブラウザからサイトへ直接送られます。
WordPress側でチェックを入れるまでは、NexraOneからこのサイトへログインすることはできません。許可はサイトの管理者だけが変えられます。