Safe Update

Basic認証のかかったサイトを監視・更新するには

Basic認証で保護されたステージングサイトで、Safe Updateやハートビートが止まる場合の原因と、NexraOneにBasic認証を登録して動かす方法です。

このページで分かること

設定前に確認すること、操作手順、運用時に注意したいポイントを順番に確認できます。

READY事前確認

Basic認証で保護されたステージングサイトを運用していること

方法1はNexraOne Agent 0.7.0以上と、NexraOneでメンバー以上の役割

方法2・3はサーバーの.htaccessまたはcron設定を変更できる権限

STEPS手順
1

症状を確認する

Safe Updateジョブがpendingのまま進まず、一定時間後にagent_no_responseで自動キャンセルされる場合は、WP-Cronが実行できていない可能性があります。手動のSend heartbeat nowでは反応するのに、定期ハートビートが5分間隔で届かない場合も同じ原因を疑います。

2

Basic認証とWP-Cronの関係を確認する

Safe UpdateはAgentが更新コマンドを受け取り、WordPress側でnexraone_run_safe_updateイベントを予約し、WP-Cronがそのイベントを実行します。WP-Cronはページアクセス時にサーバー自身がwp-cron.phpへループバックHTTPリクエストを送る仕組みです。このリクエストにはBasic認証の資格情報が付かないため、Basic認証で401になるとイベントが実行されません。

3

方法1: NexraOneにBasic認証のユーザー名とパスワードを登録する

サイト詳細の「サイト設定」タブを開き、「サイトの情報」にある「Basic認証」の「登録する」から、ユーザー名とパスワードを入力して保存します。クライアントから預かった情報をそのまま入れてかまいません。パスワードは暗号化して保存し、保存したあとは画面にも表示しません。登録できるのはメンバー以上の役割の人です。保存すると、NexraOneがその場でサイトにアクセスして認証が通るかを確かめ、「認証が通りました」「認証に失敗しています」のように結果を表示します。Basic認証がかかっているかどうかは、サイトを登録した直後と死活監視のたびにNexraOneが見分けています。認証を求めているのに登録がまだのサイトでは、サイト詳細の上に「このサイトにはBasic認証がかかっています」と出るので、「Basic認証を登録する」から登録の画面を開けます。Basic認証のないサイトには、この案内は出ません。サイト側でBasic認証を外した場合も、次の死活監視で案内は消えます。httpで登録したサイトがhttpsへ転送し、転送先で認証を求めている場合は見分けられないため、転送先のhttps://のURLで登録してください。

4

登録すると何が変わるか

NexraOneからの死活監視、Safe Updateの更新前後のチェック、復元のあとのチェックにBasic認証の情報が付くようになります。今までは401しか見えなかったので更新後のチェックが素通りになり、画面が真っ白になっても自動ロールバックが働きませんでしたが、登録すればトップページの中身まで確かめられます。Agent 0.7.0以上のサイトでは、Agentにも同じ情報が渡り、WordPressが自分自身に送るwp-cron.phpへのアクセスにも付くので、WP-Cronとハートビートが止まらなくなり、Safe Updateも最後まで進みます。認証情報はサイトの登録URLと同じアドレスにだけ送り、別のドメインへ転送された先には送りません。閲覧の少ないステージングでも、NexraOneの死活監視が確認間隔ごとにページを開くので、それが訪問の代わりになってWP-Cronが動き続けます。

5

Agentへの反映を確かめる

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

6

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

httpのサイトでは、パスワードが暗号化されずに送られるため、初期状態ではNexraOneからのアクセスに認証情報を付けません。Agentには渡すので、誰かがサイトを開けばWP-Cronは動きますが、閲覧の少ないステージングではまた止まりがちです。NexraOneの死活監視を訪問の代わりにしたい場合は、登録のダイアログで「HTTPのままNexraOneからのアクセスにも使う」にチェックを入れて保存してください。そのサイトをブラウザで開く人も同じ情報を平文で送っていますが、NexraOneとサイトの間の通信でも読まれうることは承知のうえで選んでください。チェックを外すときも、ユーザー名とパスワードを入れ直して保存します。httpのサイトが同じアドレスのhttpsへ転送している場合は、チェックを入れるのではなく、NexraOneに登録しているURLをhttps://に変更してください。

7

方法2: wp-cron.phpをBasic認証から除外する

Agentを0.7.0以上に更新できない場合や、Basic認証の情報をNexraOneに預けたくない場合の方法です。Apache環境では、Basic認証を定義している.htaccessの末尾に次の設定を追加します。# END WordPressマーカーの内側ではなく、マーカーの外に追記してください。<Files>はファイル名でマッチするため、WordPressがサブディレクトリ設置でも親の.htaccessに書けば効きます。

# WP-Cron のループバックリクエストは Basic 認証を除外する
<Files "wp-cron.php">
Require all granted
</Files>
8

Apache 2.2系では代替設定を使う

Require all grantedで500エラーになる環境では、Apache 2.2系の書き方に変更します。サーバー仕様が不明な場合は、変更後にwp-cron.phpへアクセスして500エラーにならないことを確認してください。

<Files "wp-cron.php">
Order allow,deny
Allow from all
Satisfy Any
</Files>
9

方法3: サーバーcronでWP-Cronを実行する

WP-CLIが使える環境では、疑似cronを止めてサーバーcronから定期実行します。まずwp-config.phpにDISABLE_WP_CRONを追加し、crontabで5分間隔の実行を登録します。/path/to/wpはWordPress本体のパスに置き換えてください。

define('DISABLE_WP_CRON', true);

*/5 * * * * wp cron event run --due-now --path=/path/to/wp
10

wp-cron.phpのURLを確認する

シークレットウィンドウでwp-cron.phpのURLを開き、認証ダイアログなしで真っ白なページが返ることを確認します。WordPressがサブディレクトリ設置の場合、URLはホームURLではなくWordPressアドレスを基準にします。例として、ホームがexample.comでもWordPress本体がexample.com/wp/にある場合はexample.com/wp/wp-cron.phpを確認します。

11

ハートビートとSafe Updateを再確認する

設定後に5〜10分待ち、NexraOneダッシュボードでハートビートが5分間隔で届くことを確認します。定期ハートビートが戻ったら、Safe Updateを再実行してください。方法2と方法3では、NexraOneからのアクセスには認証情報が付かないので、更新後のチェックはトップページの中身までは見られません。中身まで確かめたい場合は方法1も合わせて登録してください。

NOTES補足

方法1で登録すると、NexraOneの死活監視が訪問の代わりになります。ただし、ページキャッシュやCDNがWordPressより手前で応答しているサイトや、死活監視を止めているサイトでは、このアクセスでWP-Cronは動きません。その場合はサーバーcronも検討してください。

サイトに誰かがアクセスしても、wp-cron.phpへのループバックが401で弾かれる状態ではSafe Updateは進みません。

Basic認証の除外設定はwp-cron.phpに限定し、管理画面やサイト全体の保護範囲を不用意に広げないでください。

サイトのURLがwwwの有無などで別のアドレスへ転送される場合、転送先には認証情報を送りません。NexraOneに登録しているURLを、転送先と同じアドレスにしてください。

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

WordPress以外のサイトとして登録していたサイトにあとからAgentを接続したときや、接続を解除したサイトをつなぎ直したときは、登録していたBasic認証の情報を消します。接続してきたAgentが本当にそのサイトで動いているかをNexraOneは確かめられないので、別のサイトのAgentにパスワードを渡さないためです。接続が済んだら、もう一度登録してください。