メインコンテンツへスキップ
見出し画像

PHP と MySQL のサイトを守る:SQL インジェクションの点検と改ざん検知

    この記事では、PHP 8 と PDO と MySQL(または MariaDB)で動くサイトに、2層の守りを作る。1層目は侵入を防ぐ層で、コードの SQL インジェクションを点検し、PDO と DB の権限を固める。2層目は侵入に気づく層で、cron で5分ごとにサイトのフォルダと DB と DNS を見張り、変化をメールで知らせる。

    防ぐ側の結論は1つである。SQL に入る値はすべてプレースホルダで渡し、渡せない部分は許可リストで固定の断片に置き換える。PDO の設定と DB の権限は、その見落としが1つ残ったときに被害を小さくするための2段目である。

    気づく側の結論は3つある。ファイルはハッシュ(SHA-256)のベースラインと比べ、mtime だけでなく ctime も見る。自分のデプロイは署名つきのマニフェストで見分け、知らない変更だけを警告や至急にする。知らせは同じ状態が続く間は1回だけ送り、何もない回は黙る。

    限界もはっきりさせておく。同じサーバーの上の監視は、侵入した者に止められうる。そのため毎朝1通の無事のメールを送り、それが届かないことを異常の知らせとして扱い、さらにサーバーの外からも見る。

    防ぐ層(プレースホルダ・PDO の設定・最小権限)と気づく層(改ざん検知・署名・見張り・無事のメール)の全体図
    防ぐ層(プレースホルダ・PDO の設定・最小権限)と気づく層(改ざん検知・署名・見張り・無事のメール)の全体図

    はじめに

    この記事の前提

    読み手に要るものは、Linux のシェル、PDO と pdo_mysql の入った PHP 8、MySQL か MariaDB、cron、OpenSSL 3.0 以上、curl、rsync、dig(dnsutils)、flock(util-linux)、mail コマンド(mailutils か bsd-mailx)と、メールを実際に配送する MTA(Mail Transfer Agent。postfix など)である。

    第2章から第5章は、サーバーに root(または sudo)で入れることを前提にする。root が無い場合は、監視の記録の場所とスクリプトの置き場所を自分のホームの下(例 ~/sitewatch)に替え、自分のユーザーの crontab を使う。

    コマンドと出力は、Ubuntu 22.04、PHP 8.3、MariaDB 10.11、OpenSSL 3.0.2 で確かめた。メールの送信と crontab の書き換えは実際には行わず、mail の代わりに引数と本文を画面に出す代役を置いて確かめた。そうした箇所は本文で断っている。

    全体を通して、次の置き場所と名前を使う。自分の環境に合わせて読み替える。

    • SITE:サイトのフォルダ /var/www/example。公開フォルダ public と、その外に置くコードや vendor を含むアプリ全体

    • STATE:監視の記録の場所 /var/lib/sitewatch(公開フォルダの外)

    • example.com:見張るドメイン

    • admin@example.com:知らせの宛先のメールアドレス

    • SERVER:SSH で入る先 deploy@www.example.com

    • app:DB の名前と、アプリの DB ユーザー

    章ごとに、コマンドを流す場所が違う。各コードブロックの前にも、どこで流すかを1文で書く。

    • 第1章:開発用の機械と開発用の DB。点検(grep)と権限の確認(SHOW GRANTS)はサーバーで、読むだけ

    • 第2章:サーバー(root)

    • 第3章:デプロイ用の機械とサーバー

    • 第4章:サーバー(root)と DB の管理者

    • 第5章:サーバーと、サーバーとは別の機械

    知らせは次の3つの段階に分ける。件名の頭の【】で段階が分かるので、メールの一覧だけで読む順番を決められる。

    • 予定どおり
      件名の頭:【予定どおり】
      意味:自分のデプロイで、署名つきのマニフェストと一致した変更

    • 警告
      件名の頭:【警告】
      意味:理由の分からない変更

    • 至急
      件名の頭:【至急】
      意味:ウェブシェルの設置など、侵入に典型的な変更

    毎朝の無事のメール(第5章)だけは、件名の頭を【無事】にする。これは段階ではなく、届くこと自体が知らせである。

    読み方

    • 第1章
      得られるもの:SQL インジェクションの点検と、PDO と DB の権限の固め方
      前に要る章:なし

    • 第2章
      得られるもの:ファイルの改ざんを5分ごとに見つける sitewatch.sh
      前に要る章:なし

    • 第3章
      得られるもの:自分のデプロイを予定どおりとして見分ける署名
      前に要る章:第2章

    • 第4章
      得られるもの:ログイン・設定・証明書・DNS の見張り
      前に要る章:第2章

    • 第5章
      得られるもの:監視の停止に気づく無事のメールと外の見張り
      前に要る章:第2章

    SQL の点検だけなら第1章、監視だけなら第2章と第5章で用が足りる。経験のある読み手は、各章の手順のコードと踏み込みを中心に拾い読みできる。

    第1章 SQL インジェクションを防ぐ

    値はすべてプレースホルダで渡し、渡せない部分は許可リストで固定する。PDO の設定と DB の権限は、見落としが残ったときに被害を小さくする2段目である。この章では、攻撃が通るコードと直したコード、既存のコードの点検、設定と権限を示し、最後に同じ入力を流して違いを確かめる。

    値を文字列につなぐ場合とプレースホルダで渡す場合の比較と、被害を小さくする3つの設定
    値を文字列につなぐ場合とプレースホルダで渡す場合の比較と、被害を小さくする3つの設定

    しくみ:値が SQL の文として読まれる

    SQL インジェクション(SQL injection)とは、受け取った値が SQL の文の一部として解釈され、作り手の意図と違う SQL が流れる脆弱性である。原因は、値を SQL の文字列に直接つなぐことにある。' OR '1'='1 をつなぐと WHERE の条件が常に真になり、'; DROP TABLE … をつなぐと表を消す2つ目の文が流れる。

    直し方はプレースホルダ(placeholder)である。SQL の文は固定し、値は ? の位置に別に渡す。この形をプリペアドステートメント(prepared statement)と呼ぶ。PDO の渡し方は次の2つで、どちらでも値は文として解釈されない。

    • サーバー側のプリペア:文を先に DB に送り、値はあとから別に送る。

    • エミュレーション(emulated prepare):PDO が値をエスケープして文に埋めてから送る。pdo_mysql の既定で、接続の文字コードを PDO が正しく知っていることが前提になる。

    手順:試す場所を用意する

    この章のコマンドは、点検と権限の確認を除いて開発用の機械で流す。試しには、開発用の DB で CREATE TEMPORARY TABLES の権限を持つユーザーを使い、本番の DB では流さない。パスワードは環境変数 APP_DB_PASSWORD で渡す。次の1行は「DB のパスワード:」と出してパスワードの入力を待つ。read -s は打った文字を画面にも履歴にも残さない。

    read -rsp 'DB のパスワード: ' APP_DB_PASSWORD && export APP_DB_PASSWORD && echo

    同じシェルで、この章の PHP のファイルを1つのフォルダに置いて流す。試しの表は一時表(TEMPORARY TABLE)にする。接続を閉じると消えるので、跡が残らない。

    <?php
    // connect.php
    function connect(array $options = []): PDO
    {
        $password = getenv('APP_DB_PASSWORD');
        $pdo = new PDO("mysql:host=localhost;dbname=app;charset=utf8mb4", "app", $password, $options);
        // 試すための一時表(接続を閉じると消える)
        $pdo->exec("CREATE TEMPORARY TABLE lab_users (id INT PRIMARY KEY, name VARCHAR(32), role VARCHAR(16))");
        $pdo->exec("INSERT INTO lab_users VALUES (1, 'alice', 'admin'), (2, 'bob', 'user'), (3, 'carol', 'user')");
        return $pdo;
    }

    比べるために、受け取った名前を SQL にそのままつなぐ検索も置く。

    <?php
    // search.php:脆弱性のある検索(比べるために置く)
    require_once __DIR__ . '/connect.php';
    $pdo = connect($options ?? []);   // harden.php から読まれたときは固めた設定
    
    // 脆弱性:受け取った値を SQL の文字列に直接つないでいる
    $sql = "SELECT id FROM lab_users WHERE name = '" . $argv[1] . "'";
    try {
        $r = "返った行 " . count($pdo->query($sql)->fetchAll());
    } catch (PDOException $e) {
        $r = "止まった " . $e->getCode();
    }
    try {
        $c = "表の行数 " . $pdo->query("SELECT COUNT(*) FROM lab_users")->fetchColumn();
    } catch (PDOException $e) {
        $c = "表が無い " . $e->getCode();
    }
    echo $r, "、", $c, "\n";

    手順:値はプレースホルダで渡す

    同じ検索を、値を ? で渡す形に直す。画面のコードなら $argv[1] が $_GET['name'] にあたる。

    <?php
    // search2.php:値をプレースホルダで渡す
    require_once __DIR__ . '/connect.php';
    $pdo = connect();
    $stmt = $pdo->prepare("SELECT id FROM lab_users WHERE name = ?");
    $stmt->execute([$argv[1]]);
    echo "返った行 ", count($stmt->fetchAll()), "、表の行数 ", $pdo->query("SELECT COUNT(*) FROM lab_users")->fetchColumn(), "\n";

    手順:プレースホルダで渡せない部分を固定する

    プレースホルダで渡せるのは値だけである。識別子(identifier、表と列の名前)、ORDER BY の並べ方、IN (...) の値の数は文の一部なので、別の方法で固定する。

    • 並べ方は許可リスト(allowlist)で決める。受け取った語で固定の断片を引き、一覧に無い語は既定に落とす。

    • 識別子は、形を正規表現で確かめてからバッククォートで囲む。形の確認は文の破損を防ぐだけなので、使える名前は許可リストでも絞る。

    • IN の中は、値の数だけ ? を並べる(implode(', ', array_fill(0, count($ids), '?')))。空の配列では IN () になり文法の誤りになる。

    この例はサーバー側のプリペアを使うが、扱いはどちらの方式でも同じである。

    <?php
    // parts.php:プレースホルダで渡せない部分を固定する
    require_once __DIR__ . '/connect.php';
    $pdo = connect([PDO::ATTR_EMULATE_PREPARES => false]);
    
    function order_by(string $sort): string
    {
        $allowed = ['name' => 'name ASC', 'name_rev' => 'name DESC'];
        return $allowed[$sort] ?? 'id ASC';   // 一覧に無い語は既定の並べ方
    }
    
    function quote_ident(string $name): string
    {
        // MariaDB の名前は64文字まで
        if (!preg_match('/\A[A-Za-z_][A-Za-z0-9_]{0,63}\z/', $name)) {
            throw new InvalidArgumentException('識別子の形ではない');
        }
        return '`' . $name . '`';
    }
    
    foreach (['name_rev', 'name; DROP TABLE lab_users'] as $sort) {
        $names = $pdo->query("SELECT name FROM lab_users ORDER BY " . order_by($sort))->fetchAll(PDO::FETCH_COLUMN);
        echo $sort, " → ", implode(' ', $names), "\n";
    }
    foreach (['lab_users', "lab_users`; DROP", "lab_users\n"] as $table) {
        try {
            $quoted = quote_ident($table);
        } catch (InvalidArgumentException $e) {
            $quoted = '拒否';
        }
        echo json_encode($table), " → ", $quoted, "\n";
    }

    手順:既存のコードを点検する

    点検は、SQL を流す所(シンク、sink)をすべて並べ、変数から組み立てた SQL だけを出どころまでさかのぼる。

    シンクを grep で並べる

    サーバーで流す。ファイルは読むだけである。PDO と mysqli、フレームワークの生の SQL を受け取るメソッド(DB::raw、whereRaw など)を拾い、vendor は除く。

    SITE=/var/www/example
    grep -rnE --include='*.php' --exclude-dir=vendor \
      -e '(->|::)(query|exec|prepare|real_query|multi_query)[[:space:]]*\(' \
      -e 'mysqli_(query|real_query|multi_query)[[:space:]]*\(' \
      -e '(DB::raw|[A-Za-z]+Raw)[[:space:]]*\(' \
      "$SITE" | sort

    安全な書き方と危ない書き方を混ぜた見本のコードでは、次のように出た。

    /var/www/example/app/author.php:2:$nick = $pdo->query("SELECT nick FROM users WHERE id = 1")->fetchColumn();
    /var/www/example/app/author.php:3:$pdo->exec("UPDATE stats SET hits = hits + 1 WHERE nick = '$nick'");
    /var/www/example/app/count.php:2:$st = $pdo->prepare("SELECT * FROM users WHERE id = ?");
    /var/www/example/app/list.php:4:$st = $pdo->prepare('SELECT * FROM posts ORDER BY ' . $order);
    /var/www/example/app/report.php:3:$res = $mysqli->query($sql);
    /var/www/example/app/search.php:3:$rows = $pdo->query("SELECT * FROM posts WHERE title LIKE '%$q%'");

    組に分けてさかのぼる

    固定の文だけの author.php の2行目と、値を ? で渡す count.php の2行目は、ここで終わる。残りの4行は変数から組み立てているので、同じシェルで、変数が代入される行を grep -n で探し、その前後を sed -n で見る。

    grep -n '\$order' "$SITE/app/list.php"
    sed -n '1,3p' "$SITE/app/report.php"
    3:$order = order_by($_GET['sort'] ?? '');
    4:$st = $pdo->prepare('SELECT * FROM posts ORDER BY ' . $order);
    <?php
    $sql = "SELECT * FROM orders WHERE status = 'open'";
    $res = $mysqli->query($sql);
    • list.php の $order は、parts.php と同じ許可リストの関数から来る。固定の断片しか返らないので、このままでよい。

    • report.php の $sql は固定の文である。このままでよい。

    • search.php の $q はリクエストから来る。脆弱性なので、プレースホルダに直す。

    • author.php の $nick は DB から読んだ値である。保存済みの値をあとで SQL につなぐ形を二次の SQL インジェクション(second-order SQL injection)といい、保存のときにプレースホルダを使っていても防げない。これもプレースホルダに直す。

    手順:PDO の設定で2つ目の文を止める

    直しとは別に、接続の設定で2つ目の文を止める。見落としたつなぎが残っても、表を消すような文は通らない。次のファイルは search.php を固めた接続で流す。

    <?php
    // harden.php:search.php を、設定を固めた接続で流す
    $options = [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_EMULATE_PREPARES => false,
        PDO::MYSQL_ATTR_MULTI_STATEMENTS => false,
    ];
    require __DIR__ . '/search.php';
    • ERRMODE_EXCEPTION:エラーを例外にする。PHP 8.0 からの既定だが、前提として明示する。

    • EMULATE_PREPARES を false:サーバー側のプリペアにする。これは1回に1つの文しか受け付けない。

    • MULTI_STATEMENTS を false:複数の文を流すのを止める。new PDO() の引数でしか効かず、接続後の setAttribute() は false を返して変わらなかった。

    • DSN(Data Source Name、new PDO() の1つ目の引数の接続先の文字列)の charset=utf8mb4:接続の文字コードを PDO に知らせる(踏み込みで述べる)。

    2つの false は、どちらか一方だけでも2つ目の文を止めた。両方を書けば、一方が戻されても残りが効く。PHP 8.4 からは子クラスの Pdo\Mysql::ATTR_MULTI_STATEMENTS が使え、8.5.0 では PDO::MYSQL_ATTR_* が非推奨(deprecated)になった(php.net の PDO_MYSQL)。

    手順:DB の権限を絞る

    アプリの DB ユーザーには、画面の動きに要る権限だけを与える。これを最小権限(least privilege)という。SQL インジェクションが起きても、流れる SQL はその権限の内側に収まる。サーバーで、mysql クライアントにアプリのユーザーとして入って流す。読むだけの SQL で、-p はパスワードを尋ねる。

    mysql -u app -p app -e 'SHOW GRANTS FOR CURRENT_USER()'

    結果は次の形の行になる(ハッシュを含まない、作った見本である)。

    GRANT SELECT, INSERT, UPDATE, DELETE ON `app`.* TO `app`@`localhost`

    ON の後ろがアプリの DB(app.*)だけで、*.*(すべての DB)が無いことを見る。次の権限も無いことを見る。

    • DROP と ALTER:表を消す・作りを変える。作りの変更は別のユーザーで流す。

    • FILE:DB のサーバーのファイルを読み書きする(SELECT ... INTO OUTFILE など)。

    • SUPER と PROCESS:サーバーの設定を変える・ほかの接続の SQL を見る。

    • CREATE ROUTINE と TRIGGER:あとで動く処理を DB に仕込む。

    • WITH GRANT OPTION と ALL PRIVILEGES:権限を配る権限と、GRANT OPTION 以外のすべての権限。

    FILE の害はサーバーの変数 secure_file_priv でも絞れる。フォルダを指定すると、ファイルの読み書きはその中に限られる。未設定か空なら制限は無い。権限を外すのは DB の管理者で、次はその例である(流していない)。

    REVOKE DROP, ALTER ON app.* FROM 'app'@'localhost';

    確かめる:攻撃の文字列を流す

    3つの検索を比べる

    開発用の機械で、APP_DB_PASSWORD を設定したシェルのまま、PHP のファイルのフォルダで流す。普通の名前と、全行を返させる文字列と、表を消す文字列を渡す。

    for f in search search2 harden; do
      for v in "alice" "' OR '1'='1" "x'; DROP TABLE lab_users; -- "; do
        printf '%-8s %-32s ' "$f" "$v"; php "$f.php" "$v"
      done
    done
    search   alice                            返った行 1、表の行数 3
    search   ' OR '1'='1                      返った行 3、表の行数 3
    search   x'; DROP TABLE lab_users; --     返った行 0、表が無い 42S02
    search2  alice                            返った行 1、表の行数 3
    search2  ' OR '1'='1                      返った行 0、表の行数 3
    search2  x'; DROP TABLE lab_users; --     返った行 0、表の行数 3
    harden   alice                            返った行 1、表の行数 3
    harden   ' OR '1'='1                      返った行 3、表の行数 3
    harden   x'; DROP TABLE lab_users; --     止まった 42000、表の行数 3
    • search.php は全行を返し、表も消えた。PDO の既定は1回の呼び出しで複数の文を通す。42S02 は「表が無い」を表す SQLSTATE(SQL の標準のエラーの分類)である。

    • search2.php では、同じ入力がただの名前として比べられ、0行だった。

    • harden.php では2つ目の文が文法の誤り(42000)で止まり、表は残った。ただし ' OR '1'='1 はまだ全行を返す。設定が止めるのは2つ目の文だけで、つなぎはプレースホルダでしか直らない。

    渡せない部分の固定を確かめる

    同じフォルダで parts.php を流す。

    php parts.php
    name_rev → carol bob alice
    name; DROP TABLE lab_users → alice bob carol
    "lab_users" → `lab_users`
    "lab_users`; DROP" → 拒否
    "lab_users\n" → 拒否

    一覧に無い並べ方は既定の id の順に落ち、文に入らなかった。最後の行は、正規表現の終わりを \z にしたので改行の付いた名前を拒んだ結果である。$ は末尾の改行の手前でも一致するので、この名前を通してしまう。

    踏み込み:プレースホルダの注意点

    同じ名前のプレースホルダを2回使う

    エミュレーションを止めると、:q のような名前付きのプレースホルダを1つの文で2回使えなくなる。WHERE name = :q OR role = :q は、止めると SQLSTATE[HY093]: Invalid parameter number で止まった。設定を替える前に、:q1 と :q2 に分けて同じ値を2つ渡す形へ直しておく。

    文字コードは DSN に書く

    エミュレーションのエスケープは、PDO が知っている接続の文字コードに従う。SET NAMES を SQL で流しても、PDO はそれを知らない(php.net の文字コードの説明)。GBK のように2バイト目に \(0x5C)が来うる文字コードでは脆弱性になる。DSN に charset を書かずに SET NAMES gbk を流し、0xBF に ' OR 1=1 -- を続けた値をプレースホルダで渡すと、3行すべてが返った。PDO が足した \ を DB が 0xBF と合わせて1文字と読み、残った ' が文字列を閉じた。DSN に charset=gbk を書くか、サーバー側のプリペアにすると0行だった。

    grep より細かく絞る

    grep は SQL の引数が文字列の定数かどうかを区別できない。PhpToken::tokenize() でコードをトークン(文法の最小の単位)に分け、引数が文字列の定数1つでない呼び出しだけを並べると、見本の6行は4行に減った。落ちたのは author.php と count.php の2行目で、変数を渡す report.php の3行目は残る。残った行は、上と同じくさかのぼって確かめる。

    第2章 ファイルの改ざんに気づく

    第1章の守りは、見落としが1つでも残れば破られる。破られたことに気づく層を、ここから作る。サイトのフォルダの全ファイルのハッシュと属性をベースライン(baseline、正しい状態の記録)に残し、5分ごとに今の状態と比べる。変化は警告と至急に分けてメールで送り、同じ状態が続く間は1回しか送らず、何も無い回は黙る。知らない変更はベースラインに自動で取り込まず、人が確かめてから取り込む。

    サイトのフォルダの一覧をベースラインと突き合わせ、変化を警告と至急に分けてメールで送る流れ
    サイトのフォルダの一覧をベースラインと突き合わせ、変化を警告と至急に分けてメールで送る流れ

    しくみ:何が書き換えられるか

    侵入したあとに攻撃者が手を入れる場所は、おおむね決まっている。

    • アップロード先や画像のフォルダに、新しい PHP ファイルを置く。外から命令を受けて実行する、こうしたファイルをウェブシェル(web shell)と呼ぶ。

    • 既存の PHP ファイルに数行を足し、裏口(backdoor)を作る。見た目は変わらないので気づきにくい。

    • .htaccess や .user.ini を書き換える。auto_prepend_file を足すと、すべてのページの前に任意のファイルが読み込まれる。AddHandler を足すと、.jpg のような画像が PHP として動く。

    • 権限を変え、全ユーザーが書けるファイル(world-writable)にする。次の書き換えの足場になる。

    • トップページを差し替える(改ざん、defacement)。

    どれも「ファイルが増える・消える・中身が変わる・属性が変わる」のどれかになる。ハッシュ(hash)は中身から計算する決まった長さの値で、SHA-256 なら16進数64文字になり、1バイトでも違えば別の値になる。ファイルごとのハッシュと属性を記録しておけば、種類を問わず差分として見つかる。これを改ざん検知(file integrity monitoring)という。

    変化のうち、次のものは侵入に特有なので至急にする。ほかの変化は警告にする。

    • 日時の偽装:中身を変えて mtime を戻すのは、隠す意図の表れである(次の節)

    • 全ユーザーが書けるファイルとフォルダ:次の書き換えの足場になる

    • アップロード先の PHP:利用者が置ける場所で PHP が動く。a.php.jpg のように途中に .php がある名前も含める

    • ウェブシェルに似たコード:受け取った文字列を実行する書き方

    • .htaccess と .user.ini の変化:すべてのページの動きを変えられる

    • 扱えない名前、リンクと特殊なファイル:名前のタブや改行は一覧の列をずらして判定を素通りする。リンクはサイトの外のファイルを晒す

    ウェブシェルのパターンは、手抜きのシェルを至急に上げるためのものである。文字列をつないだり圧縮したりしたシェルには当たらない。本当の検知はハッシュの差分で、パターンが外れても追加か内容の変更の警告にはなる。

    しくみ:中身・属性・日時のどれが変わるか

    ベースラインは、サイトのフォルダの全ファイルについて1行に7列をタブ区切りで書き、パスの順に並べたものである。

    • 1
      中身:サイトのフォルダからのパス
      find の書式:%P

    • 2
      中身:権限(8進数)
      find の書式:%m

    • 3
      中身:持ち主の uid(ユーザー番号)
      find の書式:%U

    • 4
      中身:大きさ(バイト)
      find の書式:%s

    • 5
      中身:mtime(更新日時、エポック秒)
      find の書式:%T@

    • 6
      中身:ctime(状態の変更日時、エポック秒)
      find の書式:%C@

    • 7
      中身:SHA-256
      find の書式:sha256sum

    エポック秒は1970年1月1日(UTC)からの秒数で、%T@ と %C@ は小数部まで出す(ext4 ではナノ秒単位)。毎回すべてのファイルのハッシュを取ると、ファイルが多いほど重い。そこで、大きさ・mtime・ctime がベースラインと同じファイルはハッシュを使い回す。

    ところが mtime は touch で好きな値に戻せる。中身を書き換えて mtime を戻すと、大きさと mtime だけを見る絞り方では見逃す。これを防ぐのが ctime である。ctime は、中身や属性が変わったときにカーネルが今の時刻を入れる。touch が使う utimensat は atime(最後に読んだ日時)と mtime を設定するだけで、ctime は呼んだ時点の時刻になる(utimensat(2))。日時を戻す操作そのものが ctime を新しくする。

    そこで、ハッシュを取り直したうえで中身が違い、しかも大きさと mtime がベースラインと同じなら、日時を偽装した書き換えとみなして至急にする。普通の編集では mtime も変わるので、この組み合わせは偽装のほかでは起きにくい。例外は rsync -t や tar の展開のように、元の mtime を保ったまま書き込む道具である。デプロイにそうした道具を使う場合は、第3章の署名つきマニフェストで自分の変更を見分ける。

    手順:スクリプトを書く

    次の sitewatch.sh を、サーバーの作業用のフォルダに、改行を LF にして保存する。

    #!/bin/bash
    # サイトのフォルダの改ざんを見張る。何も無いときは何も出さない
    # 使い方: sitewatch.sh(見張る) / sitewatch.sh --accept(変化を見せてから今の状態をベースラインにする)
    set -u -o pipefail
    export LANG=C.UTF-8
    PATH=${PATH:+$PATH:}/usr/sbin:/usr/bin:/sbin:/bin
    : "${SITE:=/var/www/example}"
    : "${STATE:=/var/lib/sitewatch}"
    : "${MAILTO:=admin@example.com}"
    BASE=$STATE/base.tsv
    PAT=$STATE/patterns.txt
    T=$(printf '\t')
    BAD='*[[:cntrl:]\\]*'
    RE_UP='^public/(uploads|images)/'
    RE_PHP='\.(php[0-9]?|phtml|phar)(\.|$)'
    RE_CONF='(^|/)(\.htaccess|\.user\.ini)$'
    # アプリが動いている間に書き換えるフォルダ。自分のサイトに合わせて替える(空なら何も除かない)
    SKIP='^storage/(logs|framework/(sessions|cache|views))/'
    # 除いたフォルダのうち、PHP ができて当然の場所(コンパイル済みのテンプレート)
    SKIP_PHP='^storage/framework/views/'
    umask 077
    
    # 同じ時刻に2つ動かない。一時ファイルは STATE の中に作る
    exec 9>"$STATE/lock" || exit 1
    flock -n 9 || { echo "sitewatch: 前の回がまだ動いている" >&2; exit 1; }
    TMP=$(mktemp -d "$STATE/tmp.XXXXXX") || exit 1
    trap 'rm -rf "$TMP"' EXIT
    trap 'exit 1' HUP INT TERM
    [ -r "$PAT" ] || { echo "sitewatch: $PAT が無い" >&2; exit 1; }
    touch "$STATE/links.tsv" || exit 1
    
    # 第3章で、署名つきマニフェストと照らす処理に置き換える
    is_planned() { return 1; }
    
    # notify 段階 件名 本文
    notify() {
      printf '%s\n' "$3" | mail -s "$2" "$MAILTO" || { echo "sitewatch: メールを送れない: $2" >&2; return 1; }
      echo "$(date -Iseconds) $1 $2" >> "$STATE/alerts.log"
    }
    
    # 今の一覧を出す。SKIP に当たるパスは除く。大きさ・mtime・ctime がベースラインと同じファイルはハッシュを使い回す
    scan() {
      (cd "$SITE" && find . -path "./$BAD" -prune -o -type f -printf '%P\t%m\t%U\t%s\t%T@\t%C@\n') |
        S=$SKIP awk -F'\t' 'ENVIRON["S"] == "" || $1 !~ ENVIRON["S"]' |
        LC_ALL=C sort -t "$T" -k1,1 > "$TMP/meta" || return 1
      awk -F'\t' -v OFS='\t' 'FILENAME == ARGV[1] { k[$1] = $4 " " $5 " " $6; h[$1] = $7; next }
        { print $0, (($1 in k) && k[$1] == $4 " " $5 " " $6) ? h[$1] : "-" }' "$1" "$TMP/meta" |
      while IFS=$T read -r p m u s mt ct h; do
        if [ "$h" = - ]; then
          # find のあとで消えたファイルは飛ばす
          h=$(sha256sum 2>/dev/null < "$SITE/$p" | cut -c1-64) || { [ -e "$SITE/$p" ] && return 1; continue; }
        fi
        printf '%s\t%s\t%s\t%s\t%s\t%s\t%s\n' "$p" "$m" "$u" "$s" "$mt" "$ct" "$h"
      done
    }
    
    # ベースラインに載らないもの。扱えない名前、リンクと特殊なファイル、除いたフォルダの PHP、全ユーザーが書けるフォルダ
    odd() {
      cd "$SITE" || return 1
      find . -name "$BAD" -printf '%P\0' | LC_ALL=C tr -c '[:print:]\0' '?' | tr '\0' '\n' |
        sed "s/^/至急$T/; s/\$/$T-${T}監視で扱えない名前/" || return 1
      # links.tsv に「パス<TAB>リンクの先」で書いたリンクは飛ばす
      find . -path "./$BAD" -prune -o ! -type f ! -type d -printf "%P$T%y$T%l\n" > "$TMP/links" || return 1
      awk -F'\t' -v OFS='\t' 'FILENAME == ARGV[1] { ok[$1 FS $2]; next }
        !($2 == "l" && ($1 FS $3) in ok) { print "至急", $1, $2, "リンクか特殊なファイル" }' "$STATE/links.tsv" "$TMP/links" || return 1
      find . -path "./$BAD" -prune -o -type f -printf '%P\n' |
        S=$SKIP SP=$SKIP_PHP RE=$RE_PHP awk -v t="$T" 'ENVIRON["S"] != "" && $0 ~ ENVIRON["S"] && tolower($0) ~ ENVIRON["RE"] &&
          (ENVIRON["SP"] == "" || $0 !~ ENVIRON["SP"]) { print "警告" t $0 t "-" t "除いたフォルダの PHP" }' || return 1
      find . -path "./$BAD" -prune -o -type d -perm -o+w -printf "至急$T%P/$T-${T}全ユーザーが書けるフォルダ\n"
    }
    
    if [ ! -s "$BASE" ]; then
      [ "${1:-}" = --accept ] || { echo "sitewatch: $BASE が無い。先に --accept で作る" >&2; exit 1; }
      scan /dev/null > "$TMP/cur" && mv "$TMP/cur" "$BASE" || exit 1
      echo "ベースラインを作った: $(wc -l < "$BASE") ファイル"
      exit 0
    fi
    scan "$BASE" > "$TMP/cur" || { echo "sitewatch: 一覧を作れない" >&2; exit 1; }
    
    # ベースラインと今を突き合わせ、変わったものを「段階 パス ハッシュ 理由」で書き出す
    LC_ALL=C join -t "$T" -a1 -a2 -e - -o 0,1.2,1.3,1.4,1.5,1.6,1.7,2.2,2.3,2.4,2.5,2.6,2.7 "$BASE" "$TMP/cur" |
    while IFS=$T read -r p om ou os omt oct oh m u s mt ct h; do
      [ "$om $ou $oh" = "$m $u $h" ] && continue
      if [ "$h" = - ]; then
        lv=警告 why=削除
      elif is_planned "$p" "$h"; then
        echo "予定どおり$T$p$T$h${T}マニフェストと一致"; continue
      else
        lv=警告
        if [ "$oh" = - ]; then why=追加
        elif [ "$oh" = "$h" ]; then why="権限か持ち主の変更 $om/$ou→$m/$u"
        elif [ "$omt $os" = "$mt $s" ]; then lv=至急 why="日時の偽装(mtime はベースラインのまま)"
        else why=内容の変更
        fi
        (( 8#$m & 2 )) && lv=至急 why+="・全ユーザーが書ける"
        [[ $p =~ $RE_UP && ${p,,} =~ $RE_PHP ]] && lv=至急 why+="・アップロード先の PHP"
        if [ "$oh" != "$h" ] && grep -qE -f "$PAT" "$SITE/$p" 2>/dev/null &&
           ! grep -qxF "$p$T$h" "$STATE/allow.tsv" 2>/dev/null; then
          lv=至急 why+="・ウェブシェルに似たコード"
        fi
      fi
      [[ $p =~ $RE_CONF ]] && lv=至急 why+="・サーバーの設定ファイル"
      echo "$lv$T$p$T$h$T$why"
    done > "$TMP/found" || { echo "sitewatch: 突き合わせに失敗した" >&2; exit 1; }
    (odd) >> "$TMP/found" || { echo "sitewatch: 名前とリンクを調べられない" >&2; exit 1; }
    
    touch "$STATE/sent.txt"
    if [ "${1:-}" = --accept ]; then
      # 取り込む変化を先に見せる。消すのはファイル用の3列のキーだけ
      cut -f2,4 "$TMP/found" | tr '\t' ' '
      awk -F'\t' 'NF != 3' "$STATE/sent.txt" > "$TMP/sent" &&
        mv "$TMP/cur" "$BASE" && mv "$TMP/sent" "$STATE/sent.txt" || exit 1
      echo "ベースラインを更新した: $(wc -l < "$BASE") ファイル"
      exit 0
    fi
    
    # 今回の変化に無いファイルのキーを落とす。直ったあとに再び置かれれば、また知らせる
    awk -F'\t' 'FILENAME == ARGV[1] { k[$1 FS $2 FS $3]; next } NF != 3 || ($0 in k)' \
      "$TMP/found" "$STATE/sent.txt" > "$TMP/sent" && mv "$TMP/sent" "$STATE/sent.txt" || exit 1
    
    # 段階ごとに、まだ送っていないものだけを1通にまとめて送る
    for lv in 至急 警告; do
      awk -F'\t' -v lv="$lv" 'FILENAME == ARGV[1] { seen[$0]; next }
        $1 == lv && !(($1 FS $2 FS $3) in seen)' "$STATE/sent.txt" "$TMP/found" > "$TMP/new"
      n=$(wc -l < "$TMP/new")
      [ "$n" -gt 0 ] || continue
      body="$(cut -f2,4 "$TMP/new" | tr '\t' ' ')
    確かめてから sitewatch.sh --accept でベースラインを更新する。"
      [ "$lv" = 至急 ] && what=改ざんの疑い || what=知らない変更
      notify "$lv" "【$lv】$SITE で${what} ${n}件" "$body" || exit 1
      cut -f1-3 "$TMP/new" >> "$STATE/sent.txt"
    done
    
    files=$(wc -l < "$TMP/cur")
    changed=$(wc -l < "$TMP/found")
    warn=$(grep -c "^警告$T" "$TMP/found")
    urgent=$(grep -c "^至急$T" "$TMP/found")
    echo "$(date -Iseconds) files=$files changed=$changed warn=$warn urgent=$urgent" >> "$STATE/runs.log"

    書き方の要点は次のとおりである。知らない変更はベースラインに自動で取り込まず、人が確かめてから --accept で取り込む。

    • export LANG=C.UTF-8:LANG の無い cron の環境でも、日本語の件名を UTF-8 で扱わせる。

    • set -u と pipefail:未定義の変数とパイプの途中の失敗を誤りにする。: "${SITE:=…}" は、環境変数で渡されなければ既定の値を入れる。

    • PATH:呼んだ側の PATH を先に探し、足りない場所をあとに足す。PATH が空のときは先頭に「:」を付けない。空の要素は今いるフォルダを意味し、そこに置かれたコマンドを root が動かしてしまうからである。

    • flock -n:前の回がロックを持っていれば終了ステータス 1 で終わる(flock(1))。一時ファイルは監視の記録の場所の中に作るので、mv は同じファイルシステムの中の置き換えになる。

    • SKIP:アプリが動いている間に書き換えるフォルダ(ログ・セッション・キャッシュ)である。ここのファイルは毎回ハッシュが変わり、5分ごとに警告になるので、一覧から除く。除いたフォルダに置かれた PHP だけは、odd が「除いたフォルダの PHP」の警告として別に見る。SKIP_PHP は、除いたフォルダのうち PHP ができて当然の場所(コンパイル済みのテンプレート)である。例は Laravel の形なので、自分のサイトの名前に替える。

    • scan:SKIP に当たるパスを除き、属性がベースラインと同じファイルのハッシュを使い回す。find のあとで消えたファイルは飛ばす。

    • odd:名前に制御文字やバックスラッシュを含むもの、リンクと特殊なファイル(FIFO、名前つきパイプなど)、除いたフォルダの PHP、全ユーザーが書けるフォルダを並べる。どれもベースラインに載らないので、消すまで毎回見つかる。links.tsv に書いた正規のリンクだけは飛ばす。

    • join -a1 -a2 -e -:片方にしか無いパスも出し、無い側の列を - で埋める。ハッシュが - なら削除か追加である。

    • (( 8#$m & 2 )):権限を8進数として読み、その他のユーザーの書き込みのビット(2)を見る。${p,,} はパスを小文字にして .PHTML も拾う。

    • RE_UP:uploads と images は、利用者がファイルを置けるフォルダの例である。自分のサイトの名前に替える。

    • is_planned:「この変更は自分のデプロイか」を答える。この章では常に「違う」を返す。

    • notify 段階 件名 本文:メールを送り、alerts.log に1行を残す。

    • sent.txt:送った知らせのキー(段階・パス・ハッシュの3列)を残し、同じ状態が続く間は二度送らない。毎回、今回の変化に無いキーは落とすので、消したウェブシェルを置き直されると、また知らせる。送るのに失敗したときはキーを残さず、次の回にもう一度送る。

    • FILENAME == ARGV[1]:NR == FNR は、1つ目のファイルが空だと2つ目でも真になるので使わない。

    • --accept:取り込む変化を一覧で見せてから、今の状態をベースラインにする。消すのは3列のキーだけで、第4章の見張りのキーは残す。

    手順:置いて、最初のベースラインを作る

    置く

    サーバーで root として、保存したフォルダで流す。どちらも成功すれば何も出さない。

    install -m 700 sitewatch.sh /usr/local/bin/sitewatch.sh
    install -d -m 700 /var/lib/sitewatch

    ウェブシェルのパターンを書く

    同じくサーバーの root で流す。受け取った文字列を実行する書き方を、拡張正規表現(ERE)で1行に1つ書く。スクリプトは grep -f でこのファイルを読む。

    cat > /var/lib/sitewatch/patterns.txt <<'EOF'
    eval[[:space:]]*\([[:space:]]*base64_decode
    assert[[:space:]]*\([[:space:]]*\$_(POST|GET|REQUEST|COOKIE)
    preg_replace[[:space:]]*\([[:space:]]*['"]/[^/]*/[a-zA-Z]*e[a-zA-Z]*['"]
    \$_(REQUEST|POST|GET|COOKIE)\[[^]]*\][[:space:]]*\(
    EOF
    chmod 600 /var/lib/sitewatch/patterns.txt

    chmod 600 は、第3章で監視の記録の場所を deploy のユーザーに開けたあとも、どのパターンを避ければよいかを読ませないためである。4行目の $_REQUEST[...](...) は、送られてきた関数名をそのまま呼ぶ書き方である。preg_replace の /e 修飾子は、置き換え後の文字列を PHP のコードとして実行する古い機能である。PHP 8.3 では警告(E_WARNING)が出て NULL が返り、何も実行されない(preg_replace)。古い PHP を狙う攻撃道具の印として残している。

    難読化した商用のライブラリは、このパターンに当たることがある。確かめたファイルは「パス・タブ・SHA-256」の1行で allow.tsv に書く。手で打つとタブが空白になるので、printf '%s\t%s\n' vendor/x/obf.php "$(sha256sum < /var/www/example/vendor/x/obf.php | cut -c1-64)" >> /var/lib/sitewatch/allow.tsv; chmod 600 /var/lib/sitewatch/allow.tsv のように作る。ハッシュまで合うときだけ見逃すので、そのファイルが書き換えられれば、また至急になる。

    正規のリンクを書く

    Laravel の public/storage のような正規のリンクは、そのままでは毎回「リンクか特殊なファイル」の至急になる。確かめたリンクは「パス・タブ・リンクの先」の1行で links.tsv に書く。サーバーの root で流し、パスは自分のリンクに替える。

    printf '%s\t%s\n' public/storage "$(readlink /var/www/example/public/storage)" >> /var/lib/sitewatch/links.tsv
    chmod 600 /var/lib/sitewatch/links.tsv

    リンクの先まで合うときだけ飛ばすので、別の場所へ向け直されれば、また至急になる。

    今のサイトを点検する

    最初のベースラインの前に、至急の条件にあたるものが今のサイトに無いことを確かめる。すでにウェブシェルが置かれていれば、それも正しい状態として記録されるからである。サーバーの root で流し、4つのコマンドがどれも何も出さなければよい。

    SITE=/var/www/example
    STATE=/var/lib/sitewatch
    grep -rlE -f "$STATE/patterns.txt" "$SITE"
    grep -rniE --include=.htaccess --include=.user.ini 'auto_(prepend|append)_file|(Add|Set)Handler|AddType|ForceType' "$SITE"
    find "$SITE" -name '*[[:cntrl:]\\]*' -o ! -type f ! -type d -o -perm -o+w
    find "$SITE/public/uploads" "$SITE/public/images" -type f | grep -iE '\.(php[0-9]?|phtml|phar)(\.|$)'

    grep -r はフォルダの下をたどり、-l は当たったファイルの名前だけを出す。拡張子を問わずに探すのは、.txt でも .htaccess で PHP として動かされうるからである。何か出たら、中身を確かめて取り除いてから進む。

    ベースラインを作る

    /usr/local/bin/sitewatch.sh --accept
    ベースラインを作った: 6 ファイル

    手順:cron で回す

    cron は、決めた時刻にコマンドを動かす常駐の仕組みで、時刻とコマンドは crontab に書く。cron は、コマンドが何かを出力すると、その内容を MAILTO の宛先へメールで送る(crontab(5))。スクリプトは無事なときに黙り、エラーは標準エラー出力(stderr)へ書くので、失敗は cron のメールで届く。

    root の crontab に書く

    スクリプトは root だけが書ける監視の記録の場所に書くので、root の crontab に書く。サーバーで sudo crontab -e で開き、次の2行を足す。

    MAILTO=admin@example.com
    */5 * * * * /usr/local/bin/sitewatch.sh

    確かめる:改ざんと日時の偽装

    初めの2つは本番の場所で流す。サイトのフォルダは変えず、監視の記録の場所には5分ごとの回と同じ記録が残る。残りは写しで試す。

    メールが届くことを確かめる

    cron のメールも mail コマンドも、MTA が動いていて初めて届く。サーバーから1通送り、届くことと件名が化けないことを確かめる。届かなければ MTA の設定から直す。この手順は試していない。

    echo テスト | mail -s '【警告】sitewatch のテスト' admin@example.com

    cron と同じ環境で動かす

    cron の環境は対話のシェルとは違う。PATH は短く、SHELL は /bin/sh で、LANG も無い。サーバーの root で env -i を使い、同じ最小の環境で動かす。何も出ず、終了ステータスは 0 だった。

    env -i HOME=/root PATH=/usr/bin:/bin SHELL=/bin/sh /usr/local/bin/sitewatch.sh; echo "exit=$?"
    exit=0

    mail コマンドが無いと、変化がある回に「mail: command not found」と「sitewatch: メールを送れない」が stderr に出て、終了ステータスは 1 になる。

    写しを作る

    ここからはサーバーで root として、写しで試す。本番のサイトのフォルダでは試さず、cp -a で作る写し /tmp/example-test と試しの記録の場所 /tmp/sitewatch-test を使う。以下のブロックは同じシェルで続けて流す。最初のブロックの3行目は、2つのフォルダがまだ無いことを確かめ、試しの記録の場所を自分だけが入れる 700 で作る。ほかのユーザーが先に作ったフォルダを使うと、そこに置かれたコマンドが root で動きうるからである。この行が何か出したら、先へ進まない。

    SITE=/tmp/example-test STATE=/tmp/sitewatch-test
    export SITE STATE
    [ ! -e "$SITE" ] && mkdir -m 700 "$STATE" || echo "$SITE か $STATE がすでにある。中身を確かめて消してから流す"
    cp -a /var/www/example "$SITE"

    以下で使う見本のファイルを写しの中に作る。すでにあれば上書きしない。以下の出力は、この6つのファイルと空の public/uploads だけを持つ写しのものである。自分のサイトでは件数や行が増える。

    mkdir -p "$SITE/lib" "$SITE/vendor" "$SITE/public/uploads" "$SITE/public/images" "$SITE/public/assets"
    [ -e "$SITE/lib/app.php" ] || printf '<?php\nfunction greet() { return "Welcome to the example site!"; }\n' > "$SITE/lib/app.php"
    [ -e "$SITE/public/index.php" ] || printf '<?php require __DIR__ . "/../lib/app.php";\n' > "$SITE/public/index.php"
    [ -e "$SITE/public/.htaccess" ] || printf 'Options -Indexes\n' > "$SITE/public/.htaccess"
    [ -e "$SITE/public/assets/app.min.js" ] || printf 'console.log("app");\n' > "$SITE/public/assets/app.min.js"
    [ -e "$SITE/public/images/logo.png" ] || printf 'PNGDATA' > "$SITE/public/images/logo.png"
    [ -e "$SITE/vendor/autoload.php" ] || printf '<?php // vendor\n' > "$SITE/vendor/autoload.php"

    無事なとき

    mail の代わりに、引数と本文を画面に出す代役を作って PATH の先頭に置く。--- mail の行が引数(件名と宛先)、続く行が本文である。スクリプトは呼んだ側の PATH を先に探すので、代役が使われる。

    mkdir -p "$STATE/stub"
    printf '#!/bin/sh\necho "--- mail $*"; cat\n' > "$STATE/stub/mail"; chmod +x "$STATE/stub/mail"
    PATH="$STATE/stub:$PATH"
    cp /var/lib/sitewatch/patterns.txt "$STATE/"
    sitewatch.sh --accept
    sitewatch.sh; echo "exit=$?"
    ベースラインを作った: 6 ファイル
    exit=0

    改ざんされたとき

    アップロード先にウェブシェルを置き、lib/app.php に1行足し、.htaccess に AddHandler を足し、画像を 666 にし、JavaScript を書き換え、名前にタブを含むファイルとリンクを置く。置く PHP は test と表示するだけの無害なものである。

    P=$SITE/public
    printf '<?php eval(base64_decode("ZWNobyAidGVzdCI7"));\n' > "$P/uploads/a.jpg.php"
    printf 'eval(base64_decode("ZWNobyAidGVzdCI7"));\n' >> "$SITE/lib/app.php"
    printf 'AddHandler application/x-httpd-php .jpg\n' >> "$P/.htaccess"
    chmod 666 "$P/images/logo.png"
    echo 'track();' >> "$P/assets/app.min.js"
    printf 'x\n' > "$P/uploads/x$(printf '\t').php"
    ln -s ../../lib/app.php "$P/uploads/l.php"
    sitewatch.sh
    --- mail -s 【至急】/tmp/example-test で改ざんの疑い 6件 admin@example.com
    lib/app.php 内容の変更・ウェブシェルに似たコード
    public/.htaccess 内容の変更・サーバーの設定ファイル
    public/images/logo.png 権限か持ち主の変更 644/0→666/0・全ユーザーが書ける
    public/uploads/a.jpg.php 追加・アップロード先の PHP・ウェブシェルに似たコード
    public/uploads/x?.php 監視で扱えない名前
    public/uploads/l.php リンクか特殊なファイル
    確かめてから sitewatch.sh --accept でベースラインを更新する。
    --- mail -s 【警告】/tmp/example-test で知らない変更 1件 admin@example.com
    public/assets/app.min.js 内容の変更
    確かめてから sitewatch.sh --accept でベースラインを更新する。

    至急と警告が1通ずつ届いた。名前のタブは ? に替えて知らせる。644/0→666/0 は「権限/持ち主の uid」の前と後で、写しは root の持ち物なので uid は 0 である。

    もう一度動かしたとき

    sitewatch.sh
    tail -2 "$STATE/runs.log"
    2026-10-30T11:45:51+09:00 files=7 changed=7 warn=1 urgent=6
    2026-10-30T11:45:51+09:00 files=7 changed=7 warn=1 urgent=6

    メールは出ない。1行目は知らせを送った回、2行目はもう一度動かした回である。ベースラインを更新するまでは同じ変化を毎回数えるので changed は減らないが、メールは送らない。

    消して置き直したとき

    rm "$P/uploads/a.jpg.php"
    sitewatch.sh
    printf '<?php eval(base64_decode("ZWNobyAidGVzdCI7"));\n' > "$P/uploads/a.jpg.php"
    sitewatch.sh
    --- mail -s 【至急】/tmp/example-test で改ざんの疑い 1件 admin@example.com
    public/uploads/a.jpg.php 追加・アップロード先の PHP・ウェブシェルに似たコード
    確かめてから sitewatch.sh --accept でベースラインを更新する。

    消した回は黙り、そのキーは落ちた。同じウェブシェルを置き直すと、また至急が届いた。

    日時を偽装したとき

    index.php の先頭の <?php を同じ長さの <?PHP に替え、touch -r で mtime を元の値に戻す。

    cp -p "$P/index.php" "$STATE/ref"
    sed -i '1s/<?php/<?PHP/' "$P/index.php"
    touch -r "$STATE/ref" "$P/index.php"
    stat --printf 'Size: %s\nModify: %y\nChange: %z\n' "$P/index.php"
    sitewatch.sh
    Size: 43
    Modify: 2026-10-30 10:45:11.811371478 +0900
    Change: 2026-10-30 11:45:51.564204448 +0900
    --- mail -s 【至急】/tmp/example-test で改ざんの疑い 1件 admin@example.com
    public/index.php 日時の偽装(mtime はベースラインのまま)
    確かめてから sitewatch.sh --accept でベースラインを更新する。

    大きさと Modify(mtime)はベースラインのときのままで、Change(ctime)だけが新しい。

    2つ同時に動いたとき

    ロックを3秒持つ別のプロセスを裏で動かし、その間に動かす。括弧のサブシェルの中で裏に回すので、対話のシェルでもジョブの行([1] 番号 など)は出ない。

    (flock "$STATE/lock" sleep 3 &)
    sleep 1
    sitewatch.sh; echo "exit=$?"
    sleep 3
    sitewatch: 前の回がまだ動いている
    exit=1

    確かめて取り込む

    sitewatch.sh --accept
    lib/app.php 内容の変更・ウェブシェルに似たコード
    public/.htaccess 内容の変更・サーバーの設定ファイル
    public/assets/app.min.js 内容の変更
    public/images/logo.png 権限か持ち主の変更 644/0→666/0・全ユーザーが書ける
    public/index.php 日時の偽装(mtime はベースラインのまま)
    public/uploads/a.jpg.php 追加・アップロード先の PHP・ウェブシェルに似たコード
    public/uploads/x?.php 監視で扱えない名前
    public/uploads/l.php リンクか特殊なファイル
    ベースラインを更新した: 7 ファイル

    取り込む前に変化がすべて出た。本番では、この一覧を知らせのメールと見比べてから取り込む。名前にタブを含むファイルとリンクはベースラインに入らないので、消すまで至急のまま残る。

    写しを片づける

    試しが終わったら写しを消す。写しにはサイトの設定ファイルと無害なウェブシェルの見本が入っているからである。消すのはこの節で作った2つの試しのフォルダだけである。次の章の確かめるも、まだ無い状態から始める。

    rm -rf /tmp/example-test /tmp/sitewatch-test

    踏み込み:規模と精度

    ハッシュの取り直しを分ける

    sitewatch.sh は毎回すべてのファイルの属性を読むが、ハッシュを取り直すのは大きさ・mtime・ctime が変わったファイルだけである。属性の読み取りは軽く、ハッシュは中身をすべて読むので重い。ただし root を取られると ctime も偽れる(第5章の踏み込み)。その備えとして、ベースラインの行を N 個の組に分け、毎回1つの組だけは属性が同じでもハッシュを取り直す「カーソル」を足せる。5分ごとで N=288 なら、1日で全ファイルを1回は読み直す。

    時間の上限

    timeout で上限を決めると、詰まったときに止まる。時間切れの終了ステータスは 124 である(timeout(1))。cron は終了ステータスだけではメールを出さないので、失敗を文字にして stderr へ出す。crontab では % が改行の意味になるので、コマンドに % を書くときは \% とする。次の行には % が無い。crontab の */5 の行を、次の行に置き換える。両方を残すと、5分ごとに2つの回がロックを取り合い、片方が毎回「前の回がまだ動いている」を cron のメールで送る。

    */5 * * * * timeout 240 /usr/local/bin/sitewatch.sh || echo "sitewatch: 終了ステータス $?" >&2

    timeout 1 sleep 5 || echo "sitewatch: 終了ステータス $?" >&2 で試すと、sitewatch: 終了ステータス 124 が出た。

    精度と見張る範囲

    mtime と ctime はナノ秒まで記録するので、同じ秒の中の書き換えも ctime の差として出る。デプロイを「版ごとのフォルダと、そこを指すリンク」で切り替えるサイトでは、リンクが毎回至急になる。SITE をリンクの先の実体のフォルダにする。監視の記録の場所を誰の持ち物にするかは、第5章の踏み込みで扱う。

    常駐型と専用の道具

    inotify を使うと、書き込みの瞬間に気づける。ただし常に動き続けるプロセスが要る。サーバーを root で管理できるなら、AIDE、Tripwire、auditd のような専用の道具もある。

    第3章 デプロイを署名で見分ける

    配るファイルのハッシュの一覧に署名し、一覧と一致する変化だけを予定どおりとしてベースラインに取り込む。第2章の sitewatch.sh は自分のデプロイ(deploy、組み立てたファイルをサーバーへ配ること)も警告にするので、読む側が慣れて本物の知らせを見落とす。これを警告疲れ(alert fatigue)と呼ぶ。一覧に無い変化は第2章と同じく警告か至急のまま残る。

    デプロイ用の機械で一覧に署名し、サーバーが公開鍵で確かめて予定どおりと警告を分ける流れ
    デプロイ用の機械で一覧に署名し、サーバーが公開鍵で確かめて予定どおりと警告を分ける流れ

    しくみ:なぜ署名が要るか

    マニフェスト(manifest)は、デプロイするファイルのパスと SHA-256 の一覧である。署名の無い一覧には、サーバーに入った攻撃者が自分のウェブシェルの行を足せる。そこで秘密鍵(private key)で署名(signature)を作り、サーバーは対の公開鍵(public key)で確かめる。公開鍵から署名は作れない。秘密鍵はデプロイ用の機械(ファイルを組み立ててサーバーへ送る側の機械。開発用の PC や CI のサーバー)から出さない。するとサーバーを乗っ取られても、通る一覧は作れない。

    方式は Ed25519 で、OpenSSL の pkeyutl -rawin を使う。OpenSSL 1.1.1 の pkeyutl は Ed25519 を扱えず、-rawin は 3.0 から使える(openssl-pkeyutl)。両方の機械で openssl version が 3.0 以上かを先に確かめる。

    手順:鍵を作る

    この節のコマンドはデプロイ用の機械で流し、サーバーでは流さない。サーバーにある秘密鍵は、乗っ取った攻撃者にも使えるからである。umask 077 の中で作るので、秘密鍵 deploy.key は作られた瞬間から 600(持ち主だけが読める)になる。

    mkdir -p ~/.sitewatch
    chmod 700 ~/.sitewatch
    (umask 077; openssl genpkey -algorithm ed25519 -out ~/.sitewatch/deploy.key)
    openssl pkey -in ~/.sitewatch/deploy.key -pubout -out ~/.sitewatch/deploy.pub

    サーバーへは公開鍵 deploy.pub だけを送り、root だけが書ける /etc/sitewatch/deploy.pub に置く。差し替えられると攻撃者の鍵の署名が通るからである。SERVER は SSH で入るユーザーとサーバーの名前である。次の3行は実際のサーバーが要るので試していない。

    SERVER=deploy@www.example.com
    scp ~/.sitewatch/deploy.pub "$SERVER":
    ssh -t "$SERVER" 'sudo install -D -m 644 -o root -g root deploy.pub /etc/sitewatch/deploy.pub'

    手順:マニフェストを作って署名する

    一覧を作って署名する

    デプロイ用の機械で流す。BUILD は組み立てたファイルのフォルダで、サイトのフォルダと同じ形にし、アップロード先は含めない。%P は先頭の ./ を外したパスで、第2章のベースラインと同じ形になる。1行目の作成時刻(エポック秒)は、サーバーが古い一覧を拒むのに使う。

    BUILD=~/deploy/build
    OUT=~/deploy
    KEY=~/.sitewatch/deploy.key
    (
      date '+# created=%s %FT%T%:z'
      cd "$BUILD" && find . -type f -printf '%P\0' | LC_ALL=C sort -z | xargs -0 -r sha256sum
    ) > "$OUT/manifest.txt"
    openssl pkeyutl -sign -inkey "$KEY" -rawin -in "$OUT/manifest.txt" -out "$OUT/manifest.sig"
    head -3 "$OUT/manifest.txt"
    wc -c < "$OUT/manifest.sig"
    # created=1793325292 2026-10-30T10:54:52+09:00
    8cd2d20b51c3416e996cd1cc626c26ff2997785565571a4fe0e5aeef0646dc06  lib/app.php
    74d7c0a057cc6a4e4b762757f8f69194a1249028bff3ede8ed80a66f06494d21  public/.htaccess
    64

    Ed25519 では -rawin が必須で -digest は付けられない。本文を丸ごと署名する方式なので、一覧は全体がメモリに載る。署名は常に64バイトである。

    受け口を作る

    ここだけサーバーで root として流す。deploy はデプロイに使う OS ユーザーとそのグループで、無ければ先に作る。deploy は /var/www/example に書けるユーザーにする(例 chown -R deploy:deploy /var/www/example)。ウェブサーバーのユーザーとは別にし、ウェブサーバーにはサイトのフォルダを書かせない。持ち主を替えると全ファイルが「権限か持ち主の変更」になるので、確かめてから sitewatch.sh --accept でベースラインを取り直す。第2章で 700 にした監視の記録の場所は、この章から 711 に替える。711 なら deploy は中を一覧できないが、incoming へは入れる。

    chmod 711 /var/lib/sitewatch
    install -d -m 770 -o root -g deploy /var/lib/sitewatch/incoming
    install -d -m 700 -o deploy -g deploy /var/www/.rsync-tmp

    3行目は rsync の一時ファイルの置き場である。rsync は既定で、送るファイルを同じフォルダの一時ファイル .名前.XXXXXX に書いてから名前を変える。.app.php.XXXXXX のような名前は一覧に無い PHP として至急になり、次の回には消えているので、誤った至急が届く。そこで一時ファイルはサイトのフォルダの外で、同じファイルシステムの中に作らせる。

    送る

    デプロイ用の機械で、「一覧を作って署名する」と同じシェルで続ける。一覧を先に送る。逆だと、一覧が届く前の回が変化を警告にする。rsync -a は -t を含み mtime を保つが、一覧との照合が日時の偽装の判定より先に当たるので偽装とはみなされない。--delete が無いので、サーバーのファイルは消さない。--temp-dir は一時ファイルを受け口のブロックで作ったフォルダに書かせる。

    SERVER=deploy@www.example.com
    scp "$OUT/manifest.txt" "$OUT/manifest.sig" "$SERVER":/var/lib/sitewatch/incoming/
    rsync -a --temp-dir=/var/www/.rsync-tmp --exclude=/public/uploads/ "$BUILD/" "$SERVER":/var/www/example/

    受け口と送るのブロックは、実際のサーバーが要るので試していない。確かめるの節では1台の中で同じことをする。

    手順:sitewatch.sh に組み込む

    第2章の sitewatch.sh に3か所を足す。サーバーの /usr/local/bin/sitewatch.sh を root で編集する。

    • notify 関数の閉じ括弧 } の後:一覧を取り込むブロックを足す。第2章の is_planned() { return 1; } とその上のコメント行は消す

    • elif is_planned "$p" "$h"; then の行:下の照合の1行に置き換える

    • (odd) >> "$TMP/found" で始まる行の後:予定どおりを取り込むブロックを足す

    一覧を取り込むブロック

    # 署名つきマニフェスト。届いた一覧は root の写しを確かめてから取り込む
    : "${PUB:=/etc/sitewatch/deploy.pub}"
    IN=$STATE/incoming MAN=$STATE/manifest
    verify() { openssl pkeyutl -verify -pubin -inkey "$PUB" -rawin -in "$1.txt" -sigfile "$1.sig" >/dev/null 2>&1; }
    created() { sed -n '1s/^# created=\([0-9][0-9]*\) .*/\1/p' "$1.txt"; }
    reject() {
      local d
      d=$(mkdir -p "$STATE/rejected" && mktemp -d "$STATE/rejected/$(date +%Y%m%dT%H%M%S)-XXXX") &&
        mv "$1.txt" "$1.sig" "$d"/ || return 1
      notify 至急 "【至急】$SITE でマニフェストを拒否した($2)" "$d に移した。自分のデプロイでなければ侵入を疑う。"
    }
    intake() {
      local f=$IN/manifest new old
      [ -e "$f.txt" ] && [ -e "$f.sig" ] || return 0
      if [ -L "$f.txt" ] || [ -L "$f.sig" ] || [ ! -f "$f.txt" ] || [ ! -f "$f.sig" ]; then
        reject "$f" 通常のファイルでない; return
      fi
      # 大きさに上限を置いて写す。切れた一覧は署名が合わない
      head -c 10M "$f.txt" > "$TMP/m.txt" && head -c 1K "$f.sig" > "$TMP/m.sig" || return 1
      if ! verify "$TMP/m"; then
        # 送っている途中かもしれないので、届いて1分は待つ
        [ -n "$(find "$IN" -maxdepth 1 -name 'manifest.*' -mmin -1)" ] || reject "$f" 署名が合わない
        return
      fi
      new=$(created "$TMP/m") old=$(cat "$STATE/manifest.last" 2>/dev/null)
      if [ -z "$new" ] || [ "$new" -le "${old:-0}" ]; then reject "$f" 前のものより新しくない; return; fi
      mv "$TMP/m.sig" "$MAN.sig" && mv "$TMP/m.txt" "$MAN.txt" && rm "$f.txt" "$f.sig" &&
        echo "$new" > "$STATE/manifest.last"
    }
    intake || exit 1
    if [ -e "$MAN.txt" ] && ! verify "$MAN"; then reject "$MAN" 取り込み済みのものが書き換えられた || exit 1; fi
    is_planned() { [ -e "$MAN.txt" ] && grep -qxF "$2  $1" "$MAN.txt"; }

    incoming の中身は deploy の持ち物で、確かめた直後に差し替えられうる。そこで root の写しを作り、確かめるのも取り込むのも写しにする。リンクや FIFO は拒む。調べた直後に /dev/zero へのリンクへ替えられても、head -c が 10MiB で切る。署名が合わなくても変更から1分(-mmin -1)は待ち、送る途中を至急と取り違えない。is_planned は「ハッシュ・空白2つ・パス」の行が一覧にあるかを見る。

    照合の1行

      elif [ "$oh" != "$h" ] && ! (( 8#$m & 2 )) && is_planned "$p" "$h"; then

    中身が変わり、全ユーザーが書ける権限でもないときだけ一覧と照らす。権限だけの変化や 666 のファイルは第2章の判定へ進む。

    予定どおりを取り込むブロック

    # 一覧を一度でも取り込んだら、一覧に無い PHP の追加は置き場所を問わず至急にする
    if [ -e "$MAN.txt" ] || [ -s "$STATE/manifest.last" ]; then
      RE=$RE_PHP awk -F'\t' -v OFS='\t' '$1 == "警告" && $4 ~ /^追加/ && tolower($2) ~ ENVIRON["RE"] {
        $1 = "至急"; $4 = $4 "・一覧に無い PHP" } 1' "$TMP/found" > "$TMP/f2" && mv "$TMP/f2" "$TMP/found" || exit 1
    fi
    # 予定どおりの変化はベースラインに取り込み、この回の分を1通で知らせる
    grep "^予定どおり$T" "$TMP/found" > "$TMP/plan"
    if [ -s "$TMP/plan" ] && [ "${1:-}" != --accept ]; then
      awk -F'\t' 'FILENAME == ARGV[1] { p[$2]; next } FILENAME == ARGV[2] { if ($1 in p) print; next }
        !($1 in p)' "$TMP/plan" "$TMP/cur" "$BASE" | LC_ALL=C sort -t "$T" -k1,1 > "$TMP/base" &&
        mv "$TMP/base" "$BASE" || { echo "sitewatch: ベースラインを更新できない" >&2; exit 1; }
      notify 予定どおり "【予定どおり】$SITE でデプロイを反映した $(wc -l < "$TMP/plan")件" "$(cut -f2 "$TMP/plan")" || exit 1
    fi

    デプロイの PHP はすべて一覧に載るので、一覧に無い .php の追加は場所を問わず至急にする。取り込み済みの一覧が書き換えられて拒否された後も、manifest.last が残っている限りこの規則は続く。--accept の回は全体を取り込むので、予定どおりのメールは送らない。awk は予定どおりのパスには今の行を、ほかにはベースラインの行を出す。件数は「この回に反映した件数」で、反映が2回にまたがれば2通になる。デプロイで消したファイルは「削除」の警告になるので、確かめて --accept で取り込む。

    確かめる:デプロイと偽の一覧

    届いた一覧の署名を確かめる

    サーバーの root で、最初のデプロイを sitewatch.sh が取り込んだあとに流す。取り込み済みの一覧を公開鍵で確かめ、次に1行足した写しを同じ署名で確かめる。合えば終了ステータスは 0、合わなければ 1 である。監視の記録の場所のファイルは読むだけで、写しは mktemp で作る。

    STATE=/var/lib/sitewatch
    PUB=/etc/sitewatch/deploy.pub
    openssl pkeyutl -verify -pubin -inkey "$PUB" -rawin -in "$STATE/manifest.txt" -sigfile "$STATE/manifest.sig"
    echo "exit=$?"
    M=$(mktemp)
    cp "$STATE/manifest.txt" "$M"
    echo "0000  lib/x.php" >> "$M"
    openssl pkeyutl -verify -pubin -inkey "$PUB" -rawin -in "$M" -sigfile "$STATE/manifest.sig"
    echo "exit=$?"
    rm -f "$M"
    Signature Verified Successfully
    exit=0
    Signature Verification Failure
    exit=1

    正しいデプロイ

    ここからはサーバーで root として、写しで試す。本番のサイトのフォルダでは試さず、cp -a で作る写し /tmp/example-test と試しの記録の場所 /tmp/sitewatch-test を使う。試しの鍵の組もその中に作り、終われば捨てる。メールは第2章と同じ代役で受ける。sitewatch.sh は前の節の追加を済ませたものである。3行目は第2章と同じく、2つのフォルダがまだ無いことを確かめる。何か出したら先へ進まない(第2章の写しが残っていれば、第2章の終わりの rm -rf で先に消す)。見本のファイルは第2章と同じ6つで、すでにあれば上書きしない。

    lib/app.php を書き換え public/assets/new.js を足した組み立てを作り、一覧、ファイルの順に送って2回動かす。以下のブロックは同じシェルで続けて流す。

    SITE=/tmp/example-test STATE=/tmp/sitewatch-test
    export SITE STATE PUB=$STATE/test.pub
    [ ! -e "$SITE" ] && mkdir -m 700 "$STATE" || echo "$SITE か $STATE がすでにある。中身を確かめて消してから流す"
    cp -a /var/www/example "$SITE"
    mkdir -p "$SITE/lib" "$SITE/vendor" "$SITE/public/uploads" "$SITE/public/images" "$SITE/public/assets"
    [ -e "$SITE/lib/app.php" ] || printf '<?php\nfunction greet() { return "Welcome to the example site!"; }\n' > "$SITE/lib/app.php"
    [ -e "$SITE/public/index.php" ] || printf '<?php require __DIR__ . "/../lib/app.php";\n' > "$SITE/public/index.php"
    [ -e "$SITE/public/.htaccess" ] || printf 'Options -Indexes\n' > "$SITE/public/.htaccess"
    [ -e "$SITE/public/assets/app.min.js" ] || printf 'console.log("app");\n' > "$SITE/public/assets/app.min.js"
    [ -e "$SITE/public/images/logo.png" ] || printf 'PNGDATA' > "$SITE/public/images/logo.png"
    [ -e "$SITE/vendor/autoload.php" ] || printf '<?php // vendor\n' > "$SITE/vendor/autoload.php"
    mkdir -p "$STATE/stub" "$STATE/incoming" "$STATE/build" "$STATE/rsync-tmp"
    printf '#!/bin/sh\necho "--- mail $*"; cat\n' > "$STATE/stub/mail"; chmod +x "$STATE/stub/mail"
    PATH="$STATE/stub:$PATH"
    cp /var/lib/sitewatch/patterns.txt "$STATE/"
    openssl genpkey -algorithm ed25519 -out "$STATE/test.key"
    openssl pkey -in "$STATE/test.key" -pubout -out "$PUB"
    sitewatch.sh --accept
    B=$STATE/build
    rsync -a --exclude=/public/uploads/ "$SITE/" "$B/"
    echo '// v2' >> "$B/lib/app.php"; echo 'x();' > "$B/public/assets/new.js"
    (
      date '+# created=%s %FT%T%:z'
      cd "$B" && find . -type f -printf '%P\0' | LC_ALL=C sort -z | xargs -0 -r sha256sum
    ) > "$STATE/incoming/manifest.txt"
    openssl pkeyutl -sign -inkey "$STATE/test.key" -rawin -in "$STATE/incoming/manifest.txt" -out "$STATE/incoming/manifest.sig"
    rsync -a --temp-dir="$STATE/rsync-tmp" --exclude=/public/uploads/ "$B/" "$SITE/"
    sitewatch.sh; sitewatch.sh; tail -2 "$STATE/runs.log"
    ベースラインを作った: 6 ファイル
    --- mail -s 【予定どおり】/tmp/example-test でデプロイを反映した 2件 admin@example.com
    lib/app.php
    public/assets/new.js
    2026-10-30T11:46:52+09:00 files=7 changed=2 warn=0 urgent=0
    2026-10-30T11:46:52+09:00 files=7 changed=0 warn=0 urgent=0

    届くのは1回目の1通だけで、2回目は取り込み済みなので changed=0 になる。

    書き換えられた一覧

    同じシェルで続ける。攻撃者の立場で lib/helper.php(test と表示するだけの無害な PHP)を置き、取り込み済みの一覧にその行を足して、元の署名と incoming へ置く。touch -d で一覧を2分前にして、1分の待ちを過ぎたことにする。

    printf '<?php echo "test";\n' > "$SITE/lib/helper.php"
    (cat "$STATE/manifest.txt"; cd "$SITE" && sha256sum lib/helper.php) > "$STATE/incoming/manifest.txt"
    cp "$STATE/manifest.sig" "$STATE/incoming/"
    sitewatch.sh
    touch -d '2 minutes ago' "$STATE"/incoming/manifest.*
    sitewatch.sh
    --- mail -s 【至急】/tmp/example-test で改ざんの疑い 1件 admin@example.com
    lib/helper.php 追加・一覧に無い PHP
    確かめてから sitewatch.sh --accept でベースラインを更新する。
    --- mail -s 【至急】/tmp/example-test でマニフェストを拒否した(署名が合わない) admin@example.com
    /tmp/sitewatch-test/rejected/20261030T114652-XyLu に移した。自分のデプロイでなければ侵入を疑う。

    1回目は、アップロード先でない lib/ の PHP でも一覧に無いので至急になる。2回目は一覧を拒む。同じ写しで、取り込み済みの一覧に1行足すと「取り込み済みのものが書き換えられた」、届いた一覧を /dev/zero へのリンクにすると「通常のファイルでない」の至急になった。666 にしたファイルを一覧に載せて送ると「内容の変更・全ユーザーが書ける」の至急になった。

    写しを片づける

    試しが終わったら、第2章と同じく写しを消す。消すのはこの節で作った2つの試しのフォルダだけで、試しの鍵の組もこの中にある。

    rm -rf /tmp/example-test /tmp/sitewatch-test

    踏み込み:巻き戻しと鍵の管理

    巻き戻しを拒む

    署名が正しくても古い一覧は危ない。攻撃者が前の一覧と署名を置き直してファイルを前の版(脆弱性を直す前のもの)に戻すと、変化が一覧と一致する。これを巻き戻し(rollback)と呼ぶ。そこで取り込んだ一覧の作成時刻を $STATE/manifest.last に残し、それより新しい一覧だけを受け取る。確かめるの節の写しで、取り込み済みの一覧と署名を incoming へ置き直すと「前のものより新しくない」の至急になった。作成時刻は秒単位なので、同じ秒に作った2つ目の一覧も拒まれる。続けて送るときは1秒以上あける。デプロイ用の機械の時計が戻ったときも、正しい一覧が拒まれる。

    鍵が漏れたとき、なくしたとき

    秘密鍵が漏れたら、新しい鍵の組を作って /etc/sitewatch/deploy.pub を差し替え、取り込み済みの $STATE/manifest.txt と manifest.sig を同時に $STATE/rejected へ移す。残すと次の回に「取り込み済みのものが書き換えられた」の至急になる。漏れてから差し替えるまでの予定どおりの知らせは見直す。秘密鍵をなくしただけなら、デプロイが警告になるだけで守りは弱くならない。

    OpenSSL 1.1.1 のサーバー

    OpenSSL 1.1.1 のサーバーでは、PHP の sodium 拡張の sodium_crypto_sign_verify_detached で同じ署名を確かめられる。生の公開鍵は、PEM の2行目を Base64 から戻した44バイトの後ろ32バイトである。次を sitewatch-verify.php として保存し、サーバーの root で install -m 700 sitewatch-verify.php /usr/local/bin/sitewatch-verify.php として置く。署名が合えば終了ステータス 0、合わないか読めなければ 1 で終わる。

    <?php
    // sitewatch-verify.php 公開鍵 一覧 署名:署名が合えば終了ステータス 0
    try {
        [, $pub, $txt, $sig] = $argv;
        $pem = file($pub, FILE_IGNORE_NEW_LINES);
        $pk = substr(base64_decode($pem[1], true), -32);
        exit(sodium_crypto_sign_verify_detached(file_get_contents($sig), file_get_contents($txt), $pk) ? 0 : 1);
    } catch (Throwable $e) {
        fwrite(STDERR, "sitewatch-verify: " . $e->getMessage() . "\n");
        exit(1);
    }

    sitewatch.sh の verify() の行は、次の1行に置き換える。

    verify() { php /usr/local/bin/sitewatch-verify.php "$PUB" "$1.txt" "$1.sig" >/dev/null 2>&1; }

    試しの一覧では、合う署名で 0、1行足した一覧と10バイトに切った署名で 1 が返った。

    第4章 ファイルの外を見張る

    ファイルを1つも書き換えない侵入がある。盗んだパスワードでのログイン、DB への直接の書き込み、証明書の期限切れ、DNS の乗っ取りである。第2章のハッシュの比較は、これらを捉えない。この章では、この4つを見張る関数を sitewatch.sh に足す。知らせは、同じ状態が続く間は一度だけ送る。

    sitewatch.sh から4つの見張りを呼び、同じ件名は一度だけ知らせる構成
    sitewatch.sh から4つの見張りを呼び、同じ件名は一度だけ知らせる構成

    しくみ:ファイルの外で起きる侵入を捉える

    4つの見張り(ログインは失敗と新しい IP の2行に分ける)は、それぞれの記録を前回の値や控えと比べ、しきい値を超えたら次の段階で知らせる。

    • ログイン失敗
      見るもの:同じ IP の失敗の数
      しきい値:15分で5回以上
      段階:警告

    • 新しい IP
      見るもの:90日間に成功のない IP の成功
      しきい値:1回
      段階:至急

    • 設定
      見るもの:settings のハッシュと記録の数
      しきい値:記録なしの変化
      段階:至急

    • 証明書
      見るもの:有効期限までの日数
      しきい値:30日、7日
      段階:警告、至急

    • DNS
      見るもの:A・AAAA、NS・MX の答え
      しきい値:控えとの差
      段階:警告、至急

    ログインと設定は DB の行を SQL で調べ、証明書と DNS は外から見える答えを取りに行く。どれもファイルのパスを持たないので、知らせのキーは第2章の「段階・パス・ハッシュ」ではなく「段階・件名」にする。

    手順:知らせを一度だけ送る

    notify_once は同じ段階と件名の知らせを一度だけ送り、キーを sent.txt に2列で残す。第2章の --accept と毎回の掃除が消すのは3列のキーだけなので、続いている状態を --accept のあとにもう一度知らせることはない。forget_old は、件名が今日でない日付で終わるキーを落とす。日付はログイン失敗の件名にだけ入れるので、同じ IP の総当たりは1日に1通になり、キーも溜まらない。

    # 同じ段階と件名の知らせは一度だけ送る。キーは「段階<TAB>件名」の2列
    notify_once() {
      grep -qxF "$1$T$2" "$STATE/sent.txt" 2>/dev/null && return 0
      notify "$1" "【$1】$2" "$3" && printf '%s\n' "$1$T$2" >> "$STATE/sent.txt"
    }
    
    # 件名が今日でない日付で終わるキーを落とす
    forget_old() {
      awk -F'\t' -v d="$(date +%F)" 'NF != 2 || $2 !~ / [0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]$/ ||
        substr($2, length($2) - 9) == d' "$STATE/sent.txt" > "$TMP/once" && mv "$TMP/once" "$STATE/sent.txt"
    }

    手順:ログインを記録して数える

    ログインの試みは、成功も失敗もすべて DB に残す。残せば、同じ IP からの失敗の連続(総当たり、brute force)と、見たことのない IP からの成功を SQL で拾える。後者は、盗まれたパスワードで入られた可能性を示す。

    記録の表を作る

    開発用の機械で表の定義を書き、DB の管理者が本番の DB に作る。

    CREATE TABLE login_log (
      id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
      created_at DATETIME NOT NULL,
      ip VARCHAR(45) NOT NULL,
      username VARCHAR(64) NOT NULL,
      kind VARCHAR(8) NOT NULL,
      ok TINYINT(1) NOT NULL,
      KEY (created_at),
      KEY (ip, created_at)
    );

    ip の 45 文字は、IPv4 を埋め込んだ IPv6 の最長の表記に合わせた。kind は、パスワードの入力なら password、2段階認証(two-factor authentication)のコードの入力なら otp である。パスワードが漏れたあとの総当たりはコードの入力で起きるので、コードの失敗も数える。

    ログインのたびに書く

    次の関数をアプリに置き、ログインの処理の中で結果が決まるたびに呼ぶ。値は第1章と同じくプレースホルダで渡す。

    // 呼び方: log_login($pdo, $_SERVER["REMOTE_ADDR"], $user, "password", $ok);
    function log_login(PDO $pdo, string $ip, string $user, string $kind, bool $ok): void
    {
        $st = $pdo->prepare("INSERT INTO login_log (created_at, ip, username, kind, ok) VALUES (NOW(), ?, ?, ?, ?)");
        $st->execute([$ip, $user, $kind, (int)$ok]);
    }

    サイトがリバースプロキシ(利用者の接続を受けて後ろのサーバーへ取り次ぐサーバー)や CDN(Content Delivery Network、各地のサーバーから内容を配る仕組み)の後ろにあるときは、REMOTE_ADDR はプロキシの IP になり、数え方が成り立たない。その場合は、接続元が自分のプロキシの IP であることを確かめたうえで、プロキシが付ける X-Forwarded-For の値を使う。

    手順:設定の直接の書き換えを見つける

    設定の表 settings が管理画面を通らずに書き換えられたら至急にする。DB に直接書けるのは、DB のパスワードを盗んだ者か、SQL インジェクションを見つけた者だからである。管理画面は保存のたびに setting_events へ1行書く。見張りは settings 全体のハッシュを前回と比べ、ハッシュが変わったのに setting_events が増えていなければ知らせる。

    表を作る

    CREATE TABLE settings (
      name VARCHAR(64) PRIMARY KEY,
      value TEXT NOT NULL
    );
    CREATE TABLE setting_events (
      id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
      created_at DATETIME NOT NULL,
      name VARCHAR(64) NOT NULL,
      admin VARCHAR(64) NOT NULL
    );

    管理画面の保存で記録も書く

    管理画面の保存の処理の中で、設定の変更と記録を1つのトランザクションで確定する。

    // 設定の変更と記録を一緒に確定する
    $pdo->beginTransaction();
    $pdo->prepare("UPDATE settings SET value = ? WHERE name = ?")->execute([$value, $name]);
    $pdo->prepare("INSERT INTO setting_events (created_at, name, admin) VALUES (NOW(), ?, ?)")->execute([$name, $admin]);
    $pdo->commit();

    見張りのスクリプトを書く

    DB の見張りは、サーバーの /usr/local/bin/sitewatch-db.php にまとめる。異常を「段階、件名、本文」のタブ区切りで1行ずつ出し、何も無ければ何も出さない。前の節のログインの見張りもここに入る。

    <?php
    // DB を見張る。異常があれば「段階<TAB>件名<TAB>本文」を 1 行ずつ出す
    $state = getenv("STATE") ?: "/var/lib/sitewatch";
    $out = [];
    try {
        // 件名の日付は sitewatch.sh が date +%F で作って渡す
        $today = getenv("TODAY") ?: throw new RuntimeException("TODAY が無い");
        $password = trim(file_get_contents("/etc/sitewatch/db.pass"));
        $pdo = new PDO("mysql:host=localhost;dbname=app;charset=utf8mb4", "sitewatch", $password, [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_EMULATE_PREPARES => false,
        ]);
        // 15 分で 5 回以上失敗した IP。2 段階認証のコードの失敗も数える
        $sql = "SELECT ip, COUNT(*) AS n FROM login_log
                WHERE ok = 0 AND created_at >= NOW() - INTERVAL 15 MINUTE
                GROUP BY ip HAVING n >= 5";
        foreach ($pdo->query($sql) as $r) {
            $out[] = ["警告", "ログイン失敗が続く {$r['ip']} $today", "15分で{$r['n']}回"];
        }
        // 直近 10 分の成功のうち、その前の 90 日に成功のない IP
        $sql = "SELECT DISTINCT s.ip, s.username FROM login_log s
                WHERE s.ok = 1 AND s.created_at >= NOW() - INTERVAL 10 MINUTE
                AND NOT EXISTS (SELECT 1 FROM login_log p
                    WHERE p.ip = s.ip AND p.ok = 1
                    AND p.created_at >= NOW() - INTERVAL 90 DAY
                    AND p.created_at < NOW() - INTERVAL 10 MINUTE)";
        foreach ($pdo->query($sql) as $r) {
            $out[] = ["至急", "見慣れない IP からのログイン {$r['ip']} {$r['username']}", "90日間に成功のない IP"];
        }
        // 設定と記録を同じ時点の中身で読む
        $pdo->beginTransaction();
        $ev = (int)$pdo->query("SELECT COALESCE(MAX(id), 0) FROM setting_events")->fetchColumn();
        $h = hash_init("sha256");
        foreach ($pdo->query("SELECT name, value FROM settings ORDER BY name") as $r) {
            hash_update($h, json_encode([$r["name"], $r["value"]], JSON_THROW_ON_ERROR) . "\n");
        }
        $pdo->commit();
        $sum = hash_final($h);
        $file = "$state/settings.sum";
        $alert = false;
        if (is_file($file)) {
            [$oldSum, $oldEv] = explode("\t", trim(file_get_contents($file)));
            if ($sum !== $oldSum && $ev === (int)$oldEv) {
                $out[] = ["至急", "管理画面を通らない設定の変更 " . substr($sum, 0, 12), "settings が変わったのに setting_events に記録がない"];
                $alert = true;
            }
        }
        // 知らせを出した回は書き換えない。送るのに失敗しても、次の回にまた行が出る
        if (!$alert && file_put_contents($file, "$sum\t$ev\n") === false) {
            throw new RuntimeException("$file を書けない");
        }
    } catch (Throwable $e) {
        fwrite(STDERR, "sitewatch-db: " . $e->getMessage() . "\n");
        exit(1);
    }
    // 入力された値も件名に入るので、制御文字を ? に替え、長さを切る
    foreach ($out as $o) {
        echo implode("\t", array_map(fn($s) => mb_substr(preg_replace('/[\x00-\x1f\x7f]/', '?', $s), 0, 200), $o)), "\n";
    }

    成功を見る窓を10分にしたのは、5分ごとの実行が1回遅れても取りこぼさないためである。重なって次の回にも出る行は notify_once が二度は送らない。2つの SELECT をトランザクションで囲むと、InnoDB(MySQL と MariaDB の既定の表の格納方式)の既定の分離レベル REPEATABLE READ(トランザクションの中では最初に読んだ時点の中身を読み続ける)では、両方が同じ時点の中身(スナップショット)を読む。囲まないと、間に管理画面の保存が確定した回に至急の誤報が出る。設定の至急を出した回は settings.sum を書き換えない。書き換えると、メールを送るのに失敗した回のあとで行が二度と出なくなるからである。行は確かめるまで毎回出るが、二度目からは notify_once が送らない。管理画面で正しく保存されれば setting_events が増え、そこで記録が更新される。確かめたあとは settings.sum を消すと、今の中身を新しい控えにする。PHP は php.ini の date.timezone が無ければ UTC で日付を出すので、件名の日付は forget_old と同じ date +%F で作り、環境変数 TODAY で渡す。JSON_THROW_ON_ERROR は不正な UTF-8 を例外にし、空の文字列として足されて別の中身と同じハッシュになるのを防ぐ。username は入力された値なので、タブや改行が入ると出力の行と sent.txt と件名が壊れる。そこで最後に制御文字を ? に替え、200文字で切る。

    DB のパスワードを置く

    cron から動く見張りは、ログインしたシェルの環境変数を持たない。そこで第1章の環境変数ではなく、root だけが読めるファイルから読む。サーバーで root として次の1行を流し、空のファイルにエディタでパスワードを1行書く。この手順は試していない。

    install -D -m 600 -o root -g root /dev/null /etc/sitewatch/db.pass

    -D は、/etc/sitewatch が無ければ先に作る。第3章を飛ばした場合でも、この1行で済む。

    見張りはアプリの DB ユーザーではなく、3つの表に SELECT だけを持つ見張り用のユーザー sitewatch で入る。GRANT は無いユーザーを作らない(MySQL 8 は作らず、MariaDB も既定の sql_mode の NO_AUTO_CREATE_USER ではパスワードの無い GRANT で作らない)ので、先に CREATE USER で作る。パスワードは db.pass に書いたものと同じにする。DB の管理者が次を流す(試していない)。ファイルを読まれても、表の書き換えには使えない。

    CREATE USER 'sitewatch'@'localhost' IDENTIFIED BY '(db.pass に書いたものと同じパスワード)';
    GRANT SELECT ON app.login_log TO 'sitewatch'@'localhost';
    GRANT SELECT ON app.settings TO 'sitewatch'@'localhost';
    GRANT SELECT ON app.setting_events TO 'sitewatch'@'localhost';

    sitewatch.sh から呼ぶ

    check_db() {
      local out lv subject body
      out=$(STATE=$STATE TODAY=$(date +%F) php -d display_errors=stderr /usr/local/bin/sitewatch-db.php) ||
        { echo "sitewatch: DB の見張りが失敗した" >&2; return 1; }
      [ -n "$out" ] || return 0
      while IFS=$T read -r lv subject body; do
        case $lv in
          警告|至急) notify_once "$lv" "$subject" "$body" ;;
          *) echo "sitewatch: DB の見張りの出力が読めない: ${lv:0:40}" >&2 ;;
        esac
      done <<< "$out"
    }

    PHP の CLI は既定で警告を標準出力に出すので、-d display_errors=stderr で stderr へ回す(display_errors)。回さないと Warning の行が知らせとして読まれる。送るのは段階が「警告」か「至急」の行だけで、ほかは stderr に出す。DB に接続できないときも、失敗が stderr から cron のメールで届く。

    手順:証明書の期限を見る

    サーバーが今出している証明書を取り出し、有効期限まで30日を切ったら警告、7日を切ったら至急にする。自動更新が止まっても、期限が切れるまで何も起きず、切れると訪問者全員がブラウザの警告画面を見るからである。DOMAIN は sitewatch.sh の先頭の変数である。

    check_cert() {
      local pem="$STATE/cert.pem" end days
      # 期限は日単位でしか変わらないので、取ってから24時間は取り直さない
      [ -n "$(find "$pem" -mmin -1440 2>/dev/null)" ] && return 0
      if ! timeout 20 openssl s_client -connect "$DOMAIN:443" -servername "$DOMAIN" </dev/null 2>/dev/null |
          openssl x509 -out "$pem.new" 2>/dev/null || ! mv "$pem.new" "$pem"; then
        echo "sitewatch: 証明書を取得できない: $DOMAIN" >&2
        return 1
      fi
      end=$(openssl x509 -in "$pem" -noout -enddate | cut -d= -f2)
      days=$(( ($(date -d "$end" +%s) - $(date +%s)) / 86400 ))
      if ! openssl x509 -in "$pem" -noout -checkend $((7 * 86400)) >/dev/null; then
        notify_once 至急 "証明書の残りが7日を切った $DOMAIN($end)" "残り ${days} 日"
      elif ! openssl x509 -in "$pem" -noout -checkend $((30 * 86400)) >/dev/null; then
        notify_once 警告 "証明書の残りが30日を切った $DOMAIN($end)" "残り ${days} 日"
      fi
    }

    -servername は SNI(Server Name Indication)で名前を伝え、1台で複数のドメインを出すサーバーに返す証明書を選ばせる。-checkend 秒 は、その秒数のうちに期限が来るなら 0 以外で終わる(openssl-x509)。件名に期限の日時を入れたので、更新された証明書の次の期限もまた知らせる。取り出しに失敗したときは cert.pem を書き換えず、次の回にまた取りに行く。

    手順:DNS の答えを控えと比べる

    A・AAAA・MX・NS の答えを決まった形に並べ、正しいと確かめた控え dns.expected と比べる。NS と MX の違いは至急、A と AAAA の違いは警告にする。NS を奪われると DNS の答えをすべて書き換えられ、MX を奪われるとメールが別の宛先へ届く。どちらもサーバーに触れずに起きる。A と AAAA は CDN やロードバランサの都合でも変わる。

    check_dns() {
      local now=$STATE/dns.now t r d lv=警告
      : > "$now" || return 1
      for t in $DNS_TYPES; do
        r=$(dig +noall +comments +answer +time=5 +tries=2 "$DOMAIN" "$t") || r=
        if ! grep -q 'status: NOERROR' <<< "$r"; then
          echo "sitewatch: DNS を引けない: $DOMAIN $t" >&2
          return 1
        fi
        # 答えの行の5列目から後を「種類 値」の形で書く
        awk -v t="$t" '!/^;/ && $4 == t { v = $5; for (i = 6; i <= NF; i++) v = v " " $i; print t, v }' <<< "$r" >> "$now"
      done
      LC_ALL=C sort -o "$now" "$now"
      if [ ! -f "$STATE/dns.expected" ]; then
        echo "sitewatch: $STATE/dns.expected が無い。dns.now を確かめてから写す" >&2
        return 1
      fi
      d=$(diff "$STATE/dns.expected" "$now") && return 0
      grep -qE '^[<>] (NS|MX) ' <<< "$d" && lv=至急
      notify_once "$lv" "DNS の答えが変わった $DOMAIN $(sha256sum < "$now" | cut -c1-8)" "$d"
    }

    +noall +comments +answer は、状態の行(status:)と答えの行だけを出す。+short は SERVFAIL でも終了ステータス 0 で空の答えを返すので、一時的な失敗を「答えが変わった」と取り違える。そこで状態が NOERROR でなければ「DNS を引けない」を stderr に出し、値は答えの行の5列目から後を使う。+time=5 は1回の問い合わせを5秒で打ち切り、+tries=2 は2回まで試す。LC_ALL=C で並べ、ロケールによる順序の差を防ぐ。件名に答えのハッシュを入れたので、同じ変化は一度だけ、別の変化はまた知らせる。A と AAAA が CDN の都合で日常的に変わるドメインでは、DNS_TYPES を MX NS にして NS と MX だけを比べる。

    手順:sitewatch.sh に組み込む

    サーバーの /usr/local/bin/sitewatch.sh を root で編集し、3か所に足す。前の節までのコードのうち、写すのは関数の塊だけである。

    • : "${MAILTO:=admin@example.com}" の次の行:: "${DOMAIN:=example.com}" と : "${DNS_TYPES:=A AAAA MX NS}" の2行

    • is_planned() { で始まる行の次:notify_once、forget_old、check_db、check_cert、check_dns の5つの関数

    • 最後の files= の行の前:forget_old; check_db; check_cert; check_dns の1行

    1つの見張りが失敗しても、ほかの見張りと runs.log の記録は続き、失敗は stderr から cron のメールで届く。--accept の回は送る処理の前で終わるので、見張りは動かない。最初の回は「dns.expected が無い」が出る。/var/lib/sitewatch/dns.now の NS・MX・IP アドレスが自分の設定どおりであることを確かめてから、cp /var/lib/sitewatch/dns.now /var/lib/sitewatch/dns.expected で控えにする。

    確かめる:ログイン・設定・証明書・DNS

    4つの見張りが表の段階で知らせ、同じ知らせを二度送らないことを確かめる。

    ログインと設定

    開発用の機械で試す。本番の DB では流さない。次の lab_check.php を第1章の PHP のファイルと同じフォルダに置く。1つの接続の中で lab_ の一時表(TEMPORARY TABLE、接続を閉じると消える表)を作って試しの行を入れ、sitewatch-db.php と同じ SELECT を4回流す。一時表はその接続の中でしか見えないので、別の接続で動く sitewatch-db.php は使わず、同じ処理を check() に写してある。違うのは表の名前だけである。2回目の前には管理画面と同じトランザクションで site_name を変え、3回目の前には admin_mail だけを記録なしで書き換える。

    <?php
    // lab_check.php:sitewatch-db.php と同じ SELECT を、lab_ の一時表に対して4回流す
    require_once __DIR__ . '/connect.php';
    $pdo = connect([PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false]);
    
    // 列は前の節の CREATE TABLE と同じ
    $pdo->exec("CREATE TEMPORARY TABLE lab_login_log (id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
        created_at DATETIME NOT NULL, ip VARCHAR(45) NOT NULL, username VARCHAR(64) NOT NULL,
        kind VARCHAR(8) NOT NULL, ok TINYINT(1) NOT NULL)");
    $pdo->exec("CREATE TEMPORARY TABLE lab_settings (name VARCHAR(64) PRIMARY KEY, value TEXT NOT NULL)");
    $pdo->exec("CREATE TEMPORARY TABLE lab_setting_events (id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
        created_at DATETIME NOT NULL, name VARCHAR(64) NOT NULL, admin VARCHAR(64) NOT NULL)");
    $pdo->exec("SET @t = NOW() - INTERVAL 2 MINUTE, @f = '203.0.113.5'");
    $pdo->exec(<<<'SQL'
    INSERT INTO lab_login_log (created_at, ip, username, kind, ok) VALUES
    (@t, @f, 'alice', 'password', 0), (@t, @f, 'alice', 'password', 0), (@t, @f, 'alice', 'password', 0),
    (@t, @f, 'alice', 'password', 0), (@t, @f, 'alice', 'otp', 0), (@t, @f, 'alice', 'otp', 0),
    (@t, '203.0.113.9', 'alice', 'password', 0), (@t, '203.0.113.9', 'alice', 'password', 0),
    (@t, '203.0.113.9', 'alice', 'password', 0), (@t, '203.0.113.9', 'alice', 'password', 0),
    (@t, '198.51.100.7', 'dave', 'password', 1), (NOW() - INTERVAL 30 DAY, '198.51.100.7', 'dave', 'password', 1),
    (@t, '192.0.2.44', 'bob', 'password', 1), (@t, '192.0.2.44', 'bob', 'otp', 1),
    (@t, '192.0.2.99', 'carol', 'password', 1), (NOW() - INTERVAL 100 DAY, '192.0.2.99', 'carol', 'password', 1),
    (@t, '192.0.2.66', 'eve\tadmin', 'password', 1)
    SQL);
    $pdo->exec("INSERT INTO lab_settings (name, value) VALUES ('site_name', 'Example'), ('admin_mail', 'admin@example.com')");
    
    // sitewatch-db.php の try の中と同じ処理。表の名前だけが違う
    function check(PDO $pdo, string $state, string $today): void
    {
        $out = [];
        $sql = "SELECT ip, COUNT(*) AS n FROM lab_login_log
                WHERE ok = 0 AND created_at >= NOW() - INTERVAL 15 MINUTE
                GROUP BY ip HAVING n >= 5";
        foreach ($pdo->query($sql) as $r) {
            $out[] = ["警告", "ログイン失敗が続く {$r['ip']} $today", "15分で{$r['n']}回"];
        }
        $sql = "SELECT DISTINCT s.ip, s.username FROM lab_login_log s
                WHERE s.ok = 1 AND s.created_at >= NOW() - INTERVAL 10 MINUTE
                AND NOT EXISTS (SELECT 1 FROM lab_login_log p
                    WHERE p.ip = s.ip AND p.ok = 1
                    AND p.created_at >= NOW() - INTERVAL 90 DAY
                    AND p.created_at < NOW() - INTERVAL 10 MINUTE)";
        foreach ($pdo->query($sql) as $r) {
            $out[] = ["至急", "見慣れない IP からのログイン {$r['ip']} {$r['username']}", "90日間に成功のない IP"];
        }
        $pdo->beginTransaction();
        $ev = (int)$pdo->query("SELECT COALESCE(MAX(id), 0) FROM lab_setting_events")->fetchColumn();
        $h = hash_init("sha256");
        foreach ($pdo->query("SELECT name, value FROM lab_settings ORDER BY name") as $r) {
            hash_update($h, json_encode([$r["name"], $r["value"]], JSON_THROW_ON_ERROR) . "\n");
        }
        $pdo->commit();
        $sum = hash_final($h);
        $file = "$state/settings.sum";
        $alert = false;
        if (is_file($file)) {
            [$oldSum, $oldEv] = explode("\t", trim(file_get_contents($file)));
            if ($sum !== $oldSum && $ev === (int)$oldEv) {
                $out[] = ["至急", "管理画面を通らない設定の変更 " . substr($sum, 0, 12), "settings が変わったのに setting_events に記録がない"];
                $alert = true;
            }
        }
        if (!$alert && file_put_contents($file, "$sum\t$ev\n") === false) {
            throw new RuntimeException("$file を書けない");
        }
        foreach ($out as $o) {
            echo implode("\t", array_map(fn($s) => mb_substr(preg_replace('/[\x00-\x1f\x7f]/', '?', $s), 0, 200), $o)), "\n";
        }
    }
    
    foreach ([1, 2, 3, 4] as $n) {
        if ($n === 2) {
            // 管理画面の保存と同じく、変更と記録を一緒に確定する
            $pdo->beginTransaction();
            $pdo->prepare("UPDATE lab_settings SET value = ? WHERE name = ?")->execute(["Example Site", "site_name"]);
            $pdo->prepare("INSERT INTO lab_setting_events (created_at, name, admin) VALUES (NOW(), ?, ?)")->execute(["site_name", "alice"]);
            $pdo->commit();
        }
        if ($n === 3) {
            // 記録を書かずに直接書き換える
            $pdo->exec("UPDATE lab_settings SET value = 'x@example.net' WHERE name = 'admin_mail'");
        }
        echo "== {$n}回目\n";
        check($pdo, getenv("STATE"), getenv("TODAY"));
    }

    開発用の機械で、第1章の APP_DB_PASSWORD を設定したシェルのまま、PHP のファイルのフォルダで流す。2行目は、試しの記録の場所がまだ無いことを確かめて 700 で作る。何か出したら先へ進まない。settings.sum はその中に書き、最後に消す。

    STATE=/tmp/sitewatch-test
    mkdir -m 700 "$STATE" || echo "$STATE がすでにある。中身を確かめて消してから流す"
    STATE=$STATE TODAY=$(date +%F) php lab_check.php
    rm -rf /tmp/sitewatch-test
    • 203.0.113.5
      中身:2分前に失敗6回(うちコード2回)
      期待:警告

    • 203.0.113.9
      中身:2分前に失敗4回
      期待:出ない

    • 198.51.100.7
      中身:2分前と30日前に成功
      期待:出ない

    • 192.0.2.44
      中身:2分前にパスワードとコードで成功
      期待:至急が1行

    • 192.0.2.99
      中身:2分前と100日前に成功
      期待:至急

    • 192.0.2.66
      中身:2分前に成功。名前にタブ
      期待:至急。タブは ?

    出力は次のとおりで、列の区切りはタブである。

    == 1回目
    警告	ログイン失敗が続く 203.0.113.5 2026-10-30	15分で6回
    至急	見慣れない IP からのログイン 192.0.2.44 bob	90日間に成功のない IP
    至急	見慣れない IP からのログイン 192.0.2.99 carol	90日間に成功のない IP
    至急	見慣れない IP からのログイン 192.0.2.66 eve?admin	90日間に成功のない IP
    == 2回目
    警告	ログイン失敗が続く 203.0.113.5 2026-10-30	15分で6回
    至急	見慣れない IP からのログイン 192.0.2.44 bob	90日間に成功のない IP
    至急	見慣れない IP からのログイン 192.0.2.99 carol	90日間に成功のない IP
    至急	見慣れない IP からのログイン 192.0.2.66 eve?admin	90日間に成功のない IP
    == 3回目
    警告	ログイン失敗が続く 203.0.113.5 2026-10-30	15分で6回
    至急	見慣れない IP からのログイン 192.0.2.44 bob	90日間に成功のない IP
    至急	見慣れない IP からのログイン 192.0.2.99 carol	90日間に成功のない IP
    至急	見慣れない IP からのログイン 192.0.2.66 eve?admin	90日間に成功のない IP
    至急	管理画面を通らない設定の変更 09adcf4c38dc	settings が変わったのに setting_events に記録がない
    == 4回目
    警告	ログイン失敗が続く 203.0.113.5 2026-10-30	15分で6回
    至急	見慣れない IP からのログイン 192.0.2.44 bob	90日間に成功のない IP
    至急	見慣れない IP からのログイン 192.0.2.99 carol	90日間に成功のない IP
    至急	見慣れない IP からのログイン 192.0.2.66 eve?admin	90日間に成功のない IP
    至急	管理画面を通らない設定の変更 09adcf4c38dc	settings が変わったのに setting_events に記録がない

    ログインの4行は表の期待どおりである。192.0.2.44 は2行の成功が DISTINCT で1行になった。1回目は settings.sum を作るだけで、管理画面と同じ形で site_name を変えた2回目も、設定の行は出ない。admin_mail を直接書き換えた3回目に設定の至急が出た。知らせを出した回は settings.sum を書き換えないので、4回目も同じ行が出る。行が毎回出ても、notify_once が二度は送らない。

    証明書

    ここからはサーバーで root として流す。先に第2章の notify と、この章の notify_once、check_cert、check_dns を今の bash に貼り付け、以下のブロックを同じシェルで続けて流す。記録は試しの場所 /tmp/sitewatch-test に置き、メールは第2章と同じ代役で受ける。3行目は、試しの記録の場所がまだ無いことを確かめて 700 で作る。何か出したら先へ進まない。

    DOMAIN=example.com DNS_TYPES="A AAAA MX NS" MAILTO=admin@example.com T=$(printf '\t')
    STATE=/tmp/sitewatch-test
    mkdir -m 700 "$STATE" || echo "$STATE がすでにある。中身を確かめて消してから流す"
    mkdir -p "$STATE/stub"
    printf '#!/bin/sh\necho "--- mail $*"; cat\n' > "$STATE/stub/mail"; chmod +x "$STATE/stub/mail"
    PATH="$STATE/stub:$PATH"
    check_cert; echo "exit=$?"
    openssl x509 -in "$STATE/cert.pem" -noout -subject -enddate
    openssl x509 -in "$STATE/cert.pem" -noout -checkend $((30 * 86400))
    openssl x509 -in "$STATE/cert.pem" -noout -checkend $((90 * 86400))
    exit=0
    subject=CN = example.com
    notAfter=Dec 25 22:56:35 2026 GMT
    Certificate will not expire
    Certificate will expire

    check_cert は何も送らない。残りは約56日なので、30日の判定は「切れない」、90日の判定は「切れる」になる。

    DNS

    本物の dns.expected と sent.txt に触れないよう、mktemp -d で作る空の記録の場所で流す。最初の回は控えが無いので止まる。dns.now を確かめてから控えに写し(表示は NS の2行を省く)、控えの1行目を書き換えて変化を作った。

    STATE=$(mktemp -d)
    check_dns
    grep -v '^NS ' "$STATE/dns.now"
    cp "$STATE/dns.now" "$STATE/dns.expected"
    check_dns; echo "exit=$?"
    sed -i '1s/.*/A 192.0.2.1/' "$STATE/dns.expected"
    check_dns
    check_dns; echo "exit=$?"
    rm -r "$STATE"; STATE=/tmp/sitewatch-test
    sitewatch: /tmp/tmp.aYieMTxnBN/dns.expected が無い。dns.now を確かめてから写す
    A 104.20.23.154
    A 172.66.147.243
    AAAA 2606:4700:10::6814:179a
    AAAA 2606:4700:10::ac42:93f3
    MX 0 .
    exit=0
    --- mail -s 【警告】DNS の答えが変わった example.com ffb0ea4e admin@example.com
    1c1
    < A 192.0.2.1
    ---
    > A 104.20.23.154
    exit=0

    A の違いは警告になり、同じ件名の2回目は送らなかった。MX 0 . は、このドメインがメールを受けないという宣言(Null MX)である。

    写しを片づける

    試しが終わったら、試しの記録の場所を消す。消すのはこの節で作ったフォルダだけである。

    rm -rf /tmp/sitewatch-test

    踏み込み:見張りの精度

    リゾルバのキャッシュ

    dig は既定で /etc/resolv.conf のリゾルバに聞くので、変化に気づくのが TTL(キャッシュの有効期間)の分だけ遅れる。権威サーバー(authoritative server)に dig @NS の名前 +norecurse で聞けばキャッシュを通らない。一部のリゾルバだけが偽の答えを覚えた場合(キャッシュポイズニング)は、運営者の違う2〜3のリゾルバの答えを比べて拾う。

    NS の変化がいちばん早い兆し

    レジストラ(ドメインの登録業者)のアカウントを乗っ取った攻撃者は、まず NS を自分のネームサーバーへ向け、その先で A や MX を書く。NS の差を至急にしたのはこのためで、DNS_TYPES を絞っても NS は外さない。

    証明書を外から見る

    DNS を一時的に奪われて別の証明書を取られても、サーバーの証明書は変わらないので check_cert では気づけない。公開の認証局(CA)が出した証明書は Certificate Transparency(CT)のログに載るので、CT を検索できるサービスで知らない発行が無いかを見る。

    設定の見張りが拾えないもの

    DB に書ける侵入者は、setting_events にも1行足せばすり抜けられる。管理画面の保存と直接の書き込みが同じ5分の間に起きた場合も見分けられない。拾うのは、記録を気にしない直接の書き込みである。

    キーと IP アドレスを残す期間

    DNS・証明書・新しい IP のキーは日付を持たないので sent.txt に残る。増えるのは変化のときだけなので小さいが、ときどき終わった件の行を消す。IP アドレスはほかの記録と結びつくと人の特定につながるので、login_log は新しい IP の判定に使う90日より長い期間(例えば180日)を決めて古い行を消す。

    DB の見張りの出力が乱れたとき

    sitewatch-db.php が PHP の Warning を出しても、-d display_errors=stderr で stderr へ回るので、知らせの行とは混ざらない。段階が「警告」か「至急」でない行は送らず、「出力が読めない」を stderr に出す。付録の全体を試しの写しで動かし、DB の見張りを決まった行と Warning を出す代わりのスクリプトに替えて、この2つを確かめた。

    第5章 監視の停止に気づく

    ここまでの監視は、止まると何も言わない。この章では毎朝1通の無事のメールを送り、届かないことを異常の知らせにする。あわせてサーバーの外からも見る。監視が止まっても、サーバーごと止まっても気づける。

    サーバーの監視の記録から毎朝の無事のメールを作り、外の見張りと死活監視で止まりに気づく構成
    サーバーの監視の記録から毎朝の無事のメールを作り、外の見張りと死活監視で止まりに気づく構成

    しくみ:届かないことを知らせにする

    sitewatch.sh は無事な回に黙るので、止まった状態と区別できない。cron のメールも mail コマンドも、MTA が動いていて初めて届く。MTA が無いか壊れていると、失敗の知らせは黙って消える。そこで何もなくても毎朝1通送る。これが最後の頼りになる。材料は、回ごとに書く runs.log と、知らせごとに書く alerts.log である。

    手順:無事のメールを毎朝送る

    過去24時間の実行が足りなければ件名を【警告】に、至急の知らせがあれば【至急】にする。どちらも無ければ【無事】にする。次の sitewatch-daily.sh を、サーバーの作業用のフォルダに、改行を LF にして保存する。

    #!/bin/bash
    # 過去24時間の監視の記録を数えて、毎朝1通だけ送る
    export LANG=C.UTF-8
    set -u
    : "${STATE:=/var/lib/sitewatch}"
    : "${MAILTO:=admin@example.com}"
    MIN=276   # 5分ごとなら24時間で288回。1時間分の欠けまで許す
    since=$(date -d '24 hours ago' -Iseconds)
    cnt() { awk -v s="$since" -v l="${2:-}" '$1 >= s && (l == "" || $2 == l)' "$STATE/$1" | wc -l; }
    runs=$(cnt runs.log); warn=$(cnt alerts.log 警告); urgent=$(cnt alerts.log 至急)
    last=$(tail -n 1 "$STATE/runs.log" | cut -d' ' -f1)
    if [ "$urgent" -gt 0 ]; then s="【至急】sitewatch 至急の知らせが${urgent}件"
    elif [ "$runs" -lt "$MIN" ]; then s="【警告】sitewatch 実行が${runs}回しかない"
    else s="【無事】sitewatch ${runs}回 警告${warn}件"; fi
    printf '実行: %d 回(予定 288 回)\n最後の実行: %s\n警告: %d 件\n至急: %d 件\n' "$runs" "${last:-なし}" "$warn" "$urgent" |
      mail -s "$s" "$MAILTO" || { echo "sitewatch-daily: メールを送れない: $s" >&2; exit 1; }

    時刻は ISO 8601 の文字列のまま比べる。同じタイムゾーンなら、文字列の大小と時刻の前後が一致する。runs.log が無ければ実行0回と数え、エラーは stderr に出る。サーバーで root として、保存したフォルダで第2章と同じ形で置く。成功すれば何も出さない。

    install -m 700 sitewatch-daily.sh /usr/local/bin/sitewatch-daily.sh

    root の crontab(sudo crontab -e)に、第2章の MAILTO の行と並べて足す。

    0 7 * * * /usr/local/bin/sitewatch-daily.sh

    手順:サーバーの外から見る

    サーバーごと止まると、中の監視は何も送れない。そこで別の機械から、ページの状態コードと、変わらないはずのファイルのハッシュを見る。取得の失敗と中身の変化は分けて出す。分けないと、取れなかった回を変化と取り違える。次の outside-check.sh を、別の機械の作業用のフォルダに、改行を LF にして保存する。curl が要る。

    #!/bin/bash
    # サーバーの外から主なページと静的ファイルを見る。正常なら何も出さない
    export LANG=C.UTF-8
    set -u
    BASE=https://example.com
    PAGES=${PAGES:-/}   # 主なページ。空白で区切る
    FILE=${FILE:-/}     # 中身が変わらないはずのファイル
    FILE_SHA=${FILE_SHA:-25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484}
    fail=0
    for p in $PAGES; do
      code=$(curl -sS -o /dev/null --max-time 10 -w '%{http_code}' "$BASE$p") ||
        { echo "取得できない: $p" >&2; fail=1; continue; }
      [ "$code" = 200 ] || { echo "状態コード $code: $p" >&2; fail=1; }
    done
    tmp=$(mktemp) && trap 'rm -f "$tmp"' EXIT || exit 1
    if ! curl -fsS --max-time 10 -o "$tmp" "$BASE$FILE"; then
      echo "取得できない: $FILE" >&2; fail=1
    elif [ "$(sha256sum < "$tmp" | cut -c1-64)" != "$FILE_SHA" ]; then
      echo "中身が変わった: $FILE" >&2; fail=1
    fi
    exit $fail

    FILE と FILE_SHA は自分のサイトの値に替える。例は example.com のトップページを curl -fsS https://example.com/ | sha256sum で控えた値である。別の機械の root で、保存したフォルダで置く。crontab を持つユーザーが root でなくても動かせるよう、755 にする。

    install -m 755 outside-check.sh /usr/local/bin/outside-check.sh

    その機械の crontab に MAILTO=admin@example.com と */5 * * * * /usr/local/bin/outside-check.sh を書けば、知らせがメールで届く。

    確かめる:無事のメールと外の見張り

    止まった監視が件名に出る

    サーバー(root)で、記録の写し STATE=/tmp/sitewatch-test を使う。本物の監視の記録の場所では流さない。mail は第2章と同じ代役で受ける。6時間前に止まった runs.log(216回分)と警告1件の alerts.log を作り、cron に近い env -i で流す。2行目は、試しの記録の場所がまだ無いことを確かめて 700 で作る。何か出したら先へ進まない。

    STATE=/tmp/sitewatch-test
    mkdir -m 700 "$STATE" || echo "$STATE がすでにある。中身を確かめて消してから流す"
    mkdir -p "$STATE/stub"
    printf '#!/bin/sh\necho "--- mail $*"; cat\n' > "$STATE/stub/mail"; chmod +x "$STATE/stub/mail"
    for i in $(seq 288 -1 73); do echo "$(date -d "-$((i*5-2)) minutes" -Iseconds) files=120"; done > "$STATE/runs.log"
    echo "$(date -d '-3 hours' -Iseconds) 警告 【警告】/var/www/example で知らない変更 1件" > "$STATE/alerts.log"
    env -i HOME=/root PATH="$STATE/stub:/usr/bin:/bin" SHELL=/bin/sh STATE="$STATE" /usr/local/bin/sitewatch-daily.sh
    --- mail -s 【警告】sitewatch 実行が216回しかない admin@example.com
    実行: 216 回(予定 288 回)
    最後の実行: 2026-10-30T05:45:29+09:00
    警告: 1 件
    至急: 0 件

    最後の実行の時刻から、止まった時刻が分かる。seq 288 -1 1 で288回分にすると件名は【無事】、至急の行を足すと【至急】になった。代役が失敗すると「メールを送れない」が stderr に出て、終了ステータスは1になった。試しが終わったら、この節で作った試しの記録の場所を消す。

    rm -rf /tmp/sitewatch-test

    取得の失敗と中身の変化を分ける

    別の機械で、無いページとファイルを渡す。正常なら何も出ず、終了ステータスは0である。

    PAGES="/ /no-such-page" FILE=/no-such-file /usr/local/bin/outside-check.sh; echo "exit=$?"
    状態コード 404: /no-such-page
    curl: (22) The requested URL returned error: 404
    取得できない: /no-such-file
    exit=1

    FILE_SHA=0 を渡すと、別の行で「中身が変わった: /」が出た。

    踏み込み:同じサーバーで見張る限界

    同じサーバーの監視は、侵入した者に止められうる。ウェブサーバーのユーザーで動く侵入者は、書ければスクリプトと記録と crontab を書き換え、ベースラインを作り直せる。root を取れば、時計を戻すかファイルシステムを直接書き換えて(ext4 なら debugfs)ctime も偽れる。それでも残るのが、無事のメールと外の見張りである。止めにくくする手は次の3つである。

    • 監視は root か専用のユーザー(例 sitewatch)で動かし、crontab もそのユーザーのものにする。

    • 監視の記録の場所は公開フォルダの外に置き、スクリプトとともにそのユーザーの持ち物にする。ウェブサーバーのユーザーには書かせない。

    • runs.log と alerts.log を syslog などでサーバーの外へ送る。中を消されても外に残る。

    外の見張りも止まりうる。備えはデッドマンスイッチ(dead man's switch)型の死活監視サービスである。決まった間隔で URL を叩き(ハートビート、heartbeat)、叩かれなければサービスが知らせる。sitewatch.sh の DNS_TYPES の行の次に1行目を、最後に2行目を足す。途中で失敗した回は叩かないので、止まれば数分で分かる。

    : "${HEARTBEAT_URL:=}"
    [ -z "$HEARTBEAT_URL" ] || curl -fsS --max-time 10 -o /dev/null "$HEARTBEAT_URL" || echo "sitewatch: ハートビートを送れない" >&2

    HEARTBEAT_URL はサービスが発行する URL で、空なら何もしない。実際のサービスでは試していない。404 を返す URL で、stderr に「ハートビートを送れない」が出ることだけを確かめた。

    付録 sitewatch.sh の全体

    第2章の sitewatch.sh に、第3章から第5章の足す指示をそのまま当てはめた全体である。

    #!/bin/bash
    # サイトのフォルダの改ざんを見張る。何も無いときは何も出さない
    # 使い方: sitewatch.sh(見張る) / sitewatch.sh --accept(変化を見せてから今の状態をベースラインにする)
    set -u -o pipefail
    export LANG=C.UTF-8
    PATH=${PATH:+$PATH:}/usr/sbin:/usr/bin:/sbin:/bin
    : "${SITE:=/var/www/example}"
    : "${STATE:=/var/lib/sitewatch}"
    : "${MAILTO:=admin@example.com}"
    : "${DOMAIN:=example.com}"
    : "${DNS_TYPES:=A AAAA MX NS}"
    : "${HEARTBEAT_URL:=}"
    BASE=$STATE/base.tsv
    PAT=$STATE/patterns.txt
    T=$(printf '\t')
    BAD='*[[:cntrl:]\\]*'
    RE_UP='^public/(uploads|images)/'
    RE_PHP='\.(php[0-9]?|phtml|phar)(\.|$)'
    RE_CONF='(^|/)(\.htaccess|\.user\.ini)$'
    # アプリが動いている間に書き換えるフォルダ。自分のサイトに合わせて替える(空なら何も除かない)
    SKIP='^storage/(logs|framework/(sessions|cache|views))/'
    # 除いたフォルダのうち、PHP ができて当然の場所(コンパイル済みのテンプレート)
    SKIP_PHP='^storage/framework/views/'
    umask 077
    
    # 同じ時刻に2つ動かない。一時ファイルは STATE の中に作る
    exec 9>"$STATE/lock" || exit 1
    flock -n 9 || { echo "sitewatch: 前の回がまだ動いている" >&2; exit 1; }
    TMP=$(mktemp -d "$STATE/tmp.XXXXXX") || exit 1
    trap 'rm -rf "$TMP"' EXIT
    trap 'exit 1' HUP INT TERM
    [ -r "$PAT" ] || { echo "sitewatch: $PAT が無い" >&2; exit 1; }
    touch "$STATE/links.tsv" || exit 1
    
    # notify 段階 件名 本文
    notify() {
      printf '%s\n' "$3" | mail -s "$2" "$MAILTO" || { echo "sitewatch: メールを送れない: $2" >&2; return 1; }
      echo "$(date -Iseconds) $1 $2" >> "$STATE/alerts.log"
    }
    
    # 署名つきマニフェスト。届いた一覧は root の写しを確かめてから取り込む
    : "${PUB:=/etc/sitewatch/deploy.pub}"
    IN=$STATE/incoming MAN=$STATE/manifest
    verify() { openssl pkeyutl -verify -pubin -inkey "$PUB" -rawin -in "$1.txt" -sigfile "$1.sig" >/dev/null 2>&1; }
    created() { sed -n '1s/^# created=\([0-9][0-9]*\) .*/\1/p' "$1.txt"; }
    reject() {
      local d
      d=$(mkdir -p "$STATE/rejected" && mktemp -d "$STATE/rejected/$(date +%Y%m%dT%H%M%S)-XXXX") &&
        mv "$1.txt" "$1.sig" "$d"/ || return 1
      notify 至急 "【至急】$SITE でマニフェストを拒否した($2)" "$d に移した。自分のデプロイでなければ侵入を疑う。"
    }
    intake() {
      local f=$IN/manifest new old
      [ -e "$f.txt" ] && [ -e "$f.sig" ] || return 0
      if [ -L "$f.txt" ] || [ -L "$f.sig" ] || [ ! -f "$f.txt" ] || [ ! -f "$f.sig" ]; then
        reject "$f" 通常のファイルでない; return
      fi
      # 大きさに上限を置いて写す。切れた一覧は署名が合わない
      head -c 10M "$f.txt" > "$TMP/m.txt" && head -c 1K "$f.sig" > "$TMP/m.sig" || return 1
      if ! verify "$TMP/m"; then
        # 送っている途中かもしれないので、届いて1分は待つ
        [ -n "$(find "$IN" -maxdepth 1 -name 'manifest.*' -mmin -1)" ] || reject "$f" 署名が合わない
        return
      fi
      new=$(created "$TMP/m") old=$(cat "$STATE/manifest.last" 2>/dev/null)
      if [ -z "$new" ] || [ "$new" -le "${old:-0}" ]; then reject "$f" 前のものより新しくない; return; fi
      mv "$TMP/m.sig" "$MAN.sig" && mv "$TMP/m.txt" "$MAN.txt" && rm "$f.txt" "$f.sig" &&
        echo "$new" > "$STATE/manifest.last"
    }
    intake || exit 1
    if [ -e "$MAN.txt" ] && ! verify "$MAN"; then reject "$MAN" 取り込み済みのものが書き換えられた || exit 1; fi
    is_planned() { [ -e "$MAN.txt" ] && grep -qxF "$2  $1" "$MAN.txt"; }
    
    # 同じ段階と件名の知らせは一度だけ送る。キーは「段階<TAB>件名」の2列
    notify_once() {
      grep -qxF "$1$T$2" "$STATE/sent.txt" 2>/dev/null && return 0
      notify "$1" "【$1】$2" "$3" && printf '%s\n' "$1$T$2" >> "$STATE/sent.txt"
    }
    
    # 件名が今日でない日付で終わるキーを落とす
    forget_old() {
      awk -F'\t' -v d="$(date +%F)" 'NF != 2 || $2 !~ / [0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]$/ ||
        substr($2, length($2) - 9) == d' "$STATE/sent.txt" > "$TMP/once" && mv "$TMP/once" "$STATE/sent.txt"
    }
    
    check_db() {
      local out lv subject body
      out=$(STATE=$STATE TODAY=$(date +%F) php -d display_errors=stderr /usr/local/bin/sitewatch-db.php) ||
        { echo "sitewatch: DB の見張りが失敗した" >&2; return 1; }
      [ -n "$out" ] || return 0
      while IFS=$T read -r lv subject body; do
        case $lv in
          警告|至急) notify_once "$lv" "$subject" "$body" ;;
          *) echo "sitewatch: DB の見張りの出力が読めない: ${lv:0:40}" >&2 ;;
        esac
      done <<< "$out"
    }
    
    check_cert() {
      local pem="$STATE/cert.pem" end days
      # 期限は日単位でしか変わらないので、取ってから24時間は取り直さない
      [ -n "$(find "$pem" -mmin -1440 2>/dev/null)" ] && return 0
      if ! timeout 20 openssl s_client -connect "$DOMAIN:443" -servername "$DOMAIN" </dev/null 2>/dev/null |
          openssl x509 -out "$pem.new" 2>/dev/null || ! mv "$pem.new" "$pem"; then
        echo "sitewatch: 証明書を取得できない: $DOMAIN" >&2
        return 1
      fi
      end=$(openssl x509 -in "$pem" -noout -enddate | cut -d= -f2)
      days=$(( ($(date -d "$end" +%s) - $(date +%s)) / 86400 ))
      if ! openssl x509 -in "$pem" -noout -checkend $((7 * 86400)) >/dev/null; then
        notify_once 至急 "証明書の残りが7日を切った $DOMAIN($end)" "残り ${days} 日"
      elif ! openssl x509 -in "$pem" -noout -checkend $((30 * 86400)) >/dev/null; then
        notify_once 警告 "証明書の残りが30日を切った $DOMAIN($end)" "残り ${days} 日"
      fi
    }
    
    check_dns() {
      local now=$STATE/dns.now t r d lv=警告
      : > "$now" || return 1
      for t in $DNS_TYPES; do
        r=$(dig +noall +comments +answer +time=5 +tries=2 "$DOMAIN" "$t") || r=
        if ! grep -q 'status: NOERROR' <<< "$r"; then
          echo "sitewatch: DNS を引けない: $DOMAIN $t" >&2
          return 1
        fi
        # 答えの行の5列目から後を「種類 値」の形で書く
        awk -v t="$t" '!/^;/ && $4 == t { v = $5; for (i = 6; i <= NF; i++) v = v " " $i; print t, v }' <<< "$r" >> "$now"
      done
      LC_ALL=C sort -o "$now" "$now"
      if [ ! -f "$STATE/dns.expected" ]; then
        echo "sitewatch: $STATE/dns.expected が無い。dns.now を確かめてから写す" >&2
        return 1
      fi
      d=$(diff "$STATE/dns.expected" "$now") && return 0
      grep -qE '^[<>] (NS|MX) ' <<< "$d" && lv=至急
      notify_once "$lv" "DNS の答えが変わった $DOMAIN $(sha256sum < "$now" | cut -c1-8)" "$d"
    }
    
    # 今の一覧を出す。SKIP に当たるパスは除く。大きさ・mtime・ctime がベースラインと同じファイルはハッシュを使い回す
    scan() {
      (cd "$SITE" && find . -path "./$BAD" -prune -o -type f -printf '%P\t%m\t%U\t%s\t%T@\t%C@\n') |
        S=$SKIP awk -F'\t' 'ENVIRON["S"] == "" || $1 !~ ENVIRON["S"]' |
        LC_ALL=C sort -t "$T" -k1,1 > "$TMP/meta" || return 1
      awk -F'\t' -v OFS='\t' 'FILENAME == ARGV[1] { k[$1] = $4 " " $5 " " $6; h[$1] = $7; next }
        { print $0, (($1 in k) && k[$1] == $4 " " $5 " " $6) ? h[$1] : "-" }' "$1" "$TMP/meta" |
      while IFS=$T read -r p m u s mt ct h; do
        if [ "$h" = - ]; then
          # find のあとで消えたファイルは飛ばす
          h=$(sha256sum 2>/dev/null < "$SITE/$p" | cut -c1-64) || { [ -e "$SITE/$p" ] && return 1; continue; }
        fi
        printf '%s\t%s\t%s\t%s\t%s\t%s\t%s\n' "$p" "$m" "$u" "$s" "$mt" "$ct" "$h"
      done
    }
    
    # ベースラインに載らないもの。扱えない名前、リンクと特殊なファイル、除いたフォルダの PHP、全ユーザーが書けるフォルダ
    odd() {
      cd "$SITE" || return 1
      find . -name "$BAD" -printf '%P\0' | LC_ALL=C tr -c '[:print:]\0' '?' | tr '\0' '\n' |
        sed "s/^/至急$T/; s/\$/$T-${T}監視で扱えない名前/" || return 1
      # links.tsv に「パス<TAB>リンクの先」で書いたリンクは飛ばす
      find . -path "./$BAD" -prune -o ! -type f ! -type d -printf "%P$T%y$T%l\n" > "$TMP/links" || return 1
      awk -F'\t' -v OFS='\t' 'FILENAME == ARGV[1] { ok[$1 FS $2]; next }
        !($2 == "l" && ($1 FS $3) in ok) { print "至急", $1, $2, "リンクか特殊なファイル" }' "$STATE/links.tsv" "$TMP/links" || return 1
      find . -path "./$BAD" -prune -o -type f -printf '%P\n' |
        S=$SKIP SP=$SKIP_PHP RE=$RE_PHP awk -v t="$T" 'ENVIRON["S"] != "" && $0 ~ ENVIRON["S"] && tolower($0) ~ ENVIRON["RE"] &&
          (ENVIRON["SP"] == "" || $0 !~ ENVIRON["SP"]) { print "警告" t $0 t "-" t "除いたフォルダの PHP" }' || return 1
      find . -path "./$BAD" -prune -o -type d -perm -o+w -printf "至急$T%P/$T-${T}全ユーザーが書けるフォルダ\n"
    }
    
    if [ ! -s "$BASE" ]; then
      [ "${1:-}" = --accept ] || { echo "sitewatch: $BASE が無い。先に --accept で作る" >&2; exit 1; }
      scan /dev/null > "$TMP/cur" && mv "$TMP/cur" "$BASE" || exit 1
      echo "ベースラインを作った: $(wc -l < "$BASE") ファイル"
      exit 0
    fi
    scan "$BASE" > "$TMP/cur" || { echo "sitewatch: 一覧を作れない" >&2; exit 1; }
    
    # ベースラインと今を突き合わせ、変わったものを「段階 パス ハッシュ 理由」で書き出す
    LC_ALL=C join -t "$T" -a1 -a2 -e - -o 0,1.2,1.3,1.4,1.5,1.6,1.7,2.2,2.3,2.4,2.5,2.6,2.7 "$BASE" "$TMP/cur" |
    while IFS=$T read -r p om ou os omt oct oh m u s mt ct h; do
      [ "$om $ou $oh" = "$m $u $h" ] && continue
      if [ "$h" = - ]; then
        lv=警告 why=削除
      elif [ "$oh" != "$h" ] && ! (( 8#$m & 2 )) && is_planned "$p" "$h"; then
        echo "予定どおり$T$p$T$h${T}マニフェストと一致"; continue
      else
        lv=警告
        if [ "$oh" = - ]; then why=追加
        elif [ "$oh" = "$h" ]; then why="権限か持ち主の変更 $om/$ou→$m/$u"
        elif [ "$omt $os" = "$mt $s" ]; then lv=至急 why="日時の偽装(mtime はベースラインのまま)"
        else why=内容の変更
        fi
        (( 8#$m & 2 )) && lv=至急 why+="・全ユーザーが書ける"
        [[ $p =~ $RE_UP && ${p,,} =~ $RE_PHP ]] && lv=至急 why+="・アップロード先の PHP"
        if [ "$oh" != "$h" ] && grep -qE -f "$PAT" "$SITE/$p" 2>/dev/null &&
           ! grep -qxF "$p$T$h" "$STATE/allow.tsv" 2>/dev/null; then
          lv=至急 why+="・ウェブシェルに似たコード"
        fi
      fi
      [[ $p =~ $RE_CONF ]] && lv=至急 why+="・サーバーの設定ファイル"
      echo "$lv$T$p$T$h$T$why"
    done > "$TMP/found" || { echo "sitewatch: 突き合わせに失敗した" >&2; exit 1; }
    (odd) >> "$TMP/found" || { echo "sitewatch: 名前とリンクを調べられない" >&2; exit 1; }
    
    # 一覧を一度でも取り込んだら、一覧に無い PHP の追加は置き場所を問わず至急にする
    if [ -e "$MAN.txt" ] || [ -s "$STATE/manifest.last" ]; then
      RE=$RE_PHP awk -F'\t' -v OFS='\t' '$1 == "警告" && $4 ~ /^追加/ && tolower($2) ~ ENVIRON["RE"] {
        $1 = "至急"; $4 = $4 "・一覧に無い PHP" } 1' "$TMP/found" > "$TMP/f2" && mv "$TMP/f2" "$TMP/found" || exit 1
    fi
    # 予定どおりの変化はベースラインに取り込み、この回の分を1通で知らせる
    grep "^予定どおり$T" "$TMP/found" > "$TMP/plan"
    if [ -s "$TMP/plan" ] && [ "${1:-}" != --accept ]; then
      awk -F'\t' 'FILENAME == ARGV[1] { p[$2]; next } FILENAME == ARGV[2] { if ($1 in p) print; next }
        !($1 in p)' "$TMP/plan" "$TMP/cur" "$BASE" | LC_ALL=C sort -t "$T" -k1,1 > "$TMP/base" &&
        mv "$TMP/base" "$BASE" || { echo "sitewatch: ベースラインを更新できない" >&2; exit 1; }
      notify 予定どおり "【予定どおり】$SITE でデプロイを反映した $(wc -l < "$TMP/plan")件" "$(cut -f2 "$TMP/plan")" || exit 1
    fi
    
    touch "$STATE/sent.txt"
    if [ "${1:-}" = --accept ]; then
      # 取り込む変化を先に見せる。消すのはファイル用の3列のキーだけ
      cut -f2,4 "$TMP/found" | tr '\t' ' '
      awk -F'\t' 'NF != 3' "$STATE/sent.txt" > "$TMP/sent" &&
        mv "$TMP/cur" "$BASE" && mv "$TMP/sent" "$STATE/sent.txt" || exit 1
      echo "ベースラインを更新した: $(wc -l < "$BASE") ファイル"
      exit 0
    fi
    
    # 今回の変化に無いファイルのキーを落とす。直ったあとに再び置かれれば、また知らせる
    awk -F'\t' 'FILENAME == ARGV[1] { k[$1 FS $2 FS $3]; next } NF != 3 || ($0 in k)' \
      "$TMP/found" "$STATE/sent.txt" > "$TMP/sent" && mv "$TMP/sent" "$STATE/sent.txt" || exit 1
    
    # 段階ごとに、まだ送っていないものだけを1通にまとめて送る
    for lv in 至急 警告; do
      awk -F'\t' -v lv="$lv" 'FILENAME == ARGV[1] { seen[$0]; next }
        $1 == lv && !(($1 FS $2 FS $3) in seen)' "$STATE/sent.txt" "$TMP/found" > "$TMP/new"
      n=$(wc -l < "$TMP/new")
      [ "$n" -gt 0 ] || continue
      body="$(cut -f2,4 "$TMP/new" | tr '\t' ' ')
    確かめてから sitewatch.sh --accept でベースラインを更新する。"
      [ "$lv" = 至急 ] && what=改ざんの疑い || what=知らない変更
      notify "$lv" "【$lv】$SITE で${what} ${n}件" "$body" || exit 1
      cut -f1-3 "$TMP/new" >> "$STATE/sent.txt"
    done
    
    forget_old; check_db; check_cert; check_dns
    
    files=$(wc -l < "$TMP/cur")
    changed=$(wc -l < "$TMP/found")
    warn=$(grep -c "^警告$T" "$TMP/found")
    urgent=$(grep -c "^至急$T" "$TMP/found")
    echo "$(date -Iseconds) files=$files changed=$changed warn=$warn urgent=$urgent" >> "$STATE/runs.log"
    [ -z "$HEARTBEAT_URL" ] || curl -fsS --max-time 10 -o /dev/null "$HEARTBEAT_URL" || echo "sitewatch: ハートビートを送れない" >&2

    まとめ

    この記事の守りを、置く順に並べる。第1章の5行が防ぐ層、残りが気づく層である。

    • 第1章 SQL インジェクションを防ぐ
      やること:SQL の値をプレースホルダで渡す
      コマンドや設定:prepare と execute
      確かめ方:攻撃の文字列で0行が返る

    • 第1章 SQL インジェクションを防ぐ
      やること:並べ方と識別子を固定する
      コマンドや設定:許可リストと \z の正規表現
      確かめ方:一覧に無い語が既定に落ちる

    • 第1章 SQL インジェクションを防ぐ
      やること:SQL を流す所を点検する
      コマンドや設定:grep -rnE でシンクを並べる
      確かめ方:変数から組み立てた行を出どころまでたどる

    • 第1章 SQL インジェクションを防ぐ
      やること:PDO の設定を固める
      コマンドや設定:EMULATE_PREPARES と MULTI_STATEMENTS を false
      確かめ方:2つ目の文が 42000 で止まる

    • 第1章 SQL インジェクションを防ぐ
      やること:DB の権限を絞る
      コマンドや設定:DROP・ALTER・FILE・GRANT を外す
      確かめ方:SHOW GRANTS FOR CURRENT_USER()

    • 第2章 ファイルの改ざんに気づく
      やること:ベースラインを作る
      コマンドや設定:sitewatch.sh --accept
      確かめ方:作る前に至急の条件で何も出ないことを確かめる

    • 第2章 ファイルの改ざんに気づく
      やること:5分ごとに見張る
      コマンドや設定:root の crontab に */5 の行
      確かめ方:env -i で動かして何も出ない

    • 第3章 デプロイを署名で見分ける
      やること:自分のデプロイを見分ける
      コマンドや設定:openssl pkeyutl -sign で署名
      確かめ方:予定どおりのメールが1通届く

    • 第4章 ファイルの外を見張る
      やること:DB・証明書・DNS を見張る
      コマンドや設定:check_db と check_cert と check_dns
      確かめ方:控えを書き換えると知らせが1通だけ届く

    • 第5章 監視の停止に気づく
      やること:止まりに気づく
      コマンドや設定:sitewatch-daily.sh を毎朝7時
      確かめ方:無事のメールが毎朝届く

    • 第5章 監視の停止に気づく
      やること:外から見る
      コマンドや設定:別の機械で outside-check.sh
      確かめ方:無いページで終了ステータス 1

    次に進むなら、第2章の踏み込みのカーソルで全ファイルのハッシュを定期的に読み直すことと、監視を専用のユーザーへ移して記録をサーバーの外へ送ること(第5章の踏み込み)を勧める。どちらも、同じサーバーで見張る限界を狭める手である。

    元の記事:https://cgpt.jp/pages/journal-entry.html?id=23

     
     
    調布の天気・地震・バスがわかるサイト cgpt.jp を作っている父です。鉄道好きの子どもが作ったホームページを引き継いで、機能を足しつづけていたら、こうなりました。サイトづくりと鉄道部屋の記録を、ゆるく書いています。https://cgpt.jp

    あなたへのおすすめ