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の告知でも念押しされています。試すなら、ローカルやテスト環境で、鍵の変更や削除の挙動まで確認しておくとよいでしょう。
出典(一次情報)
- Make WordPress Core「The Secrets API in WordPress 7.2」(2026年11月11日)
- WordPress.org News「WordPress 7.2 Beta 5」(2026年11月10日)
- WordPress 日本語版 リリース一覧
2026年11月13日時点の情報です。

コメント