Wordpresser.questのwordpressの基本アイキャッチ画像

WordPress 7.2に「Secrets API」──APIキーやトークンを暗号化して保存、ただし既存サイトは自動では有効にならない

2026年12月8日に公開予定の「WordPress 7.2」に、プラグインがAPIキー・トークン・パスワードを暗号化してデータベースに保存できる「Secrets API」が入る見通しです。ただし、既存のサイトでは、サイト運営者がwp-config.phpに暗号化用のキーを追加するまで有効になりません。セキュリティ系メディアのCyber Kendraが、開発者向けの告知などをもとに整理しています。

Secrets APIとは

これまで多くのプラグインは、外部サービスのAPIキーなどをoptionsテーブルに平文で保存してきました。Secrets APIを使うと、これらを暗号化した状態で保存できます。

  • プラグイン向けの関数は4つ: wp_set_secret()、wp_get_secret()、wp_delete_secret()、wp_retire_secret_version()
  • 取り出した値はWP_Secretオブジェクトになり、reveal()を呼ぶまでログやデバッグ出力ではマスクされる
  • 各シークレットは直前の1世代分が保持され、停止なしでキーを入れ替えられる
  • 名前はplugin-slug/secret-nameの形式

暗号化にはlibsodiumのXChaCha20-Poly1305が使われます。データベースのダンプや流出したバックアップ、読み取り専用のSQLインジェクションで見えるのは暗号文だけになります。

サイト運営者がやること: WP_SECRETS_KEYの用意

機能を有効にするには、wp-config.phpにWP_SECRETS_KEYという定数を定義します。記事では、ランダムな32バイトをbase64にした値(例としてopenssl rand -base64 32)が推奨されています。

  • 新規インストールではキーが自動で作られる。ただし、書き込むのはブラウザ上のインストーラーのみ。WP-CLIのwp config create、ワンクリックインストーラー、ホスティング側の自動構築では、まだ書き込まれないと報告されている
  • 7.1.4から更新したサイトにはキーが作られない。サイトヘルスが追加方法を案内する
  • Beta 5でログイン用ソルトへのフォールバックが廃止され、有効なキーがないと読み書きはsecret_key_unavailableエラーになる
  • キーを変更・削除すると、保存済みのシークレットはすべて読めなくなる。サイトの移行、ステージングの複製、復元のときは、キーも一緒に持っていく必要がある

共用サーバーでSoftaculousから入れたサイトを7.2 Beta 5に上げたテスターが、キーがない状態になったと報告しています。サイトヘルスの評価は「重大」ではなく「推奨」にとどまっていた、とのことです。

防げるものと防げないもの

この仕組みが守るのは「保存されているとき」だけです。記事は、サイト上で動くコードなら暗号化されたシークレットを読めること、キーがデータと同じサーバーにあることを限界として挙げています。悪意あるプラグインや、サイト内でコードを実行された場合は防げません。たとえば、「WP2Shell」攻撃連鎖のようにコード実行まで至る攻撃では、この保護は届かない、という位置づけです。

7.2の時点では、シークレットを管理する管理画面はありません。後のリリースで計画されているとのことです。

7.2への採用をめぐる議論

記事によると、コア貢献者のRyan McCue氏が、7.2からこのAPIを外すよう求めました。「シークレットはアプリケーションが管理するものではなく、外から渡されるものだ」「保存時暗号化されたデータベースで似た保護が得られる」といった理由です。Matt Mullenweg氏も懸念に同意し、機密データを狙われやすくするには時期が悪いと述べたと伝えられています。一方、Eric Mann氏は、ホスティング側が読み取り専用のシークレットをsecrets.phpのドロップインで渡せるように設計を直したとして、残すべきだと反論しました。

ホスティングチームは、11月17日のRelease Candidate 1より前にBeta 5で試すよう呼びかけています。RC1以降の変更にはコミッターの承認が必要になります。RC1までにAPIが変わるかどうかは、記事の時点では示されていません。

日本のサイト運営者・開発者が確認しておきたいこと

  • プラグイン開発者: 変更前にwp_is_secrets_api_available()で利用可否を確認する。既存の平文オプションはwp_import_option_as_secret()で移せるが、古い平文はすでにバックアップに残っているため、移行した認証情報は再発行(ローテーション)の対象にする
  • サイト運営者: 7.2へ上げる前に、ホスティングや移行ツールがWP_SECRETS_KEYを引き継ぐか確認する。バックアップにはwp-config.phpも含める
  • ステージング運用: 本番とステージングでキーが違うと、複製したサイトで保存済みの認証情報が読めなくなる

7.2では、ほかにも管理バーとサイドバーのアイコンがDashiconsからインライン SVGに変わり、::beforeでアイコンを装飾・非表示にしているCSSが効かなくなる可能性があります。load-scripts.phpとload-styles.phpは非推奨になり、投稿をランダムに表示する/randomというURLも加わる、と記事は伝えています。なお、直近の脆弱性対応は「WordPress 7.1.4」のセキュリティリリースの記事も参考にしてください。

出典: Cyber Kendra「WordPress 7.2 Secrets API: Encrypted API Keys Explained」

記事 by
ai-taco

コメントする