NexraOne活用ガイドに戻る

NexraOne活用ガイド / 更新と復元

Basic認証のかかったステージングサイトをNexraOneで監視・更新する方法

Basic認証をかけたステージングサイトでは、そのままだとハートビートが途切れたり、Safe Updateが進まなかったりします。NexraOneのサイト設定にユーザー名とパスワードを登録して、死活監視とSafe Updateを本番と同じように使う手順と、登録したあとの確かめ方をまとめました。

Basic認証をかけたステージングサイトをNexraOneで監視・更新するときは、サイト詳細の「サイト設定」タブを開き、「サイトの情報」にある「Basic認証」の「登録する」から、ユーザー名とパスワードを保存します。保存するとNexraOneがその場でサイトにアクセスし、「認証が通りました」と出れば、死活監視とSafe Updateの更新後のチェックが認証の先まで届くようになります。

登録はどのプランでもでき、操作できるのはチームのMember以上の人です。NexraOne Agentが0.7.0以上なら、WordPressが自分自身に送るWP-Cronのアクセスにも同じ情報が付くので、ハートビートが途切れず、Safe Updateも最後まで進みます。

登録しないと、何が止まるのか

Basic認証をかけたサイトでも、Agentのインストールと接続はふだんどおりにできます。困るのは接続したあとです。

NexraOne Agentは、WordPressのWP-Cronを使ってNexraOneへ定期的に状態を送り(ハートビート)、Safe Updateの更新もWP-Cronで動かします。WP-Cronは、サイトにアクセスがあったときにサーバーが自分の wp-cron.php を呼び出す仕組みで、この呼び出しにはBasic認証のユーザー名とパスワードが付きません。認証で弾かれるとWP-Cronが動かないので、ハートビートが届かなくなり、Safe Updateを実行しても待ちのまま進まず、15分たつと自動で取り消されます。Agentが更新の指示を受け取れた場合でも、WP-Cronにアクセスできないことが分かった時点で止まり、「WordPressのWP-Cronにアクセスできず、更新処理を開始できませんでした。」と出ます。

NexraOneからの死活監視と、Safe Updateの更新後のチェックも、認証の画面までしか見えません。更新でトップページが真っ白になっていても、NexraOneからは見分けられず、自動で元に戻す判断も働きません。

「このサイトにはBasic認証がかかっています」と出たら

NexraOneは、サイトを登録した直後と死活監視のたびに、そのサイトがBasic認証を求めているかを見分けています。認証を求めているのにまだ登録していないサイトでは、サイト詳細のタブの下に「このサイトには Basic 認証がかかっています」という案内が出ます(「サイト設定」タブを開いている間は出ません)。案内の「Basic認証を登録する」を押すと、「サイト設定」タブの登録の画面がそのまま開きます。このボタンはMember以上の人にだけ出て、Viewerの人には案内の文だけが出ます。

サイト設定の「Basic認証」の欄にも、未登録で認証を見分けたサイトには「Basic 認証を検知しました」と出ます。案内が出ていなくても、Basic認証をかけているサイトなら同じ手順で登録できます。

ユーザー名とパスワードを登録する

  1. サイト一覧から対象のサイトを開き、「サイト設定」タブに切り替える
  2. 「サイトの情報」の「Basic認証」で「登録する」を押す
  3. ダイアログにユーザー名とパスワードを入力し、「保存する」を押す

入れるのは、クライアントやサーバーの担当者から受け取ったBasic認証のユーザー名とパスワードそのものです。パスワードは暗号化して保存され、保存したあとは画面に表示されません。Viewerの人には、ユーザー名も表示されません。

保存すると、NexraOneがその情報でサイトにアクセスし、結果を表示します(https:// のサイトの場合)。

表示意味と、次にすること
保存しました。認証が通りました。登録できています。次の「登録したあとに確かめること」に進みます
保存しましたが、認証に失敗しました。ユーザー名かパスワードが違います。「変更する」から入れ直します
保存しました。いまはサイトが Basic 認証を求めていません。保存した時点で認証がかかっていませんでした。認証を外したサイトなら登録は不要です
保存しました。サイトが別のアドレスへ転送するため確認できませんでした。登録しているURLと、実際に開くURL(wwwの有無など)が違います。NexraOneに登録しているURLを転送先に合わせます
保存しました。サイトに接続できなかったため確認できませんでした。情報は保存されています。サイトが開けるかを確かめ、開けるようになってから「変更する」で保存し直すと、もう一度確かめられます
保存しました。続けて保存したため、確認は行っていません。1サイトにつき1分間に5回を超えて保存すると、確認を省きます。少し時間をおいて保存し直すと確かめられます

認証の情報は、NexraOneに登録しているURLと同じアドレスにだけ送り、別のドメインへ転送された先には送りません。転送で確認できなかったときにURLを合わせるのは、このためです。

httpで始まるURLのサイトの場合

URLが http:// で始まるサイトは、Basic認証とは関係なく、Safe Updateとバックアップの操作ができません(「HTTP接続のため、リモート更新とバックアップ操作は利用できません。」と出ます)。このようなサイトで登録して効くのは、WP-Cronが動いてハートビートが届き、死活監視を続けられる点だけです。更新までNexraOneで行いたいなら、サイトを https:// で開けるようにして、登録しているURLを変えます。

http:// のサイトでは、パスワードが暗号化されずに送られるので、初期状態ではNexraOneからのアクセスに認証の情報を付けず、保存したときの確認もしません。保存すると「HTTP のサイトなので NexraOne からのアクセスには使わず、Agent にだけ渡します。」と出ます。Agentには渡すので、誰かがサイトを開けばWP-Cronは動きますが、閲覧の少ないステージングではまた止まりがちです。

NexraOneの死活監視でWP-Cronを動かしたい場合は、登録のダイアログで「HTTP のまま NexraOne からのアクセスにも使う」にチェックを入れて保存します。そのサイトをブラウザで開く人も同じ情報を暗号化せずに送っていますが、NexraOneとサイトの間の通信でも読まれうることは承知のうえで選びます。サイトが同じアドレスの https:// へ転送しているなら、チェックを入れるより、NexraOneに登録しているURLを https:// に変えるほうが安全です。

登録したあとに確かめること

まず、「Basic認証」の欄の下に「Agent に反映済み」と出ているかを見ます。「Agent への反映待ち」のまましばらく変わらないときは、WP-Cronが止まっていて、AgentがNexraOneと通信できていない状態です。WordPressの管理画面でNexraOne Agentの設定を開き、「Send heartbeat now」を一度押すと、その通信でAgentが情報を受け取り、以後はWP-Cronが動きます。URLが http:// で始まるサイトは、NexraOneからAgentに知らせる経路が使えないので、この操作が必ず要ります。

「Agent 0.7.0 以上で WP-Cron にも使えます。」と出ている場合は、Agentが登録した情報をまだ一度も受け取っていません。Agentが0.7.0より古い版なら、NexraOneからの監視と更新後のチェックには登録した情報が使われますが、WP-Cronには付かないので、Agentを0.7.0以上に更新します。0.7.0以上なのにこの表示のままなら、ページを読み込み直し、それでも変わらなければ上と同じく「Send heartbeat now」を押します。

反映を確かめたら、5〜10分おいて、サイト詳細でハートビートが5分おきに届いているかを見ます。届いていれば、Safe Updateを本番のサイトと同じように実行できます。Safe Updateの手順はSafe Updateでプラグインを更新して結果を確認する方法にまとめています。

閲覧の少ないステージングでも、NexraOneの死活監視が確認の間隔ごとにページを開くので、それが訪問の代わりになってWP-Cronが動き続けます。ただし、ページキャッシュやCDNがWordPressより手前で応答しているサイト、wp-config.php で DISABLE_WP_CRON を設定しているサイト、死活監視を止めているサイトでは、このアクセスではWP-Cronが動きません。その場合は、サーバーのcronでWP-Cronを動かす方法を検討します。

登録できないとき、預けたくないとき

Agentを0.7.0以上に上げられない場合や、Basic認証の情報をNexraOneに預けたくない場合は、wp-cron.php だけをBasic認証から外すか、サーバーのcronでWP-Cronを動かす方法があります。どちらも .htaccess やサーバーの設定を変える作業で、書き方はBasic認証のかかったサイトを監視・更新するにはに載せています。この方法では、NexraOneからのアクセスには認証の情報が付かないので、更新後のチェックはトップページの中身までは確かめられません。

IPアドレスの制限、WAF、Cloudflare AccessのようなBasic認証以外の制限には、この登録は効きません。

登録した情報を消すときは、「Basic認証」の欄の「削除する」を押します。NexraOneからはすぐに消え、Agentからは、https:// のサイトならNexraOneからの知らせで、届かないときは次のハートビートのときに消えます。WordPress以外のサイトとして登録していたサイトにあとからAgentを接続したときや、接続を解除したサイトをつなぎ直したときも、登録していた情報は消えるので、接続が済んだらもう一度登録します。

この記事を書いた人

uehiro
uehiroWebアプリケーションエンジニア

2019年よりWeb制作・システム開発に従事。WordPress・PowerCMS・Movable TypeのCMS構築・運用支援のほか、Next.js・Astro・Nuxt.jsを活用したヘッドレスCMS・モダンWeb開発に携わる。約150件の制作・運用支援実績を持ち、現在はWordPress監視サービス「NexraOne」の開発・運営を担当。