WordPress Nonceの使い方とCSRF対策完全ガイド|検証エラー・期限切れの対処法と実装コード集

WordPressのテーマやプラグイン開発、あるいはカスタム機能の実装において、セキュリティ対策は最も重要視すべき要素のひとつです。

特に CSRF(クロスサイトリクエストフォージェリ)攻撃 への対策として、WordPressでは Nonce(ノンス / ナンス) と呼ばれるセキュリティトークンを使用します。しかし、「とりあえず関数を使っているが仕組みを正しく理解できていない」「AjaxやREST APIで nonce verification failed や rest_cookie_invalid_nonce エラーが多発する」「キャッシュプラグインと併用したらリンク期限切れエラーが起きる」といったトラブルに直面する開発者は少なくありません。

💡 本記事は「WordPress セキュアコーディング実践シリーズ」の第1弾(基礎・ハブ記事)です

本記事では、WordPressにおけるNonceの根本的な仕組みとCSRF対策の必要性を紐解き、フォーム送信(POST)・URLリンク(GET)・Ajax通信・REST API の4大用途別における正しい実装コード(コピペ可)を徹底解説します。さらに、現場で頻発する Nonce検証エラー(ライフタイム切れ、ページキャッシュ問題、ユーザーセッション不一致)の根本原因と具体的な解決策 、REST API特有のトラブルシューティングまで実務で役立つノウハウを完全網羅しました。


目次

WordPressにおけるNonce(ノンス)とは?仕組みとCSRF対策の必須性

Nonce(Number used once) は、暗号工学や情報セキュリティの分野において、本来「一度だけ使われる使い捨ての乱数・暗号トークン」を意味します。しかし、WordPressにおけるNonceは一般的な定義とは異なり、「特定のアクション・特定のユーザー・特定の時間枠」に紐づく暗号化ハッシュトークン として独自に設計されています。

つまり、一度リクエストを処理したら消滅する完全なワンタイムトークンではなく、有効期間内(通常12〜24時間)かつ同一ユーザー・同一アクションであれば複数回検証にパスする仕組みになっています。この独自仕様を理解しておくことが、不具合を防ぐ第一歩です。

1. Nonceが防ぐ「CSRF(クロスサイトリクエストフォージェリ)」の脅威

CSRF(Cross-Site Request Forgery)とは、Webサイトにログイン中のユーザー(特に管理者や編集者)のブラウザを悪用し、本人の意図しない悪意あるリクエストを送信させて不正な処理を実行させるサイバー攻撃 です。

ブラウザには、特定のドメインに対して発行されたCookie(認証セッション)を、そのドメイン宛てのリクエストに自動的に付与して送信する仕組みがあります。攻撃者はこのブラウザの標準的な挙動を悪用します。

CSRF攻撃が発生する流れ

  1. 管理者がWordPress管理画面にログインする(ブラウザに認証Cookieが保持される)。
  2. 管理者が同一ブラウザの別タブ等で、攻撃者が用意した悪意ある罠サイト(またはフィッシングメールに記載されたリンク)を開く。
  3. 罠サイト内に仕込まれた非表示のフォームやJavaScriptが、管理者のWordPressサイトへリクエスト(例: 記事の全削除や管理者権限ユーザーの追加)を自動送信する。
  4. WordPressサーバーはブラウザから自動添付されたCookieを確認し、「正規の管理者からの通信」と誤認して悪意ある処理を実行してしまう。

もしWordPressの処理にNonce検証が組み込まれていれば、攻撃者は正規の管理画面から発行された正しいNonce値を知ることができない ため、不正なリクエストはサーバー側で即座に遮断されます。

🚨 実際の脆弱性事例(CVE-2025-1463)
過去には有名プラグイン(Spreadsheet Integrationなど)において、管理処理のNonce検証が欠落していたために、管理者が悪意あるリンクを踏むだけで意図しないデータ公開や設定変更が行われる重大なCSRF脆弱性が報告されました。安全な機能開発においてNonceの適切な実装は絶対条件です。

2. WordPressのNonceの有効期限(ライフサイクル)とカスタマイズ方法(nonce_lifeフィルター)

WordPressのNonceは、コア関数である wp_create_nonce() によって生成されます。内部的には以下の4つの要素を組み合わせてハッシュ化(HMAC-MD5ベース)されています。

  • ユーザーID(UID):未ログイン時は 0、ログイン時は該当ユーザーのID。ログイン状態が変わるとハッシュ値も変わります。
  • アクション名(Action):一意の操作識別文字列(例: 'delete_post_123' や 'wp_rest')。
  • 秘密鍵とソルト(wp_salt):wp-config.php 内に定義された NONCE_KEY と NONCE_SALT。
  • 時間枠Tick(Tick):12時間単位で区切られたタイムウィンドウのインデックス値。

WordPressのNonceは デフォルトで12〜24時間有効 です。内部的には2つの12時間スロット(現在の12時間スロット+直前の12時間スロット)を受け付けるため、生成されたタイミングによって12時間から最大24時間有効となります。

wp_verify_nonce() 関数の戻り値は以下の3パターンに分かれます:

  • 1 : 直近0〜12時間以内 に生成されたNonce(最新スロット)
  • 2 : 12〜24時間前 に生成されたNonce(直前スロット)
  • false : 無効・期限切れ・改ざんされたNonce(検証失敗)

有効期限をカスタマイズする(nonce_lifeフィルター)

金融系サービスや機密性の高い管理機能を扱う場合など、Nonceの有効期限を標準の24時間から短縮したいときは、nonce_life フィルターフックを使用して秒単位で設定を変更できます。

<?php
/**
 * Nonceの有効期限をデフォルトの24時間から4時間に短縮する
 * 
 * @param int $life 有効期限(秒)
 * @return int
 */
add_filter( 'nonce_life', function( $life ) {
    return 4 * HOUR_IN_SECONDS; // 4時間(14,400秒)
} );

ただし、有効期限を極端に短く(例: 数分〜1時間)設定すると、ユーザーが記事の長文執筆中に下書き保存しようとした際や、フォーム入力に時間がかかった際にNonce期限切れエラーが頻発する原因になります。システムの利用実態に合わせて慎重に調整してください。


【用途別】WordPress Nonceの正しい実装コード集(コピペ可)

WordPress開発で頻出する4つの通信パターン(POSTフォーム送信、GETリンク、Ajax通信、REST API)におけるNonceの実装手順を解説します。コピペして実務にそのまま適用できる実用的なコード例を用意しました。

1. フォーム送信(POST)でのNonce生成と検証(wp_nonce_field / check_admin_referer)

管理画面の設定ページやフロントエンドのHTMLフォームからPOST送信を行う場合の最も標準的な実装です。

【HTMLフォーム側】wp_nonce_field で隠しフィールドを出力

フォーム内に wp_nonce_field() を記述するだけで、Nonce値とリファラー確認用の2つの隠しフィールド(_wpnonce と _wp_http_referer)が自動出力されます。

<!-- 管理画面またはテーマのテンプレート内 -->
<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
    <?php
    // 隠しフィールド (_wpnonce, _wp_http_referer) を自動出力
    // 第1引数: アクション名, 第2引数: フィールド名(省略時は '_wpnonce')
    wp_nonce_field( 'my_custom_post_action', 'my_custom_nonce' );
    ?>
    
    <input type="hidden" name="action" value="my_save_settings">
    
    <label for="site_notice">サイト告知テキスト:</label>
    <input type="text" id="site_notice" name="site_notice" value="" class="regular-text">
    
    <?php submit_button( '設定を保存' ); ?>
</form>

【PHPサーバー側】check_admin_referer による検証と権限チェック

受信側では check_admin_referer() を呼び出して検証します。検証に失敗した場合は、自動的に wp_die() が実行されて処理が安全に中断されます。

<?php
// admin-post.php 経由のPOSTリクエストをフック
add_action( 'admin_post_my_save_settings', 'handle_my_save_settings' );

function handle_my_save_settings() {
    // 1. Nonce と リファラーの検証(不正な場合は自動で wp_die() 終了)
    check_admin_referer( 'my_custom_post_action', 'my_custom_nonce' );

    // 2. 権限チェック(認可)の実施
    if ( ! current_user_can( 'manage_options' ) ) {
        wp_die( esc_html__( 'この操作を実行する権限がありません。', 'textdomain' ), 403 );
    }

    // 3. 入力値のサニタイズとデータ保存
    if ( isset( $_POST['site_notice'] ) ) {
        $notice = sanitize_text_field( wp_unslash( $_POST['site_notice'] ) );
        update_option( 'my_site_notice', $notice );
    }

    // 4. 処理完了後の安全なリダイレクト
    wp_safe_redirect( add_query_arg( 'updated', 'true', admin_url( 'admin.php?page=my-settings' ) ) );
    exit;
}

2. URLリンク(GET)でのNonce付与と検証(wp_nonce_url / wp_verify_nonce)

管理画面の投稿一覧やカスタムテーブルで「削除」「ステータス変更」といった操作をリンク(GETリクエスト)で提供する場合の実装です。

【リンク生成側】wp_nonce_url でパラメータ付与

wp_nonce_url() を使用すると、既存のURLの末尾にクエリパラメータ(デフォルトは _wpnonce=...)が自動で付加されます。

<?php
$item_id = 42;

// 基準となるURL
$base_url = admin_url( 'admin.php?page=my-items&action=delete_item&item_id=' . $item_id );

// URLに '_wpnonce' パラメータを自動付与
$secure_delete_url = wp_nonce_url( $base_url, 'delete_item_' . $item_id );
?>

<!-- 削除リンクの出力 -->
<a href="<?php echo esc_url( $secure_delete_url ); ?>" class="button delete-button" onclick="return confirm('本当に削除しますか?');">
    削除する
</a>

【PHPサーバー側】wp_verify_nonce による検証

GETリクエストの処理では、wp_verify_nonce() を使って自前で結果を判定します。戻り値が false の場合は wp_die() で403レスポンスを返します。

<?php
add_action( 'admin_init', 'handle_my_item_delete' );

function handle_my_item_delete() {
    // 該当アクションのGETリクエストのみ処理
    if ( ! isset( $_GET['action'] ) || $_GET['action'] !== 'delete_item' ) {
        return;
    }

    $item_id = isset( $_GET['item_id'] ) ? absint( $_GET['item_id'] ) : 0;
    $nonce   = isset( $_GET['_wpnonce'] ) ? sanitize_text_field( wp_unslash( $_GET['_wpnonce'] ) ) : '';

    // 1. Nonceの検証
    if ( ! wp_verify_nonce( $nonce, 'delete_item_' . $item_id ) ) {
        wp_die( esc_html__( 'セキュリティチェックに失敗しました。', 'textdomain' ), 403 );
    }

    // 2. 権限チェック
    if ( ! current_user_can( 'manage_options' ) ) {
        wp_die( esc_html__( '権限がありません。', 'textdomain' ), 403 );
    }

    // 3. 削除処理の実行(例)
    // my_custom_delete_item( $item_id );

    // 4. リダイレクト
    wp_safe_redirect( admin_url( 'admin.php?page=my-items&deleted=1' ) );
    exit;
}

3. Ajax通信でのNonceチェック(wp_create_nonce / check_ajax_referer)

admin-ajax.php を利用した非同期通信では、PHP側で生成したNonceを wp_localize_script() 経由でJavaScriptへ受け渡し、サーバー側のフックで check_ajax_referer() を用いて検証します。

【PHP側】スクリプト登録とNonceの受け渡し

<?php
add_action( 'wp_enqueue_scripts', 'my_enqueue_ajax_scripts' );

function my_enqueue_ajax_scripts() {
    wp_enqueue_script(
        'my-ajax-script',
        get_template_directory_uri() . '/js/my-ajax.js',
        array(),
        '1.0.0',
        true
    );

    // JavaScriptにオブジェクト(URLとNonce)を渡す
    wp_localize_script(
        'my-ajax-script',
        'myAjaxObj',
        array(
            'ajaxUrl' => admin_url( 'admin-ajax.php' ),
            'nonce'   => wp_create_nonce( 'my_ajax_secret_action' ),
        )
    );
}

【JavaScript側】Ajaxリクエストの送信(モダンなfetch API)

// モダンな fetch API による実装例
document.querySelector('#my-ajax-btn')?.addEventListener('click', async () => {
    const formData = new FormData();
    formData.append('action', 'my_ajax_handler');
    formData.append('security', myAjaxObj.nonce); // PHPから渡されたNonce
    formData.append('post_id', 123);

    try {
        const response = await fetch(myAjaxObj.ajaxUrl, {
            method: 'POST',
            body: formData,
        });

        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }

        const result = await response.json();
        
        if (result.success) {
            console.log('成功:', result.data);
        } else {
            console.error('エラー:', result.data.message);
        }
    } catch (error) {
        console.error('通信エラー:', error);
    }
});

【PHPサーバー側】check_ajax_referer による検証

<?php
// ログインユーザー用
add_action( 'wp_ajax_my_ajax_handler', 'my_ajax_handler_function' );
// 未ログインユーザー用(必要な場合のみ)
// add_action( 'wp_ajax_nopriv_my_ajax_handler', 'my_ajax_handler_function' );

function my_ajax_handler_function() {
    // 1. Nonceの検証(失敗時は自動で 403 / JSONエラーレスポンスを返して終了)
    // 第1引数: アクション名, 第2引数: POSTキー名(デフォルトは '_ajax_nonce' または '_wpnonce')
    check_ajax_referer( 'my_ajax_secret_action', 'security' );

    // 2. 権限チェック
    if ( ! current_user_can( 'edit_posts' ) ) {
        wp_send_json_error( array( 'message' => '権限が不足しています。' ), 403 );
    }

    $post_id = isset( $_POST['post_id'] ) ? absint( $_POST['post_id'] ) : 0;

    // 3. データ処理
    // ...

    wp_send_json_success( array(
        'message' => '処理が正常に完了しました。',
        'post_id' => $post_id,
    ) );
}

4. 【重要】WordPress REST APIでのNonce利用手順(X-WP-Nonceヘッダー)

WordPress REST API(/wp-json/...)は、Ajaxとは異なるNonce仕様を持っています。React / VueなどのSPA(シングルページアプリケーション)やブロックエディタ連携、カスタムブロック開発で必須となる知識です。

📌 REST API Nonce の3大原則
1. アクション名は常に 'wp_rest' 固定:独自のアクション名は使用できません。
2. リクエストヘッダー X-WP-Nonce で送信:HTTPリクエストヘッダーにセットして送信します。
3. 現在のログインユーザーの認証:Cookie認証と併用時、X-WP-Nonce が存在することで初めてWordPressはリクエストを「ログインユーザーの通信」として認識・初期化します。

【JavaScript側】X-WP-Nonceヘッダーを付与して通信

WordPressの管理画面ではグローバルオブジェクト wpApiSettings.nonce が標準で提供されています。フロントエンドでは wp_create_nonce( 'wp_rest' ) を wp_localize_script() で渡して利用します。

// wpApiSettings.nonce または wp_create_nonce('wp_rest') の値を使用
const restNonce = typeof wpApiSettings !== 'undefined' ? wpApiSettings.nonce : myCustomSettings.nonce; 

async function updateCustomPost(postId, data) {
    const response = await fetch(`/wp-json/my-plugin/v1/posts/${postId}`, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'X-WP-Nonce': restNonce, // ★ここが最重要!
        },
        body: JSON.stringify(data),
    });

    if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }

    return await response.json();
}

【PHP側】REST APIルート登録と permission_callback の実装

REST APIエンドポイント側では、permission_callback でユーザーの権限をチェックします。リクエストヘッダーに有効な X-WP-Nonce が含まれていれば、WordPress内部で現在のユーザーが正しくセットされるため、current_user_can() がそのまま動作します。

<?php
add_action( 'rest_api_init', function() {
    register_rest_route( 'my-plugin/v1', '/posts/(?P<id>\\d+)', array(
        'methods'             => WP_REST_Server::EDITABLE, // POST, PUT, PATCH
        'callback'            => 'my_rest_update_post_handler',
        'permission_callback' => function( WP_REST_Request $request ) {
            // X-WP-Nonce によりログインユーザーが正しく初期化されているため、
            // current_user_can() で権限をチェックするだけで安全に認可できる
            $post_id = $request->get_param( 'id' );
            return current_user_can( 'edit_post', $post_id );
        },
        'args'                => array(
            'id' => array(
                'validate_callback' => function( $param ) {
                    return is_numeric( $param );
                }
            ),
        ),
    ) );
} );

function my_rest_update_post_handler( WP_REST_Request $request ) {
    $post_id = $request->get_param( 'id' );
    $params  = $request->get_json_params();

    // 更新処理の実行
    // ...

    return rest_ensure_response( array(
        'success' => true,
        'post_id' => $post_id,
    ) );
}

主要Nonce関数のまとめ(クイックリファレンス)

WordPressにはNonceを生成・検証するための関数が複数用意されています。役割の違いや、失敗時に自動終了するかどうかを整理して把握しておきましょう。

関数名主な用途・説明戻り値 / 失敗時の挙動
wp_create_nonce($action)指定した $action 用にNonceトークン文字列(10文字のハッシュ)を生成文字列(Nonce)
wp_nonce_field($action, $name)フォーム用の <input type="hidden"> をHTML出力(または文字列返却)HTML文字列を出力(または返却)
wp_nonce_url($actionurl, $action, $name)指定URLに _wpnonce=... パラメータを付与したURL文字列を生成URL文字列
wp_verify_nonce($nonce, $action)渡されたNonceの正当性と有効期限を検証(自動終了しない)1(0〜12h)、2(12〜24h)、false(無効)
check_admin_referer($action, $name)管理画面POSTのNonceおよびリファラーを検証成功時は 1 または 2、失敗時は自動で wp_die() 終了
check_ajax_referer($action, $name, $die)AjaxリクエストのNonceを検証成功時は 1 または 2、失敗時は wp_die(-1) 終了($die=true時)

Nonce生成関数(wp_create_nonce, wp_nonce_field, wp_nonce_url)

生成系の関数は、通信方式に応じて使い分けます:

  • wp_create_nonce( $action ):純粋な文字列としてのNonceを取得します。JavaScript(Ajax・REST API)への受け渡しや、カスタムAPIレスポンスの生成で活躍します。
  • wp_nonce_field( $action, $name, $referer, $echo ):HTMLフォーム内に埋め込むhiddenタグを生成します。第3引数を true にするとリファラー確認用の _wp_http_referer も一緒に出力されます。
  • wp_nonce_url( $actionurl, $action, $name ):GETリクエスト用のURLパラメータを自動生成します。管理画面の操作リンクに必須の関数です。

Nonce検証関数(wp_verify_nonce, check_admin_referer, check_ajax_referer)

検証関数における最大の相違点は、「検証失敗時にプログラムが自動終了するかどうか」 です。

check_admin_referer() や check_ajax_referer() は、検証に失敗すると自動的に wp_die() を呼び出してHTTPステータス403を返し、PHPの実行を強制停止します。コード量を減らして簡潔に書けるメリットがあります。

一方、wp_verify_nonce() は自動終了せず、真偽値(厳密には 1, 2, false)を返すだけです。そのため、「失敗した理由をカスタムログに記録したい」「独自のJSONエラーレスポンスを返したい」「別のエラーハンドリングを行いたい」といった高度な制御を行いたい場合は wp_verify_nonce() を使用します。


Nonce検証エラー(nonce verification failed)が発生する3大原因と解決策

開発やサイト運用において最も頭を悩ませるのが、「実装したはずのフォームやAjaxで nonce verification failed やリンク期限切れエラーが起きる」というトラブルです。このエラーが発生する根本原因は、主に以下の3パターンに分類されます。

① ライフタイム切れ(12〜24時間の有効期限超過)による403 Forbidden・リンク期限切れエラー

WordPressのNonceは、前述の通り12〜24時間で失効します。ユーザーが管理画面の投稿作成ページやフロントエンドの入力フォームをブラウザのタブで開いたまま放置し、翌日になってから送信ボタンを押した場合、HTML内に埋め込まれていたNonceが期限切れとなり、403エラー(「リンクの期限が切れています。」など)が表示されます。

【解決策と対策】

  1. Heartbeat APIの活用:管理画面であればWordPress標準のHeartbeat APIが定期的に通信してNonceを更新します。Heartbeatを無効化するプラグインやコードを導入している場合は、適切な間隔で動かすよう設定を見直してください。
  2. JavaScriptによる定期リフレッシュ:フロントエンドの長文フォームや会員ダッシュボードでは、JavaScriptの setInterval を用いて定期的に軽量なAPIを呼び出し、フォーム内のNonceフィールドを自動更新する仕組みを実装します。
  3. 再認証モーダルの表示:検証失敗時に画面をリロードさせて入力データを失わせるのではなく、エラー発生時に「セッションが切れました。再読み込みしてください」と親切に案内するUIを設計します。

② ページキャッシュプラグイン(WP Rocket, LiteSpeed等)による古いNonceのキャッシュ問題と動的取得(REST API/Ajax)での解決法

WP Rocket、LiteSpeed Cache、W3 Total Cache、あるいは Cloudflare などのフルページキャッシュをフロントエンドに導入しているサイトで最も頻発するトラブルです。

キャッシュプラグインがページのHTML全体を静的キャッシュとしてサーバーやCDNに保存すると、PHPが生成したNonce値もそのままHTML内に固定化 されてしまいます。その結果、以下の重大な問題が発生します。

  • キャッシュ保持期間が24時間を超えると、訪問者全員に期限切れの無効なNonceが配信され、フォーム送信が全滅する。
  • 未ログイン状態でキャッシュされたNonce(UID=0)がログイン中ユーザーに配信され、ユーザーID不一致で検証エラーになる。

【解決策:Nonceの動的取得パターン(推奨)】

この問題を根本から解消するベストプラクティスは、「ページHTMLはキャッシュさせ、Nonceはページ読み込み後にJavaScriptで動的に取得してフォームにセットする」 アプローチです。

<?php
// Nonceを返す軽量なREST APIエンドポイントを用意する
add_action( 'rest_api_init', function() {
    register_rest_route( 'my-site/v1', '/refresh-nonce', array(
        'methods'             => 'GET',
        'callback'            => function() {
            return rest_ensure_response( array(
                'nonce' => wp_create_nonce( 'my_custom_post_action' ),
            ) );
        },
        'permission_callback' => '__return_true', // 公開エンドポイント
    ) );
} );
// フロントエンドJavaScript: ページ読み込み後に最新Nonceを取得してフォームに注入
document.addEventListener('DOMContentLoaded', async () => {
    const nonceInput = document.querySelector('input[name="my_custom_nonce"]');
    if (!nonceInput) return;

    try {
        const res = await fetch('/wp-json/my-site/v1/refresh-nonce');
        if (res.ok) {
            const data = await res.json();
            if (data.nonce) {
                nonceInput.value = data.nonce; // キャッシュされた古いNonceを上書き!
            }
        }
    } catch (e) {
        console.error('Nonceの動的取得に失敗しました:', e);
    }
});

その他の対策として、お問い合わせフォームやマイページなど動的処理を行うページ全体をキャッシュプラグインの「キャッシュ除外URL」に指定する方法や、ログインユーザー向けのキャッシュバイパスを有効化する方法も有効です。

③ ユーザーセッション不一致(ログイン状態の変更、未ログインとログイン後でのUID不整合)

WordPressのNonce生成にはユーザーID(UID)が組み込まれています。未ログインユーザーは 0、ログインユーザーは 1 や 2 などの固有IDでハッシュが計算されます。

そのため、以下のようなシナリオでセッション不一致による検証失敗が発生します:

  • 未ログイン状態で開いたページ(UID=0のNonceが発行される)のまま、別タブでログインし、元のタブに戻ってフォーム送信する(送信時はログイン中UIDになるため不一致)。
  • 作業途中でブラウザの認証Cookieが有効期限切れになり、送信時には未ログイン(UID=0)として扱われる。
  • 複数アカウントを切り替えてテストしている際に、古いセッションのNonceが残っている。

【解決策】
Ajax通信やREST APIのレスポンスで403 Forbidden(検証失敗)が返ってきた場合、JavaScript側で wp.heartbeat やセッション状態を確認し、ログイン状態が変化していれば画面をリフレッシュするか、再ログインダイアログを表示して安全にセッションを復帰させる設計を取り入れましょう。


REST APIにおけるX-WP-Nonce検証失敗のトラブルシューティング

WordPress REST APIでカスタムエンドポイントを構築する際、リクエスト時に rest_cookie_invalid_nonce エラーが返されて詰まってしまう開発者が非常に多く見られます。このエラーの解明と対処法をまとめました。

rest_cookie_invalid_nonce エラーが発生する主な原因

WordPress REST APIに対してブラウザのCookie認証を使ってPOST/PUT/DELETEリクエストを送信すると、WordPressはCSRF対策として X-WP-Nonce ヘッダーを自動検証します。この検証に失敗すると、以下のJSONエラー(HTTP 403 Forbidden)が返されます:

{
    "code": "rest_cookie_invalid_nonce",
    "message": "Cookie ノンスが無効です。",
    "data": {
        "status": 403
    }
}

このエラーが発生する主な原因は以下の3点です:

  1. アクション名に 'wp_rest' 以外を指定している
    最も多いミスです。開発者が独自のアクション名(例: wp_create_nonce('my_custom_api_action'))で生成したNonceをヘッダーにセットしていると、REST APIのコア検証を通過できません。REST API用のNonceは必ず wp_create_nonce('wp_rest') で生成する必要があります。
  2. Cookieが送信されていない、またはCORS設定の不備
    モダンブラウザの fetch では、デフォルトでクロスオリジンや環境によってCookieが送信されない場合があります。同一ドメイン内通信であっても credentials: 'same-origin'(またはクロスオリジン時は 'include')を明示してください。
  3. 未ログイン状態でヘッダーを送信している
    未ログイン(Cookieなし)の状態でログイン用のNonceを送信したり、逆にCookieがある状態で不整合なNonceを送信するとエラーになります。

リクエストヘッダー付与時の注意点(大文字小文字・wpApiSettings.nonceの渡し方)

JavaScriptからリクエストヘッダーを送信する際の重要ポイントを確認しましょう。

  • ヘッダー名の大文字・小文字:HTTP/2やHTTP/3ではヘッダー名が小文字に正規化されますが、プログラム上では公式ドキュメント通りの 'X-WP-Nonce' で統一して記述するのが確実です。
  • wpApiSettings.nonce の安全な参照:管理画面外(フロントエンド)では wpApiSettings は自動出力されません。フロントエンドでREST APIを叩く場合は、自前で wp_localize_script() を使って wp_create_nonce('wp_rest') を渡す必要があります。

リバースプロキシやセキュリティプラグインによるヘッダー削除への対処

コードが正しくても、NginxやApacheなどのリバースプロキシ設定、あるいはCloudflareやWAF(ModSecurity、Wordfence等)によって X-WP-Nonce カスタムヘッダーが遮断・削除されているケースがあります。

ブラウザの開発者ツール(ネットワークタブ)で「リクエストヘッダーに X-WP-Nonce が含まれているか」を確認し、サーバー側のアクセスログやPHPの $_SERVER['HTTP_X_WP_NONCE'] に届いているかを検証してください。Nginxでカスタムヘッダーを通す場合は、必要に応じて underscores_in_headers on; やプロキシパス設定を確認します。


よくある質問(FAQ)

WordPress Nonceに関して開発者から頻繁に寄せられる疑問について回答します。

Q1: Nonceだけで権限チェック(認可)の代わりになりますか?(current_user_can併用の徹底)

回答:絶対に代わりにはなりません。必ず current_user_can() と併用してください。

開発初心者が最も陥りやすいセキュリティ上の落とし穴が、「Nonceチェックを通ったから安全=実行して良い」 と思い込んでしまうことです。

  • Nonceが証明すること:「このリクエストは、当サイトの正規の画面から送信されたものである(CSRF攻撃ではない)」
  • Nonceが証明しないこと:「このリクエストを送信したユーザーに、その処理を実行する権限があるかどうか(認可・アクセス制御)」

例えば、一般購読者(Subscriber)としてログインしているユーザーであっても、画面から正しいNonceを取得して管理者用エンドポイントにリクエストを送信することは容易です。current_user_can() による厳格な権限チェックを怠ると、一般ユーザーが他人の記事を改ざんしたり管理設定を変更できる特権昇格脆弱性(Broken Access Control / IDOR) に直結します。

<?php
// ❌ 危険なコード:Nonceしかチェックしていない(認可の欠落)
function dangerous_delete_item() {
    check_ajax_referer( 'delete_item_action', 'security' );
    // 購読者でも他人のデータを勝手に削除できてしまう!
    delete_user_data( $_POST['item_id'] );
}

// ⭕ 安全なコード:Nonce検証と権限チェック(認可)を必ず併用
function safe_delete_item() {
    // 1. CSRF対策(送信元の検証)
    check_ajax_referer( 'delete_item_action', 'security' );
    
    // 2. 認可(実行権限のチェック)
    if ( ! current_user_can( 'delete_posts' ) ) {
        wp_send_json_error( array( 'message' => 'この操作を実行する権限がありません。' ), 403 );
    }
    
    $item_id = absint( $_POST['item_id'] );
    delete_user_data( $item_id );
}

Q2: Nonceは暗号化キーですか?(推測防止トークンであり機密データの暗号化ではない)

回答:いいえ、Nonceは暗号化キーではありません。

WordPressのNonceは、外部から推測できないようにハッシュ化された「一時的な検証用トークン」に過ぎません。平文のデータを暗号化したり復号化したりする鍵ではないため、Nonceトークン自体にパスワードや個人情報などの機密データを含めて送信・保存してはいけません。

通信経路上での盗聴防止には常時SSL/TLS(HTTPS)の適用が必須であり、データベース内に保存する機密情報の暗号化が必要な場合は、PHP標準の openssl_encrypt() や sodium_crypto_secretbox() などの本格的な暗号化関数・ライブラリを利用してください。


開発者として次のステップへ:セキュアコーディング体系の完成

WordPressで堅牢なテーマ・プラグインやカスタム機能を開発するためには、「CSRF対策(Nonce)」 に加えて、「認可(権限チェック)」「入力サニタイズ」「出力エスケープ」 の3大要素を網羅した包括的なセキュリティ設計が不可欠です。

本記事でNonceの実装とトラブルシューティングをマスターした後は、ぜひ以下のシリーズ関連記事に進み、セキュアなWordPress開発スキルを完成させましょう。

WordPress セキュアコーディング実践シリーズ(全4回)


参照リンクとサイト診断

公式開発者リソース・参照リンク

あなたのWordPressサイトの安全性をチェックしませんか?(MozCheck CTA)

プラグインの脆弱性や設定ミス、セキュリティリスクは目に見えない場所で発生します。「MozCheck」は、WordPressサイトのURLを入力するだけで、セキュリティ状態や改善ポイントを即座に診断できる無料ツールです。

投稿者

🧰 WordPress無料診断

サイト改善の第一歩をお届け

当サイト「MozCheck」は、WordPressサイトの不安をチェックできる無料診断サービスです。
URLを入力するだけ。登録不要、すぐに診断結果が表示されます。

コメント

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です