本体とプラグインのファイルが知らないうちに書き換えられていないかを、定期的に確認する仕組みを作りました。WordPress.org は、本体とプラグインのファイルごとの md5(ファイルの内容から求める 32 けたの値。1 文字でも違えば別の値になる)を配っているので、サーバーのファイルの md5 と比べれば、変わったファイルが分かります。実際に比べてみると、改ざんではないのに「変わった」と出るものがいくつかあり、その見分け方もあわせてまとめました。
WordPress.org が配っているチェックサム
チェックサムは、次の URL で JSON として取れます。本体は、バージョンと言語(日本語のサイトなら ja)ごとに、プラグインはスラッグとバージョンごとに用意されています。
# 本体(version と locale を替える)# プラグイン(スラッグとバージョンを替える) https://api.wordpress.org/core/checksums/1.0/?version=7.1.3&locale=ja{スラッグ}/{バージョン}.json https://downloads.wordpress.org/plugin-checksums/
| 比べるもの | 内容 |
|---|---|
| 本体 | checksums の下に「ファイルの場所 => md5」が並ぶ。wp-content の下(初めから付いているテーマ・プラグイン・翻訳)も含まれる |
| プラグイン | files の下に「ファイルの場所 => { md5, sha256 }」が並ぶ。1 つのファイルに md5 が複数あることがある |
WP-CLI で比べる
サーバーで WP-CLI(WordPress をコマンドで操作するツール)が使えるなら、次の 2 つで比べられます。違うファイルがあると、ファイルの場所とともに警告が出ます。
# 本体のファイルを比べる(言語はサイトの言語。日本語のサイトなら ja のチェックサム) wp core verify-checksums # WordPress.org にあるプラグインを全部比べる wp plugin verify-checksums --all
PHP で比べる検証用スクリプト
WP-CLI が使えないサーバーでも、PHP でチェックサムを取って md5_file() と比べれば、同じことができます。次は、WordPress のフォルダに置いてコマンドで動かす、検証用のオリジナルコードです。WordPress.org には、本体で 1 回、プラグイン 1 つにつき 1 回だけ問い合わせ、プラグインは 1 件ごとに 1 秒あけています。
<?php
/**
* WordPress.org のチェックサムと、本体・プラグインのファイルを比べる検証用スクリプト
* 使い方:php my-check-files.php (WordPress のフォルダに置いて、コマンドで動かす)
*/
define( 'WP_USE_THEMES', false );
require __DIR__ . '/wp-load.php';
require_once ABSPATH . 'wp-admin/includes/plugin.php';
function my_get_json( $url ) {
$res = wp_remote_get( $url, array( 'timeout' => 20, 'redirection' => 0 ) );
if ( is_wp_error( $res ) || 200 !== wp_remote_retrieve_response_code( $res ) ) {
return null;
}
return json_decode( wp_remote_retrieve_body( $res ), true );
}
// 1. 本体
global $wp_version;
$data = my_get_json( 'https://api.wordpress.org/core/checksums/1.0/?' . http_build_query( array(
'version' => $wp_version,
'locale' => get_locale(),
) ) );
$sums = isset( $data['checksums'] ) && is_array( $data['checksums'] ) ? $data['checksums'] : array();
foreach ( $sums as $file => $md5 ) {
if ( 0 === strpos( $file, 'wp-content/' ) ) {
continue; // テーマ・プラグイン・翻訳のファイルは、本体の比べる対象から外す
}
if ( ! is_file( ABSPATH . $file ) ) {
echo "ない:{$file}\n";
} elseif ( md5_file( ABSPATH . $file ) !== $md5 ) {
echo "変わった:{$file}\n";
}
}
// 一覧にないファイル(wp-admin・wp-includes の下)
foreach ( array( 'wp-admin', 'wp-includes' ) as $dir ) {
$it = new RecursiveIteratorIterator( new RecursiveDirectoryIterator( ABSPATH . $dir, FilesystemIterator::SKIP_DOTS ) );
foreach ( $it as $f ) {
$rel = str_replace( '\\', '/', substr( $f->getPathname(), strlen( ABSPATH ) ) );
if ( ! isset( $sums[ $rel ] ) ) {
echo "一覧にない:{$rel}\n";
}
}
}
// 2. プラグイン
foreach ( get_plugins() as $main => $info ) {
$slug = dirname( $main );
if ( '.' === $slug ) {
continue; // フォルダの中にない 1 ファイルだけのプラグインは、比べない(チェックサムはフォルダごとに配られている)
}
// Update URI が WordPress.org 以外を指していれば、比べない
$uri = trim( $info['UpdateURI'] );
$host = '' !== $uri ? strtolower( (string) wp_parse_url( $uri, PHP_URL_HOST ) ) : '';
if ( '' !== $uri && ! in_array( $host, array( 'wordpress.org', 'w.org' ), true ) ) {
echo "比べない:{$slug}(Update URI {$uri})\n";
continue;
}
$data = my_get_json( "https://downloads.wordpress.org/plugin-checksums/{$slug}/{$info['Version']}.json" );
if ( ! isset( $data['files'] ) ) {
echo "チェックサムなし:{$slug} {$info['Version']}\n"; // WordPress.org にないプラグインなど
continue;
}
foreach ( $data['files'] as $rel => $h ) {
$path = WP_PLUGIN_DIR . "/{$slug}/{$rel}";
if ( is_file( $path ) && ! in_array( md5_file( $path ), (array) $h['md5'], true ) ) {
echo "変わった:{$slug}/{$rel}\n";
}
}
sleep( 1 ); // WordPress.org に続けて問い合わせないよう、1 件ごとに 1 秒あける
}
本体は、wp-content の下を比べる対象から外しています。初めから付いているテーマやプラグインは、更新で内容が変わることが多く、プラグインはプラグインのチェックサムで比べるためです。また、一覧にないファイルは wp-admin と wp-includes の下だけを探しています。サイトのいちばん上のフォルダには、.htaccess や wp-config.php など、もともと一覧にないファイルが並ぶからです。
作業環境で試した結果
作業環境(WordPress 7.1.3・日本語・PHP 8.3)で、上の検証用スクリプトと同じ比べ方を動かしました。本体は一覧のファイルを全部、プラグインは WordPress.org にあるものを 3 つ比べています。
| 比べたもの | 結果 |
|---|---|
| 本体(wp-admin・wp-includes・いちばん上の .php) | 変わったもの 0・ないもの 0。一覧にないファイルとして wp-admin/.htaccess が 1 つ出た |
| 手を加えていないプラグイン | 変わったもの 0 |
| 同じプラグインの readme.txt の最後に 1 行足した | 「変わった:readme.txt」と出た。元のファイルに戻すと md5 が足す前と同じになり、変わったもの 0 に戻った |
| 表示回数の多い記事を出すプラグイン | 1 ファイル(一覧を出す PHP)だけ「変わった」と出た |
| 見出しの Update URI が WordPress.org 以外のプラグイン | 「比べない」と出て、WordPress.org には問い合わせなかった |
ここからは、「変わった」「一覧にない」と出たものを、どう見分けたかを順に書きます。
自作のプラグインが「変わった」と出たとき
自分で作って WordPress.org にも公開しているプラグインが、「変わった 1」と出たことがありました。違っていたのは readme.txt だけで、本体の PHP は公開しているものと同じでした。サイトには手元で作ったファイルを置いていて、readme.txt だけが WordPress.org に上げたものと少し違っていたのが原因です。
自作のプラグインは、手元のファイルがいちばん新しいことが多く、WordPress.org と比べても役に立ちません。そこで、比べる前にプラグインの見出しの Update URI を見て、wordpress.org・w.org 以外を指していれば比べない形にしました。Update URI は WordPress 5.8 から使える見出しで、WordPress 自身も、この値が WordPress.org 以外を指していれば、WordPress.org からの更新を受け取りません。
ポイント
- Update URI がない:WordPress.org のプラグインとして比べる
- Update URI が wordpress.org・w.org:WordPress.org のプラグインとして比べる
- Update URI がそれ以外:WordPress.org のものではないので比べない
WordPress.org のプラグインで 1 ファイルだけ違ったとき
表示回数の多い記事を出すプラグインで、一覧を出す PHP の 1 ファイルだけが「変わった」と出ました。改ざんか、前に手で直したものかは、md5 だけでは分かりません。同じバージョンの zip を WordPress.org から取って、差分を取りました。
# 同じバージョンの zip を取って、違うと出たファイルと比べる
curl -s -o plugin.zip https://downloads.wordpress.org/plugin/{スラッグ}.{バージョン}.zip
unzip -q plugin.zip -d original
diff -u original/{スラッグ}/{変わったファイル} wp-content/plugins/{スラッグ}/{変わったファイル}
差分を見ると、表示を速くするためにテーマに合わせて手で直したところでした。一覧の HTML を 1 日キャッシュする処理と、一覧の前後のタグ(ul を ol と class に替える)の 2 つです。あわせて、改ざんでよく使われる書き方がないかも探し、どれも見つかりませんでした。
# 改ざんでよく使われる書き方がないかを探す(0 件なら、ひとまず手直しの見込みが高い)
grep -n -i -E 'eval\(|base64_decode|gzinflate|str_rot13|\$_(POST|GET|REQUEST|COOKIE)|https?://|file_put_contents|fwrite|curl_|assert\(' {変わったファイル}
| 探した書き方 | 改ざんで使われる理由 |
|---|---|
| eval・assert | 文字列を PHP として動かす |
| base64_decode・gzinflate・str_rot13 | 動かすコードを読めない形に隠す |
| $_POST・$_GET・$_REQUEST・$_COOKIE | 外から送った命令を受け取る |
| http:// ・https:// | 外のサーバーからコードを取る・情報を送る |
| file_put_contents・fwrite・curl_ | ファイルを書き込む・外と通信する |
手直しと分かったら、プラグインのファイルを直したままにせず、テーマ側に移しておくと、プラグインを元のファイルに戻せます。一覧の前後のタグは、プラグインが用意しているフィルターで替えられます。キャッシュは、テーマのテンプレートで一覧を出すところを transient(期限つきでデータベースに置く値)で包みます。
<?php
// 一覧の前後のタグを、テーマに合わせて替える
// (フィルターの名前は、プラグインが用意しているものに替える。ここでは仮に plugin_list_before・plugin_list_after)
add_filter( 'plugin_list_before', function () {
return '<ol class="my-popular-list">';
} );
add_filter( 'plugin_list_after', function () {
return '</ol>';
} );
<?php
// 一覧の HTML を 1 日キャッシュする(テーマのテンプレートから my_popular_list() を呼ぶ)
function my_popular_list() {
$html = get_transient( 'my_popular_list' );
if ( false === $html ) {
ob_start();
my_render_popular_list(); // プラグインの一覧を出す処理(ウィジェットや関数)
$html = ob_get_clean();
set_transient( 'my_popular_list', $html, DAY_IN_SECONDS );
}
echo $html;
}
プラグインのファイルを元に戻せば、チェックサムの比べる結果も「変わったもの 0」になり、プラグインを更新しても手直しが消える心配がありません。なお、手直ししたプラグインの見出しに Update URI を書いて「比べない」にする方法もありますが、WordPress.org からの更新が届かなくなるので、おすすめしません。
もう 1 つ、このプラグインでは、バナーやアイコンの画像が「ない」として並びました。同じバージョンの zip を開くと、これらの画像は zip にも含まれていません。チェックサムの一覧には、配布の zip に含まれないファイルが並ぶことがあるので、「ない」と出たファイルも、zip と見比べてから判断します。
本体で「一覧にないファイル」が出たとき
本体では、一覧にないファイルとして wp-admin/.htaccess が出ました。管理画面のために、自分で置いた .htaccess です。一覧にないファイルは、WordPress が配っていないファイルという意味なので、置いた覚えがあるかで判断します。覚えのない .php が wp-admin や wp-includes の下にあるときは、改ざんを疑って内容を見てください。
気をつけること
- 本体のチェックサムは、サイトの言語に合わせて取ります。日本語のサイトで英語(en_US)のチェックサムと比べると、日本語に訳された wp-config-sample.php などが「変わった」と出ることがあります。
- WordPress.org にないプラグイン(有料のプラグインなど)は、チェックサムがなく比べられません。この場合は、配布元の zip と差分を取ります。
- チェックサムで分かるのは、配っているファイルと同じかどうかだけです。アップロードのフォルダに置かれた .php や、データベースに書き込まれたコードは見つけられないので、ほかの確認のしかたと組み合わせてください。
- 多くのサイトでまとめて動かすときは、WordPress.org に一度にたくさん問い合わせないよう、1 件ごとに 1 秒あけるなどの間隔をとってください。
まとめ
WordPress.org のチェックサムと md5 を比べると、本体とプラグインのファイルが書き換えられていないかを、ファイルごとに確認できます。「変わった」と出ても改ざんとは限らず、自作のプラグインは Update URI で比べる対象から外し、WordPress.org のプラグインは同じバージョンの zip と差分を取って、改ざんでよく使われる書き方があるかを見ます。手直しと分かったものはテーマ側のフィルターに移し、プラグインを元のファイルに戻しておくと、次からは本当に気にするべきファイルだけが残ります。
