В WordPress 7.2 появится Secrets API: ключи и токены плагинов будут храниться зашифрованными

WordPress 7.2, релиз которого назначен на 8 декабря 2026 года, получит Secrets API: API-ключи, токены и пароли плагинов будут храниться в базе зашифрованными, а не открытым текстом в wp_options. Для работы нужен отдельный ключ WP_SECRETS_KEY в wp-config.php. Без него API ничего не сохраняет. 17 ноября выходит RC1, и до этой даты хостингов просят протестировать новинку.
Для владельцев сайтов это первая встроенная защита учётных данных на случай утечки дампа базы или копии staging-сервера. Сейчас ключи платёжных шлюзов, CRM и почтовых сервисов у большинства плагинов лежат в БД как обычный текст. Если вы ведёте сайт на WordPress с интеграциями, переход стоит запланировать заранее.
При этом функция вызвала спор в сообществе. Создатель REST API WordPress Райан Маккью (Human Made) предложил убрать Secrets API из релиза 7.2, автор API Эрик Манн ответил на критику. Пока функция остаётся в ветке. Командам поддержки сайтов разумно подготовиться к обоим исходам.
Что такое Secrets API в WordPress 7.2
Secrets API — набор функций ядра, через которые плагины сохраняют и читают чувствительные значения. Основных функций три: wp_set_secret() сохраняет значение в зашифрованном виде, wp_get_secret() читает его, wp_delete_secret() удаляет. Дополнительно есть wp_list_secrets() (только имена и метаданные, без значений), wp_import_option_as_secret() для переноса старых опций и сетевые варианты функций для мультисайта.
Имена секретов строятся по схеме plugin-slug/secret-name: строчные латинские буквы, цифры, дефисы и подчёркивания. Префикс не даёт плагинам перезаписывать чужие значения, но доступ он не ограничивает. Как прямо пишут в dev note, любой код на сайте может прочитать любой секрет.
wp_get_secret() возвращает объект WP_Secret. При выводе в лог или на экран он показывает заглушку вида [secret:my-plugin/api-key], а настоящее значение отдаёт только метод reveal(). Сериализовать или клонировать такой объект нельзя: будет исключение. Так ключи реже случайно оказываются в debug-логах.
Как устроено шифрование и зачем нужен WP_SECRETS_KEY
Значения шифруются через libsodium алгоритмом XChaCha20-Poly1305 и хранятся в таблице опций. Каждый секрет шифруется корневым ключом, а тот, в свою очередь, ключом WP_SECRETS_KEY из wp-config.php. Сам ключ в базе не лежит, поэтому одной копии БД для расшифровки недостаточно.
- Ключ обязателен. Начиная с поздних бет запасной вариант через
LOGGED_IN_KEYиLOGGED_IN_SALTубран. БезWP_SECRETS_KEYлюбая запись и чтение возвращают ошибкуsecret_key_unavailable. - Не любой ключ подходит. Пустое значение, заглушка из
wp-config-sample.phpили копия одной из солей не засчитываются. Нужны 32 случайных байта в base64. - Ключ нельзя просто поменять. Если после сохранения секретов изменить или удалить
WP_SECRETS_KEY, все значения станут нечитаемыми, пока старый ключ не вернут. Для смены ключа есть отдельная процедура ротации через WP-CLI. - Site Health подскажет. В «Здоровье сайта» появятся проверки источника ключа, нерасшифровываемых секретов и учётных данных, ожидающих ротации.
Хостинги могут подключить своё хранилище через drop-in wp-content/secrets.php: KMS или HSM для ключей, внешнее хранилище записей или полностью внешний менеджер секретов. Если провайдер работает только на чтение, wp_set_secret() вернёт WP_Error, а wp_secrets_provider_is_writable() покажет false.
Почему Secrets API предлагают убрать из релиза
Критики считают, что WordPress должен только читать секреты, а не управлять ими. Райан Маккью, вице-президент по продукту Human Made и Altis, 12 ноября оставил под dev note комментарий с «сильным −1». По его словам, лучшая практика индустрии в том, чтобы секреты хранились отдельно от остальных данных и были доступны приложению только на чтение, а управление ими шло вне приложения: так проще аудит, контроль изменений и ротация по требованиям комплаенса. Он опасается, что API с записью «окостенеет» и внешним провайдерам придётся поддерживать запись ради совместимости. В пример он привёл плагин WordPress AI, который считает, что сохранение всегда проходит, и не сообщает об ошибке.
Эрик Манн ответил, что после похожих замечаний в августе API уже изменили: хостинги могут подключать собственные хранилища, в том числе только для чтения. Главный его аргумент в том, что у большинства сайтов на WordPress вообще нет внешнего менеджера секретов. Учётные данные приходят через страницу настроек плагина и лежат в wp_options открытым текстом, попадая в каждый дамп, бэкап и клон для staging. API только на чтение таким сайтам ничего не даёт.
Официального решения по итогам спора на момент публикации нет. Даже если функцию отложат, это не отменяет главного вывода: хранить ключи интеграций открытым текстом в базе рискованно уже сейчас.
Что проверить на своём сайте до 8 декабря
- Сделайте инвентаризацию секретов. Выясните, какие плагины хранят ключи API, токены и пароли в
wp_options: платежи, CRM, почта, аналитика, ИИ-сервисы. - Добавьте
WP_SECRETS_KEYна staging. Сгенерируйте ключ, сохраните его в менеджере паролей вне сервера и проверьте, что бэкапыwp-config.phpи базы не лежат в одном месте. - Протестируйте обновление на копии сайта. Помимо Secrets API в 7.2 иконки админки переведены с Dashicons на SVG (CSS через
::beforeперестанет работать), а склейка скриптов админки черезload-scripts.phpотключена. Это может задеть кастомные темы и плагины. - Если вы разрабатываете плагин, проверяйте
wp_is_secrets_api_available(), обрабатывайтеWP_Errorпри записи и не удаляйте старое хранилище, пока секрет не сохранён. Проверку прав пользователя функции не делают, её нужно добавить в своём коде. - После переноса ротируйте ключи. Значение, которое лежало открытым текстом, уже попало в старые бэкапы, поэтому
wp_import_option_as_secret()сам помечает такие секреты на ротацию.
Перед крупным обновлением полезно заодно пересмотреть сам набор расширений: лишний плагин с доступом к ключам сторонних сервисов увеличивает риск при любой утечке. Для сверки пригодится наш обзор лучших плагинов для WordPress.
Часто задаваемые вопросы
Когда выйдет WordPress 7.2?
Финальный релиз запланирован на 8 декабря 2026 года, RC1 на 17 ноября. Сроки ещё могут сдвинуться, а состав релиза окончательно фиксируется на этапе RC.
Будут ли старые плагины работать после обновления?
Да. Secrets API добровольный: плагины, которые хранят ключи в wp_options, продолжат работать как раньше. Защита появится только после того, как авторы перейдут на новые функции.
Защищает ли Secrets API от вредоносного плагина?
Нет. Шифрование помогает при утечке дампа базы, SQL-инъекции с чтением опций или публичной копии staging. Код, запущенный на самом сайте, по-прежнему может прочитать любой секрет, как и тот, у кого есть одновременно база и wp-config.php.
Что будет, если потерять WP_SECRETS_KEY?
Все сохранённые секреты станут нечитаемыми, и их придётся заново ввести в настройках плагинов. Поэтому ключ нужно хранить отдельно от сервера, например в корпоративном менеджере паролей.
Источники
- Make WordPress Core: The Secrets API in WordPress 7.2, Эрик Манн, 11 ноября 2026 года (первоисточник).
- Make WordPress Hosting: Call to test WordPress 7.2’s Secrets API, upgrades and /random/, 12 ноября 2026 года.
- WordPress Developer Blog: What’s new for developers? (November 2026), 13 ноября 2026 года.
- The Repository: WordPress 7.2’s Secrets API Faces Pushback as Hosts Are Asked to Test It Before RC1, Рэй Морей, 13 ноября 2026 года.
Подготовим сайт на WordPress к обновлению 7.2
Проверим плагины и интеграции, перенесём ключи сервисов в защищённое хранилище и обновим сайт сначала на тестовой копии, чтобы релиз прошёл без простоев.