WordPress 7.2のSecrets API、鍵はwp-configのWP_SECRETS_KEYに

WordPress開発コミュニティのMake WordPress Coreは2026年11月11日、WordPress 7.2に入るSecrets APIの開発者向け解説(Dev Note)を公開しました。書いたのはEric Mann氏で、APIキーやOAuthのクライアントシークレットといった認証情報を、暗号化したうえで保存・取得するための仕組みです。WordPress 7.2の正式版は2026年12月8日の予定で、プラグインでAPIキーを扱っている開発者は、リリース前に保存方法を見直しておく価値があります。

Secrets APIの仕組みは「鍵をwp-configに置く」ことが前提

Dev Noteによると、暗号化にはlibsodium(XChaCha20-Poly1305)を使い、保存先はデフォルトでoptionsテーブルです。ランダムなルートキーから各レコードの鍵を導き、そのルートキー自体をwp-config.phpのWP_SECRETS_KEYで暗号化して保存します。WP_SECRETS_KEYはbase64でエンコードしたランダムな32バイトの鍵です。

新規インストールではインストーラーがソルトと一緒に自動生成します。既存サイトでは自分で追加する必要があり、サイトヘルスが、ソルトの下に足す行を生成してくれます。手動で作る場合は、php -r 'echo base64_encode( random_bytes( 32 ) ), "\n";'のようなコマンドで生成できます。

ここで一番重要な制約は、WP_SECRETS_KEYが使えないときは、APIが何も保存しないことです。書き込みも、保存済みのシークレットの読み取りも、secret_key_unavailableエラーになります。空の値、wp-config-sample.phpのプレースホルダー、認証キーやソルトの値をコピーしたものは、有効な鍵とは扱われません。保存済みのシークレットがある状態で鍵を変えたり消したりすると、元に戻すまで読めなくなる点にも注意が必要です。

wp_set_secret・wp_get_secretの基本と、nullとWP_Errorの区別

保存はwp_set_secret()、取得はwp_get_secret()です。名前はplugin-slug/secret-nameの形で、使える文字は小文字、数字、ハイフン、アンダースコアです。スラッシュなしの名前も動きますが、_doing_it_wrong()が出ます。このプレフィックスは他のプラグインとの衝突を避けるためのもので、アクセス制御ではありません。サイト上で動くコードなら、どのシークレットも読めます。

取得結果の扱いは3通りです。WP_Secretオブジェクトが返れば成功で、値を取り出すにはreveal()を使います。nullが返るのは、そのシークレットが一度も保存されていないときだけです。存在するのに読めないとき(鍵やデータベースが使えないなど)はWP_Errorが返ります。このとき「新しいキーを入力してください」と表示すると、まだ使える認証情報を上書きしてしまうおそれがあるため、nullとWP_Errorは分けて処理するようDev Noteが促しています。

WP_Secretは、出力、ログ、JSONエンコード、var_dump()に渡しても[secret:my-plugin/api-key]と表示され、値は出ません。シリアライズとクローンは例外になります。reveal()は使う直前に呼び、オブジェクトをキャッシュしないことが推奨されています。

ローテーション、既存optionの取り込み、読み取り専用のホスト管理

新しい値を書き込むと、現在の値はWP_Secret_Version::PREVIOUSに移ります。ローテーション中は旧バージョンにフォールバックでき、不要になったらwp_retire_secret_version()で削除します。

すでにoptionにAPIキーを保存しているプラグインには、wp_import_option_as_secret()が用意されています。元のoptionは削除されずに残るため、自分で消す必要があります。取り込んだシークレットは、ローテーション対象としてマークされます。利用できるかどうかはwp_is_secrets_api_available()で確認でき、secrets.phpドロップインの読み込み失敗、WP_SECRETS_KEYがない・使えない、保存済みのルートキーを復号できない、のいずれかならfalseになります。

ホストによっては、シークレットをダッシュボードやCLIで管理し、WordPressからは読み取り専用で提供します。このときwp_secrets_provider_is_writable()はfalseを返し、wp_set_secret()はWP_Errorを返します。Dev Noteは、書き込みに失敗してもoptionへの保存に逃げないこと、入力欄の代わりに通知を出すことを勧めています。

ベータ1から変わった点と、サイトヘルスへの追加

ベータ1ですでに試した開発者向けに、破壊的変更も記載されています。主な点は次の2つです。

  • WP_SECRETS_KEYが必須になり、LOGGED_IN_KEYとLOGGED_IN_SALTから導く鍵へのフォールバックは削除されました。ソルトを変えると全シークレットが読めなくなる問題があったためとされています。
  • キーリング、ストア、プロバイダがinterfaceからabstract classに変わりました。ドロップインではimplementsをextendsに直す必要があり、implementsのままだと全リクエストで致命的エラーになります。

ベータ中にWP_SECRETS_KEYなしで保存したシークレットは、旧フォールバック鍵で暗号化されたままです。更新後は復号できないと報告されますが、データは残っています。Dev Noteには、WP_SECRETS_KEY_PREVIOUSを使って、WP-CLIでルートキーを再暗号化する手順が載っています。手順が終わるまではソルトを変更しないよう書かれています。

サイトヘルスのSecurityカテゴリには、Secrets APIのテストが3つ加わります。鍵が使えないときのrecommended(保存済みのルートキーを復号できないときはcritical)、復号できないシークレットがあるときのcritical、ローテーション待ちの認証情報があるときのrecommendedです。Infoタブにも、プロバイダや鍵の取得元、シークレットの数が出ます。

権限チェックは呼び出し側の仕事、動作はPHP 7.4以上

Dev Noteは、関数の内部で権限チェック(capability)をしないと明記しています。cronやREST経由でも呼ばれるためです。ユーザーが値を入力・管理する画面では、呼び出し側で必ず権限を確認してください。また、ドロップインでキーや値を受け取る引数には、#[\SensitiveParameter]を自分で付ける必要があります。この属性は継承されません。動作要件はPHP 7.4以上です。

プラグイン開発者が今のうちにやっておきたいこと

まず、自分のプラグインがAPIキーをどこに保存しているかを洗い出します。optionに平文で入っているものがあれば、wp_is_secrets_api_available()で分岐して、使える環境だけSecrets APIに移す設計が考えられます。使えない環境(鍵が未設定のサイトなど)では従来の保存に戻す分岐を残す、という書き方です。ただし、書き込みに失敗した場合にoptionへ逃がすのはDev Noteが避けるよう求めている点なので、「API自体が使えない」場合と「書き込みがエラーになった」場合を分けて考える必要があります。

なお、このAPIにはコミュニティ内で異論もあります。Dev Noteのコメント欄では、シークレットは外部から提供するのがベストプラクティスではないか、書き込み機能があることでプロバイダにも書き込み対応が事実上求められるのではないか、といった懸念が出ています。これに対してMann氏は、外部プロバイダを最も外側の拡張点として設計し直し、読み取り専用プロバイダも正式に支えていると答えています。今後のRCまでに仕様が動く可能性もあるため、本番プラグインへの組み込みはベータ段階では慎重に進めるのが無難です。

個人的には、「鍵をwp-configに置く」前提が一番の実務上の論点だと考えます。暗号化の強さより、鍵の管理を間違えたときに全シークレットが読めなくなるという運用リスクのほうが、小規模サイトでは現実的です。ベータ版を本番サイトに入れないことは、WordPress 7.2 Beta 5の告知でも念押しされています。試すなら、ローカルやテスト環境で、鍵の変更や削除の挙動まで確認しておくとよいでしょう。

出典(一次情報)

2026年11月13日時点の情報です。

PR当サイトはアフィリエイト広告を利用しています。掲載内容は広告主から依頼・指示を受けたものではなく、筆者の調査・体験にもとづきます。

コメント

PR エックスサーバー

WordPressを、速く・止まらずに運営したい方へ

サーバー選びを間違えると、表示が遅い・サイトが止まるリスクがあります

こんなお悩みはありませんか?

  • どのレンタルサーバーを選べばよいか分からない
  • 表示が遅い・サイトが落ちるのが心配
  • WordPressの設定やセキュリティに自信がない

サーバーは、あとから乗り換えると、データの移行やドメインの設定に手間がかかります。表示が遅い、突然止まるといったトラブルは、訪問者が離れる原因にもなります。最初に、稼働率の保証や実績を確認して選ぶのが安全です。

エックスサーバーなら、WordPressの運営に強いレンタルサーバーを、迷わず選べます。国内でWordPressを利用して運用されているサイトの集計(Dataprovider.com調べ、2025年6月)で、国内シェアNo.1と公式サイトに記載されています。

No.1WordPressサイトの国内シェア(Dataprovider.com調べ・2025年6月)
99.99%以上サーバー月間稼働率を保証
99%以上WordPressへの攻撃を未然に防ぐ(2024年9月15日〜11月15日の当社調べ)

選ばれるポイント

  • WordPressサイトの国内シェアNo.1。実績で選びたいときの安心材料(Dataprovider.com調べ、2025年6月)
  • サイトが止まりにくい。月間稼働率99.99%以上を保証し、下回ると月額費用の一部を返金
  • 攻撃に強い。WordPressを狙った攻撃の99%以上を未然に防ぐ機能(2024年9月15日〜11月15日の当社調べ)
  • ドメイン代を節約できる。独自ドメインが永久無料(対象ドメイン・契約期間などの条件あり)
  • テーマ選びも安心。人気テーマ「Cocoon」の開発・提供元が運営
  • 10日間の無料お試しで、契約前に操作や表示の速さを確かめられる

10日間の無料お試しで、契約前に試せます

公式サイトを見る

10日間無料でお試し

エックスサーバー

広告(アフィリエイト)を含みます。特長は2026年11月8日時点の公式サイトの記載で、数値・順位は各調査・調べの時点のものです。料金・条件は公式サイトでご確認ください。

タイトルとURLをコピーしました